feat(uptimerobot): add UptimeRobot v3 integration

.claude/commands/add-block.md

@@ -27,7 +27,7 @@ export const {ServiceName}Block: BlockConfig = {
  name: '{Service Name}', // Human readable
  description: 'Brief description', // One sentence
  longDescription: 'Detailed description for docs',
- docsLink: 'https://docs.sim.ai/tools/{service}',
+ docsLink: 'https://docs.sim.ai/integrations/{service}',
  category: 'tools', // 'tools' | 'blocks' | 'triggers'
  integrationType: IntegrationType.X, // Primary category (see IntegrationType enum)
  tags: ['oauth', 'api'], // Cross-cutting tags (see IntegrationTag type)
@@ -626,7 +626,7 @@ export const ServiceBlock: BlockConfig = {
  name: 'Service',
  description: 'Integrate with Service API',
  longDescription: 'Full description for documentation...',
- docsLink: 'https://docs.sim.ai/tools/service',
+ docsLink: 'https://docs.sim.ai/integrations/service',
  category: 'tools',
  integrationType: IntegrationType.DeveloperTools,
  tags: ['oauth', 'api'],

.claude/commands/add-integration.md

@@ -121,7 +121,7 @@ export const {Service}Block: BlockConfig = {
  name: '{Service}',
  description: '...',
  longDescription: '...',
- docsLink: 'https://docs.sim.ai/tools/{service}',
+ docsLink: 'https://docs.sim.ai/integrations/{service}',
  category: 'tools',
  integrationType: IntegrationType.X, // Primary category (see IntegrationType enum)
  tags: ['oauth', 'api'], // Cross-cutting tags (see IntegrationTag type)

.claude/commands/validate-integration.md

@@ -185,7 +185,7 @@ For **each tool** in `tools.access`:
 - [ ] `name` is human-readable (e.g., `'X'`, `'Cloudflare'`)
 - [ ] `description` is a concise one-liner
 - [ ] `longDescription` provides detail for docs
-- [ ] `docsLink` points to `'https://docs.sim.ai/tools/{service}'`
+- [ ] `docsLink` points to `'https://docs.sim.ai/integrations/{service}'`
 - [ ] `category` is `'tools'`
 - [ ] `bgColor` uses the service's brand color hex
 - [ ] `icon` references the correct icon component from `@/components/icons`

apps/docs/components/icons.tsx

@@ -7706,6 +7706,17 @@ export function UpstashIcon(props: SVGProps<SVGSVGElement>) {
  )
 }
 
+export function UptimeRobotIcon(props: SVGProps<SVGSVGElement>) {
+ return (
+ <svg {...props} xmlns='http://www.w3.org/2000/svg' viewBox='0 0 298 298' width='24' height='24'>
+ <g fill='#3BD771' transform='translate(.9 .9)'>
+ <circle cx='148.1' cy='148.1' r='148.1' opacity='.3' />
+ <circle cx='148.1' cy='148.1' r='98.9' />
+ </g>
+ </svg>
+ )
+}
+
 export function RevenueCatIcon(props: SVGProps<SVGSVGElement>) {
  return (
  <svg

apps/docs/components/ui/icon-mapping.ts

@@ -216,6 +216,7 @@ import {
  TwilioIcon,
  TypeformIcon,
  UpstashIcon,
+ UptimeRobotIcon,
  VantaIcon,
  VercelIcon,
  VideoIcon,
@@ -475,6 +476,7 @@ export const blockTypeToIconMap: Record<string, IconComponent> = {
  twilio_voice: TwilioIcon,
  typeform: TypeformIcon,
  upstash: UpstashIcon,
+ uptimerobot: UptimeRobotIcon,
  vanta: VantaIcon,
  vercel: VercelIcon,
  video_generator: VideoIcon,

apps/docs/content/docs/en/integrations/meta.json

@@ -218,6 +218,7 @@
  "twilio_voice",
  "typeform",
  "upstash",
+ "uptimerobot",
  "vanta",
  "vercel",
  "wealthbox",

apps/sim/app/api/tools/uptimerobot/create-psp/route.ts

@@ -0,0 +1,48 @@
+import { createLogger } from '@sim/logger'
+import { getErrorMessage } from '@sim/utils/errors'
+import { type NextRequest, NextResponse } from 'next/server'
+import { uptimeRobotCreatePspContract } from '@/lib/api/contracts/tools/uptimerobot'
+import { parseRequest } from '@/lib/api/server'
+import { checkInternalAuth } from '@/lib/auth/hybrid'
+import { generateRequestId } from '@/lib/core/utils/request'
+import { withRouteHandler } from '@/lib/core/utils/with-route-handler'
+import { forwardPspRequest } from '@/app/api/tools/uptimerobot/server-utils'
+
+export const dynamic = 'force-dynamic'
+
+const logger = createLogger('UptimeRobotCreatePspAPI')
+
+export const POST = withRouteHandler(async (request: NextRequest) => {
+ const requestId = generateRequestId()
+
+ try {
+ const authResult = await checkInternalAuth(request, { requireWorkflowId: false })
+ if (!authResult.success || !authResult.userId) {
+ logger.warn(`[${requestId}] Unauthorized UptimeRobot create-psp request: ${authResult.error}`)
+ return NextResponse.json(
+ { success: false, error: authResult.error || 'Authentication required' },
+ { status: 401 }
+ )
+ }
+
+ const parsed = await parseRequest(uptimeRobotCreatePspContract, request, {})
+ if (!parsed.success) return parsed.response
+ const body = parsed.data.body
+
+ return forwardPspRequest({
+ apiKey: body.apiKey,
+ method: 'POST',
+ path: '/psps',
+ fields: body,
+ userId: authResult.userId,
+ requestId,
+ logger,
+ })
+ } catch (error) {
+ logger.error(`[${requestId}] Unexpected error creating status page:`, error)
+ return NextResponse.json(
+ { success: false, error: getErrorMessage(error, 'Unknown error') },
+ { status: 500 }
+ )
+ }
+})

apps/sim/app/api/tools/uptimerobot/server-utils.ts

@@ -0,0 +1,162 @@
+import type { Logger } from '@sim/logger'
+import { NextResponse } from 'next/server'
+import { processFilesToUserFiles, type RawFileInput } from '@/lib/uploads/utils/file-utils'
+import { downloadFileFromStorage } from '@/lib/uploads/utils/file-utils.server'
+import { assertToolFileAccess } from '@/app/api/files/authorization'
+import { mapPsp, UPTIMEROBOT_API_BASE } from '@/tools/uptimerobot/types'
+
+/** Fields shared by the PSP create and update routes (before the files). */
+interface PspFormFields {
+ friendlyName?: string | null
+ monitorIds?: string | null
+ status?: string | null
+ password?: string | null
+ customDomain?: string | null
+ hideUrlLinks?: boolean | null
+ noIndex?: boolean | null
+ logo?: unknown
+ icon?: unknown
+}
+
+/**
+ * Appends a single optional image file (logo or icon) to the form after
+ * downloading it from storage and verifying the caller may access it.
+ *
+ * @returns an error `NextResponse` if the file is invalid or access is denied,
+ * otherwise `null`.
+ */
+async function appendPspImage(
+ form: FormData,
+ field: 'logo' | 'icon',
+ file: unknown,
+ userId: string,
+ requestId: string,
+ logger: Logger
+): Promise<NextResponse | null> {
+ const userFiles = processFilesToUserFiles([file as RawFileInput], requestId, logger)
+ if (userFiles.length === 0) {
+ // A file was supplied but could not be resolved to a stored UserFile (e.g. a
+ // bare string reference). Surface it rather than silently dropping the image.
+ return NextResponse.json(
+ { success: false, error: `Invalid ${field} file: expected an uploaded file reference` },
+ { status: 400 }
+ )
+ }
+
+ const userFile = userFiles[0]
+ const denied = await assertToolFileAccess(userFile.key, userId, requestId, logger)
+ if (denied) return denied
+
+ const buffer = await downloadFileFromStorage(userFile, requestId, logger)
+ const mimeType = userFile.type || 'application/octet-stream'
+ form.append(field, new Blob([new Uint8Array(buffer)], { type: mimeType }), userFile.name)
+ return null
+}
+
+/**
+ * Builds the multipart form for a PSP request, downloads any referenced
+ * logo/icon files, forwards the request to UptimeRobot, and returns a typed
+ * `{ success, output: { psp } }` envelope as a `NextResponse`.
+ */
+export async function forwardPspRequest(options: {
+ apiKey: string
+ method: 'POST' | 'PATCH'
+ path: string
+ fields: PspFormFields
+ userId: string
+ requestId: string
+ logger: Logger
+}): Promise<NextResponse> {
+ const { apiKey, method, path, fields, userId, requestId, logger } = options
+
+ const form = new FormData()
+ if (fields.friendlyName) form.append('friendlyName', fields.friendlyName)
+ if (fields.status) form.append('status', fields.status)
+ if (fields.password) form.append('password', fields.password)
+ if (fields.customDomain) form.append('customDomain', fields.customDomain)
+ if (typeof fields.hideUrlLinks === 'boolean') {
+ form.append('hideUrlLinks', String(fields.hideUrlLinks))
+ }
+ if (typeof fields.noIndex === 'boolean') form.append('noIndex', String(fields.noIndex))
+ if (fields.monitorIds) {
+ for (const id of fields.monitorIds.split(',')) {
+ const trimmed = id.trim()
+ if (trimmed) form.append('monitorIds', trimmed)
+ }
+ }
+
+ if (fields.logo) {
+ const denied = await appendPspImage(form, 'logo', fields.logo, userId, requestId, logger)
+ if (denied) return denied
+ }
+ if (fields.icon) {
+ const denied = await appendPspImage(form, 'icon', fields.icon, userId, requestId, logger)
+ if (denied) return denied
+ }
+
+ const response = await fetch(`${UPTIMEROBOT_API_BASE}${path}`, {
+ method,
+ headers: { Authorization: `Bearer ${apiKey}`, Accept: 'application/json' },
+ body: form,
+ })
+
+ const text = await response.text()
+ if (!response.ok) {
+ let message: string | undefined
+ try {
+ message = JSON.parse(text)?.message
+ } catch {
+ message = undefined
+ }
+ logger.error(`[${requestId}] UptimeRobot PSP request failed`, {
+ status: response.status,
+ body: text,
+ })
+ return NextResponse.json(
+ { success: false, error: message || `UptimeRobot API error (HTTP ${response.status})` },
+ { status: response.status }
+ )
+ }
+
+ // A successful PSP create/update must return the PspDto object. An empty or
+ // non-object body is unexpected — reject it rather than mapping a phantom PSP
+ // (id: 0, empty name, null images) back to the workflow.
+ if (!text) {
+ logger.error(`[${requestId}] UptimeRobot returned an empty PSP response`)
+ return NextResponse.json(
+ { success: false, error: 'UptimeRobot returned an unexpected response' },
+ { status: 502 }
+ )
+ }
+
+ let data: Record<string, unknown>
+ try {
+ const parsed = JSON.parse(text)
+ if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
+ throw new Error('Expected a PSP object response')
+ }
+ data = parsed as Record<string, unknown>
+ } catch {
+ logger.error(`[${requestId}] UptimeRobot returned an unexpected PSP response`, { body: text })
+ return NextResponse.json(
+ { success: false, error: 'UptimeRobot returned an unexpected response' },
+ { status: 502 }
+ )
+ }
+
+ // A real PspDto always carries a positive numeric `id` and a non-empty
+ // `friendlyName` (both spec-required). If they are absent, the body is a `{}`
+ // or metadata envelope, not a status page — surface the provider error rather
+ // than mapping a phantom PSP.
+ if (typeof data.id !== 'number' || data.id < 1 || !data.friendlyName) {
+ logger.error(`[${requestId}] UptimeRobot returned a PSP response without core fields`, {
+ body: text,
+ })
+ return NextResponse.json(
+ { success: false, error: 'UptimeRobot returned an unexpected response' },
+ { status: 502 }
+ )
+ }
+
+ return NextResponse.json({ success: true, output: { psp: mapPsp(data) } })
+}

apps/sim/app/api/tools/uptimerobot/update-psp/route.ts

@@ -0,0 +1,48 @@
+import { createLogger } from '@sim/logger'
+import { getErrorMessage } from '@sim/utils/errors'
+import { type NextRequest, NextResponse } from 'next/server'
+import { uptimeRobotUpdatePspContract } from '@/lib/api/contracts/tools/uptimerobot'
+import { parseRequest } from '@/lib/api/server'
+import { checkInternalAuth } from '@/lib/auth/hybrid'
+import { generateRequestId } from '@/lib/core/utils/request'
+import { withRouteHandler } from '@/lib/core/utils/with-route-handler'
+import { forwardPspRequest } from '@/app/api/tools/uptimerobot/server-utils'
+
+export const dynamic = 'force-dynamic'
+
+const logger = createLogger('UptimeRobotUpdatePspAPI')
+
+export const POST = withRouteHandler(async (request: NextRequest) => {
+ const requestId = generateRequestId()
+
+ try {
+ const authResult = await checkInternalAuth(request, { requireWorkflowId: false })
+ if (!authResult.success || !authResult.userId) {
+ logger.warn(`[${requestId}] Unauthorized UptimeRobot update-psp request: ${authResult.error}`)
+ return NextResponse.json(
+ { success: false, error: authResult.error || 'Authentication required' },
+ { status: 401 }
+ )
+ }
+
+ const parsed = await parseRequest(uptimeRobotUpdatePspContract, request, {})
+ if (!parsed.success) return parsed.response
+ const body = parsed.data.body
+
+ return forwardPspRequest({
+ apiKey: body.apiKey,
+ method: 'PATCH',
+ path: `/psps/${body.pspId}`,
+ fields: body,
+ userId: authResult.userId,
+ requestId,
+ logger,
+ })
+ } catch (error) {
+ logger.error(`[${requestId}] Unexpected error updating status page:`, error)
+ return NextResponse.json(
+ { success: false, error: getErrorMessage(error, 'Unknown error') },
+ { status: 500 }
+ )
+ }
+})