Dirección base
https://api.nuvostatus.com
Todas las rutas de abajo son relativas a ella. Peticiones y respuestas son JSON; las horas van en ISO 8601 en UTC; los identificadores son UUID.
Autenticación
Una clave pertenece a un espacio de trabajo y la crea en sus ajustes un propietario o un administrador. Su valor se muestra una sola vez; guárdalo donde tus scripts guardan sus secretos. Envíalo como token bearer en cada petición. Una clave con ámbito de lectura ve lo que ve un lector; una con ámbito de escritura además crea, cambia, pausa y borra monitores y programa mantenimientos. Los miembros, las claves y el propio espacio nunca son alcanzables con una clave.
curl "https://api.nuvostatus.com/v1/me" \
-H "Authorization: Bearer $NUVOSTATUS_KEY"
Errores
Un error es un sobre con un código estable, el mismo que muestra el panel. El estado dice de qué clase: 400 para un cuerpo o un parámetro que la API no acepta (con detalle por campo), 401 para una clave ausente, desconocida, revocada o caducada, 403 para algo que la clave no puede hacer, 404 para un recurso que no está en el espacio de la clave, 409 para un límite alcanzado, 429 pasado el límite de peticiones.
{
"error": {
"code": "monitor.not_found"
}
}
Copia de seguridad y restauración
La configuración completa de un espacio de trabajo sale como un único documento JSON versionado y vuelve de la misma forma, al mismo espacio o a otro. El documento lleva monitores, grupos, ventanas de mantenimiento, canales y páginas de estado, y ningún secreto: la credencial de un monitor, el destino de un canal y la contraseña de una página se quedan atrás, y la importación nombra las entradas que dejó sin configurar. Nada de lo que ya está se crea dos veces, y el plan se comprueba antes de escribir nada. Una clave de lectura puede llevarse la copia; una de escritura puede restaurarla.
GET https://api.nuvostatus.com/v1/workspace/export
POST https://api.nuvostatus.com/v1/workspace/import
Límites
El límite sigue el plan del espacio de trabajo: 60 peticiones por minuto en free, 120 en starter, 600 en pro y 1.200 en business. Se cuenta en PostgreSQL, por clave y por minuto, así que reiniciar la API no lo reinicia. Cada respuesta dice en qué punto está la clave en las cabeceras RateLimit-Limit, RateLimit-Remaining y RateLimit-Reset; pasado el límite la respuesta es 429 request.rate_limited con Retry-After.
Zapier
Un espacio de trabajo también puede enviar sus incidentes a Zapier: añade un canal de Zapier con la URL de tu Catch Hook y cada canal activo recibe el incidente como JSON. El cuerpo, los pasos de configuración y las garantías que comparten los canales están en la documentación de canales de notificación, en docs/architecture/notifications.md.
The key, its workspace, and the plan
GET /v1/meÁmbito: read
Says which key is calling, what it may do, the workspace it belongs to, the limits that apply to it, what it uses of them, and whether it is within them. A read key may be limited to a set of monitors; `monitorIds` says which, and empty means the whole workspace. Read-only: nothing about billing can be changed through a key.
Respuestas
200 — The answer.{ key: { id: string, scope: "read" | "write", monitorIds: string[] }, workspace: { id: string, name: string, defaultLocale: string, role: "owner" | "admin" | "member" | "viewer", createdAt: string, planId: string, escalationAfterSeconds: integer | null }, plan: { planId: "free" | "starter" | "pro" | "business" | "beta" }, limits: { monitors: integer, minIntervalSeconds: integer, members: integer, retentionDays: integer, apiKeys: integer, contacts: integer, maintenanceWindows: integer, regions: integer, statusPages: integer, webhooks: integer, manualChecksPerDay: integer }, usage: { monitors: integer, members: integer, contacts: integer, maintenanceWindows: integer, apiKeys: integer, shortestIntervalSeconds: integer | null }, compliance: { withinLimits: boolean, exceeded: { key: "monitors" | "minIntervalSeconds" | "members" | "retentionDays" | "apiKeys" | "contacts" | "maintenanceWindows" | "regions" | "statusPages" | "webhooks" | "manualChecksPerDay", used: integer, allowed: integer }[], featuresInUse: "monitor.http" | "monitor.tcp" | "monitor.dns" | "monitor.heartbeat" | "monitor.ping" | "monitor.udp" | "monitor.domain" | "ssl" | "api" | "statusPages" | "webhooks"[] } }
401 — One of: auth.unauthenticated.403 — One of: request.host_not_allowed.429 — One of: request.rate_limited.
Ejemplo
curl "https://api.nuvostatus.com/v1/me" \
-H "Authorization: Bearer $NUVOSTATUS_KEY"
The account: plan, limits and usage
GET /v1/accountÁmbito: read
The workspace, the plan it is on, its language, and where it stands against the plan’s limits: monitors used and allowed, seats used and allowed, and the shortest interval it may choose. The same figures the dashboard shows, counted by the same queries. The key that asked, with its name and scope, and nothing of another workspace.
Respuestas
200 — The answer.{ workspace: { id: string, name: string, slug: string }, plan: string, locale: string, createdAt: string, entitlements: { monitorLimit: integer, monitorsUsed: integer, seatLimit: integer, seatsUsed: integer, minimumIntervalSeconds: integer }, apiKey: { id: string, name: string, scopes: "read" | "write"[] } }
401 — One of: auth.unauthenticated.403 — One of: request.host_not_allowed.429 — One of: request.rate_limited.
Ejemplo
curl "https://api.nuvostatus.com/v1/account" \
-H "Authorization: Bearer $NUVOSTATUS_KEY"
Read the activity log
GET /v1/audit-logsÁmbito: read
What happened in the workspace, who did it, on what and when, newest first. Only an owner, an administrator or a read key may ask; a write key and a member are refused. The entry never carries the request’s address or a secret, and its metadata holds only what the change recorded on purpose.
Parámetros
limit — en la cadena de consulta, opcionalcursor — en la cadena de consulta, opcionalaction — en la cadena de consulta, opcionalactorId — en la cadena de consulta, opcionaltargetType — en la cadena de consulta, opcionaltargetId — en la cadena de consulta, opcionalfrom — en la cadena de consulta, opcionalto — en la cadena de consulta, opcional
Respuestas
200 — The answer.{ entries: { id: string, actorType: "user" | "api_key" | "system", actorId: string | null, actorName: string | null, action: string, targetType: string | null, targetId: string | null, metadata: {}, createdAt: string }[], nextCursor: string | null }
400 — One of: validation.failed.401 — One of: auth.unauthenticated.403 — One of: request.host_not_allowed, audit.read_forbidden.429 — One of: request.rate_limited.
Ejemplo
curl "https://api.nuvostatus.com/v1/audit-logs" \
-H "Authorization: Bearer $NUVOSTATUS_KEY"
Export the whole workspace as one document
GET /v1/workspace/exportÁmbito: read
The workspace’s configuration as one versioned JSON file: its name, monitors, groups, maintenance windows, channels and status pages. It carries the shape of every credential and never a value — an HTTP monitor’s headers, password, token and body are the mask, a channel has no destination, a protected page has no password — and each such entry says `secretsOmitted`. Ids are absent by design: an import remaps everything through names, targets and slugs. Send it back to `/v1/workspace/import`, in this workspace or another.
Respuestas
200 — The answer.{ formatVersion: 1, exportedAt: string, workspace: { name: string }, monitors: { name: string, type: "http" | "tcp" | "dns" | "heartbeat" | "ping" | "udp" | "domain", config: {}, intervalSeconds: integer, timeoutSeconds: integer, confirmationChecks: integer, confirmationSpanSeconds: integer, importance: "critical" | "standard", certificateAlertDays: integer, slaTargetBp: integer, slaBudgetAlertPercent: integer | null, slowResponseMs: integer | null, runbookUrl?: string | null, responseBaselinePercent?: integer | null, paused: boolean, groupName: string | null, channelNames: string[], secretsOmitted: boolean }[], groups: { name: string }[], maintenance: { name: string, startsAt: string, endsAt: string, recurrence: "none" | "daily" | "weekly" | "monthly", timeZone: string | null, monitorNames: string[], groupNames: string[] }[], channels: { kind: "webhook" | "slack" | "telegram" | "teams" | "discord" | "google_chat" | "mattermost" | "splunk" | "pagerduty" | "pushover" | "pushbullet" | "sms" | "voice" | "zapier", name: string, enabled: boolean, events: "opened" | "resolved" | "escalated"[], severityFloor: "all" | "critical", secretsOmitted: true }[], statusPages: { slug: string, title: string, description: string | null, accentColor: string | null, logoUrl: string | null, locale: "en" | "es" | "de" | "fr" | "pt", subscriberAlertBudget: integer, published: boolean, passwordProtected: boolean, services: … | …[], secretsOmitted: true }[] }
401 — One of: auth.unauthenticated.403 — One of: request.host_not_allowed, permission.denied.429 — One of: request.rate_limited.
Ejemplo
curl "https://api.nuvostatus.com/v1/workspace/export" \
-H "Authorization: Bearer $NUVOSTATUS_KEY"
Import a workspace document
POST /v1/workspace/importÁmbito: write
Creates what the document carries in this workspace: monitors, groups, maintenance windows, channels and status pages, with every id its own and every reference remapped by name. A channel arrives disabled without its destination; a monitor that needs a credential the file did not carry arrives paused; a page arrives unpublished, and under a fresh slug when its own is taken. Nothing already there — a monitor with the same name and target, a group, channel or page with the same name or slug, a window with the same name and start — is created twice. The plan is checked before anything is written: a document that would exceed it answers `workspace.import_limit_exceeded` and creates nothing. Send an `Idempotency-Key` to make a retry replay this answer.
Parámetros
Idempotency-Key — en la cadena de consulta, opcional
Cuerpo de la petición
{ formatVersion: 1, exportedAt: string, workspace: { name: string }, monitors: { name: string, type: "http" | "tcp" | "dns" | "heartbeat" | "ping" | "udp" | "domain", config: {}, intervalSeconds: integer, timeoutSeconds: integer, confirmationChecks: integer, confirmationSpanSeconds: integer, importance: "critical" | "standard", certificateAlertDays: integer, slaTargetBp: integer, slaBudgetAlertPercent: integer | null, slowResponseMs: integer | null, runbookUrl?: string | null, responseBaselinePercent?: integer | null, paused: boolean, groupName: string | null, channelNames: string[], secretsOmitted: boolean }[], groups: { name: string }[], maintenance: { name: string, startsAt: string, endsAt: string, recurrence: "none" | "daily" | "weekly" | "monthly", timeZone: string | null, monitorNames: string[], groupNames: string[] }[], channels: { kind: "webhook" | "slack" | "telegram" | "teams" | "discord" | "google_chat" | "mattermost" | "splunk" | "pagerduty" | "pushover" | "pushbullet" | "sms" | "voice" | "zapier", name: string, enabled: boolean, events: "opened" | "resolved" | "escalated"[], severityFloor: "all" | "critical", secretsOmitted: true }[], statusPages: { slug: string, title: string, description: string | null, accentColor: string | null, logoUrl: string | null, locale: "en" | "es" | "de" | "fr" | "pt", subscriberAlertBudget: integer, published: boolean, passwordProtected: boolean, services: … | …[], secretsOmitted: true }[] }
Respuestas
201 — The answer.{ created: { monitors: integer, groups: integer, maintenance: integer, channels: integer, statusPages: integer }, ids: { monitors: string[], groups: string[], maintenance: string[], channels: string[], statusPages: string[] }, skipped: { kind: "monitor" | "group" | "maintenance" | "channel" | "status_page", name: string, reason: "already_present" | "invalid" | "unknown_reference" }[], unconfigured: { monitors: string[], channels: string[], statusPages: string[] } }
400 — One of: validation.failed, workspace.import_limit_exceeded.401 — One of: auth.unauthenticated.403 — One of: request.host_not_allowed, permission.denied.409 — One of: idempotency.conflict, idempotency.in_progress.429 — One of: request.rate_limited.
Ejemplo
curl -X POST "https://api.nuvostatus.com/v1/workspace/import" \
-H "Authorization: Bearer $NUVOSTATUS_KEY" \
-H "Content-Type: application/json" \
-d '{"formatVersion":1,"exportedAt":"2026-11-13T10:00:00.000Z","workspace":{"name":"Acme"},"monitors":[{"name":"Shop","type":"tcp","config":{"host":"shop.example.com","port":443},"intervalSeconds":300,"timeoutSeconds":10,"confirmationChecks":3,"confirmationSpanSeconds":60,"importance":"standard","certificateAlertDays":30,"slaTargetBp":9990,"slaBudgetAlertPercent":null,"slowResponseMs":null,"responseBaselinePercent":null,"paused":false,"groupName":"Storefront","channelNames":[],"secretsOmitted":false}],"groups":[{"name":"Storefront"}],"maintenance":[],"channels":[],"statusPages":[]}'
List the members
GET /v1/membersÁmbito: read
The people in the workspace, with the role each holds and since when. Never a session, a credential or a token. A read key sees them as a viewer sees them.
Respuestas
200 — The answer.{ items: { id: string, email: string, role: "owner" | "admin" | "member" | "viewer", joinedAt: string }[], next: string | null }
401 — One of: auth.unauthenticated.403 — One of: request.host_not_allowed, permission.denied.429 — One of: request.rate_limited.
Ejemplo
curl "https://api.nuvostatus.com/v1/members" \
-H "Authorization: Bearer $NUVOSTATUS_KEY"
Invite somebody to the workspace
POST /v1/members/invitationsÁmbito: write
Invites one address with one role. A write key acts as an administrator over people, never as an owner: it may invite members and viewers only. The invitation is sent by email; its token is in the link and never in an answer.
Cuerpo de la petición
{ email: string, role: "owner" | "admin" | "member" | "viewer" }
Respuestas
201 — The answer.{ invitation: { id: string, email: string, role: "owner" | "admin" | "member" | "viewer", invitedBy: string | null, expiresAt: string, createdAt: string } }
400 — One of: validation.failed.401 — One of: auth.unauthenticated.403 — One of: request.host_not_allowed, permission.denied, member.role_not_assignable.409 — One of: member.limit_reached, invitation.already_member, invitation.limit_reached.429 — One of: request.rate_limited.
Ejemplo
curl -X POST "https://api.nuvostatus.com/v1/members/invitations" \
-H "Authorization: Bearer $NUVOSTATUS_KEY" \
-H "Content-Type: application/json" \
-d '{"email":"person@example.com","role":"member"}'
List the open invitations
GET /v1/members/invitationsÁmbito: write
The invitations that have been sent and not yet accepted, oldest first. Their tokens are not part of any answer.
Respuestas
200 — The answer.{ items: { id: string, email: string, role: "owner" | "admin" | "member" | "viewer", invitedBy: string | null, expiresAt: string, createdAt: string }[], next: string | null }
401 — One of: auth.unauthenticated.403 — One of: request.host_not_allowed, permission.denied.429 — One of: request.rate_limited.
Ejemplo
curl "https://api.nuvostatus.com/v1/members/invitations" \
-H "Authorization: Bearer $NUVOSTATUS_KEY"
Withdraw an invitation
DELETE /v1/members/invitations/{id}Ámbito: write
Revokes an invitation that has not been accepted; its link stops working.
Parámetros
id — en la ruta, obligatorio
Respuestas
204 — Done; no body.401 — One of: auth.unauthenticated.403 — One of: request.host_not_allowed, permission.denied.404 — One of: invitation.not_found.429 — One of: request.rate_limited.
Ejemplo
curl -X DELETE "https://api.nuvostatus.com/v1/members/invitations/0199e6a0-0000-7000-8000-000000000001" \
-H "Authorization: Bearer $NUVOSTATUS_KEY"
Change a member's role
PATCH /v1/members/{id}Ámbito: write
Gives a member another role. A write key acts as an administrator over people: it may change members and viewers, never an owner or another administrator.
Parámetros
id — en la ruta, obligatorio
Cuerpo de la petición
{ role: "owner" | "admin" | "member" | "viewer" }
Respuestas
204 — Done; no body.400 — One of: validation.failed.401 — One of: auth.unauthenticated.403 — One of: request.host_not_allowed, permission.denied, member.role_not_assignable.404 — One of: member.not_found.409 — One of: member.last_owner.429 — One of: request.rate_limited.
Ejemplo
curl -X PATCH "https://api.nuvostatus.com/v1/members/0199e6a0-0000-7000-8000-000000000001" \
-H "Authorization: Bearer $NUVOSTATUS_KEY" \
-H "Content-Type: application/json" \
-d '{"role":"member"}'
Remove a member
DELETE /v1/members/{id}Ámbito: write
Removes a member from the workspace. The last owner stays; an owner or another administrator is out of a write key’s reach.
Parámetros
id — en la ruta, obligatorio
Respuestas
204 — Done; no body.401 — One of: auth.unauthenticated.403 — One of: request.host_not_allowed, permission.denied, member.role_not_assignable.404 — One of: member.not_found.409 — One of: member.last_owner.429 — One of: request.rate_limited.
Ejemplo
curl -X DELETE "https://api.nuvostatus.com/v1/members/0199e6a0-0000-7000-8000-000000000001" \
-H "Authorization: Bearer $NUVOSTATUS_KEY"
List the monitors
GET /v1/monitorsÁmbito: read
A page of the monitors the key may read, with its state and the limits of the workspace. Search by name or address, keep one group, label or state, order by name, creation or latest median response time, and ask for the next page with `cursor`. A read key limited to some monitors lists exactly those; another monitor of the workspace answers as one that does not exist.
Parámetros
q — en la cadena de consulta, opcionalgroupId — en la cadena de consulta, opcionaltagId — en la cadena de consulta, opcionalstatus — en la cadena de consulta, opcionalsort — en la cadena de consulta, opcionaldirection — en la cadena de consulta, opcionallimit — en la cadena de consulta, opcionalcursor — en la cadena de consulta, opcional
Respuestas
200 — The answer.{ items: { type: "http", config: { url: …, method: …, followRedirects: …, expectedStatus: …, keyword: …, keywordMustAppear: …, conditions: …, conditionMode: …, headers: …, auth: …, body: … }, id: string, name: string, target: string, intervalSeconds: integer, timeoutSeconds: integer, paused: boolean, pausedUntil: string | null, status: "pending" | "passing" | "failing" | "down" | "paused" | "unknown", statusSince: string | null, pendingReason: { code: …, missingCapability: … }, lastCheck: { at: …, class: …, error: …, statusCode: …, responseMs: … }, certificate: { notBefore: …, notAfter: …, issuer: …, subject: …, sans: …, seenAt: …, daysLeft: …, state: … }, maintenance: { id: …, name: …, endsAt: … }, incident: { id: …, startedAt: …, confirmedAt: …, recovering: …, flapping: … }, notifications: { alertMembers: …, contactIds: …, quietUntil: …, quietForever: … }, groupId: string | null, groupName: string | null, groupState: "operational" | "degraded" | "down" | "maintenance" | "unknown", tags: …[], nextCheckAt: string | null, heartbeat: { lastPingAt: …, dueAt: … }, createdAt: string, updatedAt: string } | { type: "tcp", config: { host: …, port: … }, id: string, name: string, target: string, intervalSeconds: integer, timeoutSeconds: integer, paused: boolean, pausedUntil: string | null, status: "pending" | "passing" | "failing" | "down" | "paused" | "unknown", statusSince: string | null, pendingReason: { code: …, missingCapability: … }, lastCheck: { at: …, class: …, error: …, statusCode: …, responseMs: … }, certificate: { notBefore: …, notAfter: …, issuer: …, subject: …, sans: …, seenAt: …, daysLeft: …, state: … }, maintenance: { id: …, name: …, endsAt: … }, incident: { id: …, startedAt: …, confirmedAt: …, recovering: …, flapping: … }, notifications: { alertMembers: …, contactIds: …, quietUntil: …, quietForever: … }, groupId: string | null, groupName: string | null, groupState: "operational" | "degraded" | "down" | "maintenance" | "unknown", tags: …[], nextCheckAt: string | null, heartbeat: { lastPingAt: …, dueAt: … }, createdAt: string, updatedAt: string } | { type: "dns", config: { name: …, recordType: …, expected: …, resolver: … }, id: string, name: string, target: string, intervalSeconds: integer, timeoutSeconds: integer, paused: boolean, pausedUntil: string | null, status: "pending" | "passing" | "failing" | "down" | "paused" | "unknown", statusSince: string | null, pendingReason: { code: …, missingCapability: … }, lastCheck: { at: …, class: …, error: …, statusCode: …, responseMs: … }, certificate: { notBefore: …, notAfter: …, issuer: …, subject: …, sans: …, seenAt: …, daysLeft: …, state: … }, maintenance: { id: …, name: …, endsAt: … }, incident: { id: …, startedAt: …, confirmedAt: …, recovering: …, flapping: … }, notifications: { alertMembers: …, contactIds: …, quietUntil: …, quietForever: … }, groupId: string | null, groupName: string | null, groupState: "operational" | "degraded" | "down" | "maintenance" | "unknown", tags: …[], nextCheckAt: string | null, heartbeat: { lastPingAt: …, dueAt: … }, createdAt: string, updatedAt: string } | { type: "heartbeat", config: { periodSeconds: …, graceSeconds: … }, id: string, name: string, target: string, intervalSeconds: integer, timeoutSeconds: integer, paused: boolean, pausedUntil: string | null, status: "pending" | "passing" | "failing" | "down" | "paused" | "unknown", statusSince: string | null, pendingReason: { code: …, missingCapability: … }, lastCheck: { at: …, class: …, error: …, statusCode: …, responseMs: … }, certificate: { notBefore: …, notAfter: …, issuer: …, subject: …, sans: …, seenAt: …, daysLeft: …, state: … }, maintenance: { id: …, name: …, endsAt: … }, incident: { id: …, startedAt: …, confirmedAt: …, recovering: …, flapping: … }, notifications: { alertMembers: …, contactIds: …, quietUntil: …, quietForever: … }, groupId: string | null, groupName: string | null, groupState: "operational" | "degraded" | "down" | "maintenance" | "unknown", tags: …[], nextCheckAt: string | null, heartbeat: { lastPingAt: …, dueAt: … }, createdAt: string, updatedAt: string } | { type: "ping", config: { host: … }, id: string, name: string, target: string, intervalSeconds: integer, timeoutSeconds: integer, paused: boolean, pausedUntil: string | null, status: "pending" | "passing" | "failing" | "down" | "paused" | "unknown", statusSince: string | null, pendingReason: { code: …, missingCapability: … }, lastCheck: { at: …, class: …, error: …, statusCode: …, responseMs: … }, certificate: { notBefore: …, notAfter: …, issuer: …, subject: …, sans: …, seenAt: …, daysLeft: …, state: … }, maintenance: { id: …, name: …, endsAt: … }, incident: { id: …, startedAt: …, confirmedAt: …, recovering: …, flapping: … }, notifications: { alertMembers: …, contactIds: …, quietUntil: …, quietForever: … }, groupId: string | null, groupName: string | null, groupState: "operational" | "degraded" | "down" | "maintenance" | "unknown", tags: …[], nextCheckAt: string | null, heartbeat: { lastPingAt: …, dueAt: … }, createdAt: string, updatedAt: string } | { type: "udp", config: { host: …, port: … }, id: string, name: string, target: string, intervalSeconds: integer, timeoutSeconds: integer, paused: boolean, pausedUntil: string | null, status: "pending" | "passing" | "failing" | "down" | "paused" | "unknown", statusSince: string | null, pendingReason: { code: …, missingCapability: … }, lastCheck: { at: …, class: …, error: …, statusCode: …, responseMs: … }, certificate: { notBefore: …, notAfter: …, issuer: …, subject: …, sans: …, seenAt: …, daysLeft: …, state: … }, maintenance: { id: …, name: …, endsAt: … }, incident: { id: …, startedAt: …, confirmedAt: …, recovering: …, flapping: … }, notifications: { alertMembers: …, contactIds: …, quietUntil: …, quietForever: … }, groupId: string | null, groupName: string | null, groupState: "operational" | "degraded" | "down" | "maintenance" | "unknown", tags: …[], nextCheckAt: string | null, heartbeat: { lastPingAt: …, dueAt: … }, createdAt: string, updatedAt: string } | { type: "domain", config: { domain: … }, id: string, name: string, target: string, intervalSeconds: integer, timeoutSeconds: integer, paused: boolean, pausedUntil: string | null, status: "pending" | "passing" | "failing" | "down" | "paused" | "unknown", statusSince: string | null, pendingReason: { code: …, missingCapability: … }, lastCheck: { at: …, class: …, error: …, statusCode: …, responseMs: … }, certificate: { notBefore: …, notAfter: …, issuer: …, subject: …, sans: …, seenAt: …, daysLeft: …, state: … }, maintenance: { id: …, name: …, endsAt: … }, incident: { id: …, startedAt: …, confirmedAt: …, recovering: …, flapping: … }, notifications: { alertMembers: …, contactIds: …, quietUntil: …, quietForever: … }, groupId: string | null, groupName: string | null, groupState: "operational" | "degraded" | "down" | "maintenance" | "unknown", tags: …[], nextCheckAt: string | null, heartbeat: { lastPingAt: …, dueAt: … }, createdAt: string, updatedAt: string }[], next: string | null, total: integer, limits: { maxMonitors: integer, usedMonitors: integer, intervals: 30 | 60 | 120 | 180 | 300 | 600 | 900 | 1800 | 3600[] } }
400 — One of: validation.failed, monitor.invalid_cursor.401 — One of: auth.unauthenticated.403 — One of: request.host_not_allowed.429 — One of: request.rate_limited.
Ejemplo
curl "https://api.nuvostatus.com/v1/monitors" \
-H "Authorization: Bearer $NUVOSTATUS_KEY"
Create a monitor
POST /v1/monitorsÁmbito: write
A monitor of one of the kinds. A heartbeat answers with the address its job must call, shown here and never again. Send an `Idempotency-Key` to make a retry replay this answer instead of creating a second monitor.
Parámetros
Idempotency-Key — en la cadena de consulta, opcional
Cuerpo de la petición
{ type: "http", name: string, channelIds?: string[], dependsOn?: string[], intervalSeconds?: 30 | 60 | 120 | 180 | 300 | 600 | 900 | 1800 | 3600, confirmationChecks?: integer, confirmationSpanSeconds?: integer, timeoutSeconds?: integer, importance?: "critical" | "standard", certificateThresholds?: { warningDays: integer, criticalDays: integer }, certificateAlertDays?: integer, slaTargetBp?: integer, slaBudgetAlertPercent?: integer | null, slowResponseMs?: integer | null, baselinePercent?: integer | null, runbookUrl?: string | null, config: { url: string, method?: "GET" | "HEAD" | "POST" | "PUT" | "PATCH" | "DELETE", followRedirects?: boolean, expectedStatus?: string[], keyword?: string | null, keywordMustAppear?: boolean, conditions?: … | … | … | … | … | …[], conditionMode?: "all" | "any", headers?: { name: …, value: … }[], auth?: { type: … } | { type: …, username: …, password: … } | { type: …, token: … } | { type: …, value: … }, body?: { contentType: string, value: string } } } | { type: "tcp", name: string, channelIds?: string[], dependsOn?: string[], intervalSeconds?: 30 | 60 | 120 | 180 | 300 | 600 | 900 | 1800 | 3600, confirmationChecks?: integer, confirmationSpanSeconds?: integer, timeoutSeconds?: integer, importance?: "critical" | "standard", certificateThresholds?: { warningDays: integer, criticalDays: integer }, certificateAlertDays?: integer, slaTargetBp?: integer, slaBudgetAlertPercent?: integer | null, slowResponseMs?: integer | null, baselinePercent?: integer | null, runbookUrl?: string | null, config: { host: string, port: integer } } | { type: "dns", name: string, channelIds?: string[], dependsOn?: string[], intervalSeconds?: 30 | 60 | 120 | 180 | 300 | 600 | 900 | 1800 | 3600, confirmationChecks?: integer, confirmationSpanSeconds?: integer, timeoutSeconds?: integer, importance?: "critical" | "standard", certificateThresholds?: { warningDays: integer, criticalDays: integer }, certificateAlertDays?: integer, slaTargetBp?: integer, slaBudgetAlertPercent?: integer | null, slowResponseMs?: integer | null, baselinePercent?: integer | null, runbookUrl?: string | null, config: { name: string, recordType: "A" | "AAAA" | "CNAME" | "MX" | "TXT" | "NS", expected?: string[], resolver?: "system" | "cloudflare" | "google" | "quad9" | "opendns" } } | { type: "heartbeat", name: string, channelIds?: string[], dependsOn?: string[], importance?: "critical" | "standard", confirmationChecks?: integer, confirmationSpanSeconds?: integer, slowResponseMs?: integer | null, baselinePercent?: integer | null, runbookUrl?: string | null, config: { periodSeconds: 60 | 120 | 300 | 600 | 900 | 1800 | 3600 | 7200 | 21600 | 43200 | 86400 | 604800 | 2592000, graceSeconds: integer } } | { type: "ping", name: string, channelIds?: string[], dependsOn?: string[], intervalSeconds?: 30 | 60 | 120 | 180 | 300 | 600 | 900 | 1800 | 3600, confirmationChecks?: integer, confirmationSpanSeconds?: integer, timeoutSeconds?: integer, importance?: "critical" | "standard", certificateThresholds?: { warningDays: integer, criticalDays: integer }, certificateAlertDays?: integer, slaTargetBp?: integer, slaBudgetAlertPercent?: integer | null, slowResponseMs?: integer | null, baselinePercent?: integer | null, runbookUrl?: string | null, config: { host: string } } | { type: "udp", name: string, channelIds?: string[], dependsOn?: string[], intervalSeconds?: 30 | 60 | 120 | 180 | 300 | 600 | 900 | 1800 | 3600, confirmationChecks?: integer, confirmationSpanSeconds?: integer, timeoutSeconds?: integer, importance?: "critical" | "standard", certificateThresholds?: { warningDays: integer, criticalDays: integer }, certificateAlertDays?: integer, slaTargetBp?: integer, slaBudgetAlertPercent?: integer | null, slowResponseMs?: integer | null, baselinePercent?: integer | null, runbookUrl?: string | null, config: { host: string, port: integer } } | { type: "domain", name: string, channelIds?: string[], dependsOn?: string[], intervalSeconds?: 30 | 60 | 120 | 180 | 300 | 600 | 900 | 1800 | 3600, confirmationChecks?: integer, confirmationSpanSeconds?: integer, timeoutSeconds?: integer, importance?: "critical" | "standard", certificateThresholds?: { warningDays: integer, criticalDays: integer }, certificateAlertDays?: integer, slaTargetBp?: integer, slaBudgetAlertPercent?: integer | null, slowResponseMs?: integer | null, baselinePercent?: integer | null, runbookUrl?: string | null, config: { domain: string } }
Respuestas
201 — The answer.{ monitor: { type: "http", config: { url: string, method: "GET" | "HEAD" | "POST" | "PUT" | "PATCH" | "DELETE", followRedirects: boolean, expectedStatus: …[], keyword: string | null, keywordMustAppear: boolean, conditions: …[], conditionMode: "all" | "any", headers: …[], auth: … | … | …, body: { contentType: …, value: … } }, id: string, name: string, target: string, intervalSeconds: integer, timeoutSeconds: integer, paused: boolean, pausedUntil: string | null, status: "pending" | "passing" | "failing" | "down" | "paused" | "unknown", statusSince: string | null, pendingReason: { code: "no_probe_capability", missingCapability: "http" | "tcp" | "dns" | "http_secrets" | "icmp" | "udp" | "domain" | "ipv6" }, lastCheck: { at: string, class: "ok" | "fail", error: "dns_not_found" | "dns_failure" | "dns_timeout" | "connection_refused" | "connection_timeout" | "connection_reset" | "network_unreachable" | "tls_certificate_expired" | "tls_certificate_invalid" | "tls_hostname_mismatch" | "tls_handshake_failed" | "timeout" | "unexpected_status" | "too_many_redirects" | "invalid_redirect" | "destination_not_allowed" | "response_headers_too_large" | "protocol_error" | "keyword_not_found" | "keyword_found" | "json_invalid" | "json_path_missing" | "json_value_mismatch" | "json_too_large" | "header_missing" | "header_mismatch" | "final_url_mismatch" | "dns_no_records" | "dns_unexpected_answer" | "heartbeat_missed" | "no_reply" | "domain_expiring" | "domain_expired" | "lease_expired" | "rate_limited" | "expired" | "probe_overloaded" | "secret_unavailable" | "icmp_unavailable" | "domain_expiry_unknown" | "probe_no_ipv6" | "own_destination" | "self_check_failed", statusCode: integer | null, responseMs: integer | null }, certificate: { notBefore: string, notAfter: string, issuer: string, subject: string, sans: integer, seenAt: string, daysLeft: integer, state: "ok" | "attention" | "critical" | "expired" | "invalid" }, maintenance: { id: string, name: string, endsAt: string }, incident: { id: string, startedAt: string, confirmedAt: string, recovering: boolean, flapping: boolean }, notifications: { alertMembers: boolean, contactIds: …[], quietUntil: string | null, quietForever: boolean }, groupId: string | null, groupName: string | null, groupState: "operational" | "degraded" | "down" | "maintenance" | "unknown", tags: { id: …, name: … }[], nextCheckAt: string | null, heartbeat: { lastPingAt: string | null, dueAt: string | null }, createdAt: string, updatedAt: string } | { type: "tcp", config: { host: string, port: integer }, id: string, name: string, target: string, intervalSeconds: integer, timeoutSeconds: integer, paused: boolean, pausedUntil: string | null, status: "pending" | "passing" | "failing" | "down" | "paused" | "unknown", statusSince: string | null, pendingReason: { code: "no_probe_capability", missingCapability: "http" | "tcp" | "dns" | "http_secrets" | "icmp" | "udp" | "domain" | "ipv6" }, lastCheck: { at: string, class: "ok" | "fail", error: "dns_not_found" | "dns_failure" | "dns_timeout" | "connection_refused" | "connection_timeout" | "connection_reset" | "network_unreachable" | "tls_certificate_expired" | "tls_certificate_invalid" | "tls_hostname_mismatch" | "tls_handshake_failed" | "timeout" | "unexpected_status" | "too_many_redirects" | "invalid_redirect" | "destination_not_allowed" | "response_headers_too_large" | "protocol_error" | "keyword_not_found" | "keyword_found" | "json_invalid" | "json_path_missing" | "json_value_mismatch" | "json_too_large" | "header_missing" | "header_mismatch" | "final_url_mismatch" | "dns_no_records" | "dns_unexpected_answer" | "heartbeat_missed" | "no_reply" | "domain_expiring" | "domain_expired" | "lease_expired" | "rate_limited" | "expired" | "probe_overloaded" | "secret_unavailable" | "icmp_unavailable" | "domain_expiry_unknown" | "probe_no_ipv6" | "own_destination" | "self_check_failed", statusCode: integer | null, responseMs: integer | null }, certificate: { notBefore: string, notAfter: string, issuer: string, subject: string, sans: integer, seenAt: string, daysLeft: integer, state: "ok" | "attention" | "critical" | "expired" | "invalid" }, maintenance: { id: string, name: string, endsAt: string }, incident: { id: string, startedAt: string, confirmedAt: string, recovering: boolean, flapping: boolean }, notifications: { alertMembers: boolean, contactIds: …[], quietUntil: string | null, quietForever: boolean }, groupId: string | null, groupName: string | null, groupState: "operational" | "degraded" | "down" | "maintenance" | "unknown", tags: { id: …, name: … }[], nextCheckAt: string | null, heartbeat: { lastPingAt: string | null, dueAt: string | null }, createdAt: string, updatedAt: string } | { type: "dns", config: { name: string, recordType: "A" | "AAAA" | "CNAME" | "MX" | "TXT" | "NS", expected: …[], resolver: "system" | "cloudflare" | "google" | "quad9" | "opendns" }, id: string, name: string, target: string, intervalSeconds: integer, timeoutSeconds: integer, paused: boolean, pausedUntil: string | null, status: "pending" | "passing" | "failing" | "down" | "paused" | "unknown", statusSince: string | null, pendingReason: { code: "no_probe_capability", missingCapability: "http" | "tcp" | "dns" | "http_secrets" | "icmp" | "udp" | "domain" | "ipv6" }, lastCheck: { at: string, class: "ok" | "fail", error: "dns_not_found" | "dns_failure" | "dns_timeout" | "connection_refused" | "connection_timeout" | "connection_reset" | "network_unreachable" | "tls_certificate_expired" | "tls_certificate_invalid" | "tls_hostname_mismatch" | "tls_handshake_failed" | "timeout" | "unexpected_status" | "too_many_redirects" | "invalid_redirect" | "destination_not_allowed" | "response_headers_too_large" | "protocol_error" | "keyword_not_found" | "keyword_found" | "json_invalid" | "json_path_missing" | "json_value_mismatch" | "json_too_large" | "header_missing" | "header_mismatch" | "final_url_mismatch" | "dns_no_records" | "dns_unexpected_answer" | "heartbeat_missed" | "no_reply" | "domain_expiring" | "domain_expired" | "lease_expired" | "rate_limited" | "expired" | "probe_overloaded" | "secret_unavailable" | "icmp_unavailable" | "domain_expiry_unknown" | "probe_no_ipv6" | "own_destination" | "self_check_failed", statusCode: integer | null, responseMs: integer | null }, certificate: { notBefore: string, notAfter: string, issuer: string, subject: string, sans: integer, seenAt: string, daysLeft: integer, state: "ok" | "attention" | "critical" | "expired" | "invalid" }, maintenance: { id: string, name: string, endsAt: string }, incident: { id: string, startedAt: string, confirmedAt: string, recovering: boolean, flapping: boolean }, notifications: { alertMembers: boolean, contactIds: …[], quietUntil: string | null, quietForever: boolean }, groupId: string | null, groupName: string | null, groupState: "operational" | "degraded" | "down" | "maintenance" | "unknown", tags: { id: …, name: … }[], nextCheckAt: string | null, heartbeat: { lastPingAt: string | null, dueAt: string | null }, createdAt: string, updatedAt: string } | { type: "heartbeat", config: { periodSeconds: 60 | 120 | 300 | 600 | 900 | 1800 | 3600 | 7200 | 21600 | 43200 | 86400 | 604800 | 2592000, graceSeconds: integer }, id: string, name: string, target: string, intervalSeconds: integer, timeoutSeconds: integer, paused: boolean, pausedUntil: string | null, status: "pending" | "passing" | "failing" | "down" | "paused" | "unknown", statusSince: string | null, pendingReason: { code: "no_probe_capability", missingCapability: "http" | "tcp" | "dns" | "http_secrets" | "icmp" | "udp" | "domain" | "ipv6" }, lastCheck: { at: string, class: "ok" | "fail", error: "dns_not_found" | "dns_failure" | "dns_timeout" | "connection_refused" | "connection_timeout" | "connection_reset" | "network_unreachable" | "tls_certificate_expired" | "tls_certificate_invalid" | "tls_hostname_mismatch" | "tls_handshake_failed" | "timeout" | "unexpected_status" | "too_many_redirects" | "invalid_redirect" | "destination_not_allowed" | "response_headers_too_large" | "protocol_error" | "keyword_not_found" | "keyword_found" | "json_invalid" | "json_path_missing" | "json_value_mismatch" | "json_too_large" | "header_missing" | "header_mismatch" | "final_url_mismatch" | "dns_no_records" | "dns_unexpected_answer" | "heartbeat_missed" | "no_reply" | "domain_expiring" | "domain_expired" | "lease_expired" | "rate_limited" | "expired" | "probe_overloaded" | "secret_unavailable" | "icmp_unavailable" | "domain_expiry_unknown" | "probe_no_ipv6" | "own_destination" | "self_check_failed", statusCode: integer | null, responseMs: integer | null }, certificate: { notBefore: string, notAfter: string, issuer: string, subject: string, sans: integer, seenAt: string, daysLeft: integer, state: "ok" | "attention" | "critical" | "expired" | "invalid" }, maintenance: { id: string, name: string, endsAt: string }, incident: { id: string, startedAt: string, confirmedAt: string, recovering: boolean, flapping: boolean }, notifications: { alertMembers: boolean, contactIds: …[], quietUntil: string | null, quietForever: boolean }, groupId: string | null, groupName: string | null, groupState: "operational" | "degraded" | "down" | "maintenance" | "unknown", tags: { id: …, name: … }[], nextCheckAt: string | null, heartbeat: { lastPingAt: string | null, dueAt: string | null }, createdAt: string, updatedAt: string } | { type: "ping", config: { host: string }, id: string, name: string, target: string, intervalSeconds: integer, timeoutSeconds: integer, paused: boolean, pausedUntil: string | null, status: "pending" | "passing" | "failing" | "down" | "paused" | "unknown", statusSince: string | null, pendingReason: { code: "no_probe_capability", missingCapability: "http" | "tcp" | "dns" | "http_secrets" | "icmp" | "udp" | "domain" | "ipv6" }, lastCheck: { at: string, class: "ok" | "fail", error: "dns_not_found" | "dns_failure" | "dns_timeout" | "connection_refused" | "connection_timeout" | "connection_reset" | "network_unreachable" | "tls_certificate_expired" | "tls_certificate_invalid" | "tls_hostname_mismatch" | "tls_handshake_failed" | "timeout" | "unexpected_status" | "too_many_redirects" | "invalid_redirect" | "destination_not_allowed" | "response_headers_too_large" | "protocol_error" | "keyword_not_found" | "keyword_found" | "json_invalid" | "json_path_missing" | "json_value_mismatch" | "json_too_large" | "header_missing" | "header_mismatch" | "final_url_mismatch" | "dns_no_records" | "dns_unexpected_answer" | "heartbeat_missed" | "no_reply" | "domain_expiring" | "domain_expired" | "lease_expired" | "rate_limited" | "expired" | "probe_overloaded" | "secret_unavailable" | "icmp_unavailable" | "domain_expiry_unknown" | "probe_no_ipv6" | "own_destination" | "self_check_failed", statusCode: integer | null, responseMs: integer | null }, certificate: { notBefore: string, notAfter: string, issuer: string, subject: string, sans: integer, seenAt: string, daysLeft: integer, state: "ok" | "attention" | "critical" | "expired" | "invalid" }, maintenance: { id: string, name: string, endsAt: string }, incident: { id: string, startedAt: string, confirmedAt: string, recovering: boolean, flapping: boolean }, notifications: { alertMembers: boolean, contactIds: …[], quietUntil: string | null, quietForever: boolean }, groupId: string | null, groupName: string | null, groupState: "operational" | "degraded" | "down" | "maintenance" | "unknown", tags: { id: …, name: … }[], nextCheckAt: string | null, heartbeat: { lastPingAt: string | null, dueAt: string | null }, createdAt: string, updatedAt: string } | { type: "udp", config: { host: string, port: integer }, id: string, name: string, target: string, intervalSeconds: integer, timeoutSeconds: integer, paused: boolean, pausedUntil: string | null, status: "pending" | "passing" | "failing" | "down" | "paused" | "unknown", statusSince: string | null, pendingReason: { code: "no_probe_capability", missingCapability: "http" | "tcp" | "dns" | "http_secrets" | "icmp" | "udp" | "domain" | "ipv6" }, lastCheck: { at: string, class: "ok" | "fail", error: "dns_not_found" | "dns_failure" | "dns_timeout" | "connection_refused" | "connection_timeout" | "connection_reset" | "network_unreachable" | "tls_certificate_expired" | "tls_certificate_invalid" | "tls_hostname_mismatch" | "tls_handshake_failed" | "timeout" | "unexpected_status" | "too_many_redirects" | "invalid_redirect" | "destination_not_allowed" | "response_headers_too_large" | "protocol_error" | "keyword_not_found" | "keyword_found" | "json_invalid" | "json_path_missing" | "json_value_mismatch" | "json_too_large" | "header_missing" | "header_mismatch" | "final_url_mismatch" | "dns_no_records" | "dns_unexpected_answer" | "heartbeat_missed" | "no_reply" | "domain_expiring" | "domain_expired" | "lease_expired" | "rate_limited" | "expired" | "probe_overloaded" | "secret_unavailable" | "icmp_unavailable" | "domain_expiry_unknown" | "probe_no_ipv6" | "own_destination" | "self_check_failed", statusCode: integer | null, responseMs: integer | null }, certificate: { notBefore: string, notAfter: string, issuer: string, subject: string, sans: integer, seenAt: string, daysLeft: integer, state: "ok" | "attention" | "critical" | "expired" | "invalid" }, maintenance: { id: string, name: string, endsAt: string }, incident: { id: string, startedAt: string, confirmedAt: string, recovering: boolean, flapping: boolean }, notifications: { alertMembers: boolean, contactIds: …[], quietUntil: string | null, quietForever: boolean }, groupId: string | null, groupName: string | null, groupState: "operational" | "degraded" | "down" | "maintenance" | "unknown", tags: { id: …, name: … }[], nextCheckAt: string | null, heartbeat: { lastPingAt: string | null, dueAt: string | null }, createdAt: string, updatedAt: string } | { type: "domain", config: { domain: string }, id: string, name: string, target: string, intervalSeconds: integer, timeoutSeconds: integer, paused: boolean, pausedUntil: string | null, status: "pending" | "passing" | "failing" | "down" | "paused" | "unknown", statusSince: string | null, pendingReason: { code: "no_probe_capability", missingCapability: "http" | "tcp" | "dns" | "http_secrets" | "icmp" | "udp" | "domain" | "ipv6" }, lastCheck: { at: string, class: "ok" | "fail", error: "dns_not_found" | "dns_failure" | "dns_timeout" | "connection_refused" | "connection_timeout" | "connection_reset" | "network_unreachable" | "tls_certificate_expired" | "tls_certificate_invalid" | "tls_hostname_mismatch" | "tls_handshake_failed" | "timeout" | "unexpected_status" | "too_many_redirects" | "invalid_redirect" | "destination_not_allowed" | "response_headers_too_large" | "protocol_error" | "keyword_not_found" | "keyword_found" | "json_invalid" | "json_path_missing" | "json_value_mismatch" | "json_too_large" | "header_missing" | "header_mismatch" | "final_url_mismatch" | "dns_no_records" | "dns_unexpected_answer" | "heartbeat_missed" | "no_reply" | "domain_expiring" | "domain_expired" | "lease_expired" | "rate_limited" | "expired" | "probe_overloaded" | "secret_unavailable" | "icmp_unavailable" | "domain_expiry_unknown" | "probe_no_ipv6" | "own_destination" | "self_check_failed", statusCode: integer | null, responseMs: integer | null }, certificate: { notBefore: string, notAfter: string, issuer: string, subject: string, sans: integer, seenAt: string, daysLeft: integer, state: "ok" | "attention" | "critical" | "expired" | "invalid" }, maintenance: { id: string, name: string, endsAt: string }, incident: { id: string, startedAt: string, confirmedAt: string, recovering: boolean, flapping: boolean }, notifications: { alertMembers: boolean, contactIds: …[], quietUntil: string | null, quietForever: boolean }, groupId: string | null, groupName: string | null, groupState: "operational" | "degraded" | "down" | "maintenance" | "unknown", tags: { id: …, name: … }[], nextCheckAt: string | null, heartbeat: { lastPingAt: string | null, dueAt: string | null }, createdAt: string, updatedAt: string }, heartbeatUrl?: string }
400 — One of: validation.failed, monitor.url_not_allowed, monitor.host_not_allowed, monitor.domain_invalid, monitor.keyword_needs_body, monitor.conditions_need_body, monitor.json_condition_needs_body, monitor.interval_not_allowed, monitor.secrets_unavailable.401 — One of: auth.unauthenticated.403 — One of: request.host_not_allowed, permission.denied.409 — One of: monitor.limit_reached, idempotency.conflict, idempotency.in_progress.429 — One of: request.rate_limited.
Ejemplo
curl -X POST "https://api.nuvostatus.com/v1/monitors" \
-H "Authorization: Bearer $NUVOSTATUS_KEY" \
-H "Content-Type: application/json" \
-d '{"type":"tcp","name":"Database","config":{"host":"db.example.com","port":5432},"intervalSeconds":300}'
{"type":"http","name":"Shop","config":{"url":"https://shop.example.com/health","expectedStatus":["2xx"]},"baselinePercent":60}
{"type":"http","name":"Private API","config":{"url":"https://api.example.com/orders","method":"POST","headers":[{"name":"X-Environment","value":"production"}],"auth":{"type":"bearer","token":"a-token"},"body":{"contentType":"application/json","value":"{\"limit\":1}"},"expectedStatus":["2xx"]}}
{"type":"http","name":"Status page text","config":{"url":"https://shop.example.com/status","conditions":[{"type":"body_contains","text":"All systems operational"},{"type":"body_not_contains","text":"maintenance"}],"conditionMode":"all"}}
{"type":"dns","name":"Mail","config":{"name":"example.com","recordType":"MX","expected":["mail.example.com"],"resolver":"system"}}
{"type":"heartbeat","name":"Nightly backup","config":{"periodSeconds":86400,"graceSeconds":3600}}
{"type":"ping","name":"Office router","config":{"host":"router.example.com"}}
{"type":"udp","name":"Game server","config":{"host":"game.example.com","port":27015}}
{"type":"domain","name":"Company domain","config":{"domain":"example.com"}}
Import monitors from a CSV export
POST /v1/monitors/imports/csvÁmbito: write
A Pingdom, StatusCake or plain CSV export. Every row of the file is answered in order: created, already imported, a duplicate of a row above, over the plan’s cap, or refused with its file row and a code. A refusal never fails the rest, and importing the same file twice creates nothing. Send an `Idempotency-Key` to make a retry replay this answer.
Parámetros
Idempotency-Key — en la cadena de consulta, opcional
Cuerpo de la petición
{ format: "pingdom" | "statuscake" | "generic", csv: string, filename?: string }
Respuestas
200 — The answer.{ batch: { id: string, format: "pingdom" | "statuscake" | "generic", filename: string | null, rowsRead: integer, rowsCreated: integer, rowsSkipped: integer, rowsRefused: integer, rowsLimitReached: integer, createdAt: string }, rows: { row: integer, outcome: "created" | "already_imported" | "duplicate_in_file" | "limit_reached" | "refused", name: string, code?: "auth.cannot_revoke_current" | "auth.email_not_verified" | "auth.invalid_code" | "auth.invalid_credentials" | "auth.invalid_token" | "auth.password_too_long" | "auth.password_too_short" | "auth.totp_required" | "auth.two_factor_already_enabled" | "auth.two_factor_not_enabled" | "auth.unauthenticated" | "internal.error" | "invitation.already_member" | "invitation.limit_reached" | "invitation.not_found" | "account.password_incorrect" | "account.sole_owner" | "account.disabled" | "account.email_taken" | "account.email_unchanged" | "admin.not_an_operator" | "admin.permission_denied" | "admin.user_not_found" | "admin.workspace_not_found" | "admin.monitor_not_found" | "admin.incident_not_found" | "admin.plan_unknown" | "admin.plan_below_usage" | "admin.override_invalid" | "admin.subscription_not_found" | "alert_digest.invalid_window" | "alert_grouping.invalid" | "api.bulk_empty" | "audit.read_forbidden" | "billing.provider_unavailable" | "billing.plan_not_sold" | "billing.no_subscription" | "billing.subscription_state" | "billing.subscription_conflict" | "billing.webhook_rejected" | "entitlement.feature_not_included" | "escalation_steps.invalid" | "escalation.rotation_not_found" | "escalation_steps.contact_not_found" | "escalation_steps.channel_not_found" | "member.limit_reached" | "member.last_owner" | "member.not_found" | "member.role_not_assignable" | "monitor.account_limit_reached" | "monitor.confirmation_out_of_range" | "monitor.interval_not_allowed" | "monitor.limit_reached" | "monitor.timeout_not_allowed" | "monitor.update_forbidden" | "import.invalid_export" | "import.row_refused" | "import.secret_unavailable" | "import.source_key_refused" | "import.source_unavailable" | "import.unsupported_type" | "import.missing_target" | "import.invalid_target" | "import.invalid_name" | "import.unsupported_interval" | "import.too_many_rows" | "incident.not_found" | "incident.invalid_cursor" | "incident.impact_invalid" | "incident.assignee_not_member" | "incident.assignment_forbidden" | "incident.already_resolved" | "incident.not_resolved" | "incident.already_open" | "incident.not_manual" | "incident.cause_invalid" | "incident.declaration_forbidden" | "incident.export_too_large" | "action_item.not_found" | "action_item.too_many" | "action_item.incident_open" | "action_item.owner_not_member" | "action_item.due_in_past" | "postmortem.not_found" | "incident_comment.not_author" | "incident_comment.not_found" | "monitor.invalid_cursor" | "monitor.not_found" | "monitor.not_deleted" | "monitor.restore_window_expired" | "monitor.url_not_allowed" | "monitor.channel_not_found" | "monitor.keyword_needs_body" | "monitor.conditions_need_body" | "monitor.json_condition_needs_body" | "monitor.config_invalid" | "monitor.authorization_header_conflict" | "monitor.auth_value_has_scheme" | "monitor.domain_invalid" | "monitor.secrets_unavailable" | "monitor.host_not_allowed" | "monitor.not_a_heartbeat" | "monitor.slow_response_not_supported" | "monitor.baseline_not_supported" | "monitor.pause_until_in_past" | "monitor.pause_until_too_far" | "monitor.dependency_not_found" | "monitor.dependency_self" | "monitor.dependency_limit" | "monitor.dependency_duplicate" | "monitor.dependency_cycle" | "monitor.runbook_url_invalid" | "monitor.paused" | "monitor.check_too_soon" | "monitor.check_budget_spent" | "monitor.check_not_supported" | "monitor.no_capable_probe" | "manual_check.not_found" | "on_call.invalid_participant" | "on_call.invalid_window" | "on_call.invalid_name" | "on_call.name_taken" | "on_call.rotation_not_found" | "on_call.rotation_last" | "rotation.in_use" | "group.not_found" | "group.name_taken" | "group.limit_reached" | "group.order_invalid" | "idempotency.conflict" | "idempotency.in_progress" | "tag.not_found" | "tag.name_taken" | "tag.limit_reached" | "tag.limit_per_monitor" | "sla_policy.not_found" | "sla_policy.name_taken" | "sla_policy.monitor_already_covered" | "sla_report.not_found" | "sla_report.month_not_closed" | "sla_report.too_large" | "api_key.not_found" | "api_key.limit_reached" | "api_key.write_key_not_limited" | "api_key.monitor_not_allowed" | "api_key.not_rotatable" | "api_key.grace_out_of_range" | "contact.not_found" | "contact.already_exists" | "contact.limit_reached" | "contact.availability_invalid" | "contact.unavailable" | "maintenance.not_found" | "maintenance.not_editable" | "maintenance.limit_reached" | "maintenance.monitor_not_found" | "maintenance.group_not_found" | "maintenance.invalid_window" | "maintenance.skip_not_recurring" | "maintenance.skip_not_an_occurrence" | "maintenance.skip_started" | "maintenance.skip_already_skipped" | "maintenance.skip_not_found" | "maintenance_window.group_not_found" | "maintenance_window.limit_exceeded" | "maintenance_window.monitor_not_found" | "maintenance_window.not_active" | "maintenance_window.not_found" | "contact.not_verified" | "contact.unknown_contact" | "contact.verification_invalid" | "channel.not_found" | "channel.name_taken" | "channel.limit_reached" | "channel.config_invalid" | "channel.events_empty" | "channel.secret_unavailable" | "channel.secret_not_rotatable" | "delivery.not_found" | "delivery.not_retryable" | "delivery.paced" | "email.lane_budget_exhausted" | "email.suppression_not_found" | "email.webhook_rejected" | "alert_provider.not_configured" | "permission.denied" | "probe.enrolment_expired" | "probe.enrolment_invalid_key" | "probe.enrolment_invalid_request" | "probe.enrolment_revoked" | "probe.enrolment_unknown" | "probe.enrolment_used" | "request.content_type_not_allowed" | "request.cross_site" | "request.host_not_allowed" | "request.origin_missing" | "request.origin_not_allowed" | "request.rate_limited" | "resource.not_found" | "status_page.limit_reached" | "status_page.monitor_not_found" | "status_page.not_found" | "status_page.password_incorrect" | "status_page.slug_taken" | "status_page.unavailable" | "status_page.service_not_found" | "status_page.services_required" | "status_page.domain_invalid" | "status_page.domain_taken" | "status_page_announcement.invalid_window" | "status_page_announcement.limit_reached" | "status_page_announcement.not_found" | "status_page_subscriber.not_found" | "validation.failed" | "weekly_report.invalid_reader" | "workspace.limit_reached" | "workspace.not_found" | "workspace.nothing_to_change" | "workspace.import_limit_exceeded", monitorId?: string }[] }
400 — One of: validation.failed, import.invalid_export, import.too_many_rows.401 — One of: auth.unauthenticated.403 — One of: request.host_not_allowed, permission.denied.409 — One of: idempotency.conflict, idempotency.in_progress.429 — One of: request.rate_limited.
Ejemplo
curl -X POST "https://api.nuvostatus.com/v1/monitors/imports/csv" \
-H "Authorization: Bearer $NUVOSTATUS_KEY" \
-H "Content-Type: application/json" \
-d '{"format":"pingdom","filename":"monitors.csv","csv":"Monitor name,Host,Resolution,Type\nShop,https://shop.example.com/,1,http\n"}'
Import monitors from UptimeRobot with the workspace key
POST /v1/monitors/imports/uptimerobot/apiÁmbito: write
Connects the workspace to UptimeRobot’s v3 API with its own key and creates every monitor the product can carry, each once: authentication exactly as the vendor sends it, the accepted status codes, request headers and body, and the certificate alert days. The key is stored sealed, is never returned, and the API asks the configured vendor host and no other. A monitor the product cannot express is answered with its own reason; importing again creates nothing.
Cuerpo de la petición
{ apiKey: string }
Respuestas
200 — The answer.{ imported: { monitor: { type: …, config: …, id: …, name: …, target: …, intervalSeconds: …, timeoutSeconds: …, paused: …, pausedUntil: …, status: …, statusSince: …, pendingReason: …, lastCheck: …, certificate: …, maintenance: …, incident: …, notifications: …, groupId: …, groupName: …, groupState: …, tags: …, nextCheckAt: …, heartbeat: …, createdAt: …, updatedAt: … } | { type: …, config: …, id: …, name: …, target: …, intervalSeconds: …, timeoutSeconds: …, paused: …, pausedUntil: …, status: …, statusSince: …, pendingReason: …, lastCheck: …, certificate: …, maintenance: …, incident: …, notifications: …, groupId: …, groupName: …, groupState: …, tags: …, nextCheckAt: …, heartbeat: …, createdAt: …, updatedAt: … } | { type: …, config: …, id: …, name: …, target: …, intervalSeconds: …, timeoutSeconds: …, paused: …, pausedUntil: …, status: …, statusSince: …, pendingReason: …, lastCheck: …, certificate: …, maintenance: …, incident: …, notifications: …, groupId: …, groupName: …, groupState: …, tags: …, nextCheckAt: …, heartbeat: …, createdAt: …, updatedAt: … } | { type: …, config: …, id: …, name: …, target: …, intervalSeconds: …, timeoutSeconds: …, paused: …, pausedUntil: …, status: …, statusSince: …, pendingReason: …, lastCheck: …, certificate: …, maintenance: …, incident: …, notifications: …, groupId: …, groupName: …, groupState: …, tags: …, nextCheckAt: …, heartbeat: …, createdAt: …, updatedAt: … } | { type: …, config: …, id: …, name: …, target: …, intervalSeconds: …, timeoutSeconds: …, paused: …, pausedUntil: …, status: …, statusSince: …, pendingReason: …, lastCheck: …, certificate: …, maintenance: …, incident: …, notifications: …, groupId: …, groupName: …, groupState: …, tags: …, nextCheckAt: …, heartbeat: …, createdAt: …, updatedAt: … } | { type: …, config: …, id: …, name: …, target: …, intervalSeconds: …, timeoutSeconds: …, paused: …, pausedUntil: …, status: …, statusSince: …, pendingReason: …, lastCheck: …, certificate: …, maintenance: …, incident: …, notifications: …, groupId: …, groupName: …, groupState: …, tags: …, nextCheckAt: …, heartbeat: …, createdAt: …, updatedAt: … } | { type: …, config: …, id: …, name: …, target: …, intervalSeconds: …, timeoutSeconds: …, paused: …, pausedUntil: …, status: …, statusSince: …, pendingReason: …, lastCheck: …, certificate: …, maintenance: …, incident: …, notifications: …, groupId: …, groupName: …, groupState: …, tags: …, nextCheckAt: …, heartbeat: …, createdAt: …, updatedAt: … }, heartbeatUrl?: string }[], skipped: { externalId: string, name: string, uptimeRobotType: string, reason: "already_imported" | "duplicate" | "invalid_monitor" | "invalid_target" | "needs_credentials" | "paused" | "unsupported_configuration" | "unsupported_interval" | "unsupported_timeout" | "unsupported_type", authHint?: "literal" }[] }
400 — One of: validation.failed, import.invalid_export, import.source_key_refused, import.source_unavailable, import.secret_unavailable, monitor.secrets_unavailable.401 — One of: auth.unauthenticated.403 — One of: request.host_not_allowed, permission.denied.409 — One of: monitor.limit_reached.429 — One of: request.rate_limited.
Ejemplo
curl -X POST "https://api.nuvostatus.com/v1/monitors/imports/uptimerobot/api" \
-H "Authorization: Bearer $NUVOSTATUS_KEY" \
-H "Content-Type: application/json" \
-d '{"apiKey":"ur123456-abcdef0123456789abcdef0123456789"}'
The stored UptimeRobot connection
GET /v1/monitors/imports/uptimerobot/apiÁmbito: read
Whether a key is stored for this workspace, when it was last used and what the last import amounted to. The key itself is never part of any answer.
Respuestas
200 — The answer.{ source: { provider: "uptimerobot", connected: boolean, createdAt: string | null, lastUsedAt: string | null, lastOutcome: { created: integer, skipped: integer, refused: integer, limitReached: integer } } }
401 — One of: auth.unauthenticated.403 — One of: request.host_not_allowed, permission.denied.429 — One of: request.rate_limited.
Ejemplo
curl "https://api.nuvostatus.com/v1/monitors/imports/uptimerobot/api" \
-H "Authorization: Bearer $NUVOSTATUS_KEY"
Disconnect the stored UptimeRobot key
DELETE /v1/monitors/imports/uptimerobot/apiÁmbito: write
Deletes the stored key. Monitors already imported are untouched; a later import needs the key again.
Respuestas
204 — Done; no body.401 — One of: auth.unauthenticated.403 — One of: request.host_not_allowed, permission.denied.429 — One of: request.rate_limited.
Ejemplo
curl -X DELETE "https://api.nuvostatus.com/v1/monitors/imports/uptimerobot/api" \
-H "Authorization: Bearer $NUVOSTATUS_KEY"
Read a monitor
GET /v1/monitors/{id}Ámbito: read
The monitor with its state, its last check, its open incident and, over HTTPS, its certificate.
Parámetros
id — en la ruta, obligatorio
Respuestas
200 — The answer.{ type: "http", config: { url: string, method: "GET" | "HEAD" | "POST" | "PUT" | "PATCH" | "DELETE", followRedirects: boolean, expectedStatus: string[], keyword: string | null, keywordMustAppear: boolean, conditions: … | … | … | … | … | …[], conditionMode: "all" | "any", headers: { name: …, value: … }[], auth: { type: … } | { type: …, username: …, password: … } | { type: …, token: … }, body: { contentType: string, value: string } }, id: string, name: string, target: string, intervalSeconds: integer, timeoutSeconds: integer, paused: boolean, pausedUntil: string | null, status: "pending" | "passing" | "failing" | "down" | "paused" | "unknown", statusSince: string | null, pendingReason: { code: "no_probe_capability", missingCapability: "http" | "tcp" | "dns" | "http_secrets" | "icmp" | "udp" | "domain" | "ipv6" }, lastCheck: { at: string, class: "ok" | "fail", error: "dns_not_found" | "dns_failure" | "dns_timeout" | "connection_refused" | "connection_timeout" | "connection_reset" | "network_unreachable" | "tls_certificate_expired" | "tls_certificate_invalid" | "tls_hostname_mismatch" | "tls_handshake_failed" | "timeout" | "unexpected_status" | "too_many_redirects" | "invalid_redirect" | "destination_not_allowed" | "response_headers_too_large" | "protocol_error" | "keyword_not_found" | "keyword_found" | "json_invalid" | "json_path_missing" | "json_value_mismatch" | "json_too_large" | "header_missing" | "header_mismatch" | "final_url_mismatch" | "dns_no_records" | "dns_unexpected_answer" | "heartbeat_missed" | "no_reply" | "domain_expiring" | "domain_expired" | "lease_expired" | "rate_limited" | "expired" | "probe_overloaded" | "secret_unavailable" | "icmp_unavailable" | "domain_expiry_unknown" | "probe_no_ipv6" | "own_destination" | "self_check_failed", statusCode: integer | null, responseMs: integer | null }, certificate: { notBefore: string, notAfter: string, issuer: string, subject: string, sans: integer, seenAt: string, daysLeft: integer, state: "ok" | "attention" | "critical" | "expired" | "invalid" }, maintenance: { id: string, name: string, endsAt: string }, incident: { id: string, startedAt: string, confirmedAt: string, recovering: boolean, flapping: boolean }, notifications: { alertMembers: boolean, contactIds: string[], quietUntil: string | null, quietForever: boolean }, groupId: string | null, groupName: string | null, groupState: "operational" | "degraded" | "down" | "maintenance" | "unknown", tags: { id: string, name: string }[], nextCheckAt: string | null, heartbeat: { lastPingAt: string | null, dueAt: string | null }, createdAt: string, updatedAt: string } | { type: "tcp", config: { host: string, port: integer }, id: string, name: string, target: string, intervalSeconds: integer, timeoutSeconds: integer, paused: boolean, pausedUntil: string | null, status: "pending" | "passing" | "failing" | "down" | "paused" | "unknown", statusSince: string | null, pendingReason: { code: "no_probe_capability", missingCapability: "http" | "tcp" | "dns" | "http_secrets" | "icmp" | "udp" | "domain" | "ipv6" }, lastCheck: { at: string, class: "ok" | "fail", error: "dns_not_found" | "dns_failure" | "dns_timeout" | "connection_refused" | "connection_timeout" | "connection_reset" | "network_unreachable" | "tls_certificate_expired" | "tls_certificate_invalid" | "tls_hostname_mismatch" | "tls_handshake_failed" | "timeout" | "unexpected_status" | "too_many_redirects" | "invalid_redirect" | "destination_not_allowed" | "response_headers_too_large" | "protocol_error" | "keyword_not_found" | "keyword_found" | "json_invalid" | "json_path_missing" | "json_value_mismatch" | "json_too_large" | "header_missing" | "header_mismatch" | "final_url_mismatch" | "dns_no_records" | "dns_unexpected_answer" | "heartbeat_missed" | "no_reply" | "domain_expiring" | "domain_expired" | "lease_expired" | "rate_limited" | "expired" | "probe_overloaded" | "secret_unavailable" | "icmp_unavailable" | "domain_expiry_unknown" | "probe_no_ipv6" | "own_destination" | "self_check_failed", statusCode: integer | null, responseMs: integer | null }, certificate: { notBefore: string, notAfter: string, issuer: string, subject: string, sans: integer, seenAt: string, daysLeft: integer, state: "ok" | "attention" | "critical" | "expired" | "invalid" }, maintenance: { id: string, name: string, endsAt: string }, incident: { id: string, startedAt: string, confirmedAt: string, recovering: boolean, flapping: boolean }, notifications: { alertMembers: boolean, contactIds: string[], quietUntil: string | null, quietForever: boolean }, groupId: string | null, groupName: string | null, groupState: "operational" | "degraded" | "down" | "maintenance" | "unknown", tags: { id: string, name: string }[], nextCheckAt: string | null, heartbeat: { lastPingAt: string | null, dueAt: string | null }, createdAt: string, updatedAt: string } | { type: "dns", config: { name: string, recordType: "A" | "AAAA" | "CNAME" | "MX" | "TXT" | "NS", expected: string[], resolver: "system" | "cloudflare" | "google" | "quad9" | "opendns" }, id: string, name: string, target: string, intervalSeconds: integer, timeoutSeconds: integer, paused: boolean, pausedUntil: string | null, status: "pending" | "passing" | "failing" | "down" | "paused" | "unknown", statusSince: string | null, pendingReason: { code: "no_probe_capability", missingCapability: "http" | "tcp" | "dns" | "http_secrets" | "icmp" | "udp" | "domain" | "ipv6" }, lastCheck: { at: string, class: "ok" | "fail", error: "dns_not_found" | "dns_failure" | "dns_timeout" | "connection_refused" | "connection_timeout" | "connection_reset" | "network_unreachable" | "tls_certificate_expired" | "tls_certificate_invalid" | "tls_hostname_mismatch" | "tls_handshake_failed" | "timeout" | "unexpected_status" | "too_many_redirects" | "invalid_redirect" | "destination_not_allowed" | "response_headers_too_large" | "protocol_error" | "keyword_not_found" | "keyword_found" | "json_invalid" | "json_path_missing" | "json_value_mismatch" | "json_too_large" | "header_missing" | "header_mismatch" | "final_url_mismatch" | "dns_no_records" | "dns_unexpected_answer" | "heartbeat_missed" | "no_reply" | "domain_expiring" | "domain_expired" | "lease_expired" | "rate_limited" | "expired" | "probe_overloaded" | "secret_unavailable" | "icmp_unavailable" | "domain_expiry_unknown" | "probe_no_ipv6" | "own_destination" | "self_check_failed", statusCode: integer | null, responseMs: integer | null }, certificate: { notBefore: string, notAfter: string, issuer: string, subject: string, sans: integer, seenAt: string, daysLeft: integer, state: "ok" | "attention" | "critical" | "expired" | "invalid" }, maintenance: { id: string, name: string, endsAt: string }, incident: { id: string, startedAt: string, confirmedAt: string, recovering: boolean, flapping: boolean }, notifications: { alertMembers: boolean, contactIds: string[], quietUntil: string | null, quietForever: boolean }, groupId: string | null, groupName: string | null, groupState: "operational" | "degraded" | "down" | "maintenance" | "unknown", tags: { id: string, name: string }[], nextCheckAt: string | null, heartbeat: { lastPingAt: string | null, dueAt: string | null }, createdAt: string, updatedAt: string } | { type: "heartbeat", config: { periodSeconds: 60 | 120 | 300 | 600 | 900 | 1800 | 3600 | 7200 | 21600 | 43200 | 86400 | 604800 | 2592000, graceSeconds: integer }, id: string, name: string, target: string, intervalSeconds: integer, timeoutSeconds: integer, paused: boolean, pausedUntil: string | null, status: "pending" | "passing" | "failing" | "down" | "paused" | "unknown", statusSince: string | null, pendingReason: { code: "no_probe_capability", missingCapability: "http" | "tcp" | "dns" | "http_secrets" | "icmp" | "udp" | "domain" | "ipv6" }, lastCheck: { at: string, class: "ok" | "fail", error: "dns_not_found" | "dns_failure" | "dns_timeout" | "connection_refused" | "connection_timeout" | "connection_reset" | "network_unreachable" | "tls_certificate_expired" | "tls_certificate_invalid" | "tls_hostname_mismatch" | "tls_handshake_failed" | "timeout" | "unexpected_status" | "too_many_redirects" | "invalid_redirect" | "destination_not_allowed" | "response_headers_too_large" | "protocol_error" | "keyword_not_found" | "keyword_found" | "json_invalid" | "json_path_missing" | "json_value_mismatch" | "json_too_large" | "header_missing" | "header_mismatch" | "final_url_mismatch" | "dns_no_records" | "dns_unexpected_answer" | "heartbeat_missed" | "no_reply" | "domain_expiring" | "domain_expired" | "lease_expired" | "rate_limited" | "expired" | "probe_overloaded" | "secret_unavailable" | "icmp_unavailable" | "domain_expiry_unknown" | "probe_no_ipv6" | "own_destination" | "self_check_failed", statusCode: integer | null, responseMs: integer | null }, certificate: { notBefore: string, notAfter: string, issuer: string, subject: string, sans: integer, seenAt: string, daysLeft: integer, state: "ok" | "attention" | "critical" | "expired" | "invalid" }, maintenance: { id: string, name: string, endsAt: string }, incident: { id: string, startedAt: string, confirmedAt: string, recovering: boolean, flapping: boolean }, notifications: { alertMembers: boolean, contactIds: string[], quietUntil: string | null, quietForever: boolean }, groupId: string | null, groupName: string | null, groupState: "operational" | "degraded" | "down" | "maintenance" | "unknown", tags: { id: string, name: string }[], nextCheckAt: string | null, heartbeat: { lastPingAt: string | null, dueAt: string | null }, createdAt: string, updatedAt: string } | { type: "ping", config: { host: string }, id: string, name: string, target: string, intervalSeconds: integer, timeoutSeconds: integer, paused: boolean, pausedUntil: string | null, status: "pending" | "passing" | "failing" | "down" | "paused" | "unknown", statusSince: string | null, pendingReason: { code: "no_probe_capability", missingCapability: "http" | "tcp" | "dns" | "http_secrets" | "icmp" | "udp" | "domain" | "ipv6" }, lastCheck: { at: string, class: "ok" | "fail", error: "dns_not_found" | "dns_failure" | "dns_timeout" | "connection_refused" | "connection_timeout" | "connection_reset" | "network_unreachable" | "tls_certificate_expired" | "tls_certificate_invalid" | "tls_hostname_mismatch" | "tls_handshake_failed" | "timeout" | "unexpected_status" | "too_many_redirects" | "invalid_redirect" | "destination_not_allowed" | "response_headers_too_large" | "protocol_error" | "keyword_not_found" | "keyword_found" | "json_invalid" | "json_path_missing" | "json_value_mismatch" | "json_too_large" | "header_missing" | "header_mismatch" | "final_url_mismatch" | "dns_no_records" | "dns_unexpected_answer" | "heartbeat_missed" | "no_reply" | "domain_expiring" | "domain_expired" | "lease_expired" | "rate_limited" | "expired" | "probe_overloaded" | "secret_unavailable" | "icmp_unavailable" | "domain_expiry_unknown" | "probe_no_ipv6" | "own_destination" | "self_check_failed", statusCode: integer | null, responseMs: integer | null }, certificate: { notBefore: string, notAfter: string, issuer: string, subject: string, sans: integer, seenAt: string, daysLeft: integer, state: "ok" | "attention" | "critical" | "expired" | "invalid" }, maintenance: { id: string, name: string, endsAt: string }, incident: { id: string, startedAt: string, confirmedAt: string, recovering: boolean, flapping: boolean }, notifications: { alertMembers: boolean, contactIds: string[], quietUntil: string | null, quietForever: boolean }, groupId: string | null, groupName: string | null, groupState: "operational" | "degraded" | "down" | "maintenance" | "unknown", tags: { id: string, name: string }[], nextCheckAt: string | null, heartbeat: { lastPingAt: string | null, dueAt: string | null }, createdAt: string, updatedAt: string } | { type: "udp", config: { host: string, port: integer }, id: string, name: string, target: string, intervalSeconds: integer, timeoutSeconds: integer, paused: boolean, pausedUntil: string | null, status: "pending" | "passing" | "failing" | "down" | "paused" | "unknown", statusSince: string | null, pendingReason: { code: "no_probe_capability", missingCapability: "http" | "tcp" | "dns" | "http_secrets" | "icmp" | "udp" | "domain" | "ipv6" }, lastCheck: { at: string, class: "ok" | "fail", error: "dns_not_found" | "dns_failure" | "dns_timeout" | "connection_refused" | "connection_timeout" | "connection_reset" | "network_unreachable" | "tls_certificate_expired" | "tls_certificate_invalid" | "tls_hostname_mismatch" | "tls_handshake_failed" | "timeout" | "unexpected_status" | "too_many_redirects" | "invalid_redirect" | "destination_not_allowed" | "response_headers_too_large" | "protocol_error" | "keyword_not_found" | "keyword_found" | "json_invalid" | "json_path_missing" | "json_value_mismatch" | "json_too_large" | "header_missing" | "header_mismatch" | "final_url_mismatch" | "dns_no_records" | "dns_unexpected_answer" | "heartbeat_missed" | "no_reply" | "domain_expiring" | "domain_expired" | "lease_expired" | "rate_limited" | "expired" | "probe_overloaded" | "secret_unavailable" | "icmp_unavailable" | "domain_expiry_unknown" | "probe_no_ipv6" | "own_destination" | "self_check_failed", statusCode: integer | null, responseMs: integer | null }, certificate: { notBefore: string, notAfter: string, issuer: string, subject: string, sans: integer, seenAt: string, daysLeft: integer, state: "ok" | "attention" | "critical" | "expired" | "invalid" }, maintenance: { id: string, name: string, endsAt: string }, incident: { id: string, startedAt: string, confirmedAt: string, recovering: boolean, flapping: boolean }, notifications: { alertMembers: boolean, contactIds: string[], quietUntil: string | null, quietForever: boolean }, groupId: string | null, groupName: string | null, groupState: "operational" | "degraded" | "down" | "maintenance" | "unknown", tags: { id: string, name: string }[], nextCheckAt: string | null, heartbeat: { lastPingAt: string | null, dueAt: string | null }, createdAt: string, updatedAt: string } | { type: "domain", config: { domain: string }, id: string, name: string, target: string, intervalSeconds: integer, timeoutSeconds: integer, paused: boolean, pausedUntil: string | null, status: "pending" | "passing" | "failing" | "down" | "paused" | "unknown", statusSince: string | null, pendingReason: { code: "no_probe_capability", missingCapability: "http" | "tcp" | "dns" | "http_secrets" | "icmp" | "udp" | "domain" | "ipv6" }, lastCheck: { at: string, class: "ok" | "fail", error: "dns_not_found" | "dns_failure" | "dns_timeout" | "connection_refused" | "connection_timeout" | "connection_reset" | "network_unreachable" | "tls_certificate_expired" | "tls_certificate_invalid" | "tls_hostname_mismatch" | "tls_handshake_failed" | "timeout" | "unexpected_status" | "too_many_redirects" | "invalid_redirect" | "destination_not_allowed" | "response_headers_too_large" | "protocol_error" | "keyword_not_found" | "keyword_found" | "json_invalid" | "json_path_missing" | "json_value_mismatch" | "json_too_large" | "header_missing" | "header_mismatch" | "final_url_mismatch" | "dns_no_records" | "dns_unexpected_answer" | "heartbeat_missed" | "no_reply" | "domain_expiring" | "domain_expired" | "lease_expired" | "rate_limited" | "expired" | "probe_overloaded" | "secret_unavailable" | "icmp_unavailable" | "domain_expiry_unknown" | "probe_no_ipv6" | "own_destination" | "self_check_failed", statusCode: integer | null, responseMs: integer | null }, certificate: { notBefore: string, notAfter: string, issuer: string, subject: string, sans: integer, seenAt: string, daysLeft: integer, state: "ok" | "attention" | "critical" | "expired" | "invalid" }, maintenance: { id: string, name: string, endsAt: string }, incident: { id: string, startedAt: string, confirmedAt: string, recovering: boolean, flapping: boolean }, notifications: { alertMembers: boolean, contactIds: string[], quietUntil: string | null, quietForever: boolean }, groupId: string | null, groupName: string | null, groupState: "operational" | "degraded" | "down" | "maintenance" | "unknown", tags: { id: string, name: string }[], nextCheckAt: string | null, heartbeat: { lastPingAt: string | null, dueAt: string | null }, createdAt: string, updatedAt: string }
401 — One of: auth.unauthenticated.403 — One of: request.host_not_allowed.404 — One of: monitor.not_found.429 — One of: request.rate_limited.
Ejemplo
curl "https://api.nuvostatus.com/v1/monitors/0199e6a0-0000-7000-8000-000000000001" \
-H "Authorization: Bearer $NUVOSTATUS_KEY"
Change a monitor
PATCH /v1/monitors/{id}Ámbito: write
Only what is sent changes. `config` takes the fields of the monitor's own kind. Changing what is checked starts its history of state over.
Parámetros
id — en la ruta, obligatorio
Cuerpo de la petición
{ name?: string, channelIds?: string[], dependsOn?: string[], importance?: "critical" | "standard", config?: {}, intervalSeconds?: 30 | 60 | 120 | 180 | 300 | 600 | 900 | 1800 | 3600, confirmationChecks?: integer, confirmationSpanSeconds?: integer, timeoutSeconds?: integer, paused?: boolean, pausedUntil?: string | null, groupId?: string | null, tagIds?: string[], certificateAlertDays?: integer, slaTargetBp?: integer, slaBudgetAlertPercent?: integer | null, slowResponseMs?: integer | null, baselinePercent?: integer | null, runbookUrl?: string | null }
Respuestas
200 — The answer.{ type: "http", config: { url: string, method: "GET" | "HEAD" | "POST" | "PUT" | "PATCH" | "DELETE", followRedirects: boolean, expectedStatus: string[], keyword: string | null, keywordMustAppear: boolean, conditions: … | … | … | … | … | …[], conditionMode: "all" | "any", headers: { name: …, value: … }[], auth: { type: … } | { type: …, username: …, password: … } | { type: …, token: … }, body: { contentType: string, value: string } }, id: string, name: string, target: string, intervalSeconds: integer, timeoutSeconds: integer, paused: boolean, pausedUntil: string | null, status: "pending" | "passing" | "failing" | "down" | "paused" | "unknown", statusSince: string | null, pendingReason: { code: "no_probe_capability", missingCapability: "http" | "tcp" | "dns" | "http_secrets" | "icmp" | "udp" | "domain" | "ipv6" }, lastCheck: { at: string, class: "ok" | "fail", error: "dns_not_found" | "dns_failure" | "dns_timeout" | "connection_refused" | "connection_timeout" | "connection_reset" | "network_unreachable" | "tls_certificate_expired" | "tls_certificate_invalid" | "tls_hostname_mismatch" | "tls_handshake_failed" | "timeout" | "unexpected_status" | "too_many_redirects" | "invalid_redirect" | "destination_not_allowed" | "response_headers_too_large" | "protocol_error" | "keyword_not_found" | "keyword_found" | "json_invalid" | "json_path_missing" | "json_value_mismatch" | "json_too_large" | "header_missing" | "header_mismatch" | "final_url_mismatch" | "dns_no_records" | "dns_unexpected_answer" | "heartbeat_missed" | "no_reply" | "domain_expiring" | "domain_expired" | "lease_expired" | "rate_limited" | "expired" | "probe_overloaded" | "secret_unavailable" | "icmp_unavailable" | "domain_expiry_unknown" | "probe_no_ipv6" | "own_destination" | "self_check_failed", statusCode: integer | null, responseMs: integer | null }, certificate: { notBefore: string, notAfter: string, issuer: string, subject: string, sans: integer, seenAt: string, daysLeft: integer, state: "ok" | "attention" | "critical" | "expired" | "invalid" }, maintenance: { id: string, name: string, endsAt: string }, incident: { id: string, startedAt: string, confirmedAt: string, recovering: boolean, flapping: boolean }, notifications: { alertMembers: boolean, contactIds: string[], quietUntil: string | null, quietForever: boolean }, groupId: string | null, groupName: string | null, groupState: "operational" | "degraded" | "down" | "maintenance" | "unknown", tags: { id: string, name: string }[], nextCheckAt: string | null, heartbeat: { lastPingAt: string | null, dueAt: string | null }, createdAt: string, updatedAt: string } | { type: "tcp", config: { host: string, port: integer }, id: string, name: string, target: string, intervalSeconds: integer, timeoutSeconds: integer, paused: boolean, pausedUntil: string | null, status: "pending" | "passing" | "failing" | "down" | "paused" | "unknown", statusSince: string | null, pendingReason: { code: "no_probe_capability", missingCapability: "http" | "tcp" | "dns" | "http_secrets" | "icmp" | "udp" | "domain" | "ipv6" }, lastCheck: { at: string, class: "ok" | "fail", error: "dns_not_found" | "dns_failure" | "dns_timeout" | "connection_refused" | "connection_timeout" | "connection_reset" | "network_unreachable" | "tls_certificate_expired" | "tls_certificate_invalid" | "tls_hostname_mismatch" | "tls_handshake_failed" | "timeout" | "unexpected_status" | "too_many_redirects" | "invalid_redirect" | "destination_not_allowed" | "response_headers_too_large" | "protocol_error" | "keyword_not_found" | "keyword_found" | "json_invalid" | "json_path_missing" | "json_value_mismatch" | "json_too_large" | "header_missing" | "header_mismatch" | "final_url_mismatch" | "dns_no_records" | "dns_unexpected_answer" | "heartbeat_missed" | "no_reply" | "domain_expiring" | "domain_expired" | "lease_expired" | "rate_limited" | "expired" | "probe_overloaded" | "secret_unavailable" | "icmp_unavailable" | "domain_expiry_unknown" | "probe_no_ipv6" | "own_destination" | "self_check_failed", statusCode: integer | null, responseMs: integer | null }, certificate: { notBefore: string, notAfter: string, issuer: string, subject: string, sans: integer, seenAt: string, daysLeft: integer, state: "ok" | "attention" | "critical" | "expired" | "invalid" }, maintenance: { id: string, name: string, endsAt: string }, incident: { id: string, startedAt: string, confirmedAt: string, recovering: boolean, flapping: boolean }, notifications: { alertMembers: boolean, contactIds: string[], quietUntil: string | null, quietForever: boolean }, groupId: string | null, groupName: string | null, groupState: "operational" | "degraded" | "down" | "maintenance" | "unknown", tags: { id: string, name: string }[], nextCheckAt: string | null, heartbeat: { lastPingAt: string | null, dueAt: string | null }, createdAt: string, updatedAt: string } | { type: "dns", config: { name: string, recordType: "A" | "AAAA" | "CNAME" | "MX" | "TXT" | "NS", expected: string[], resolver: "system" | "cloudflare" | "google" | "quad9" | "opendns" }, id: string, name: string, target: string, intervalSeconds: integer, timeoutSeconds: integer, paused: boolean, pausedUntil: string | null, status: "pending" | "passing" | "failing" | "down" | "paused" | "unknown", statusSince: string | null, pendingReason: { code: "no_probe_capability", missingCapability: "http" | "tcp" | "dns" | "http_secrets" | "icmp" | "udp" | "domain" | "ipv6" }, lastCheck: { at: string, class: "ok" | "fail", error: "dns_not_found" | "dns_failure" | "dns_timeout" | "connection_refused" | "connection_timeout" | "connection_reset" | "network_unreachable" | "tls_certificate_expired" | "tls_certificate_invalid" | "tls_hostname_mismatch" | "tls_handshake_failed" | "timeout" | "unexpected_status" | "too_many_redirects" | "invalid_redirect" | "destination_not_allowed" | "response_headers_too_large" | "protocol_error" | "keyword_not_found" | "keyword_found" | "json_invalid" | "json_path_missing" | "json_value_mismatch" | "json_too_large" | "header_missing" | "header_mismatch" | "final_url_mismatch" | "dns_no_records" | "dns_unexpected_answer" | "heartbeat_missed" | "no_reply" | "domain_expiring" | "domain_expired" | "lease_expired" | "rate_limited" | "expired" | "probe_overloaded" | "secret_unavailable" | "icmp_unavailable" | "domain_expiry_unknown" | "probe_no_ipv6" | "own_destination" | "self_check_failed", statusCode: integer | null, responseMs: integer | null }, certificate: { notBefore: string, notAfter: string, issuer: string, subject: string, sans: integer, seenAt: string, daysLeft: integer, state: "ok" | "attention" | "critical" | "expired" | "invalid" }, maintenance: { id: string, name: string, endsAt: string }, incident: { id: string, startedAt: string, confirmedAt: string, recovering: boolean, flapping: boolean }, notifications: { alertMembers: boolean, contactIds: string[], quietUntil: string | null, quietForever: boolean }, groupId: string | null, groupName: string | null, groupState: "operational" | "degraded" | "down" | "maintenance" | "unknown", tags: { id: string, name: string }[], nextCheckAt: string | null, heartbeat: { lastPingAt: string | null, dueAt: string | null }, createdAt: string, updatedAt: string } | { type: "heartbeat", config: { periodSeconds: 60 | 120 | 300 | 600 | 900 | 1800 | 3600 | 7200 | 21600 | 43200 | 86400 | 604800 | 2592000, graceSeconds: integer }, id: string, name: string, target: string, intervalSeconds: integer, timeoutSeconds: integer, paused: boolean, pausedUntil: string | null, status: "pending" | "passing" | "failing" | "down" | "paused" | "unknown", statusSince: string | null, pendingReason: { code: "no_probe_capability", missingCapability: "http" | "tcp" | "dns" | "http_secrets" | "icmp" | "udp" | "domain" | "ipv6" }, lastCheck: { at: string, class: "ok" | "fail", error: "dns_not_found" | "dns_failure" | "dns_timeout" | "connection_refused" | "connection_timeout" | "connection_reset" | "network_unreachable" | "tls_certificate_expired" | "tls_certificate_invalid" | "tls_hostname_mismatch" | "tls_handshake_failed" | "timeout" | "unexpected_status" | "too_many_redirects" | "invalid_redirect" | "destination_not_allowed" | "response_headers_too_large" | "protocol_error" | "keyword_not_found" | "keyword_found" | "json_invalid" | "json_path_missing" | "json_value_mismatch" | "json_too_large" | "header_missing" | "header_mismatch" | "final_url_mismatch" | "dns_no_records" | "dns_unexpected_answer" | "heartbeat_missed" | "no_reply" | "domain_expiring" | "domain_expired" | "lease_expired" | "rate_limited" | "expired" | "probe_overloaded" | "secret_unavailable" | "icmp_unavailable" | "domain_expiry_unknown" | "probe_no_ipv6" | "own_destination" | "self_check_failed", statusCode: integer | null, responseMs: integer | null }, certificate: { notBefore: string, notAfter: string, issuer: string, subject: string, sans: integer, seenAt: string, daysLeft: integer, state: "ok" | "attention" | "critical" | "expired" | "invalid" }, maintenance: { id: string, name: string, endsAt: string }, incident: { id: string, startedAt: string, confirmedAt: string, recovering: boolean, flapping: boolean }, notifications: { alertMembers: boolean, contactIds: string[], quietUntil: string | null, quietForever: boolean }, groupId: string | null, groupName: string | null, groupState: "operational" | "degraded" | "down" | "maintenance" | "unknown", tags: { id: string, name: string }[], nextCheckAt: string | null, heartbeat: { lastPingAt: string | null, dueAt: string | null }, createdAt: string, updatedAt: string } | { type: "ping", config: { host: string }, id: string, name: string, target: string, intervalSeconds: integer, timeoutSeconds: integer, paused: boolean, pausedUntil: string | null, status: "pending" | "passing" | "failing" | "down" | "paused" | "unknown", statusSince: string | null, pendingReason: { code: "no_probe_capability", missingCapability: "http" | "tcp" | "dns" | "http_secrets" | "icmp" | "udp" | "domain" | "ipv6" }, lastCheck: { at: string, class: "ok" | "fail", error: "dns_not_found" | "dns_failure" | "dns_timeout" | "connection_refused" | "connection_timeout" | "connection_reset" | "network_unreachable" | "tls_certificate_expired" | "tls_certificate_invalid" | "tls_hostname_mismatch" | "tls_handshake_failed" | "timeout" | "unexpected_status" | "too_many_redirects" | "invalid_redirect" | "destination_not_allowed" | "response_headers_too_large" | "protocol_error" | "keyword_not_found" | "keyword_found" | "json_invalid" | "json_path_missing" | "json_value_mismatch" | "json_too_large" | "header_missing" | "header_mismatch" | "final_url_mismatch" | "dns_no_records" | "dns_unexpected_answer" | "heartbeat_missed" | "no_reply" | "domain_expiring" | "domain_expired" | "lease_expired" | "rate_limited" | "expired" | "probe_overloaded" | "secret_unavailable" | "icmp_unavailable" | "domain_expiry_unknown" | "probe_no_ipv6" | "own_destination" | "self_check_failed", statusCode: integer | null, responseMs: integer | null }, certificate: { notBefore: string, notAfter: string, issuer: string, subject: string, sans: integer, seenAt: string, daysLeft: integer, state: "ok" | "attention" | "critical" | "expired" | "invalid" }, maintenance: { id: string, name: string, endsAt: string }, incident: { id: string, startedAt: string, confirmedAt: string, recovering: boolean, flapping: boolean }, notifications: { alertMembers: boolean, contactIds: string[], quietUntil: string | null, quietForever: boolean }, groupId: string | null, groupName: string | null, groupState: "operational" | "degraded" | "down" | "maintenance" | "unknown", tags: { id: string, name: string }[], nextCheckAt: string | null, heartbeat: { lastPingAt: string | null, dueAt: string | null }, createdAt: string, updatedAt: string } | { type: "udp", config: { host: string, port: integer }, id: string, name: string, target: string, intervalSeconds: integer, timeoutSeconds: integer, paused: boolean, pausedUntil: string | null, status: "pending" | "passing" | "failing" | "down" | "paused" | "unknown", statusSince: string | null, pendingReason: { code: "no_probe_capability", missingCapability: "http" | "tcp" | "dns" | "http_secrets" | "icmp" | "udp" | "domain" | "ipv6" }, lastCheck: { at: string, class: "ok" | "fail", error: "dns_not_found" | "dns_failure" | "dns_timeout" | "connection_refused" | "connection_timeout" | "connection_reset" | "network_unreachable" | "tls_certificate_expired" | "tls_certificate_invalid" | "tls_hostname_mismatch" | "tls_handshake_failed" | "timeout" | "unexpected_status" | "too_many_redirects" | "invalid_redirect" | "destination_not_allowed" | "response_headers_too_large" | "protocol_error" | "keyword_not_found" | "keyword_found" | "json_invalid" | "json_path_missing" | "json_value_mismatch" | "json_too_large" | "header_missing" | "header_mismatch" | "final_url_mismatch" | "dns_no_records" | "dns_unexpected_answer" | "heartbeat_missed" | "no_reply" | "domain_expiring" | "domain_expired" | "lease_expired" | "rate_limited" | "expired" | "probe_overloaded" | "secret_unavailable" | "icmp_unavailable" | "domain_expiry_unknown" | "probe_no_ipv6" | "own_destination" | "self_check_failed", statusCode: integer | null, responseMs: integer | null }, certificate: { notBefore: string, notAfter: string, issuer: string, subject: string, sans: integer, seenAt: string, daysLeft: integer, state: "ok" | "attention" | "critical" | "expired" | "invalid" }, maintenance: { id: string, name: string, endsAt: string }, incident: { id: string, startedAt: string, confirmedAt: string, recovering: boolean, flapping: boolean }, notifications: { alertMembers: boolean, contactIds: string[], quietUntil: string | null, quietForever: boolean }, groupId: string | null, groupName: string | null, groupState: "operational" | "degraded" | "down" | "maintenance" | "unknown", tags: { id: string, name: string }[], nextCheckAt: string | null, heartbeat: { lastPingAt: string | null, dueAt: string | null }, createdAt: string, updatedAt: string } | { type: "domain", config: { domain: string }, id: string, name: string, target: string, intervalSeconds: integer, timeoutSeconds: integer, paused: boolean, pausedUntil: string | null, status: "pending" | "passing" | "failing" | "down" | "paused" | "unknown", statusSince: string | null, pendingReason: { code: "no_probe_capability", missingCapability: "http" | "tcp" | "dns" | "http_secrets" | "icmp" | "udp" | "domain" | "ipv6" }, lastCheck: { at: string, class: "ok" | "fail", error: "dns_not_found" | "dns_failure" | "dns_timeout" | "connection_refused" | "connection_timeout" | "connection_reset" | "network_unreachable" | "tls_certificate_expired" | "tls_certificate_invalid" | "tls_hostname_mismatch" | "tls_handshake_failed" | "timeout" | "unexpected_status" | "too_many_redirects" | "invalid_redirect" | "destination_not_allowed" | "response_headers_too_large" | "protocol_error" | "keyword_not_found" | "keyword_found" | "json_invalid" | "json_path_missing" | "json_value_mismatch" | "json_too_large" | "header_missing" | "header_mismatch" | "final_url_mismatch" | "dns_no_records" | "dns_unexpected_answer" | "heartbeat_missed" | "no_reply" | "domain_expiring" | "domain_expired" | "lease_expired" | "rate_limited" | "expired" | "probe_overloaded" | "secret_unavailable" | "icmp_unavailable" | "domain_expiry_unknown" | "probe_no_ipv6" | "own_destination" | "self_check_failed", statusCode: integer | null, responseMs: integer | null }, certificate: { notBefore: string, notAfter: string, issuer: string, subject: string, sans: integer, seenAt: string, daysLeft: integer, state: "ok" | "attention" | "critical" | "expired" | "invalid" }, maintenance: { id: string, name: string, endsAt: string }, incident: { id: string, startedAt: string, confirmedAt: string, recovering: boolean, flapping: boolean }, notifications: { alertMembers: boolean, contactIds: string[], quietUntil: string | null, quietForever: boolean }, groupId: string | null, groupName: string | null, groupState: "operational" | "degraded" | "down" | "maintenance" | "unknown", tags: { id: string, name: string }[], nextCheckAt: string | null, heartbeat: { lastPingAt: string | null, dueAt: string | null }, createdAt: string, updatedAt: string }
400 — One of: validation.failed, monitor.config_invalid, monitor.url_not_allowed, monitor.host_not_allowed, monitor.domain_invalid, monitor.json_condition_needs_body, monitor.interval_not_allowed, monitor.secrets_unavailable.401 — One of: auth.unauthenticated.403 — One of: request.host_not_allowed, permission.denied.404 — One of: monitor.not_found.429 — One of: request.rate_limited.
Ejemplo
curl -X PATCH "https://api.nuvostatus.com/v1/monitors/0199e6a0-0000-7000-8000-000000000001" \
-H "Authorization: Bearer $NUVOSTATUS_KEY" \
-H "Content-Type: application/json" \
-d '{"name":"Primary database","config":{"port":5433}}'
Pause a monitor
POST /v1/monitors/{id}/pauseÁmbito: write
Stops its checks; an open incident is closed as paused, told to nobody. Pausing a paused monitor changes nothing.
Parámetros
id — en la ruta, obligatorio
Respuestas
200 — The answer.{ type: "http", config: { url: string, method: "GET" | "HEAD" | "POST" | "PUT" | "PATCH" | "DELETE", followRedirects: boolean, expectedStatus: string[], keyword: string | null, keywordMustAppear: boolean, conditions: … | … | … | … | … | …[], conditionMode: "all" | "any", headers: { name: …, value: … }[], auth: { type: … } | { type: …, username: …, password: … } | { type: …, token: … }, body: { contentType: string, value: string } }, id: string, name: string, target: string, intervalSeconds: integer, timeoutSeconds: integer, paused: boolean, pausedUntil: string | null, status: "pending" | "passing" | "failing" | "down" | "paused" | "unknown", statusSince: string | null, pendingReason: { code: "no_probe_capability", missingCapability: "http" | "tcp" | "dns" | "http_secrets" | "icmp" | "udp" | "domain" | "ipv6" }, lastCheck: { at: string, class: "ok" | "fail", error: "dns_not_found" | "dns_failure" | "dns_timeout" | "connection_refused" | "connection_timeout" | "connection_reset" | "network_unreachable" | "tls_certificate_expired" | "tls_certificate_invalid" | "tls_hostname_mismatch" | "tls_handshake_failed" | "timeout" | "unexpected_status" | "too_many_redirects" | "invalid_redirect" | "destination_not_allowed" | "response_headers_too_large" | "protocol_error" | "keyword_not_found" | "keyword_found" | "json_invalid" | "json_path_missing" | "json_value_mismatch" | "json_too_large" | "header_missing" | "header_mismatch" | "final_url_mismatch" | "dns_no_records" | "dns_unexpected_answer" | "heartbeat_missed" | "no_reply" | "domain_expiring" | "domain_expired" | "lease_expired" | "rate_limited" | "expired" | "probe_overloaded" | "secret_unavailable" | "icmp_unavailable" | "domain_expiry_unknown" | "probe_no_ipv6" | "own_destination" | "self_check_failed", statusCode: integer | null, responseMs: integer | null }, certificate: { notBefore: string, notAfter: string, issuer: string, subject: string, sans: integer, seenAt: string, daysLeft: integer, state: "ok" | "attention" | "critical" | "expired" | "invalid" }, maintenance: { id: string, name: string, endsAt: string }, incident: { id: string, startedAt: string, confirmedAt: string, recovering: boolean, flapping: boolean }, notifications: { alertMembers: boolean, contactIds: string[], quietUntil: string | null, quietForever: boolean }, groupId: string | null, groupName: string | null, groupState: "operational" | "degraded" | "down" | "maintenance" | "unknown", tags: { id: string, name: string }[], nextCheckAt: string | null, heartbeat: { lastPingAt: string | null, dueAt: string | null }, createdAt: string, updatedAt: string } | { type: "tcp", config: { host: string, port: integer }, id: string, name: string, target: string, intervalSeconds: integer, timeoutSeconds: integer, paused: boolean, pausedUntil: string | null, status: "pending" | "passing" | "failing" | "down" | "paused" | "unknown", statusSince: string | null, pendingReason: { code: "no_probe_capability", missingCapability: "http" | "tcp" | "dns" | "http_secrets" | "icmp" | "udp" | "domain" | "ipv6" }, lastCheck: { at: string, class: "ok" | "fail", error: "dns_not_found" | "dns_failure" | "dns_timeout" | "connection_refused" | "connection_timeout" | "connection_reset" | "network_unreachable" | "tls_certificate_expired" | "tls_certificate_invalid" | "tls_hostname_mismatch" | "tls_handshake_failed" | "timeout" | "unexpected_status" | "too_many_redirects" | "invalid_redirect" | "destination_not_allowed" | "response_headers_too_large" | "protocol_error" | "keyword_not_found" | "keyword_found" | "json_invalid" | "json_path_missing" | "json_value_mismatch" | "json_too_large" | "header_missing" | "header_mismatch" | "final_url_mismatch" | "dns_no_records" | "dns_unexpected_answer" | "heartbeat_missed" | "no_reply" | "domain_expiring" | "domain_expired" | "lease_expired" | "rate_limited" | "expired" | "probe_overloaded" | "secret_unavailable" | "icmp_unavailable" | "domain_expiry_unknown" | "probe_no_ipv6" | "own_destination" | "self_check_failed", statusCode: integer | null, responseMs: integer | null }, certificate: { notBefore: string, notAfter: string, issuer: string, subject: string, sans: integer, seenAt: string, daysLeft: integer, state: "ok" | "attention" | "critical" | "expired" | "invalid" }, maintenance: { id: string, name: string, endsAt: string }, incident: { id: string, startedAt: string, confirmedAt: string, recovering: boolean, flapping: boolean }, notifications: { alertMembers: boolean, contactIds: string[], quietUntil: string | null, quietForever: boolean }, groupId: string | null, groupName: string | null, groupState: "operational" | "degraded" | "down" | "maintenance" | "unknown", tags: { id: string, name: string }[], nextCheckAt: string | null, heartbeat: { lastPingAt: string | null, dueAt: string | null }, createdAt: string, updatedAt: string } | { type: "dns", config: { name: string, recordType: "A" | "AAAA" | "CNAME" | "MX" | "TXT" | "NS", expected: string[], resolver: "system" | "cloudflare" | "google" | "quad9" | "opendns" }, id: string, name: string, target: string, intervalSeconds: integer, timeoutSeconds: integer, paused: boolean, pausedUntil: string | null, status: "pending" | "passing" | "failing" | "down" | "paused" | "unknown", statusSince: string | null, pendingReason: { code: "no_probe_capability", missingCapability: "http" | "tcp" | "dns" | "http_secrets" | "icmp" | "udp" | "domain" | "ipv6" }, lastCheck: { at: string, class: "ok" | "fail", error: "dns_not_found" | "dns_failure" | "dns_timeout" | "connection_refused" | "connection_timeout" | "connection_reset" | "network_unreachable" | "tls_certificate_expired" | "tls_certificate_invalid" | "tls_hostname_mismatch" | "tls_handshake_failed" | "timeout" | "unexpected_status" | "too_many_redirects" | "invalid_redirect" | "destination_not_allowed" | "response_headers_too_large" | "protocol_error" | "keyword_not_found" | "keyword_found" | "json_invalid" | "json_path_missing" | "json_value_mismatch" | "json_too_large" | "header_missing" | "header_mismatch" | "final_url_mismatch" | "dns_no_records" | "dns_unexpected_answer" | "heartbeat_missed" | "no_reply" | "domain_expiring" | "domain_expired" | "lease_expired" | "rate_limited" | "expired" | "probe_overloaded" | "secret_unavailable" | "icmp_unavailable" | "domain_expiry_unknown" | "probe_no_ipv6" | "own_destination" | "self_check_failed", statusCode: integer | null, responseMs: integer | null }, certificate: { notBefore: string, notAfter: string, issuer: string, subject: string, sans: integer, seenAt: string, daysLeft: integer, state: "ok" | "attention" | "critical" | "expired" | "invalid" }, maintenance: { id: string, name: string, endsAt: string }, incident: { id: string, startedAt: string, confirmedAt: string, recovering: boolean, flapping: boolean }, notifications: { alertMembers: boolean, contactIds: string[], quietUntil: string | null, quietForever: boolean }, groupId: string | null, groupName: string | null, groupState: "operational" | "degraded" | "down" | "maintenance" | "unknown", tags: { id: string, name: string }[], nextCheckAt: string | null, heartbeat: { lastPingAt: string | null, dueAt: string | null }, createdAt: string, updatedAt: string } | { type: "heartbeat", config: { periodSeconds: 60 | 120 | 300 | 600 | 900 | 1800 | 3600 | 7200 | 21600 | 43200 | 86400 | 604800 | 2592000, graceSeconds: integer }, id: string, name: string, target: string, intervalSeconds: integer, timeoutSeconds: integer, paused: boolean, pausedUntil: string | null, status: "pending" | "passing" | "failing" | "down" | "paused" | "unknown", statusSince: string | null, pendingReason: { code: "no_probe_capability", missingCapability: "http" | "tcp" | "dns" | "http_secrets" | "icmp" | "udp" | "domain" | "ipv6" }, lastCheck: { at: string, class: "ok" | "fail", error: "dns_not_found" | "dns_failure" | "dns_timeout" | "connection_refused" | "connection_timeout" | "connection_reset" | "network_unreachable" | "tls_certificate_expired" | "tls_certificate_invalid" | "tls_hostname_mismatch" | "tls_handshake_failed" | "timeout" | "unexpected_status" | "too_many_redirects" | "invalid_redirect" | "destination_not_allowed" | "response_headers_too_large" | "protocol_error" | "keyword_not_found" | "keyword_found" | "json_invalid" | "json_path_missing" | "json_value_mismatch" | "json_too_large" | "header_missing" | "header_mismatch" | "final_url_mismatch" | "dns_no_records" | "dns_unexpected_answer" | "heartbeat_missed" | "no_reply" | "domain_expiring" | "domain_expired" | "lease_expired" | "rate_limited" | "expired" | "probe_overloaded" | "secret_unavailable" | "icmp_unavailable" | "domain_expiry_unknown" | "probe_no_ipv6" | "own_destination" | "self_check_failed", statusCode: integer | null, responseMs: integer | null }, certificate: { notBefore: string, notAfter: string, issuer: string, subject: string, sans: integer, seenAt: string, daysLeft: integer, state: "ok" | "attention" | "critical" | "expired" | "invalid" }, maintenance: { id: string, name: string, endsAt: string }, incident: { id: string, startedAt: string, confirmedAt: string, recovering: boolean, flapping: boolean }, notifications: { alertMembers: boolean, contactIds: string[], quietUntil: string | null, quietForever: boolean }, groupId: string | null, groupName: string | null, groupState: "operational" | "degraded" | "down" | "maintenance" | "unknown", tags: { id: string, name: string }[], nextCheckAt: string | null, heartbeat: { lastPingAt: string | null, dueAt: string | null }, createdAt: string, updatedAt: string } | { type: "ping", config: { host: string }, id: string, name: string, target: string, intervalSeconds: integer, timeoutSeconds: integer, paused: boolean, pausedUntil: string | null, status: "pending" | "passing" | "failing" | "down" | "paused" | "unknown", statusSince: string | null, pendingReason: { code: "no_probe_capability", missingCapability: "http" | "tcp" | "dns" | "http_secrets" | "icmp" | "udp" | "domain" | "ipv6" }, lastCheck: { at: string, class: "ok" | "fail", error: "dns_not_found" | "dns_failure" | "dns_timeout" | "connection_refused" | "connection_timeout" | "connection_reset" | "network_unreachable" | "tls_certificate_expired" | "tls_certificate_invalid" | "tls_hostname_mismatch" | "tls_handshake_failed" | "timeout" | "unexpected_status" | "too_many_redirects" | "invalid_redirect" | "destination_not_allowed" | "response_headers_too_large" | "protocol_error" | "keyword_not_found" | "keyword_found" | "json_invalid" | "json_path_missing" | "json_value_mismatch" | "json_too_large" | "header_missing" | "header_mismatch" | "final_url_mismatch" | "dns_no_records" | "dns_unexpected_answer" | "heartbeat_missed" | "no_reply" | "domain_expiring" | "domain_expired" | "lease_expired" | "rate_limited" | "expired" | "probe_overloaded" | "secret_unavailable" | "icmp_unavailable" | "domain_expiry_unknown" | "probe_no_ipv6" | "own_destination" | "self_check_failed", statusCode: integer | null, responseMs: integer | null }, certificate: { notBefore: string, notAfter: string, issuer: string, subject: string, sans: integer, seenAt: string, daysLeft: integer, state: "ok" | "attention" | "critical" | "expired" | "invalid" }, maintenance: { id: string, name: string, endsAt: string }, incident: { id: string, startedAt: string, confirmedAt: string, recovering: boolean, flapping: boolean }, notifications: { alertMembers: boolean, contactIds: string[], quietUntil: string | null, quietForever: boolean }, groupId: string | null, groupName: string | null, groupState: "operational" | "degraded" | "down" | "maintenance" | "unknown", tags: { id: string, name: string }[], nextCheckAt: string | null, heartbeat: { lastPingAt: string | null, dueAt: string | null }, createdAt: string, updatedAt: string } | { type: "udp", config: { host: string, port: integer }, id: string, name: string, target: string, intervalSeconds: integer, timeoutSeconds: integer, paused: boolean, pausedUntil: string | null, status: "pending" | "passing" | "failing" | "down" | "paused" | "unknown", statusSince: string | null, pendingReason: { code: "no_probe_capability", missingCapability: "http" | "tcp" | "dns" | "http_secrets" | "icmp" | "udp" | "domain" | "ipv6" }, lastCheck: { at: string, class: "ok" | "fail", error: "dns_not_found" | "dns_failure" | "dns_timeout" | "connection_refused" | "connection_timeout" | "connection_reset" | "network_unreachable" | "tls_certificate_expired" | "tls_certificate_invalid" | "tls_hostname_mismatch" | "tls_handshake_failed" | "timeout" | "unexpected_status" | "too_many_redirects" | "invalid_redirect" | "destination_not_allowed" | "response_headers_too_large" | "protocol_error" | "keyword_not_found" | "keyword_found" | "json_invalid" | "json_path_missing" | "json_value_mismatch" | "json_too_large" | "header_missing" | "header_mismatch" | "final_url_mismatch" | "dns_no_records" | "dns_unexpected_answer" | "heartbeat_missed" | "no_reply" | "domain_expiring" | "domain_expired" | "lease_expired" | "rate_limited" | "expired" | "probe_overloaded" | "secret_unavailable" | "icmp_unavailable" | "domain_expiry_unknown" | "probe_no_ipv6" | "own_destination" | "self_check_failed", statusCode: integer | null, responseMs: integer | null }, certificate: { notBefore: string, notAfter: string, issuer: string, subject: string, sans: integer, seenAt: string, daysLeft: integer, state: "ok" | "attention" | "critical" | "expired" | "invalid" }, maintenance: { id: string, name: string, endsAt: string }, incident: { id: string, startedAt: string, confirmedAt: string, recovering: boolean, flapping: boolean }, notifications: { alertMembers: boolean, contactIds: string[], quietUntil: string | null, quietForever: boolean }, groupId: string | null, groupName: string | null, groupState: "operational" | "degraded" | "down" | "maintenance" | "unknown", tags: { id: string, name: string }[], nextCheckAt: string | null, heartbeat: { lastPingAt: string | null, dueAt: string | null }, createdAt: string, updatedAt: string } | { type: "domain", config: { domain: string }, id: string, name: string, target: string, intervalSeconds: integer, timeoutSeconds: integer, paused: boolean, pausedUntil: string | null, status: "pending" | "passing" | "failing" | "down" | "paused" | "unknown", statusSince: string | null, pendingReason: { code: "no_probe_capability", missingCapability: "http" | "tcp" | "dns" | "http_secrets" | "icmp" | "udp" | "domain" | "ipv6" }, lastCheck: { at: string, class: "ok" | "fail", error: "dns_not_found" | "dns_failure" | "dns_timeout" | "connection_refused" | "connection_timeout" | "connection_reset" | "network_unreachable" | "tls_certificate_expired" | "tls_certificate_invalid" | "tls_hostname_mismatch" | "tls_handshake_failed" | "timeout" | "unexpected_status" | "too_many_redirects" | "invalid_redirect" | "destination_not_allowed" | "response_headers_too_large" | "protocol_error" | "keyword_not_found" | "keyword_found" | "json_invalid" | "json_path_missing" | "json_value_mismatch" | "json_too_large" | "header_missing" | "header_mismatch" | "final_url_mismatch" | "dns_no_records" | "dns_unexpected_answer" | "heartbeat_missed" | "no_reply" | "domain_expiring" | "domain_expired" | "lease_expired" | "rate_limited" | "expired" | "probe_overloaded" | "secret_unavailable" | "icmp_unavailable" | "domain_expiry_unknown" | "probe_no_ipv6" | "own_destination" | "self_check_failed", statusCode: integer | null, responseMs: integer | null }, certificate: { notBefore: string, notAfter: string, issuer: string, subject: string, sans: integer, seenAt: string, daysLeft: integer, state: "ok" | "attention" | "critical" | "expired" | "invalid" }, maintenance: { id: string, name: string, endsAt: string }, incident: { id: string, startedAt: string, confirmedAt: string, recovering: boolean, flapping: boolean }, notifications: { alertMembers: boolean, contactIds: string[], quietUntil: string | null, quietForever: boolean }, groupId: string | null, groupName: string | null, groupState: "operational" | "degraded" | "down" | "maintenance" | "unknown", tags: { id: string, name: string }[], nextCheckAt: string | null, heartbeat: { lastPingAt: string | null, dueAt: string | null }, createdAt: string, updatedAt: string }
401 — One of: auth.unauthenticated.403 — One of: request.host_not_allowed, permission.denied.404 — One of: monitor.not_found.429 — One of: request.rate_limited.
Ejemplo
curl -X POST "https://api.nuvostatus.com/v1/monitors/0199e6a0-0000-7000-8000-000000000001/pause" \
-H "Authorization: Bearer $NUVOSTATUS_KEY"
Resume a monitor
POST /v1/monitors/{id}/resumeÁmbito: write
Checks start again at once, with nothing assumed of what was found before the pause.
Parámetros
id — en la ruta, obligatorio
Respuestas
200 — The answer.{ type: "http", config: { url: string, method: "GET" | "HEAD" | "POST" | "PUT" | "PATCH" | "DELETE", followRedirects: boolean, expectedStatus: string[], keyword: string | null, keywordMustAppear: boolean, conditions: … | … | … | … | … | …[], conditionMode: "all" | "any", headers: { name: …, value: … }[], auth: { type: … } | { type: …, username: …, password: … } | { type: …, token: … }, body: { contentType: string, value: string } }, id: string, name: string, target: string, intervalSeconds: integer, timeoutSeconds: integer, paused: boolean, pausedUntil: string | null, status: "pending" | "passing" | "failing" | "down" | "paused" | "unknown", statusSince: string | null, pendingReason: { code: "no_probe_capability", missingCapability: "http" | "tcp" | "dns" | "http_secrets" | "icmp" | "udp" | "domain" | "ipv6" }, lastCheck: { at: string, class: "ok" | "fail", error: "dns_not_found" | "dns_failure" | "dns_timeout" | "connection_refused" | "connection_timeout" | "connection_reset" | "network_unreachable" | "tls_certificate_expired" | "tls_certificate_invalid" | "tls_hostname_mismatch" | "tls_handshake_failed" | "timeout" | "unexpected_status" | "too_many_redirects" | "invalid_redirect" | "destination_not_allowed" | "response_headers_too_large" | "protocol_error" | "keyword_not_found" | "keyword_found" | "json_invalid" | "json_path_missing" | "json_value_mismatch" | "json_too_large" | "header_missing" | "header_mismatch" | "final_url_mismatch" | "dns_no_records" | "dns_unexpected_answer" | "heartbeat_missed" | "no_reply" | "domain_expiring" | "domain_expired" | "lease_expired" | "rate_limited" | "expired" | "probe_overloaded" | "secret_unavailable" | "icmp_unavailable" | "domain_expiry_unknown" | "probe_no_ipv6" | "own_destination" | "self_check_failed", statusCode: integer | null, responseMs: integer | null }, certificate: { notBefore: string, notAfter: string, issuer: string, subject: string, sans: integer, seenAt: string, daysLeft: integer, state: "ok" | "attention" | "critical" | "expired" | "invalid" }, maintenance: { id: string, name: string, endsAt: string }, incident: { id: string, startedAt: string, confirmedAt: string, recovering: boolean, flapping: boolean }, notifications: { alertMembers: boolean, contactIds: string[], quietUntil: string | null, quietForever: boolean }, groupId: string | null, groupName: string | null, groupState: "operational" | "degraded" | "down" | "maintenance" | "unknown", tags: { id: string, name: string }[], nextCheckAt: string | null, heartbeat: { lastPingAt: string | null, dueAt: string | null }, createdAt: string, updatedAt: string } | { type: "tcp", config: { host: string, port: integer }, id: string, name: string, target: string, intervalSeconds: integer, timeoutSeconds: integer, paused: boolean, pausedUntil: string | null, status: "pending" | "passing" | "failing" | "down" | "paused" | "unknown", statusSince: string | null, pendingReason: { code: "no_probe_capability", missingCapability: "http" | "tcp" | "dns" | "http_secrets" | "icmp" | "udp" | "domain" | "ipv6" }, lastCheck: { at: string, class: "ok" | "fail", error: "dns_not_found" | "dns_failure" | "dns_timeout" | "connection_refused" | "connection_timeout" | "connection_reset" | "network_unreachable" | "tls_certificate_expired" | "tls_certificate_invalid" | "tls_hostname_mismatch" | "tls_handshake_failed" | "timeout" | "unexpected_status" | "too_many_redirects" | "invalid_redirect" | "destination_not_allowed" | "response_headers_too_large" | "protocol_error" | "keyword_not_found" | "keyword_found" | "json_invalid" | "json_path_missing" | "json_value_mismatch" | "json_too_large" | "header_missing" | "header_mismatch" | "final_url_mismatch" | "dns_no_records" | "dns_unexpected_answer" | "heartbeat_missed" | "no_reply" | "domain_expiring" | "domain_expired" | "lease_expired" | "rate_limited" | "expired" | "probe_overloaded" | "secret_unavailable" | "icmp_unavailable" | "domain_expiry_unknown" | "probe_no_ipv6" | "own_destination" | "self_check_failed", statusCode: integer | null, responseMs: integer | null }, certificate: { notBefore: string, notAfter: string, issuer: string, subject: string, sans: integer, seenAt: string, daysLeft: integer, state: "ok" | "attention" | "critical" | "expired" | "invalid" }, maintenance: { id: string, name: string, endsAt: string }, incident: { id: string, startedAt: string, confirmedAt: string, recovering: boolean, flapping: boolean }, notifications: { alertMembers: boolean, contactIds: string[], quietUntil: string | null, quietForever: boolean }, groupId: string | null, groupName: string | null, groupState: "operational" | "degraded" | "down" | "maintenance" | "unknown", tags: { id: string, name: string }[], nextCheckAt: string | null, heartbeat: { lastPingAt: string | null, dueAt: string | null }, createdAt: string, updatedAt: string } | { type: "dns", config: { name: string, recordType: "A" | "AAAA" | "CNAME" | "MX" | "TXT" | "NS", expected: string[], resolver: "system" | "cloudflare" | "google" | "quad9" | "opendns" }, id: string, name: string, target: string, intervalSeconds: integer, timeoutSeconds: integer, paused: boolean, pausedUntil: string | null, status: "pending" | "passing" | "failing" | "down" | "paused" | "unknown", statusSince: string | null, pendingReason: { code: "no_probe_capability", missingCapability: "http" | "tcp" | "dns" | "http_secrets" | "icmp" | "udp" | "domain" | "ipv6" }, lastCheck: { at: string, class: "ok" | "fail", error: "dns_not_found" | "dns_failure" | "dns_timeout" | "connection_refused" | "connection_timeout" | "connection_reset" | "network_unreachable" | "tls_certificate_expired" | "tls_certificate_invalid" | "tls_hostname_mismatch" | "tls_handshake_failed" | "timeout" | "unexpected_status" | "too_many_redirects" | "invalid_redirect" | "destination_not_allowed" | "response_headers_too_large" | "protocol_error" | "keyword_not_found" | "keyword_found" | "json_invalid" | "json_path_missing" | "json_value_mismatch" | "json_too_large" | "header_missing" | "header_mismatch" | "final_url_mismatch" | "dns_no_records" | "dns_unexpected_answer" | "heartbeat_missed" | "no_reply" | "domain_expiring" | "domain_expired" | "lease_expired" | "rate_limited" | "expired" | "probe_overloaded" | "secret_unavailable" | "icmp_unavailable" | "domain_expiry_unknown" | "probe_no_ipv6" | "own_destination" | "self_check_failed", statusCode: integer | null, responseMs: integer | null }, certificate: { notBefore: string, notAfter: string, issuer: string, subject: string, sans: integer, seenAt: string, daysLeft: integer, state: "ok" | "attention" | "critical" | "expired" | "invalid" }, maintenance: { id: string, name: string, endsAt: string }, incident: { id: string, startedAt: string, confirmedAt: string, recovering: boolean, flapping: boolean }, notifications: { alertMembers: boolean, contactIds: string[], quietUntil: string | null, quietForever: boolean }, groupId: string | null, groupName: string | null, groupState: "operational" | "degraded" | "down" | "maintenance" | "unknown", tags: { id: string, name: string }[], nextCheckAt: string | null, heartbeat: { lastPingAt: string | null, dueAt: string | null }, createdAt: string, updatedAt: string } | { type: "heartbeat", config: { periodSeconds: 60 | 120 | 300 | 600 | 900 | 1800 | 3600 | 7200 | 21600 | 43200 | 86400 | 604800 | 2592000, graceSeconds: integer }, id: string, name: string, target: string, intervalSeconds: integer, timeoutSeconds: integer, paused: boolean, pausedUntil: string | null, status: "pending" | "passing" | "failing" | "down" | "paused" | "unknown", statusSince: string | null, pendingReason: { code: "no_probe_capability", missingCapability: "http" | "tcp" | "dns" | "http_secrets" | "icmp" | "udp" | "domain" | "ipv6" }, lastCheck: { at: string, class: "ok" | "fail", error: "dns_not_found" | "dns_failure" | "dns_timeout" | "connection_refused" | "connection_timeout" | "connection_reset" | "network_unreachable" | "tls_certificate_expired" | "tls_certificate_invalid" | "tls_hostname_mismatch" | "tls_handshake_failed" | "timeout" | "unexpected_status" | "too_many_redirects" | "invalid_redirect" | "destination_not_allowed" | "response_headers_too_large" | "protocol_error" | "keyword_not_found" | "keyword_found" | "json_invalid" | "json_path_missing" | "json_value_mismatch" | "json_too_large" | "header_missing" | "header_mismatch" | "final_url_mismatch" | "dns_no_records" | "dns_unexpected_answer" | "heartbeat_missed" | "no_reply" | "domain_expiring" | "domain_expired" | "lease_expired" | "rate_limited" | "expired" | "probe_overloaded" | "secret_unavailable" | "icmp_unavailable" | "domain_expiry_unknown" | "probe_no_ipv6" | "own_destination" | "self_check_failed", statusCode: integer | null, responseMs: integer | null }, certificate: { notBefore: string, notAfter: string, issuer: string, subject: string, sans: integer, seenAt: string, daysLeft: integer, state: "ok" | "attention" | "critical" | "expired" | "invalid" }, maintenance: { id: string, name: string, endsAt: string }, incident: { id: string, startedAt: string, confirmedAt: string, recovering: boolean, flapping: boolean }, notifications: { alertMembers: boolean, contactIds: string[], quietUntil: string | null, quietForever: boolean }, groupId: string | null, groupName: string | null, groupState: "operational" | "degraded" | "down" | "maintenance" | "unknown", tags: { id: string, name: string }[], nextCheckAt: string | null, heartbeat: { lastPingAt: string | null, dueAt: string | null }, createdAt: string, updatedAt: string } | { type: "ping", config: { host: string }, id: string, name: string, target: string, intervalSeconds: integer, timeoutSeconds: integer, paused: boolean, pausedUntil: string | null, status: "pending" | "passing" | "failing" | "down" | "paused" | "unknown", statusSince: string | null, pendingReason: { code: "no_probe_capability", missingCapability: "http" | "tcp" | "dns" | "http_secrets" | "icmp" | "udp" | "domain" | "ipv6" }, lastCheck: { at: string, class: "ok" | "fail", error: "dns_not_found" | "dns_failure" | "dns_timeout" | "connection_refused" | "connection_timeout" | "connection_reset" | "network_unreachable" | "tls_certificate_expired" | "tls_certificate_invalid" | "tls_hostname_mismatch" | "tls_handshake_failed" | "timeout" | "unexpected_status" | "too_many_redirects" | "invalid_redirect" | "destination_not_allowed" | "response_headers_too_large" | "protocol_error" | "keyword_not_found" | "keyword_found" | "json_invalid" | "json_path_missing" | "json_value_mismatch" | "json_too_large" | "header_missing" | "header_mismatch" | "final_url_mismatch" | "dns_no_records" | "dns_unexpected_answer" | "heartbeat_missed" | "no_reply" | "domain_expiring" | "domain_expired" | "lease_expired" | "rate_limited" | "expired" | "probe_overloaded" | "secret_unavailable" | "icmp_unavailable" | "domain_expiry_unknown" | "probe_no_ipv6" | "own_destination" | "self_check_failed", statusCode: integer | null, responseMs: integer | null }, certificate: { notBefore: string, notAfter: string, issuer: string, subject: string, sans: integer, seenAt: string, daysLeft: integer, state: "ok" | "attention" | "critical" | "expired" | "invalid" }, maintenance: { id: string, name: string, endsAt: string }, incident: { id: string, startedAt: string, confirmedAt: string, recovering: boolean, flapping: boolean }, notifications: { alertMembers: boolean, contactIds: string[], quietUntil: string | null, quietForever: boolean }, groupId: string | null, groupName: string | null, groupState: "operational" | "degraded" | "down" | "maintenance" | "unknown", tags: { id: string, name: string }[], nextCheckAt: string | null, heartbeat: { lastPingAt: string | null, dueAt: string | null }, createdAt: string, updatedAt: string } | { type: "udp", config: { host: string, port: integer }, id: string, name: string, target: string, intervalSeconds: integer, timeoutSeconds: integer, paused: boolean, pausedUntil: string | null, status: "pending" | "passing" | "failing" | "down" | "paused" | "unknown", statusSince: string | null, pendingReason: { code: "no_probe_capability", missingCapability: "http" | "tcp" | "dns" | "http_secrets" | "icmp" | "udp" | "domain" | "ipv6" }, lastCheck: { at: string, class: "ok" | "fail", error: "dns_not_found" | "dns_failure" | "dns_timeout" | "connection_refused" | "connection_timeout" | "connection_reset" | "network_unreachable" | "tls_certificate_expired" | "tls_certificate_invalid" | "tls_hostname_mismatch" | "tls_handshake_failed" | "timeout" | "unexpected_status" | "too_many_redirects" | "invalid_redirect" | "destination_not_allowed" | "response_headers_too_large" | "protocol_error" | "keyword_not_found" | "keyword_found" | "json_invalid" | "json_path_missing" | "json_value_mismatch" | "json_too_large" | "header_missing" | "header_mismatch" | "final_url_mismatch" | "dns_no_records" | "dns_unexpected_answer" | "heartbeat_missed" | "no_reply" | "domain_expiring" | "domain_expired" | "lease_expired" | "rate_limited" | "expired" | "probe_overloaded" | "secret_unavailable" | "icmp_unavailable" | "domain_expiry_unknown" | "probe_no_ipv6" | "own_destination" | "self_check_failed", statusCode: integer | null, responseMs: integer | null }, certificate: { notBefore: string, notAfter: string, issuer: string, subject: string, sans: integer, seenAt: string, daysLeft: integer, state: "ok" | "attention" | "critical" | "expired" | "invalid" }, maintenance: { id: string, name: string, endsAt: string }, incident: { id: string, startedAt: string, confirmedAt: string, recovering: boolean, flapping: boolean }, notifications: { alertMembers: boolean, contactIds: string[], quietUntil: string | null, quietForever: boolean }, groupId: string | null, groupName: string | null, groupState: "operational" | "degraded" | "down" | "maintenance" | "unknown", tags: { id: string, name: string }[], nextCheckAt: string | null, heartbeat: { lastPingAt: string | null, dueAt: string | null }, createdAt: string, updatedAt: string } | { type: "domain", config: { domain: string }, id: string, name: string, target: string, intervalSeconds: integer, timeoutSeconds: integer, paused: boolean, pausedUntil: string | null, status: "pending" | "passing" | "failing" | "down" | "paused" | "unknown", statusSince: string | null, pendingReason: { code: "no_probe_capability", missingCapability: "http" | "tcp" | "dns" | "http_secrets" | "icmp" | "udp" | "domain" | "ipv6" }, lastCheck: { at: string, class: "ok" | "fail", error: "dns_not_found" | "dns_failure" | "dns_timeout" | "connection_refused" | "connection_timeout" | "connection_reset" | "network_unreachable" | "tls_certificate_expired" | "tls_certificate_invalid" | "tls_hostname_mismatch" | "tls_handshake_failed" | "timeout" | "unexpected_status" | "too_many_redirects" | "invalid_redirect" | "destination_not_allowed" | "response_headers_too_large" | "protocol_error" | "keyword_not_found" | "keyword_found" | "json_invalid" | "json_path_missing" | "json_value_mismatch" | "json_too_large" | "header_missing" | "header_mismatch" | "final_url_mismatch" | "dns_no_records" | "dns_unexpected_answer" | "heartbeat_missed" | "no_reply" | "domain_expiring" | "domain_expired" | "lease_expired" | "rate_limited" | "expired" | "probe_overloaded" | "secret_unavailable" | "icmp_unavailable" | "domain_expiry_unknown" | "probe_no_ipv6" | "own_destination" | "self_check_failed", statusCode: integer | null, responseMs: integer | null }, certificate: { notBefore: string, notAfter: string, issuer: string, subject: string, sans: integer, seenAt: string, daysLeft: integer, state: "ok" | "attention" | "critical" | "expired" | "invalid" }, maintenance: { id: string, name: string, endsAt: string }, incident: { id: string, startedAt: string, confirmedAt: string, recovering: boolean, flapping: boolean }, notifications: { alertMembers: boolean, contactIds: string[], quietUntil: string | null, quietForever: boolean }, groupId: string | null, groupName: string | null, groupState: "operational" | "degraded" | "down" | "maintenance" | "unknown", tags: { id: string, name: string }[], nextCheckAt: string | null, heartbeat: { lastPingAt: string | null, dueAt: string | null }, createdAt: string, updatedAt: string }
401 — One of: auth.unauthenticated.403 — One of: request.host_not_allowed, permission.denied.404 — One of: monitor.not_found.429 — One of: request.rate_limited.
Ejemplo
curl -X POST "https://api.nuvostatus.com/v1/monitors/0199e6a0-0000-7000-8000-000000000001/resume" \
-H "Authorization: Bearer $NUVOSTATUS_KEY"
Delete a monitor
DELETE /v1/monitors/{id}Ámbito: write
The monitor is gone from every answer, and can be brought back with `/restore` for thirty days. After that the worker removes it and its data for good.
Parámetros
id — en la ruta, obligatorio
Respuestas
204 — Done; no body.401 — One of: auth.unauthenticated.403 — One of: request.host_not_allowed, permission.denied.404 — One of: monitor.not_found.429 — One of: request.rate_limited.
Ejemplo
curl -X DELETE "https://api.nuvostatus.com/v1/monitors/0199e6a0-0000-7000-8000-000000000001" \
-H "Authorization: Bearer $NUVOSTATUS_KEY"
Restore a deleted monitor
POST /v1/monitors/{id}/restoreÁmbito: write
Brings a monitor back from the trash, exactly as it was, within thirty days of its deletion and only if the plan has room. A paused monitor comes back paused; any other is due at once. An older one, or one that was never deleted, is refused.
Parámetros
id — en la ruta, obligatorio
Respuestas
200 — The answer.{ type: "http", config: { url: string, method: "GET" | "HEAD" | "POST" | "PUT" | "PATCH" | "DELETE", followRedirects: boolean, expectedStatus: string[], keyword: string | null, keywordMustAppear: boolean, conditions: … | … | … | … | … | …[], conditionMode: "all" | "any", headers: { name: …, value: … }[], auth: { type: … } | { type: …, username: …, password: … } | { type: …, token: … }, body: { contentType: string, value: string } }, id: string, name: string, target: string, intervalSeconds: integer, timeoutSeconds: integer, paused: boolean, pausedUntil: string | null, status: "pending" | "passing" | "failing" | "down" | "paused" | "unknown", statusSince: string | null, pendingReason: { code: "no_probe_capability", missingCapability: "http" | "tcp" | "dns" | "http_secrets" | "icmp" | "udp" | "domain" | "ipv6" }, lastCheck: { at: string, class: "ok" | "fail", error: "dns_not_found" | "dns_failure" | "dns_timeout" | "connection_refused" | "connection_timeout" | "connection_reset" | "network_unreachable" | "tls_certificate_expired" | "tls_certificate_invalid" | "tls_hostname_mismatch" | "tls_handshake_failed" | "timeout" | "unexpected_status" | "too_many_redirects" | "invalid_redirect" | "destination_not_allowed" | "response_headers_too_large" | "protocol_error" | "keyword_not_found" | "keyword_found" | "json_invalid" | "json_path_missing" | "json_value_mismatch" | "json_too_large" | "header_missing" | "header_mismatch" | "final_url_mismatch" | "dns_no_records" | "dns_unexpected_answer" | "heartbeat_missed" | "no_reply" | "domain_expiring" | "domain_expired" | "lease_expired" | "rate_limited" | "expired" | "probe_overloaded" | "secret_unavailable" | "icmp_unavailable" | "domain_expiry_unknown" | "probe_no_ipv6" | "own_destination" | "self_check_failed", statusCode: integer | null, responseMs: integer | null }, certificate: { notBefore: string, notAfter: string, issuer: string, subject: string, sans: integer, seenAt: string, daysLeft: integer, state: "ok" | "attention" | "critical" | "expired" | "invalid" }, maintenance: { id: string, name: string, endsAt: string }, incident: { id: string, startedAt: string, confirmedAt: string, recovering: boolean, flapping: boolean }, notifications: { alertMembers: boolean, contactIds: string[], quietUntil: string | null, quietForever: boolean }, groupId: string | null, groupName: string | null, groupState: "operational" | "degraded" | "down" | "maintenance" | "unknown", tags: { id: string, name: string }[], nextCheckAt: string | null, heartbeat: { lastPingAt: string | null, dueAt: string | null }, createdAt: string, updatedAt: string } | { type: "tcp", config: { host: string, port: integer }, id: string, name: string, target: string, intervalSeconds: integer, timeoutSeconds: integer, paused: boolean, pausedUntil: string | null, status: "pending" | "passing" | "failing" | "down" | "paused" | "unknown", statusSince: string | null, pendingReason: { code: "no_probe_capability", missingCapability: "http" | "tcp" | "dns" | "http_secrets" | "icmp" | "udp" | "domain" | "ipv6" }, lastCheck: { at: string, class: "ok" | "fail", error: "dns_not_found" | "dns_failure" | "dns_timeout" | "connection_refused" | "connection_timeout" | "connection_reset" | "network_unreachable" | "tls_certificate_expired" | "tls_certificate_invalid" | "tls_hostname_mismatch" | "tls_handshake_failed" | "timeout" | "unexpected_status" | "too_many_redirects" | "invalid_redirect" | "destination_not_allowed" | "response_headers_too_large" | "protocol_error" | "keyword_not_found" | "keyword_found" | "json_invalid" | "json_path_missing" | "json_value_mismatch" | "json_too_large" | "header_missing" | "header_mismatch" | "final_url_mismatch" | "dns_no_records" | "dns_unexpected_answer" | "heartbeat_missed" | "no_reply" | "domain_expiring" | "domain_expired" | "lease_expired" | "rate_limited" | "expired" | "probe_overloaded" | "secret_unavailable" | "icmp_unavailable" | "domain_expiry_unknown" | "probe_no_ipv6" | "own_destination" | "self_check_failed", statusCode: integer | null, responseMs: integer | null }, certificate: { notBefore: string, notAfter: string, issuer: string, subject: string, sans: integer, seenAt: string, daysLeft: integer, state: "ok" | "attention" | "critical" | "expired" | "invalid" }, maintenance: { id: string, name: string, endsAt: string }, incident: { id: string, startedAt: string, confirmedAt: string, recovering: boolean, flapping: boolean }, notifications: { alertMembers: boolean, contactIds: string[], quietUntil: string | null, quietForever: boolean }, groupId: string | null, groupName: string | null, groupState: "operational" | "degraded" | "down" | "maintenance" | "unknown", tags: { id: string, name: string }[], nextCheckAt: string | null, heartbeat: { lastPingAt: string | null, dueAt: string | null }, createdAt: string, updatedAt: string } | { type: "dns", config: { name: string, recordType: "A" | "AAAA" | "CNAME" | "MX" | "TXT" | "NS", expected: string[], resolver: "system" | "cloudflare" | "google" | "quad9" | "opendns" }, id: string, name: string, target: string, intervalSeconds: integer, timeoutSeconds: integer, paused: boolean, pausedUntil: string | null, status: "pending" | "passing" | "failing" | "down" | "paused" | "unknown", statusSince: string | null, pendingReason: { code: "no_probe_capability", missingCapability: "http" | "tcp" | "dns" | "http_secrets" | "icmp" | "udp" | "domain" | "ipv6" }, lastCheck: { at: string, class: "ok" | "fail", error: "dns_not_found" | "dns_failure" | "dns_timeout" | "connection_refused" | "connection_timeout" | "connection_reset" | "network_unreachable" | "tls_certificate_expired" | "tls_certificate_invalid" | "tls_hostname_mismatch" | "tls_handshake_failed" | "timeout" | "unexpected_status" | "too_many_redirects" | "invalid_redirect" | "destination_not_allowed" | "response_headers_too_large" | "protocol_error" | "keyword_not_found" | "keyword_found" | "json_invalid" | "json_path_missing" | "json_value_mismatch" | "json_too_large" | "header_missing" | "header_mismatch" | "final_url_mismatch" | "dns_no_records" | "dns_unexpected_answer" | "heartbeat_missed" | "no_reply" | "domain_expiring" | "domain_expired" | "lease_expired" | "rate_limited" | "expired" | "probe_overloaded" | "secret_unavailable" | "icmp_unavailable" | "domain_expiry_unknown" | "probe_no_ipv6" | "own_destination" | "self_check_failed", statusCode: integer | null, responseMs: integer | null }, certificate: { notBefore: string, notAfter: string, issuer: string, subject: string, sans: integer, seenAt: string, daysLeft: integer, state: "ok" | "attention" | "critical" | "expired" | "invalid" }, maintenance: { id: string, name: string, endsAt: string }, incident: { id: string, startedAt: string, confirmedAt: string, recovering: boolean, flapping: boolean }, notifications: { alertMembers: boolean, contactIds: string[], quietUntil: string | null, quietForever: boolean }, groupId: string | null, groupName: string | null, groupState: "operational" | "degraded" | "down" | "maintenance" | "unknown", tags: { id: string, name: string }[], nextCheckAt: string | null, heartbeat: { lastPingAt: string | null, dueAt: string | null }, createdAt: string, updatedAt: string } | { type: "heartbeat", config: { periodSeconds: 60 | 120 | 300 | 600 | 900 | 1800 | 3600 | 7200 | 21600 | 43200 | 86400 | 604800 | 2592000, graceSeconds: integer }, id: string, name: string, target: string, intervalSeconds: integer, timeoutSeconds: integer, paused: boolean, pausedUntil: string | null, status: "pending" | "passing" | "failing" | "down" | "paused" | "unknown", statusSince: string | null, pendingReason: { code: "no_probe_capability", missingCapability: "http" | "tcp" | "dns" | "http_secrets" | "icmp" | "udp" | "domain" | "ipv6" }, lastCheck: { at: string, class: "ok" | "fail", error: "dns_not_found" | "dns_failure" | "dns_timeout" | "connection_refused" | "connection_timeout" | "connection_reset" | "network_unreachable" | "tls_certificate_expired" | "tls_certificate_invalid" | "tls_hostname_mismatch" | "tls_handshake_failed" | "timeout" | "unexpected_status" | "too_many_redirects" | "invalid_redirect" | "destination_not_allowed" | "response_headers_too_large" | "protocol_error" | "keyword_not_found" | "keyword_found" | "json_invalid" | "json_path_missing" | "json_value_mismatch" | "json_too_large" | "header_missing" | "header_mismatch" | "final_url_mismatch" | "dns_no_records" | "dns_unexpected_answer" | "heartbeat_missed" | "no_reply" | "domain_expiring" | "domain_expired" | "lease_expired" | "rate_limited" | "expired" | "probe_overloaded" | "secret_unavailable" | "icmp_unavailable" | "domain_expiry_unknown" | "probe_no_ipv6" | "own_destination" | "self_check_failed", statusCode: integer | null, responseMs: integer | null }, certificate: { notBefore: string, notAfter: string, issuer: string, subject: string, sans: integer, seenAt: string, daysLeft: integer, state: "ok" | "attention" | "critical" | "expired" | "invalid" }, maintenance: { id: string, name: string, endsAt: string }, incident: { id: string, startedAt: string, confirmedAt: string, recovering: boolean, flapping: boolean }, notifications: { alertMembers: boolean, contactIds: string[], quietUntil: string | null, quietForever: boolean }, groupId: string | null, groupName: string | null, groupState: "operational" | "degraded" | "down" | "maintenance" | "unknown", tags: { id: string, name: string }[], nextCheckAt: string | null, heartbeat: { lastPingAt: string | null, dueAt: string | null }, createdAt: string, updatedAt: string } | { type: "ping", config: { host: string }, id: string, name: string, target: string, intervalSeconds: integer, timeoutSeconds: integer, paused: boolean, pausedUntil: string | null, status: "pending" | "passing" | "failing" | "down" | "paused" | "unknown", statusSince: string | null, pendingReason: { code: "no_probe_capability", missingCapability: "http" | "tcp" | "dns" | "http_secrets" | "icmp" | "udp" | "domain" | "ipv6" }, lastCheck: { at: string, class: "ok" | "fail", error: "dns_not_found" | "dns_failure" | "dns_timeout" | "connection_refused" | "connection_timeout" | "connection_reset" | "network_unreachable" | "tls_certificate_expired" | "tls_certificate_invalid" | "tls_hostname_mismatch" | "tls_handshake_failed" | "timeout" | "unexpected_status" | "too_many_redirects" | "invalid_redirect" | "destination_not_allowed" | "response_headers_too_large" | "protocol_error" | "keyword_not_found" | "keyword_found" | "json_invalid" | "json_path_missing" | "json_value_mismatch" | "json_too_large" | "header_missing" | "header_mismatch" | "final_url_mismatch" | "dns_no_records" | "dns_unexpected_answer" | "heartbeat_missed" | "no_reply" | "domain_expiring" | "domain_expired" | "lease_expired" | "rate_limited" | "expired" | "probe_overloaded" | "secret_unavailable" | "icmp_unavailable" | "domain_expiry_unknown" | "probe_no_ipv6" | "own_destination" | "self_check_failed", statusCode: integer | null, responseMs: integer | null }, certificate: { notBefore: string, notAfter: string, issuer: string, subject: string, sans: integer, seenAt: string, daysLeft: integer, state: "ok" | "attention" | "critical" | "expired" | "invalid" }, maintenance: { id: string, name: string, endsAt: string }, incident: { id: string, startedAt: string, confirmedAt: string, recovering: boolean, flapping: boolean }, notifications: { alertMembers: boolean, contactIds: string[], quietUntil: string | null, quietForever: boolean }, groupId: string | null, groupName: string | null, groupState: "operational" | "degraded" | "down" | "maintenance" | "unknown", tags: { id: string, name: string }[], nextCheckAt: string | null, heartbeat: { lastPingAt: string | null, dueAt: string | null }, createdAt: string, updatedAt: string } | { type: "udp", config: { host: string, port: integer }, id: string, name: string, target: string, intervalSeconds: integer, timeoutSeconds: integer, paused: boolean, pausedUntil: string | null, status: "pending" | "passing" | "failing" | "down" | "paused" | "unknown", statusSince: string | null, pendingReason: { code: "no_probe_capability", missingCapability: "http" | "tcp" | "dns" | "http_secrets" | "icmp" | "udp" | "domain" | "ipv6" }, lastCheck: { at: string, class: "ok" | "fail", error: "dns_not_found" | "dns_failure" | "dns_timeout" | "connection_refused" | "connection_timeout" | "connection_reset" | "network_unreachable" | "tls_certificate_expired" | "tls_certificate_invalid" | "tls_hostname_mismatch" | "tls_handshake_failed" | "timeout" | "unexpected_status" | "too_many_redirects" | "invalid_redirect" | "destination_not_allowed" | "response_headers_too_large" | "protocol_error" | "keyword_not_found" | "keyword_found" | "json_invalid" | "json_path_missing" | "json_value_mismatch" | "json_too_large" | "header_missing" | "header_mismatch" | "final_url_mismatch" | "dns_no_records" | "dns_unexpected_answer" | "heartbeat_missed" | "no_reply" | "domain_expiring" | "domain_expired" | "lease_expired" | "rate_limited" | "expired" | "probe_overloaded" | "secret_unavailable" | "icmp_unavailable" | "domain_expiry_unknown" | "probe_no_ipv6" | "own_destination" | "self_check_failed", statusCode: integer | null, responseMs: integer | null }, certificate: { notBefore: string, notAfter: string, issuer: string, subject: string, sans: integer, seenAt: string, daysLeft: integer, state: "ok" | "attention" | "critical" | "expired" | "invalid" }, maintenance: { id: string, name: string, endsAt: string }, incident: { id: string, startedAt: string, confirmedAt: string, recovering: boolean, flapping: boolean }, notifications: { alertMembers: boolean, contactIds: string[], quietUntil: string | null, quietForever: boolean }, groupId: string | null, groupName: string | null, groupState: "operational" | "degraded" | "down" | "maintenance" | "unknown", tags: { id: string, name: string }[], nextCheckAt: string | null, heartbeat: { lastPingAt: string | null, dueAt: string | null }, createdAt: string, updatedAt: string } | { type: "domain", config: { domain: string }, id: string, name: string, target: string, intervalSeconds: integer, timeoutSeconds: integer, paused: boolean, pausedUntil: string | null, status: "pending" | "passing" | "failing" | "down" | "paused" | "unknown", statusSince: string | null, pendingReason: { code: "no_probe_capability", missingCapability: "http" | "tcp" | "dns" | "http_secrets" | "icmp" | "udp" | "domain" | "ipv6" }, lastCheck: { at: string, class: "ok" | "fail", error: "dns_not_found" | "dns_failure" | "dns_timeout" | "connection_refused" | "connection_timeout" | "connection_reset" | "network_unreachable" | "tls_certificate_expired" | "tls_certificate_invalid" | "tls_hostname_mismatch" | "tls_handshake_failed" | "timeout" | "unexpected_status" | "too_many_redirects" | "invalid_redirect" | "destination_not_allowed" | "response_headers_too_large" | "protocol_error" | "keyword_not_found" | "keyword_found" | "json_invalid" | "json_path_missing" | "json_value_mismatch" | "json_too_large" | "header_missing" | "header_mismatch" | "final_url_mismatch" | "dns_no_records" | "dns_unexpected_answer" | "heartbeat_missed" | "no_reply" | "domain_expiring" | "domain_expired" | "lease_expired" | "rate_limited" | "expired" | "probe_overloaded" | "secret_unavailable" | "icmp_unavailable" | "domain_expiry_unknown" | "probe_no_ipv6" | "own_destination" | "self_check_failed", statusCode: integer | null, responseMs: integer | null }, certificate: { notBefore: string, notAfter: string, issuer: string, subject: string, sans: integer, seenAt: string, daysLeft: integer, state: "ok" | "attention" | "critical" | "expired" | "invalid" }, maintenance: { id: string, name: string, endsAt: string }, incident: { id: string, startedAt: string, confirmedAt: string, recovering: boolean, flapping: boolean }, notifications: { alertMembers: boolean, contactIds: string[], quietUntil: string | null, quietForever: boolean }, groupId: string | null, groupName: string | null, groupState: "operational" | "degraded" | "down" | "maintenance" | "unknown", tags: { id: string, name: string }[], nextCheckAt: string | null, heartbeat: { lastPingAt: string | null, dueAt: string | null }, createdAt: string, updatedAt: string }
400 — One of: monitor.not_deleted, monitor.restore_window_expired.401 — One of: auth.unauthenticated.403 — One of: request.host_not_allowed, permission.denied.404 — One of: monitor.not_found.409 — One of: monitor.limit_reached.429 — One of: request.rate_limited.
Ejemplo
curl -X POST "https://api.nuvostatus.com/v1/monitors/0199e6a0-0000-7000-8000-000000000001/restore" \
-H "Authorization: Bearer $NUVOSTATUS_KEY"
Pause, resume or delete many monitors
POST /v1/monitors/bulkÁmbito: write
The same three actions as one monitor at a time, for up to 100 ids. Each id is answered on its own, in the order given and once: one the workspace cannot see comes back ok false with `monitor.not_found`, and the rest still apply. A key that may only read is refused.
Cuerpo de la petición
{ action: "pause" | "resume" | "delete", monitorIds: string[] }
Respuestas
200 — The answer.{ results: { id: string, ok: boolean, code?: "auth.cannot_revoke_current" | "auth.email_not_verified" | "auth.invalid_code" | "auth.invalid_credentials" | "auth.invalid_token" | "auth.password_too_long" | "auth.password_too_short" | "auth.totp_required" | "auth.two_factor_already_enabled" | "auth.two_factor_not_enabled" | "auth.unauthenticated" | "internal.error" | "invitation.already_member" | "invitation.limit_reached" | "invitation.not_found" | "account.password_incorrect" | "account.sole_owner" | "account.disabled" | "account.email_taken" | "account.email_unchanged" | "admin.not_an_operator" | "admin.permission_denied" | "admin.user_not_found" | "admin.workspace_not_found" | "admin.monitor_not_found" | "admin.incident_not_found" | "admin.plan_unknown" | "admin.plan_below_usage" | "admin.override_invalid" | "admin.subscription_not_found" | "alert_digest.invalid_window" | "alert_grouping.invalid" | "api.bulk_empty" | "audit.read_forbidden" | "billing.provider_unavailable" | "billing.plan_not_sold" | "billing.no_subscription" | "billing.subscription_state" | "billing.subscription_conflict" | "billing.webhook_rejected" | "entitlement.feature_not_included" | "escalation_steps.invalid" | "escalation.rotation_not_found" | "escalation_steps.contact_not_found" | "escalation_steps.channel_not_found" | "member.limit_reached" | "member.last_owner" | "member.not_found" | "member.role_not_assignable" | "monitor.account_limit_reached" | "monitor.confirmation_out_of_range" | "monitor.interval_not_allowed" | "monitor.limit_reached" | "monitor.timeout_not_allowed" | "monitor.update_forbidden" | "import.invalid_export" | "import.row_refused" | "import.secret_unavailable" | "import.source_key_refused" | "import.source_unavailable" | "import.unsupported_type" | "import.missing_target" | "import.invalid_target" | "import.invalid_name" | "import.unsupported_interval" | "import.too_many_rows" | "incident.not_found" | "incident.invalid_cursor" | "incident.impact_invalid" | "incident.assignee_not_member" | "incident.assignment_forbidden" | "incident.already_resolved" | "incident.not_resolved" | "incident.already_open" | "incident.not_manual" | "incident.cause_invalid" | "incident.declaration_forbidden" | "incident.export_too_large" | "action_item.not_found" | "action_item.too_many" | "action_item.incident_open" | "action_item.owner_not_member" | "action_item.due_in_past" | "postmortem.not_found" | "incident_comment.not_author" | "incident_comment.not_found" | "monitor.invalid_cursor" | "monitor.not_found" | "monitor.not_deleted" | "monitor.restore_window_expired" | "monitor.url_not_allowed" | "monitor.channel_not_found" | "monitor.keyword_needs_body" | "monitor.conditions_need_body" | "monitor.json_condition_needs_body" | "monitor.config_invalid" | "monitor.authorization_header_conflict" | "monitor.auth_value_has_scheme" | "monitor.domain_invalid" | "monitor.secrets_unavailable" | "monitor.host_not_allowed" | "monitor.not_a_heartbeat" | "monitor.slow_response_not_supported" | "monitor.baseline_not_supported" | "monitor.pause_until_in_past" | "monitor.pause_until_too_far" | "monitor.dependency_not_found" | "monitor.dependency_self" | "monitor.dependency_limit" | "monitor.dependency_duplicate" | "monitor.dependency_cycle" | "monitor.runbook_url_invalid" | "monitor.paused" | "monitor.check_too_soon" | "monitor.check_budget_spent" | "monitor.check_not_supported" | "monitor.no_capable_probe" | "manual_check.not_found" | "on_call.invalid_participant" | "on_call.invalid_window" | "on_call.invalid_name" | "on_call.name_taken" | "on_call.rotation_not_found" | "on_call.rotation_last" | "rotation.in_use" | "group.not_found" | "group.name_taken" | "group.limit_reached" | "group.order_invalid" | "idempotency.conflict" | "idempotency.in_progress" | "tag.not_found" | "tag.name_taken" | "tag.limit_reached" | "tag.limit_per_monitor" | "sla_policy.not_found" | "sla_policy.name_taken" | "sla_policy.monitor_already_covered" | "sla_report.not_found" | "sla_report.month_not_closed" | "sla_report.too_large" | "api_key.not_found" | "api_key.limit_reached" | "api_key.write_key_not_limited" | "api_key.monitor_not_allowed" | "api_key.not_rotatable" | "api_key.grace_out_of_range" | "contact.not_found" | "contact.already_exists" | "contact.limit_reached" | "contact.availability_invalid" | "contact.unavailable" | "maintenance.not_found" | "maintenance.not_editable" | "maintenance.limit_reached" | "maintenance.monitor_not_found" | "maintenance.group_not_found" | "maintenance.invalid_window" | "maintenance.skip_not_recurring" | "maintenance.skip_not_an_occurrence" | "maintenance.skip_started" | "maintenance.skip_already_skipped" | "maintenance.skip_not_found" | "maintenance_window.group_not_found" | "maintenance_window.limit_exceeded" | "maintenance_window.monitor_not_found" | "maintenance_window.not_active" | "maintenance_window.not_found" | "contact.not_verified" | "contact.unknown_contact" | "contact.verification_invalid" | "channel.not_found" | "channel.name_taken" | "channel.limit_reached" | "channel.config_invalid" | "channel.events_empty" | "channel.secret_unavailable" | "channel.secret_not_rotatable" | "delivery.not_found" | "delivery.not_retryable" | "delivery.paced" | "email.lane_budget_exhausted" | "email.suppression_not_found" | "email.webhook_rejected" | "alert_provider.not_configured" | "permission.denied" | "probe.enrolment_expired" | "probe.enrolment_invalid_key" | "probe.enrolment_invalid_request" | "probe.enrolment_revoked" | "probe.enrolment_unknown" | "probe.enrolment_used" | "request.content_type_not_allowed" | "request.cross_site" | "request.host_not_allowed" | "request.origin_missing" | "request.origin_not_allowed" | "request.rate_limited" | "resource.not_found" | "status_page.limit_reached" | "status_page.monitor_not_found" | "status_page.not_found" | "status_page.password_incorrect" | "status_page.slug_taken" | "status_page.unavailable" | "status_page.service_not_found" | "status_page.services_required" | "status_page.domain_invalid" | "status_page.domain_taken" | "status_page_announcement.invalid_window" | "status_page_announcement.limit_reached" | "status_page_announcement.not_found" | "status_page_subscriber.not_found" | "validation.failed" | "weekly_report.invalid_reader" | "workspace.limit_reached" | "workspace.not_found" | "workspace.nothing_to_change" | "workspace.import_limit_exceeded" }[] }
400 — One of: validation.failed.401 — One of: auth.unauthenticated.403 — One of: request.host_not_allowed, permission.denied.429 — One of: request.rate_limited.
Ejemplo
curl -X POST "https://api.nuvostatus.com/v1/monitors/bulk" \
-H "Authorization: Bearer $NUVOSTATUS_KEY" \
-H "Content-Type: application/json" \
-d '{"action":"pause","monitorIds":["0199a1c0-0000-7000-8000-000000000201","0199a1c0-0000-7000-8000-000000000202"]}'
Change one setting on many monitors
PATCH /v1/monitors/bulkÁmbito: write
The same edit as one monitor at a time, for up to 100 ids: the interval, the timeout, the group or the tags, and at least one of them. Each id is answered on its own, in the order given and once, and the answer is 200 even when some were refused: an id the workspace cannot see, an interval its plan does not allow, a group or tag it does not have, or a kind with no interval or timeout of its own is that monitor’s outcome with its code, and the rest still apply. The role is decided once for the whole request; a key that may only read is refused with `monitor.update_forbidden`.
Cuerpo de la petición
{ monitorIds: string[], changes: { intervalSeconds?: 30 | 60 | 120 | 180 | 300 | 600 | 900 | 1800 | 3600, timeoutSeconds?: integer, groupId?: string | null, tagIds?: string[] } }
Respuestas
200 — The answer.{ outcomes: { id: string, ok: boolean, monitor?: { id: string, name: string, changedFields: …[] }, code?: "auth.cannot_revoke_current" | "auth.email_not_verified" | "auth.invalid_code" | "auth.invalid_credentials" | "auth.invalid_token" | "auth.password_too_long" | "auth.password_too_short" | "auth.totp_required" | "auth.two_factor_already_enabled" | "auth.two_factor_not_enabled" | "auth.unauthenticated" | "internal.error" | "invitation.already_member" | "invitation.limit_reached" | "invitation.not_found" | "account.password_incorrect" | "account.sole_owner" | "account.disabled" | "account.email_taken" | "account.email_unchanged" | "admin.not_an_operator" | "admin.permission_denied" | "admin.user_not_found" | "admin.workspace_not_found" | "admin.monitor_not_found" | "admin.incident_not_found" | "admin.plan_unknown" | "admin.plan_below_usage" | "admin.override_invalid" | "admin.subscription_not_found" | "alert_digest.invalid_window" | "alert_grouping.invalid" | "api.bulk_empty" | "audit.read_forbidden" | "billing.provider_unavailable" | "billing.plan_not_sold" | "billing.no_subscription" | "billing.subscription_state" | "billing.subscription_conflict" | "billing.webhook_rejected" | "entitlement.feature_not_included" | "escalation_steps.invalid" | "escalation.rotation_not_found" | "escalation_steps.contact_not_found" | "escalation_steps.channel_not_found" | "member.limit_reached" | "member.last_owner" | "member.not_found" | "member.role_not_assignable" | "monitor.account_limit_reached" | "monitor.confirmation_out_of_range" | "monitor.interval_not_allowed" | "monitor.limit_reached" | "monitor.timeout_not_allowed" | "monitor.update_forbidden" | "import.invalid_export" | "import.row_refused" | "import.secret_unavailable" | "import.source_key_refused" | "import.source_unavailable" | "import.unsupported_type" | "import.missing_target" | "import.invalid_target" | "import.invalid_name" | "import.unsupported_interval" | "import.too_many_rows" | "incident.not_found" | "incident.invalid_cursor" | "incident.impact_invalid" | "incident.assignee_not_member" | "incident.assignment_forbidden" | "incident.already_resolved" | "incident.not_resolved" | "incident.already_open" | "incident.not_manual" | "incident.cause_invalid" | "incident.declaration_forbidden" | "incident.export_too_large" | "action_item.not_found" | "action_item.too_many" | "action_item.incident_open" | "action_item.owner_not_member" | "action_item.due_in_past" | "postmortem.not_found" | "incident_comment.not_author" | "incident_comment.not_found" | "monitor.invalid_cursor" | "monitor.not_found" | "monitor.not_deleted" | "monitor.restore_window_expired" | "monitor.url_not_allowed" | "monitor.channel_not_found" | "monitor.keyword_needs_body" | "monitor.conditions_need_body" | "monitor.json_condition_needs_body" | "monitor.config_invalid" | "monitor.authorization_header_conflict" | "monitor.auth_value_has_scheme" | "monitor.domain_invalid" | "monitor.secrets_unavailable" | "monitor.host_not_allowed" | "monitor.not_a_heartbeat" | "monitor.slow_response_not_supported" | "monitor.baseline_not_supported" | "monitor.pause_until_in_past" | "monitor.pause_until_too_far" | "monitor.dependency_not_found" | "monitor.dependency_self" | "monitor.dependency_limit" | "monitor.dependency_duplicate" | "monitor.dependency_cycle" | "monitor.runbook_url_invalid" | "monitor.paused" | "monitor.check_too_soon" | "monitor.check_budget_spent" | "monitor.check_not_supported" | "monitor.no_capable_probe" | "manual_check.not_found" | "on_call.invalid_participant" | "on_call.invalid_window" | "on_call.invalid_name" | "on_call.name_taken" | "on_call.rotation_not_found" | "on_call.rotation_last" | "rotation.in_use" | "group.not_found" | "group.name_taken" | "group.limit_reached" | "group.order_invalid" | "idempotency.conflict" | "idempotency.in_progress" | "tag.not_found" | "tag.name_taken" | "tag.limit_reached" | "tag.limit_per_monitor" | "sla_policy.not_found" | "sla_policy.name_taken" | "sla_policy.monitor_already_covered" | "sla_report.not_found" | "sla_report.month_not_closed" | "sla_report.too_large" | "api_key.not_found" | "api_key.limit_reached" | "api_key.write_key_not_limited" | "api_key.monitor_not_allowed" | "api_key.not_rotatable" | "api_key.grace_out_of_range" | "contact.not_found" | "contact.already_exists" | "contact.limit_reached" | "contact.availability_invalid" | "contact.unavailable" | "maintenance.not_found" | "maintenance.not_editable" | "maintenance.limit_reached" | "maintenance.monitor_not_found" | "maintenance.group_not_found" | "maintenance.invalid_window" | "maintenance.skip_not_recurring" | "maintenance.skip_not_an_occurrence" | "maintenance.skip_started" | "maintenance.skip_already_skipped" | "maintenance.skip_not_found" | "maintenance_window.group_not_found" | "maintenance_window.limit_exceeded" | "maintenance_window.monitor_not_found" | "maintenance_window.not_active" | "maintenance_window.not_found" | "contact.not_verified" | "contact.unknown_contact" | "contact.verification_invalid" | "channel.not_found" | "channel.name_taken" | "channel.limit_reached" | "channel.config_invalid" | "channel.events_empty" | "channel.secret_unavailable" | "channel.secret_not_rotatable" | "delivery.not_found" | "delivery.not_retryable" | "delivery.paced" | "email.lane_budget_exhausted" | "email.suppression_not_found" | "email.webhook_rejected" | "alert_provider.not_configured" | "permission.denied" | "probe.enrolment_expired" | "probe.enrolment_invalid_key" | "probe.enrolment_invalid_request" | "probe.enrolment_revoked" | "probe.enrolment_unknown" | "probe.enrolment_used" | "request.content_type_not_allowed" | "request.cross_site" | "request.host_not_allowed" | "request.origin_missing" | "request.origin_not_allowed" | "request.rate_limited" | "resource.not_found" | "status_page.limit_reached" | "status_page.monitor_not_found" | "status_page.not_found" | "status_page.password_incorrect" | "status_page.slug_taken" | "status_page.unavailable" | "status_page.service_not_found" | "status_page.services_required" | "status_page.domain_invalid" | "status_page.domain_taken" | "status_page_announcement.invalid_window" | "status_page_announcement.limit_reached" | "status_page_announcement.not_found" | "status_page_subscriber.not_found" | "validation.failed" | "weekly_report.invalid_reader" | "workspace.limit_reached" | "workspace.not_found" | "workspace.nothing_to_change" | "workspace.import_limit_exceeded" }[] }
400 — One of: monitor.update_forbidden, validation.failed.401 — One of: auth.unauthenticated.403 — One of: request.host_not_allowed.429 — One of: request.rate_limited.
Ejemplo
curl -X PATCH "https://api.nuvostatus.com/v1/monitors/bulk" \
-H "Authorization: Bearer $NUVOSTATUS_KEY" \
-H "Content-Type: application/json" \
-d '{"monitorIds":["0199a1c0-0000-7000-8000-000000000201","0199a1c0-0000-7000-8000-000000000202"],"changes":{"intervalSeconds":300,"timeoutSeconds":10}}'
The recent checks of a monitor
GET /v1/monitors/{id}/checksÁmbito: read
Newest first, within the thirty days kept. Each check says what it found and how long each step took.
Parámetros
id — en la ruta, obligatoriolimit — en la cadena de consulta, opcional. How many at most; the default is 50 for checks, 20 for incidents.cursor — en la cadena de consulta, opcional. The `next` of the previous page.
Respuestas
200 — The answer.{ items: { scheduledAt: string, finishedAt: string, class: "ok" | "fail" | "skipped" | "probe_suspect", error: "dns_not_found" | "dns_failure" | "dns_timeout" | "connection_refused" | "connection_timeout" | "connection_reset" | "network_unreachable" | "tls_certificate_expired" | "tls_certificate_invalid" | "tls_hostname_mismatch" | "tls_handshake_failed" | "timeout" | "unexpected_status" | "too_many_redirects" | "invalid_redirect" | "destination_not_allowed" | "response_headers_too_large" | "protocol_error" | "keyword_not_found" | "keyword_found" | "json_invalid" | "json_path_missing" | "json_value_mismatch" | "json_too_large" | "header_missing" | "header_mismatch" | "final_url_mismatch" | "dns_no_records" | "dns_unexpected_answer" | "heartbeat_missed" | "no_reply" | "domain_expiring" | "domain_expired" | "lease_expired" | "rate_limited" | "expired" | "probe_overloaded" | "secret_unavailable" | "icmp_unavailable" | "domain_expiry_unknown" | "probe_no_ipv6" | "own_destination" | "self_check_failed", statusCode: integer | null, responseMs: integer | null, timings: { dnsMs: integer | null, connectMs: integer | null, tlsMs: integer | null, ttfbMs: integer | null }, resolvedIp: string | null, redirects: integer, attempts: integer, ping: { sent: integer, received: integer } }[], next: string | null }
400 — One of: validation.failed.401 — One of: auth.unauthenticated.403 — One of: request.host_not_allowed.404 — One of: monitor.not_found.429 — One of: request.rate_limited.
Ejemplo
curl "https://api.nuvostatus.com/v1/monitors/0199e6a0-0000-7000-8000-000000000001/checks" \
-H "Authorization: Bearer $NUVOSTATUS_KEY"
Uptime and response time
GET /v1/monitors/{id}/summaryÁmbito: read
Over the last day, week and month, and hour by hour over the last day. Uptime counts only the time something of ours observed the target.
Parámetros
id — en la ruta, obligatorio
Respuestas
200 — The answer.{ windows: { 24h: { coveredSeconds: number, downSeconds: number, uptime: number | null, incidents: integer, mtbfSeconds: number | null, timeWithoutIncidentSeconds: number, checks: integer, responseMs: { median: number, p95: number, p99: number }, phases: { dns: { median: …, p95: … }, connect: { median: …, p95: … }, ttfb: { median: …, p95: … } } }, 7d: { coveredSeconds: number, downSeconds: number, uptime: number | null, incidents: integer, mtbfSeconds: number | null, timeWithoutIncidentSeconds: number, checks: integer, responseMs: { median: number, p95: number, p99: number }, phases: { dns: { median: …, p95: … }, connect: { median: …, p95: … }, ttfb: { median: …, p95: … } } }, 30d: { coveredSeconds: number, downSeconds: number, uptime: number | null, incidents: integer, mtbfSeconds: number | null, timeWithoutIncidentSeconds: number, checks: integer, responseMs: { median: number, p95: number, p99: number }, phases: { dns: { median: …, p95: … }, connect: { median: …, p95: … }, ttfb: { median: …, p95: … } } } }, hours: { from: string, coveredSeconds: number, downSeconds: number }[], regions: { region: string, state: "up" | "down" | "unknown", lastCheckedAt: string | null, ageSeconds: integer | null }[], regionPerformance: { region: string, checks: integer, medianMs: integer | null, lastCheckedAt: string | null }[] }
401 — One of: auth.unauthenticated.403 — One of: request.host_not_allowed.404 — One of: monitor.not_found.429 — One of: request.rate_limited.
Ejemplo
curl "https://api.nuvostatus.com/v1/monitors/0199e6a0-0000-7000-8000-000000000001/summary" \
-H "Authorization: Bearer $NUVOSTATUS_KEY"
Regenerate a heartbeat's address
POST /v1/monitors/{id}/heartbeatÁmbito: write
A new token; the old address answers nothing from now on. The new address is in this answer and nowhere else.
Parámetros
id — en la ruta, obligatorio
Respuestas
200 — The answer.{ monitor: { type: "http", config: { url: string, method: "GET" | "HEAD" | "POST" | "PUT" | "PATCH" | "DELETE", followRedirects: boolean, expectedStatus: …[], keyword: string | null, keywordMustAppear: boolean, conditions: …[], conditionMode: "all" | "any", headers: …[], auth: … | … | …, body: { contentType: …, value: … } }, id: string, name: string, target: string, intervalSeconds: integer, timeoutSeconds: integer, paused: boolean, pausedUntil: string | null, status: "pending" | "passing" | "failing" | "down" | "paused" | "unknown", statusSince: string | null, pendingReason: { code: "no_probe_capability", missingCapability: "http" | "tcp" | "dns" | "http_secrets" | "icmp" | "udp" | "domain" | "ipv6" }, lastCheck: { at: string, class: "ok" | "fail", error: "dns_not_found" | "dns_failure" | "dns_timeout" | "connection_refused" | "connection_timeout" | "connection_reset" | "network_unreachable" | "tls_certificate_expired" | "tls_certificate_invalid" | "tls_hostname_mismatch" | "tls_handshake_failed" | "timeout" | "unexpected_status" | "too_many_redirects" | "invalid_redirect" | "destination_not_allowed" | "response_headers_too_large" | "protocol_error" | "keyword_not_found" | "keyword_found" | "json_invalid" | "json_path_missing" | "json_value_mismatch" | "json_too_large" | "header_missing" | "header_mismatch" | "final_url_mismatch" | "dns_no_records" | "dns_unexpected_answer" | "heartbeat_missed" | "no_reply" | "domain_expiring" | "domain_expired" | "lease_expired" | "rate_limited" | "expired" | "probe_overloaded" | "secret_unavailable" | "icmp_unavailable" | "domain_expiry_unknown" | "probe_no_ipv6" | "own_destination" | "self_check_failed", statusCode: integer | null, responseMs: integer | null }, certificate: { notBefore: string, notAfter: string, issuer: string, subject: string, sans: integer, seenAt: string, daysLeft: integer, state: "ok" | "attention" | "critical" | "expired" | "invalid" }, maintenance: { id: string, name: string, endsAt: string }, incident: { id: string, startedAt: string, confirmedAt: string, recovering: boolean, flapping: boolean }, notifications: { alertMembers: boolean, contactIds: …[], quietUntil: string | null, quietForever: boolean }, groupId: string | null, groupName: string | null, groupState: "operational" | "degraded" | "down" | "maintenance" | "unknown", tags: { id: …, name: … }[], nextCheckAt: string | null, heartbeat: { lastPingAt: string | null, dueAt: string | null }, createdAt: string, updatedAt: string } | { type: "tcp", config: { host: string, port: integer }, id: string, name: string, target: string, intervalSeconds: integer, timeoutSeconds: integer, paused: boolean, pausedUntil: string | null, status: "pending" | "passing" | "failing" | "down" | "paused" | "unknown", statusSince: string | null, pendingReason: { code: "no_probe_capability", missingCapability: "http" | "tcp" | "dns" | "http_secrets" | "icmp" | "udp" | "domain" | "ipv6" }, lastCheck: { at: string, class: "ok" | "fail", error: "dns_not_found" | "dns_failure" | "dns_timeout" | "connection_refused" | "connection_timeout" | "connection_reset" | "network_unreachable" | "tls_certificate_expired" | "tls_certificate_invalid" | "tls_hostname_mismatch" | "tls_handshake_failed" | "timeout" | "unexpected_status" | "too_many_redirects" | "invalid_redirect" | "destination_not_allowed" | "response_headers_too_large" | "protocol_error" | "keyword_not_found" | "keyword_found" | "json_invalid" | "json_path_missing" | "json_value_mismatch" | "json_too_large" | "header_missing" | "header_mismatch" | "final_url_mismatch" | "dns_no_records" | "dns_unexpected_answer" | "heartbeat_missed" | "no_reply" | "domain_expiring" | "domain_expired" | "lease_expired" | "rate_limited" | "expired" | "probe_overloaded" | "secret_unavailable" | "icmp_unavailable" | "domain_expiry_unknown" | "probe_no_ipv6" | "own_destination" | "self_check_failed", statusCode: integer | null, responseMs: integer | null }, certificate: { notBefore: string, notAfter: string, issuer: string, subject: string, sans: integer, seenAt: string, daysLeft: integer, state: "ok" | "attention" | "critical" | "expired" | "invalid" }, maintenance: { id: string, name: string, endsAt: string }, incident: { id: string, startedAt: string, confirmedAt: string, recovering: boolean, flapping: boolean }, notifications: { alertMembers: boolean, contactIds: …[], quietUntil: string | null, quietForever: boolean }, groupId: string | null, groupName: string | null, groupState: "operational" | "degraded" | "down" | "maintenance" | "unknown", tags: { id: …, name: … }[], nextCheckAt: string | null, heartbeat: { lastPingAt: string | null, dueAt: string | null }, createdAt: string, updatedAt: string } | { type: "dns", config: { name: string, recordType: "A" | "AAAA" | "CNAME" | "MX" | "TXT" | "NS", expected: …[], resolver: "system" | "cloudflare" | "google" | "quad9" | "opendns" }, id: string, name: string, target: string, intervalSeconds: integer, timeoutSeconds: integer, paused: boolean, pausedUntil: string | null, status: "pending" | "passing" | "failing" | "down" | "paused" | "unknown", statusSince: string | null, pendingReason: { code: "no_probe_capability", missingCapability: "http" | "tcp" | "dns" | "http_secrets" | "icmp" | "udp" | "domain" | "ipv6" }, lastCheck: { at: string, class: "ok" | "fail", error: "dns_not_found" | "dns_failure" | "dns_timeout" | "connection_refused" | "connection_timeout" | "connection_reset" | "network_unreachable" | "tls_certificate_expired" | "tls_certificate_invalid" | "tls_hostname_mismatch" | "tls_handshake_failed" | "timeout" | "unexpected_status" | "too_many_redirects" | "invalid_redirect" | "destination_not_allowed" | "response_headers_too_large" | "protocol_error" | "keyword_not_found" | "keyword_found" | "json_invalid" | "json_path_missing" | "json_value_mismatch" | "json_too_large" | "header_missing" | "header_mismatch" | "final_url_mismatch" | "dns_no_records" | "dns_unexpected_answer" | "heartbeat_missed" | "no_reply" | "domain_expiring" | "domain_expired" | "lease_expired" | "rate_limited" | "expired" | "probe_overloaded" | "secret_unavailable" | "icmp_unavailable" | "domain_expiry_unknown" | "probe_no_ipv6" | "own_destination" | "self_check_failed", statusCode: integer | null, responseMs: integer | null }, certificate: { notBefore: string, notAfter: string, issuer: string, subject: string, sans: integer, seenAt: string, daysLeft: integer, state: "ok" | "attention" | "critical" | "expired" | "invalid" }, maintenance: { id: string, name: string, endsAt: string }, incident: { id: string, startedAt: string, confirmedAt: string, recovering: boolean, flapping: boolean }, notifications: { alertMembers: boolean, contactIds: …[], quietUntil: string | null, quietForever: boolean }, groupId: string | null, groupName: string | null, groupState: "operational" | "degraded" | "down" | "maintenance" | "unknown", tags: { id: …, name: … }[], nextCheckAt: string | null, heartbeat: { lastPingAt: string | null, dueAt: string | null }, createdAt: string, updatedAt: string } | { type: "heartbeat", config: { periodSeconds: 60 | 120 | 300 | 600 | 900 | 1800 | 3600 | 7200 | 21600 | 43200 | 86400 | 604800 | 2592000, graceSeconds: integer }, id: string, name: string, target: string, intervalSeconds: integer, timeoutSeconds: integer, paused: boolean, pausedUntil: string | null, status: "pending" | "passing" | "failing" | "down" | "paused" | "unknown", statusSince: string | null, pendingReason: { code: "no_probe_capability", missingCapability: "http" | "tcp" | "dns" | "http_secrets" | "icmp" | "udp" | "domain" | "ipv6" }, lastCheck: { at: string, class: "ok" | "fail", error: "dns_not_found" | "dns_failure" | "dns_timeout" | "connection_refused" | "connection_timeout" | "connection_reset" | "network_unreachable" | "tls_certificate_expired" | "tls_certificate_invalid" | "tls_hostname_mismatch" | "tls_handshake_failed" | "timeout" | "unexpected_status" | "too_many_redirects" | "invalid_redirect" | "destination_not_allowed" | "response_headers_too_large" | "protocol_error" | "keyword_not_found" | "keyword_found" | "json_invalid" | "json_path_missing" | "json_value_mismatch" | "json_too_large" | "header_missing" | "header_mismatch" | "final_url_mismatch" | "dns_no_records" | "dns_unexpected_answer" | "heartbeat_missed" | "no_reply" | "domain_expiring" | "domain_expired" | "lease_expired" | "rate_limited" | "expired" | "probe_overloaded" | "secret_unavailable" | "icmp_unavailable" | "domain_expiry_unknown" | "probe_no_ipv6" | "own_destination" | "self_check_failed", statusCode: integer | null, responseMs: integer | null }, certificate: { notBefore: string, notAfter: string, issuer: string, subject: string, sans: integer, seenAt: string, daysLeft: integer, state: "ok" | "attention" | "critical" | "expired" | "invalid" }, maintenance: { id: string, name: string, endsAt: string }, incident: { id: string, startedAt: string, confirmedAt: string, recovering: boolean, flapping: boolean }, notifications: { alertMembers: boolean, contactIds: …[], quietUntil: string | null, quietForever: boolean }, groupId: string | null, groupName: string | null, groupState: "operational" | "degraded" | "down" | "maintenance" | "unknown", tags: { id: …, name: … }[], nextCheckAt: string | null, heartbeat: { lastPingAt: string | null, dueAt: string | null }, createdAt: string, updatedAt: string } | { type: "ping", config: { host: string }, id: string, name: string, target: string, intervalSeconds: integer, timeoutSeconds: integer, paused: boolean, pausedUntil: string | null, status: "pending" | "passing" | "failing" | "down" | "paused" | "unknown", statusSince: string | null, pendingReason: { code: "no_probe_capability", missingCapability: "http" | "tcp" | "dns" | "http_secrets" | "icmp" | "udp" | "domain" | "ipv6" }, lastCheck: { at: string, class: "ok" | "fail", error: "dns_not_found" | "dns_failure" | "dns_timeout" | "connection_refused" | "connection_timeout" | "connection_reset" | "network_unreachable" | "tls_certificate_expired" | "tls_certificate_invalid" | "tls_hostname_mismatch" | "tls_handshake_failed" | "timeout" | "unexpected_status" | "too_many_redirects" | "invalid_redirect" | "destination_not_allowed" | "response_headers_too_large" | "protocol_error" | "keyword_not_found" | "keyword_found" | "json_invalid" | "json_path_missing" | "json_value_mismatch" | "json_too_large" | "header_missing" | "header_mismatch" | "final_url_mismatch" | "dns_no_records" | "dns_unexpected_answer" | "heartbeat_missed" | "no_reply" | "domain_expiring" | "domain_expired" | "lease_expired" | "rate_limited" | "expired" | "probe_overloaded" | "secret_unavailable" | "icmp_unavailable" | "domain_expiry_unknown" | "probe_no_ipv6" | "own_destination" | "self_check_failed", statusCode: integer | null, responseMs: integer | null }, certificate: { notBefore: string, notAfter: string, issuer: string, subject: string, sans: integer, seenAt: string, daysLeft: integer, state: "ok" | "attention" | "critical" | "expired" | "invalid" }, maintenance: { id: string, name: string, endsAt: string }, incident: { id: string, startedAt: string, confirmedAt: string, recovering: boolean, flapping: boolean }, notifications: { alertMembers: boolean, contactIds: …[], quietUntil: string | null, quietForever: boolean }, groupId: string | null, groupName: string | null, groupState: "operational" | "degraded" | "down" | "maintenance" | "unknown", tags: { id: …, name: … }[], nextCheckAt: string | null, heartbeat: { lastPingAt: string | null, dueAt: string | null }, createdAt: string, updatedAt: string } | { type: "udp", config: { host: string, port: integer }, id: string, name: string, target: string, intervalSeconds: integer, timeoutSeconds: integer, paused: boolean, pausedUntil: string | null, status: "pending" | "passing" | "failing" | "down" | "paused" | "unknown", statusSince: string | null, pendingReason: { code: "no_probe_capability", missingCapability: "http" | "tcp" | "dns" | "http_secrets" | "icmp" | "udp" | "domain" | "ipv6" }, lastCheck: { at: string, class: "ok" | "fail", error: "dns_not_found" | "dns_failure" | "dns_timeout" | "connection_refused" | "connection_timeout" | "connection_reset" | "network_unreachable" | "tls_certificate_expired" | "tls_certificate_invalid" | "tls_hostname_mismatch" | "tls_handshake_failed" | "timeout" | "unexpected_status" | "too_many_redirects" | "invalid_redirect" | "destination_not_allowed" | "response_headers_too_large" | "protocol_error" | "keyword_not_found" | "keyword_found" | "json_invalid" | "json_path_missing" | "json_value_mismatch" | "json_too_large" | "header_missing" | "header_mismatch" | "final_url_mismatch" | "dns_no_records" | "dns_unexpected_answer" | "heartbeat_missed" | "no_reply" | "domain_expiring" | "domain_expired" | "lease_expired" | "rate_limited" | "expired" | "probe_overloaded" | "secret_unavailable" | "icmp_unavailable" | "domain_expiry_unknown" | "probe_no_ipv6" | "own_destination" | "self_check_failed", statusCode: integer | null, responseMs: integer | null }, certificate: { notBefore: string, notAfter: string, issuer: string, subject: string, sans: integer, seenAt: string, daysLeft: integer, state: "ok" | "attention" | "critical" | "expired" | "invalid" }, maintenance: { id: string, name: string, endsAt: string }, incident: { id: string, startedAt: string, confirmedAt: string, recovering: boolean, flapping: boolean }, notifications: { alertMembers: boolean, contactIds: …[], quietUntil: string | null, quietForever: boolean }, groupId: string | null, groupName: string | null, groupState: "operational" | "degraded" | "down" | "maintenance" | "unknown", tags: { id: …, name: … }[], nextCheckAt: string | null, heartbeat: { lastPingAt: string | null, dueAt: string | null }, createdAt: string, updatedAt: string } | { type: "domain", config: { domain: string }, id: string, name: string, target: string, intervalSeconds: integer, timeoutSeconds: integer, paused: boolean, pausedUntil: string | null, status: "pending" | "passing" | "failing" | "down" | "paused" | "unknown", statusSince: string | null, pendingReason: { code: "no_probe_capability", missingCapability: "http" | "tcp" | "dns" | "http_secrets" | "icmp" | "udp" | "domain" | "ipv6" }, lastCheck: { at: string, class: "ok" | "fail", error: "dns_not_found" | "dns_failure" | "dns_timeout" | "connection_refused" | "connection_timeout" | "connection_reset" | "network_unreachable" | "tls_certificate_expired" | "tls_certificate_invalid" | "tls_hostname_mismatch" | "tls_handshake_failed" | "timeout" | "unexpected_status" | "too_many_redirects" | "invalid_redirect" | "destination_not_allowed" | "response_headers_too_large" | "protocol_error" | "keyword_not_found" | "keyword_found" | "json_invalid" | "json_path_missing" | "json_value_mismatch" | "json_too_large" | "header_missing" | "header_mismatch" | "final_url_mismatch" | "dns_no_records" | "dns_unexpected_answer" | "heartbeat_missed" | "no_reply" | "domain_expiring" | "domain_expired" | "lease_expired" | "rate_limited" | "expired" | "probe_overloaded" | "secret_unavailable" | "icmp_unavailable" | "domain_expiry_unknown" | "probe_no_ipv6" | "own_destination" | "self_check_failed", statusCode: integer | null, responseMs: integer | null }, certificate: { notBefore: string, notAfter: string, issuer: string, subject: string, sans: integer, seenAt: string, daysLeft: integer, state: "ok" | "attention" | "critical" | "expired" | "invalid" }, maintenance: { id: string, name: string, endsAt: string }, incident: { id: string, startedAt: string, confirmedAt: string, recovering: boolean, flapping: boolean }, notifications: { alertMembers: boolean, contactIds: …[], quietUntil: string | null, quietForever: boolean }, groupId: string | null, groupName: string | null, groupState: "operational" | "degraded" | "down" | "maintenance" | "unknown", tags: { id: …, name: … }[], nextCheckAt: string | null, heartbeat: { lastPingAt: string | null, dueAt: string | null }, createdAt: string, updatedAt: string }, heartbeatUrl?: string }
400 — One of: monitor.not_a_heartbeat.401 — One of: auth.unauthenticated.403 — One of: request.host_not_allowed, permission.denied.404 — One of: monitor.not_found.429 — One of: request.rate_limited.
Ejemplo
curl -X POST "https://api.nuvostatus.com/v1/monitors/0199e6a0-0000-7000-8000-000000000001/heartbeat" \
-H "Authorization: Bearer $NUVOSTATUS_KEY"
List the monitor groups
GET /v1/monitor-groupsÁmbito: read
The groups of the workspace, by name. A monitor without one is ungrouped.
Respuestas
200 — The answer.{ groups: { id: string, name: string, state: "operational" | "degraded" | "down" | "maintenance" | "unknown", createdAt: string, updatedAt: string }[] }
401 — One of: auth.unauthenticated.403 — One of: request.host_not_allowed.429 — One of: request.rate_limited.
Ejemplo
curl "https://api.nuvostatus.com/v1/monitor-groups" \
-H "Authorization: Bearer $NUVOSTATUS_KEY"
Create a monitor group
POST /v1/monitor-groupsÁmbito: write
A folder for monitors; a name unique in the workspace, compared without case.
Parámetros
Idempotency-Key — en la cadena de consulta, opcional
Cuerpo de la petición
{ name: string }
Respuestas
201 — The answer.{ group: { id: string, name: string, state: "operational" | "degraded" | "down" | "maintenance" | "unknown", createdAt: string, updatedAt: string } }
400 — One of: validation.failed, group.name_taken, group.limit_reached.401 — One of: auth.unauthenticated.403 — One of: request.host_not_allowed, permission.denied.409 — One of: idempotency.conflict, idempotency.in_progress.429 — One of: request.rate_limited.
Ejemplo
curl -X POST "https://api.nuvostatus.com/v1/monitor-groups" \
-H "Authorization: Bearer $NUVOSTATUS_KEY" \
-H "Content-Type: application/json" \
-d '{"name":"Clients"}'
Rename a monitor group
PATCH /v1/monitor-groups/{id}Ámbito: write
Changes the group’s name, not its monitors.
Parámetros
id — en la ruta, obligatorio
Cuerpo de la petición
{ name: string }
Respuestas
200 — The answer.{ group: { id: string, name: string, state: "operational" | "degraded" | "down" | "maintenance" | "unknown", createdAt: string, updatedAt: string } }
400 — One of: validation.failed, group.not_found, group.name_taken.401 — One of: auth.unauthenticated.403 — One of: request.host_not_allowed, permission.denied.429 — One of: request.rate_limited.
Ejemplo
curl -X PATCH "https://api.nuvostatus.com/v1/monitor-groups/0199e6a0-0000-7000-8000-000000000001" \
-H "Authorization: Bearer $NUVOSTATUS_KEY" \
-H "Content-Type: application/json" \
-d '{"name":"Customers"}'
Delete a monitor group
DELETE /v1/monitor-groups/{id}Ámbito: write
The monitors in it become ungrouped; none is deleted or paused.
Parámetros
id — en la ruta, obligatorio
Respuestas
204 — Done; no body.400 — One of: group.not_found.401 — One of: auth.unauthenticated.403 — One of: request.host_not_allowed, permission.denied.429 — One of: request.rate_limited.
Ejemplo
curl -X DELETE "https://api.nuvostatus.com/v1/monitor-groups/0199e6a0-0000-7000-8000-000000000001" \
-H "Authorization: Bearer $NUVOSTATUS_KEY"
List the SLA policies
GET /v1/sla-policiesÁmbito: read
The workspace’s named availability promises, each with its target, window, members and the verdict measured over its window.
Respuestas
200 — The answer.{ policies: { id: string, name: string, targetBp: integer, windowDays: 7 | 30 | 90, monitors: { id: …, name: … }[], status: { targetBp: integer, targetUptime: number, windowSeconds: integer, coveredSeconds: integer, downSeconds: integer, allowedDownSeconds: integer, remainingDownSeconds: integer, uptime: number | null, met: boolean | null, members: …[], observations: integer }, createdAt: string, updatedAt: string }[] }
401 — One of: auth.unauthenticated.403 — One of: request.host_not_allowed.429 — One of: request.rate_limited.
Ejemplo
curl "https://api.nuvostatus.com/v1/sla-policies" \
-H "Authorization: Bearer $NUVOSTATUS_KEY"
Create an SLA policy
POST /v1/sla-policiesÁmbito: write
A name unique in the workspace, a target in basis points and a window of 7, 30 or 90 days. It covers no monitor until monitors are added.
Parámetros
Idempotency-Key — en la cadena de consulta, opcional
Cuerpo de la petición
{ name: string, targetBp: integer, windowDays: 7 | 30 | 90 }
Respuestas
201 — The answer.{ policy: { id: string, name: string, targetBp: integer, windowDays: 7 | 30 | 90, monitors: { id: string, name: string }[], status: { targetBp: integer, targetUptime: number, windowSeconds: integer, coveredSeconds: integer, downSeconds: integer, allowedDownSeconds: integer, remainingDownSeconds: integer, uptime: number | null, met: boolean | null, members: { monitorId: …, coveredSeconds: …, downSeconds: …, met: … }[], observations: integer }, createdAt: string, updatedAt: string } }
400 — One of: validation.failed, sla_policy.name_taken.401 — One of: auth.unauthenticated.403 — One of: request.host_not_allowed, permission.denied.409 — One of: idempotency.conflict, idempotency.in_progress.429 — One of: request.rate_limited.
Ejemplo
curl -X POST "https://api.nuvostatus.com/v1/sla-policies" \
-H "Authorization: Bearer $NUVOSTATUS_KEY" \
-H "Content-Type: application/json" \
-d '{"name":"Payments","targetBp":9990,"windowDays":90}'
Read an SLA policy
GET /v1/sla-policies/{id}Ámbito: read
Its name, target, window, members and the verdict measured over the window. A policy of another workspace is answered as absent.
Parámetros
id — en la ruta, obligatorio
Respuestas
200 — The answer.{ policy: { id: string, name: string, targetBp: integer, windowDays: 7 | 30 | 90, monitors: { id: string, name: string }[], status: { targetBp: integer, targetUptime: number, windowSeconds: integer, coveredSeconds: integer, downSeconds: integer, allowedDownSeconds: integer, remainingDownSeconds: integer, uptime: number | null, met: boolean | null, members: { monitorId: …, coveredSeconds: …, downSeconds: …, met: … }[], observations: integer }, createdAt: string, updatedAt: string } }
401 — One of: auth.unauthenticated.403 — One of: request.host_not_allowed.404 — One of: monitor.not_found.429 — One of: request.rate_limited.
Ejemplo
curl "https://api.nuvostatus.com/v1/sla-policies/0199e6a0-0000-7000-8000-000000000001" \
-H "Authorization: Bearer $NUVOSTATUS_KEY"
Edit an SLA policy
PATCH /v1/sla-policies/{id}Ámbito: write
Changes its name, target or window; absent fields keep what is stored.
Parámetros
id — en la ruta, obligatorio
Cuerpo de la petición
{ name?: string, targetBp?: integer, windowDays?: 7 | 30 | 90 }
Respuestas
200 — The answer.{ policy: { id: string, name: string, targetBp: integer, windowDays: 7 | 30 | 90, monitors: { id: string, name: string }[], status: { targetBp: integer, targetUptime: number, windowSeconds: integer, coveredSeconds: integer, downSeconds: integer, allowedDownSeconds: integer, remainingDownSeconds: integer, uptime: number | null, met: boolean | null, members: { monitorId: …, coveredSeconds: …, downSeconds: …, met: … }[], observations: integer }, createdAt: string, updatedAt: string } }
400 — One of: validation.failed, sla_policy.name_taken.401 — One of: auth.unauthenticated.403 — One of: request.host_not_allowed, permission.denied.404 — One of: monitor.not_found.429 — One of: request.rate_limited.
Ejemplo
curl -X PATCH "https://api.nuvostatus.com/v1/sla-policies/0199e6a0-0000-7000-8000-000000000001" \
-H "Authorization: Bearer $NUVOSTATUS_KEY" \
-H "Content-Type: application/json" \
-d '{"targetBp":9995}'
Delete an SLA policy
DELETE /v1/sla-policies/{id}Ámbito: write
Its memberships go with it, and every monitor it covered answers its own target again.
Parámetros
id — en la ruta, obligatorio
Respuestas
204 — Done; no body.401 — One of: auth.unauthenticated.403 — One of: request.host_not_allowed, permission.denied.404 — One of: monitor.not_found.429 — One of: request.rate_limited.
Ejemplo
curl -X DELETE "https://api.nuvostatus.com/v1/sla-policies/0199e6a0-0000-7000-8000-000000000001" \
-H "Authorization: Bearer $NUVOSTATUS_KEY"
Add monitors to an SLA policy
POST /v1/sla-policies/{id}/monitorsÁmbito: write
Explicit monitor ids, or a group or tag shortcut resolved at the moment of the write. A monitor already covered by another policy is refused.
Parámetros
id — en la ruta, obligatorioIdempotency-Key — en la cadena de consulta, opcional
Cuerpo de la petición
{ monitorIds?: string[], groupId?: string, tag?: string }
Respuestas
201 — The answer.{ policy: { id: string, name: string, targetBp: integer, windowDays: 7 | 30 | 90, monitors: { id: string, name: string }[], status: { targetBp: integer, targetUptime: number, windowSeconds: integer, coveredSeconds: integer, downSeconds: integer, allowedDownSeconds: integer, remainingDownSeconds: integer, uptime: number | null, met: boolean | null, members: { monitorId: …, coveredSeconds: …, downSeconds: …, met: … }[], observations: integer }, createdAt: string, updatedAt: string } }
400 — One of: validation.failed, sla_policy.monitor_already_covered, group.not_found, tag.not_found.401 — One of: auth.unauthenticated.403 — One of: request.host_not_allowed, permission.denied.404 — One of: monitor.not_found.409 — One of: idempotency.conflict, idempotency.in_progress.429 — One of: request.rate_limited.
Ejemplo
curl -X POST "https://api.nuvostatus.com/v1/sla-policies/0199e6a0-0000-7000-8000-000000000001/monitors" \
-H "Authorization: Bearer $NUVOSTATUS_KEY" \
-H "Content-Type: application/json" \
-d '{"monitorIds":["0199a1c0-0000-7000-8000-000000000201"]}'
Remove monitors from an SLA policy
DELETE /v1/sla-policies/{id}/monitorsÁmbito: write
The monitors keep their own target; the policy’s verdict is measured again.
Parámetros
id — en la ruta, obligatorio
Cuerpo de la petición
{ monitorIds: string[] }
Respuestas
200 — The answer.{ policy: { id: string, name: string, targetBp: integer, windowDays: 7 | 30 | 90, monitors: { id: string, name: string }[], status: { targetBp: integer, targetUptime: number, windowSeconds: integer, coveredSeconds: integer, downSeconds: integer, allowedDownSeconds: integer, remainingDownSeconds: integer, uptime: number | null, met: boolean | null, members: { monitorId: …, coveredSeconds: …, downSeconds: …, met: … }[], observations: integer }, createdAt: string, updatedAt: string } }
400 — One of: validation.failed.401 — One of: auth.unauthenticated.403 — One of: request.host_not_allowed, permission.denied.404 — One of: monitor.not_found.429 — One of: request.rate_limited.
Ejemplo
curl -X DELETE "https://api.nuvostatus.com/v1/sla-policies/0199e6a0-0000-7000-8000-000000000001/monitors" \
-H "Authorization: Bearer $NUVOSTATUS_KEY" \
-H "Content-Type: application/json" \
-d '{"monitorIds":["0199a1c0-0000-7000-8000-000000000201"]}'
List the tags
GET /v1/tagsÁmbito: read
The workspace’s labels, by name.
Ejemplo
curl "https://api.nuvostatus.com/v1/tags" \
-H "Authorization: Bearer $NUVOSTATUS_KEY"
Create a tag
POST /v1/tagsÁmbito: write
A label in the workspace’s own namespace; its name is unique without case.
Cuerpo de la petición
{ name: string }
Ejemplo
curl -X POST "https://api.nuvostatus.com/v1/tags" \
-H "Authorization: Bearer $NUVOSTATUS_KEY" \
-H "Content-Type: application/json" \
-d '{"name":"production"}'
Rename a tag
PATCH /v1/tags/{id}Ámbito: write
Changes the word; every monitor carrying it keeps it.
Parámetros
id — en la ruta, obligatorio
Cuerpo de la petición
{ name: string }
Ejemplo
curl -X PATCH "https://api.nuvostatus.com/v1/tags/0199e6a0-0000-7000-8000-000000000001" \
-H "Authorization: Bearer $NUVOSTATUS_KEY" \
-H "Content-Type: application/json" \
-d '{"name":"critical"}'
Delete a tag
DELETE /v1/tags/{id}Ámbito: write
Detaches it from every monitor; no monitor is changed otherwise.
Parámetros
id — en la ruta, obligatorio
Respuestas
204 — Done; no body.400 — One of: tag.not_found.401 — One of: auth.unauthenticated.403 — One of: request.host_not_allowed, permission.denied.429 — One of: request.rate_limited.
Ejemplo
curl -X DELETE "https://api.nuvostatus.com/v1/tags/0199e6a0-0000-7000-8000-000000000001" \
-H "Authorization: Bearer $NUVOSTATUS_KEY"
List the alert contacts
GET /v1/alert-contactsÁmbito: read
The addresses the workspace tells about incidents, and the most it may hold. An address receives nothing until its link is followed.
Respuestas
200 — The answer.{ items: { id: string, email: string, name: string | null, isDefault: boolean, verified: boolean, verificationSentAt: string | null, createdAt: string }[], next: string | null, max: integer }
401 — One of: auth.unauthenticated.403 — One of: request.host_not_allowed.429 — One of: request.rate_limited.
Ejemplo
curl "https://api.nuvostatus.com/v1/alert-contacts" \
-H "Authorization: Bearer $NUVOSTATUS_KEY"
Add an alert contact
POST /v1/alert-contactsÁmbito: write
A new address, unverified: a link is emailed, and only once it is followed is the address told anything. A retry with the same `Idempotency-Key` replays the answer and sends no second link.
Parámetros
Idempotency-Key — en la cadena de consulta, opcional
Cuerpo de la petición
{ email: string, name?: string, isDefault?: boolean, availability?: { days: integer[], from: string | null, to: string | null, timezone: string } }
Respuestas
201 — The answer.{ contact: { id: string, email: string, name: string | null, isDefault: boolean, verified: boolean, verificationSentAt: string | null, createdAt: string } }
400 — One of: validation.failed.401 — One of: auth.unauthenticated.403 — One of: request.host_not_allowed, permission.denied.409 — One of: contact.already_exists, contact.limit_reached, idempotency.conflict, idempotency.in_progress.429 — One of: request.rate_limited.
Ejemplo
curl -X POST "https://api.nuvostatus.com/v1/alert-contacts" \
-H "Authorization: Bearer $NUVOSTATUS_KEY" \
-H "Content-Type: application/json" \
-d '{"email":"oncall@example.com","name":"On call","isDefault":true}'
Read an alert contact
GET /v1/alert-contacts/{id}Ámbito: read
One address and whether it has been verified.
Parámetros
id — en la ruta, obligatorio
Respuestas
200 — The answer.{ id: string, email: string, name: string | null, isDefault: boolean, verified: boolean, verificationSentAt: string | null, createdAt: string }
401 — One of: auth.unauthenticated.403 — One of: request.host_not_allowed.404 — One of: contact.not_found.429 — One of: request.rate_limited.
Ejemplo
curl "https://api.nuvostatus.com/v1/alert-contacts/0199e6a0-0000-7000-8000-000000000001" \
-H "Authorization: Bearer $NUVOSTATUS_KEY"
Change an alert contact
PATCH /v1/alert-contacts/{id}Ámbito: write
Its name, or whether it is told for the monitors that choose none of their own.
Parámetros
id — en la ruta, obligatorio
Cuerpo de la petición
{ name?: string | null, isDefault?: boolean, availability?: { days: integer[], from: string | null, to: string | null, timezone: string } }
Respuestas
200 — The answer.{ contact: { id: string, email: string, name: string | null, isDefault: boolean, verified: boolean, verificationSentAt: string | null, createdAt: string } }
400 — One of: validation.failed.401 — One of: auth.unauthenticated.403 — One of: request.host_not_allowed, permission.denied.404 — One of: contact.not_found.429 — One of: request.rate_limited.
Ejemplo
curl -X PATCH "https://api.nuvostatus.com/v1/alert-contacts/0199e6a0-0000-7000-8000-000000000001" \
-H "Authorization: Bearer $NUVOSTATUS_KEY" \
-H "Content-Type: application/json" \
-d '{"name":"Primary on call"}'
Remove an alert contact
DELETE /v1/alert-contacts/{id}Ámbito: write
The monitors that chose it stop naming it; one left without any falls back to the defaults.
Parámetros
id — en la ruta, obligatorio
Respuestas
204 — Done; no body.401 — One of: auth.unauthenticated.403 — One of: request.host_not_allowed, permission.denied.404 — One of: contact.not_found.429 — One of: request.rate_limited.
Ejemplo
curl -X DELETE "https://api.nuvostatus.com/v1/alert-contacts/0199e6a0-0000-7000-8000-000000000001" \
-H "Authorization: Bearer $NUVOSTATUS_KEY"
Send the verification link again
POST /v1/alert-contacts/{id}/resendÁmbito: write
A new token and a new message; the previous link stops working.
Parámetros
id — en la ruta, obligatorio
Respuestas
202 — The answer.{ accepted: boolean }
401 — One of: auth.unauthenticated.403 — One of: request.host_not_allowed, permission.denied.404 — One of: contact.not_found.429 — One of: request.rate_limited.
Ejemplo
curl -X POST "https://api.nuvostatus.com/v1/alert-contacts/0199e6a0-0000-7000-8000-000000000001/resend" \
-H "Authorization: Bearer $NUVOSTATUS_KEY"
Send a test message
POST /v1/alert-contacts/{id}/testÁmbito: write
A test through the alert lane, only to an address whose link has been followed.
Parámetros
id — en la ruta, obligatorio
Respuestas
202 — The answer.{ accepted: boolean }
401 — One of: auth.unauthenticated.403 — One of: request.host_not_allowed, permission.denied.404 — One of: contact.not_found.409 — One of: contact.not_verified.429 — One of: request.rate_limited.
Ejemplo
curl -X POST "https://api.nuvostatus.com/v1/alert-contacts/0199e6a0-0000-7000-8000-000000000001/test" \
-H "Authorization: Bearer $NUVOSTATUS_KEY"
The weekly report’s readers
GET /v1/report-settingsÁmbito: read
Whether the workspace receives its weekly report and who it reaches: the owners and administrators by default, the members and verified contacts the workspace named instead, or nobody when it is off. A read key may see it.
Respuestas
200 — The answer.{ weeklyReport: { enabled: boolean, memberIds: string[], contactIds: string[], updatedAt: string | null }, readers: { kind: "member" | "contact", id: string, email: string, name: string }[] }
401 — One of: auth.unauthenticated.403 — One of: request.host_not_allowed.429 — One of: request.rate_limited.
Ejemplo
curl "https://api.nuvostatus.com/v1/report-settings" \
-H "Authorization: Bearer $NUVOSTATUS_KEY"
Choose the weekly report’s readers
PUT /v1/report-settingsÁmbito: write
Replaces the whole choice: the switch and the two lists. An id that is not a member or a verified contact of this workspace is refused with `weekly_report.invalid_reader`. Only an owner or an administrator may change it, so a key’s write scope is refused.
Cuerpo de la petición
{ enabled: boolean, memberIds: string[], contactIds: string[] }
Respuestas
200 — The answer.{ weeklyReport: { enabled: boolean, memberIds: string[], contactIds: string[], updatedAt: string | null }, readers: { kind: "member" | "contact", id: string, email: string, name: string }[] }
400 — One of: validation.failed, weekly_report.invalid_reader.401 — One of: auth.unauthenticated.403 — One of: request.host_not_allowed, permission.denied.429 — One of: request.rate_limited.
Ejemplo
curl -X PUT "https://api.nuvostatus.com/v1/report-settings" \
-H "Authorization: Bearer $NUVOSTATUS_KEY" \
-H "Content-Type: application/json" \
-d '{"enabled":true,"memberIds":["0199a1c0-0000-7000-8000-000000000001"],"contactIds":["0199a1c0-0000-7000-8000-000000000301"]}'
List the status pages
GET /v1/status-pagesÁmbito: read
The pages of the workspace, with their services and whether each is published. A key reads them; publishing one is an owner or an administrator in the dashboard.
Respuestas
200 — The answer.{ items: { id: string, slug: string, title: string, description: string | null, accentColor: string | null, logoUrl: string | null, subscriberAlertBudget: integer, hasPassword: boolean, published: boolean, publishedAt: string | null, customDomain: { domain: string | null, txtName: string | null, txtValue: string | null, state: "none" | "pending" | "verified" | "lapsed", lastCheckedAt: string | null, lastCheckOutcome: "verified" | "missing" | "mismatch" | "unavailable", lapsedAt: string | null }, services: … | …[], createdAt: string, updatedAt: string }[], next: string | null }
401 — One of: auth.unauthenticated.403 — One of: request.host_not_allowed.429 — One of: request.rate_limited.
Ejemplo
curl "https://api.nuvostatus.com/v1/status-pages" \
-H "Authorization: Bearer $NUVOSTATUS_KEY"
Read a status page
GET /v1/status-pages/{id}Ámbito: read
One page with its services, its address and whether it is published.
Parámetros
id — en la ruta, obligatorio
Respuestas
200 — The answer.{ id: string, slug: string, title: string, description: string | null, accentColor: string | null, logoUrl: string | null, subscriberAlertBudget: integer, hasPassword: boolean, published: boolean, publishedAt: string | null, customDomain: { domain: string | null, txtName: string | null, txtValue: string | null, state: "none" | "pending" | "verified" | "lapsed", lastCheckedAt: string | null, lastCheckOutcome: "verified" | "missing" | "mismatch" | "unavailable", lapsedAt: string | null }, services: { kind: "monitor", monitorId: string, name: string, displayName: string | null, position: integer } | { kind: "group", groupId: string, name: string, monitorIds: …[], position: integer }[], createdAt: string, updatedAt: string }
401 — One of: auth.unauthenticated.403 — One of: request.host_not_allowed.404 — One of: status_page.not_found.429 — One of: request.rate_limited.
Ejemplo
curl "https://api.nuvostatus.com/v1/status-pages/0199e6a0-0000-7000-8000-000000000001" \
-H "Authorization: Bearer $NUVOSTATUS_KEY"
List the notices of a status page
GET /v1/status-pages/{id}/announcementsÁmbito: read
The dated notices of the page, newest first, ended ones included. A visitor reads only the ones under way or still to come; the workspace manages the whole list.
Parámetros
id — en la ruta, obligatorio
Respuestas
200 — The answer.{ items: { id: string, title: string | null, body: string, startsAt: string, endsAt: string | null, createdAt: string, updatedAt: string }[], next: string | null }
401 — One of: auth.unauthenticated.403 — One of: request.host_not_allowed.404 — One of: status_page.not_found.429 — One of: request.rate_limited.
Ejemplo
curl "https://api.nuvostatus.com/v1/status-pages/0199e6a0-0000-7000-8000-000000000001/announcements" \
-H "Authorization: Bearer $NUVOSTATUS_KEY"
Publish a notice
POST /v1/status-pages/{id}/announcementsÁmbito: write
A notice is public copy with a window. A page holds at most twenty notices under way or still to come; an ended one stops counting. A write key publishes one as a member does.
Parámetros
id — en la ruta, obligatorio
Cuerpo de la petición
{ title?: string | null, body: string, startsAt: string, endsAt?: string | null }
Respuestas
201 — The answer.{ announcement: { id: string, title: string | null, body: string, startsAt: string, endsAt: string | null, createdAt: string, updatedAt: string } }
400 — One of: status_page_announcement.invalid_window, status_page_announcement.limit_reached.401 — One of: auth.unauthenticated.403 — One of: request.host_not_allowed, permission.denied.404 — One of: status_page.not_found.429 — One of: request.rate_limited.
Ejemplo
curl -X POST "https://api.nuvostatus.com/v1/status-pages/0199e6a0-0000-7000-8000-000000000001/announcements" \
-H "Authorization: Bearer $NUVOSTATUS_KEY" \
-H "Content-Type: application/json" \
-d '{"title":"Database migration","body":"We are migrating the database tonight. Expect a short pause.","startsAt":"2026-11-12T22:00:00Z","endsAt":"2026-11-13T00:00:00Z"}'
Change a notice
PATCH /v1/status-pages/{id}/announcements/{announcementId}Ámbito: write
A partial change, judged against the stored notice: moving only the end is as able to invert the window as sending both.
Parámetros
id — en la ruta, obligatorioannouncementId — en la ruta, obligatorio
Cuerpo de la petición
{ title?: string | null, body?: string, startsAt?: string, endsAt?: string | null }
Respuestas
200 — The answer.{ announcement: { id: string, title: string | null, body: string, startsAt: string, endsAt: string | null, createdAt: string, updatedAt: string } }
400 — One of: status_page_announcement.not_found, status_page_announcement.invalid_window, status_page_announcement.limit_reached.401 — One of: auth.unauthenticated.403 — One of: request.host_not_allowed, permission.denied.404 — One of: status_page.not_found.429 — One of: request.rate_limited.
Ejemplo
curl -X PATCH "https://api.nuvostatus.com/v1/status-pages/0199e6a0-0000-7000-8000-000000000001/announcements/{announcementId}" \
-H "Authorization: Bearer $NUVOSTATUS_KEY" \
-H "Content-Type: application/json" \
-d '{"endsAt":"2026-11-13T01:00:00Z"}'
Remove a notice
DELETE /v1/status-pages/{id}/announcements/{announcementId}Ámbito: write
The words leave the page at once; an ended notice could simply be left to expire.
Parámetros
id — en la ruta, obligatorioannouncementId — en la ruta, obligatorio
Respuestas
204 — Done; no body.400 — One of: status_page_announcement.not_found.401 — One of: auth.unauthenticated.403 — One of: request.host_not_allowed, permission.denied.404 — One of: status_page.not_found.429 — One of: request.rate_limited.
Ejemplo
curl -X DELETE "https://api.nuvostatus.com/v1/status-pages/0199e6a0-0000-7000-8000-000000000001/announcements/{announcementId}" \
-H "Authorization: Bearer $NUVOSTATUS_KEY"
Report a state for one published service
POST /v1/status-pages/{id}/services/{monitorId}/stateÁmbito: write
Tell the page what one of its services is doing when the cause is outside our checks — a payment provider, a CDN, a mail relay — with a note and a deadline. The page shows that state and its note until the deadline, then the monitors speak again by themselves; an expired state changes nothing a visitor reads, even before it is cleared. History, availability and the SLA keep what the monitors measured. The service is addressed by the monitor the page publishes as its own service; a monitor that is not one answers `status_page.service_not_found`. A write key reports one as a member does, and the change is audited.
Parámetros
id — en la ruta, obligatoriomonitorId — en la ruta, obligatorio
Cuerpo de la petición
{ state: "degraded" | "outage" | "operational", note?: string | null, minutes: integer }
Respuestas
200 — The answer.{ manualState: { monitorId: string, state: "degraded" | "outage" | "operational", note: string | null, expiresAt: string, createdAt: string } }
400 — One of: status_page.service_not_found, validation.failed.401 — One of: auth.unauthenticated.403 — One of: request.host_not_allowed, permission.denied.404 — One of: status_page.not_found.429 — One of: request.rate_limited.
Ejemplo
curl -X POST "https://api.nuvostatus.com/v1/status-pages/0199e6a0-0000-7000-8000-000000000001/services/{monitorId}/state" \
-H "Authorization: Bearer $NUVOSTATUS_KEY" \
-H "Content-Type: application/json" \
-d '{"state":"degraded","note":"Our payment provider is slow; card payments may fail.","minutes":90}'
Return a published service to its monitors
DELETE /v1/status-pages/{id}/services/{monitorId}/stateÁmbito: write
Clears a reported state before its deadline, so the page shows the checks again at once. Clearing a state nobody reported changes nothing and is no error. A write key clears one as a member does, and the change is audited.
Parámetros
id — en la ruta, obligatoriomonitorId — en la ruta, obligatorio
Respuestas
204 — Done; no body.400 — One of: status_page.service_not_found.401 — One of: auth.unauthenticated.403 — One of: request.host_not_allowed, permission.denied.404 — One of: status_page.not_found.429 — One of: request.rate_limited.
Ejemplo
curl -X DELETE "https://api.nuvostatus.com/v1/status-pages/0199e6a0-0000-7000-8000-000000000001/services/{monitorId}/state" \
-H "Authorization: Bearer $NUVOSTATUS_KEY"
List the subscribers of a status page
GET /v1/status-pages/{id}/subscribersÁmbito: read
The addresses subscribed to the page, newest first, and when each was confirmed, with the services each one follows (empty for the whole page, NV-101.1). An address is shown to the page’s own workspace only; the answer never carries a token, its hash or a way to stop. A read key reads the list.
Parámetros
id — en la ruta, obligatoriolimit — en la cadena de consulta, opcional. How many at most; the default is 50 for checks, 20 for incidents.cursor — en la cadena de consulta, opcional. The `next` of the previous page.serviceIds — en la cadena de consulta, opcional. A comma-separated list of the page’s service identifiers: only the addresses that follow one of them. An address that follows the whole page counts as following every one.
Respuestas
200 — The answer.{ items: { id: string, email: string, locale: string, confirmedAt: string | null, createdAt: string, serviceIds: string[], services: string[] }[], next: string | null }
400 — One of: validation.failed.401 — One of: auth.unauthenticated.403 — One of: request.host_not_allowed.404 — One of: status_page.not_found.429 — One of: request.rate_limited.
Ejemplo
curl "https://api.nuvostatus.com/v1/status-pages/0199e6a0-0000-7000-8000-000000000001/subscribers" \
-H "Authorization: Bearer $NUVOSTATUS_KEY"
Remove a subscriber
DELETE /v1/status-pages/{id}/subscribers/{subscriberId}Ámbito: write
The address stops receiving this page’s alerts at once, and may subscribe again later, starting unconfirmed. The row and its send state are removed. A write key removes one.
Parámetros
id — en la ruta, obligatoriosubscriberId — en la ruta, obligatorio
Respuestas
204 — Done; no body.400 — One of: status_page_subscriber.not_found.401 — One of: auth.unauthenticated.403 — One of: request.host_not_allowed, permission.denied.404 — One of: status_page.not_found.429 — One of: request.rate_limited.
Ejemplo
curl -X DELETE "https://api.nuvostatus.com/v1/status-pages/0199e6a0-0000-7000-8000-000000000001/subscribers/{subscriberId}" \
-H "Authorization: Bearer $NUVOSTATUS_KEY"
List the incidents
GET /v1/incidentsÁmbito: read
Newest first, open ones included. `assignedTo` narrows it to `me` (the caller's user; an API key has none), to `unassigned`, or to one member id.
Parámetros
limit — en la cadena de consulta, opcional. How many at most; the default is 50 for checks, 20 for incidents.cursor — en la cadena de consulta, opcional. The `next` of the previous page.
Respuestas
200 — The answer.{ items: { id: string, monitorId: string, monitorName: string, startedAt: string, confirmedAt: string, resolvedAt: string | null, resolution: "recovered" | "paused" | "superseded" | "deleted" | "manual", origin: "engine" | "manual", cause: string, statusCode: integer | null, checksFailed: integer, lastCheckAt: string, flapping: boolean, maintenance: boolean, regions: string[], acknowledgedAt: string | null, acknowledgedBy: { id: string, name: string }, impact: "minor" | "major" | "critical", assignee: { id: string, name: string }, assignedAt: string | null, declaredBy: { id: string, name: string }, declaredAt: string | null }[], next: string | null }
400 — One of: validation.failed.401 — One of: auth.unauthenticated.403 — One of: request.host_not_allowed.429 — One of: request.rate_limited.
Ejemplo
curl "https://api.nuvostatus.com/v1/incidents" \
-H "Authorization: Bearer $NUVOSTATUS_KEY"
Declare an incident by hand
POST /v1/incidentsÁmbito: write
The team already knows the monitor is down: a dependency told them before a check failed, or a hand-made change caused an outage no check can see. The incident is confirmed at its start, carries no failed check, and is shown, told, escalated and counted exactly as one the result pipeline confirmed. The monitor must belong to the workspace and must have no open incident of either origin. A viewer and a read key are refused.
Cuerpo de la petición
{ cause: string, severity?: "critical" | "standard", startedAt?: string, monitorId: string }
Respuestas
201 — The answer.{ incident: { id: string, monitorId: string, monitorName: string, startedAt: string, confirmedAt: string, resolvedAt: string | null, resolution: "recovered" | "paused" | "superseded" | "deleted" | "manual", origin: "engine" | "manual", cause: string, statusCode: integer | null, checksFailed: integer, lastCheckAt: string, flapping: boolean, maintenance: boolean, regions: string[], acknowledgedAt: string | null, acknowledgedBy: { id: string, name: string }, impact: "minor" | "major" | "critical", assignee: { id: string, name: string }, assignedAt: string | null, declaredBy: { id: string, name: string }, declaredAt: string | null } }
400 — One of: validation.failed, workspace.not_found, incident.already_open, incident.cause_invalid, incident.declaration_forbidden.401 — One of: auth.unauthenticated.403 — One of: request.host_not_allowed, permission.denied.429 — One of: request.rate_limited.
Ejemplo
curl -X POST "https://api.nuvostatus.com/v1/incidents" \
-H "Authorization: Bearer $NUVOSTATUS_KEY" \
-H "Content-Type: application/json" \
-d '{"monitorId":"0199a1c0-0000-7000-8000-000000000001","cause":"The payment provider is returning 503 for every charge.","severity":"critical"}'
Read an incident
GET /v1/incidents/{id}Ámbito: read
The incident, whether and by whom it was acknowledged, the events of its timeline (who was told, and when), the checks made during it and the comments people wrote on it.
Parámetros
id — en la ruta, obligatorio
Respuestas
200 — The answer.{ incident: { id: string, monitorId: string, monitorName: string, startedAt: string, confirmedAt: string, resolvedAt: string | null, resolution: "recovered" | "paused" | "superseded" | "deleted" | "manual", origin: "engine" | "manual", cause: string, statusCode: integer | null, checksFailed: integer, lastCheckAt: string, flapping: boolean, maintenance: boolean, regions: string[], acknowledgedAt: string | null, acknowledgedBy: { id: string, name: string }, impact: "minor" | "major" | "critical", assignee: { id: string, name: string }, assignedAt: string | null, declaredBy: { id: string, name: string }, declaredAt: string | null }, impactOverride: "minor" | "major" | "critical", derivedImpact: "minor" | "major" | "critical", events: { id: string, incidentId: string | null, type: "suspected" | "cleared" | "inconclusive" | "confirmed" | "recovering" | "relapsed" | "resolved" | "paused" | "superseded" | "deleted" | "escalated", at: string, checkScheduledAt: string | null, error: string | null, statusCode: integer | null, notify: "down" | "recovered", notifiedAt: string | null, notifyOutcome: "sent" | "quiet" | "withheld" | "nobody" | "maintenance" | "grouped" | "contact.unavailable", notifyCount: integer | null }[], checks: { scheduledAt: string, finishedAt: string, class: "ok" | "fail" | "skipped" | "probe_suspect", error: "dns_not_found" | "dns_failure" | "dns_timeout" | "connection_refused" | "connection_timeout" | "connection_reset" | "network_unreachable" | "tls_certificate_expired" | "tls_certificate_invalid" | "tls_hostname_mismatch" | "tls_handshake_failed" | "timeout" | "unexpected_status" | "too_many_redirects" | "invalid_redirect" | "destination_not_allowed" | "response_headers_too_large" | "protocol_error" | "keyword_not_found" | "keyword_found" | "json_invalid" | "json_path_missing" | "json_value_mismatch" | "json_too_large" | "header_missing" | "header_mismatch" | "final_url_mismatch" | "dns_no_records" | "dns_unexpected_answer" | "heartbeat_missed" | "no_reply" | "domain_expiring" | "domain_expired" | "lease_expired" | "rate_limited" | "expired" | "probe_overloaded" | "secret_unavailable" | "icmp_unavailable" | "domain_expiry_unknown" | "probe_no_ipv6" | "own_destination" | "self_check_failed", statusCode: integer | null, responseMs: integer | null, timings: { dnsMs: integer | null, connectMs: integer | null, tlsMs: integer | null, ttfbMs: integer | null }, resolvedIp: string | null, redirects: integer, attempts: integer, ping: { sent: integer, received: integer } }[], comments: { id: string, incidentId: string, author: { id: string, name: string }, body: string, visibility: "internal" | "public", createdAt: string }[], postmortem: { incidentId: string, rootCause: string, publicSummary: string, publishedAt: string | null, createdAt: string, updatedAt: string } }
401 — One of: auth.unauthenticated.403 — One of: request.host_not_allowed.404 — One of: incident.not_found.429 — One of: request.rate_limited.
Ejemplo
curl "https://api.nuvostatus.com/v1/incidents/0199e6a0-0000-7000-8000-000000000001" \
-H "Authorization: Bearer $NUVOSTATUS_KEY"
Read the derived timeline of an incident
GET /v1/incidents/{id}/timelineÁmbito: read
The incident told in order, derived from rows that already exist: the first failing check, its confirmation, the alert handed to the notifier, each escalation step with its targets, the acknowledgement and its author, the comments, the public updates and the recovery, each with the seconds since the previous event. It adds no table and copies no event.
Parámetros
id — en la ruta, obligatorio
Respuestas
200 — The answer.{ events: { kind: "detected" | "declared" | "confirmed" | "notified" | "escalation" | "acknowledged" | "comment" | "public_update" | "resolved", at: string, elapsedSeconds: integer, actor: { id: string, name: string }, body: string | null, notification: { said: "down" | "recovered", outcome: "sent" | "quiet" | "withheld" | "nobody" | "maintenance" | "grouped" | "contact.unavailable", count: integer | null }, escalation: { position: integer, targets: …[], outcome: "sent" | "quiet" | "withheld" | "nobody" | "maintenance" | "grouped" | "contact.unavailable" } }[] }
401 — One of: auth.unauthenticated.403 — One of: request.host_not_allowed.404 — One of: incident.not_found.429 — One of: request.rate_limited.
Ejemplo
curl "https://api.nuvostatus.com/v1/incidents/0199e6a0-0000-7000-8000-000000000001/timeline" \
-H "Authorization: Bearer $NUVOSTATUS_KEY"
Read the delivery log of an incident
GET /v1/incidents/{id}/deliveriesÁmbito: read
Every attempt to tell a channel about the incident, newest first: the channel, its status, the attempts, the moment and, for a failure, our classification of the cause. It carries no destination and no payload.
Parámetros
id — en la ruta, obligatorio
Respuestas
200 — The answer.{ items: { id: string, channel: { id: string, name: string, kind: "webhook" | "slack" | "telegram" | "teams" | "discord" | "google_chat" | "mattermost" | "splunk" | "pagerduty" | "pushover" | "pushbullet" | "sms" | "voice" | "zapier" }, incidentEventId: string | null, status: "pending" | "delivered" | "failed", attempts: integer, lastAttemptAt: string | null, deliveredAt: string | null, errorCode: string | null, createdAt: string }[], next: string | null }
401 — One of: auth.unauthenticated.403 — One of: request.host_not_allowed.404 — One of: incident.not_found.429 — One of: request.rate_limited.
Ejemplo
curl "https://api.nuvostatus.com/v1/incidents/0199e6a0-0000-7000-8000-000000000001/deliveries" \
-H "Authorization: Bearer $NUVOSTATUS_KEY"
Retry a failed delivery
POST /v1/deliveries/{id}/retryÁmbito: write
Queues a failed alert again, unchanged, for the worker to send. A delivery that already succeeded is refused with `delivery.not_retryable` rather than sent twice.
Parámetros
id — en la ruta, obligatorio
Respuestas
204 — Done; no body.400 — One of: delivery.not_found, delivery.not_retryable.401 — One of: auth.unauthenticated.403 — One of: request.host_not_allowed, permission.denied.429 — One of: request.rate_limited.
Ejemplo
curl -X POST "https://api.nuvostatus.com/v1/deliveries/0199e6a0-0000-7000-8000-000000000001/retry" \
-H "Authorization: Bearer $NUVOSTATUS_KEY"
Acknowledge an incident
POST /v1/incidents/{id}/acknowledgeÁmbito: write
Marks it seen. The first acknowledgement stands; a key acknowledges without a person to name.
Parámetros
id — en la ruta, obligatorio
Respuestas
200 — The answer.{ incident: { id: string, monitorId: string, monitorName: string, startedAt: string, confirmedAt: string, resolvedAt: string | null, resolution: "recovered" | "paused" | "superseded" | "deleted" | "manual", origin: "engine" | "manual", cause: string, statusCode: integer | null, checksFailed: integer, lastCheckAt: string, flapping: boolean, maintenance: boolean, regions: string[], acknowledgedAt: string | null, acknowledgedBy: { id: string, name: string }, impact: "minor" | "major" | "critical", assignee: { id: string, name: string }, assignedAt: string | null, declaredBy: { id: string, name: string }, declaredAt: string | null } }
401 — One of: auth.unauthenticated.403 — One of: request.host_not_allowed, permission.denied.404 — One of: incident.not_found.429 — One of: request.rate_limited.
Ejemplo
curl -X POST "https://api.nuvostatus.com/v1/incidents/0199e6a0-0000-7000-8000-000000000001/acknowledge" \
-H "Authorization: Bearer $NUVOSTATUS_KEY"
Resolve a declared incident by hand
POST /v1/incidents/{id}/resolveÁmbito: write
Closes the incident a person declared, with an optional note kept in its timeline beside the person who wrote it. The incident ends with `resolution: "manual"` and any pending escalation is withdrawn. An incident the result pipeline opened cannot be closed this way: the checks own it.
Parámetros
id — en la ruta, obligatorio
Cuerpo de la petición
{ note?: string }
Respuestas
200 — The answer.{ incident: { id: string, monitorId: string, monitorName: string, startedAt: string, confirmedAt: string, resolvedAt: string | null, resolution: "recovered" | "paused" | "superseded" | "deleted" | "manual", origin: "engine" | "manual", cause: string, statusCode: integer | null, checksFailed: integer, lastCheckAt: string, flapping: boolean, maintenance: boolean, regions: string[], acknowledgedAt: string | null, acknowledgedBy: { id: string, name: string }, impact: "minor" | "major" | "critical", assignee: { id: string, name: string }, assignedAt: string | null, declaredBy: { id: string, name: string }, declaredAt: string | null } }
400 — One of: validation.failed, incident.not_manual, incident.already_resolved, incident.declaration_forbidden.401 — One of: auth.unauthenticated.403 — One of: request.host_not_allowed, permission.denied.404 — One of: incident.not_found.429 — One of: request.rate_limited.
Ejemplo
curl -X POST "https://api.nuvostatus.com/v1/incidents/0199e6a0-0000-7000-8000-000000000001/resolve" \
-H "Authorization: Bearer $NUVOSTATUS_KEY" \
-H "Content-Type: application/json" \
-d '{"note":"The provider is back and charges are going through."}'
Publish an update about an incident
POST /v1/incidents/{id}/updatesÁmbito: write
Visitors of the workspace’s status page read it in the incident’s timeline. The update carries its words and its moment; it never names the author.
Parámetros
id — en la ruta, obligatorio
Cuerpo de la petición
{ body: string }
Respuestas
201 — The answer.{ update: { id: string, incidentId: string, author: { id: string, name: string }, body: string, visibility: "public", createdAt: string } }
400 — One of: validation.failed.401 — One of: auth.unauthenticated.403 — One of: request.host_not_allowed, permission.denied.404 — One of: incident.not_found.429 — One of: request.rate_limited.
Ejemplo
curl -X POST "https://api.nuvostatus.com/v1/incidents/0199e6a0-0000-7000-8000-000000000001/updates" \
-H "Authorization: Bearer $NUVOSTATUS_KEY" \
-H "Content-Type: application/json" \
-d '{"body":"The database is back and the shop is serving requests again."}'
Set or clear an incident's impact
PATCH /v1/incidents/{id}/impactÁmbito: write
How bad the incident is, chosen on purpose: `minor`, `major` or `critical`, or null to let the rule decide again. The incident answers the level a reader sees and the override that stands. The act is audited with what a reader saw before and after.
Parámetros
id — en la ruta, obligatorio
Cuerpo de la petición
{ impact: "minor" | "major" | "critical" }
Respuestas
200 — The answer.{ incident: { id: string, monitorId: string, monitorName: string, startedAt: string, confirmedAt: string, resolvedAt: string | null, resolution: "recovered" | "paused" | "superseded" | "deleted" | "manual", origin: "engine" | "manual", cause: string, statusCode: integer | null, checksFailed: integer, lastCheckAt: string, flapping: boolean, maintenance: boolean, regions: string[], acknowledgedAt: string | null, acknowledgedBy: { id: string, name: string }, impact: "minor" | "major" | "critical", assignee: { id: string, name: string }, assignedAt: string | null, declaredBy: { id: string, name: string }, declaredAt: string | null }, impactOverride: "minor" | "major" | "critical" }
400 — One of: validation.failed, incident.impact_invalid.401 — One of: auth.unauthenticated.403 — One of: request.host_not_allowed, permission.denied.404 — One of: incident.not_found.429 — One of: request.rate_limited.
Ejemplo
curl -X PATCH "https://api.nuvostatus.com/v1/incidents/0199e6a0-0000-7000-8000-000000000001/impact" \
-H "Authorization: Bearer $NUVOSTATUS_KEY" \
-H "Content-Type: application/json" \
-d '{"impact":"critical"}'
Put a member in charge of an incident, or leave it to nobody
PATCH /v1/incidents/{id}/assignmentÁmbito: write
One member of the workspace owns an incident. Null leaves it to nobody. An owner or an administrator may; a member, a viewer and an API key are refused. A resolved incident may still be assigned.
Parámetros
id — en la ruta, obligatorio
Cuerpo de la petición
{ assigneeUserId: string | null }
Respuestas
200 — The answer.{ incident: { id: string, monitorId: string, monitorName: string, startedAt: string, confirmedAt: string, resolvedAt: string | null, resolution: "recovered" | "paused" | "superseded" | "deleted" | "manual", origin: "engine" | "manual", cause: string, statusCode: integer | null, checksFailed: integer, lastCheckAt: string, flapping: boolean, maintenance: boolean, regions: string[], acknowledgedAt: string | null, acknowledgedBy: { id: string, name: string }, impact: "minor" | "major" | "critical", assignee: { id: string, name: string }, assignedAt: string | null, declaredBy: { id: string, name: string }, declaredAt: string | null } }
400 — One of: validation.failed, incident.assignee_not_member, incident.assignment_forbidden.401 — One of: auth.unauthenticated.403 — One of: request.host_not_allowed, permission.denied.404 — One of: incident.not_found.429 — One of: request.rate_limited.
Ejemplo
curl -X PATCH "https://api.nuvostatus.com/v1/incidents/0199e6a0-0000-7000-8000-000000000001/assignment" \
-H "Authorization: Bearer $NUVOSTATUS_KEY" \
-H "Content-Type: application/json" \
-d '{"assigneeUserId":"0199a1c0-0000-7000-8000-000000000001"}'
Read the postmortem of an incident
GET /v1/incidents/{id}/postmortemÁmbito: read
Why it happened and what was done, kept inside the workspace. `publishedAt` says whether visitors of the workspace’s status page read its public summary; null means a draft. The answer is null until a member drafts one.
Parámetros
id — en la ruta, obligatorio
Respuestas
200 — The answer.{ postmortem: { incidentId: string, rootCause: string, publicSummary: string, publishedAt: string | null, createdAt: string, updatedAt: string } }
401 — One of: auth.unauthenticated.403 — One of: request.host_not_allowed, permission.denied.404 — One of: incident.not_found.429 — One of: request.rate_limited.
Ejemplo
curl "https://api.nuvostatus.com/v1/incidents/0199e6a0-0000-7000-8000-000000000001/postmortem" \
-H "Authorization: Bearer $NUVOSTATUS_KEY"
Draft or correct the postmortem of an incident
PUT /v1/incidents/{id}/postmortemÁmbito: write
Takes the root cause the team keeps and the summary a visitor may read. The incident must be resolved (`incident.not_resolved`); a draft stays inside the workspace. Correcting a published one changes what visitors read at once.
Parámetros
id — en la ruta, obligatorio
Cuerpo de la petición
{ rootCause: string, publicSummary: string }
Respuestas
200 — The answer.{ postmortem: { incidentId: string, rootCause: string, publicSummary: string, publishedAt: string | null, createdAt: string, updatedAt: string } }
400 — One of: validation.failed, incident.not_resolved.401 — One of: auth.unauthenticated.403 — One of: request.host_not_allowed, permission.denied.404 — One of: incident.not_found.429 — One of: request.rate_limited.
Ejemplo
curl -X PUT "https://api.nuvostatus.com/v1/incidents/0199e6a0-0000-7000-8000-000000000001/postmortem" \
-H "Authorization: Bearer $NUVOSTATUS_KEY" \
-H "Content-Type: application/json" \
-d '{"rootCause":"A connection pool limit set below the traffic the shop received exhausted every connection.","publicSummary":"The shop was unreachable for eleven minutes because its database connections ran out. We raised the limit and added an alert on pool saturation."}'
Publish the postmortem
POST /v1/incidents/{id}/postmortem/publishÁmbito: write
Shows its public summary under the incident on the status pages that carry it, in the page’s language. The first publication’s moment stands; the root cause is never shown.
Parámetros
id — en la ruta, obligatorio
Respuestas
200 — The answer.{ postmortem: { incidentId: string, rootCause: string, publicSummary: string, publishedAt: string | null, createdAt: string, updatedAt: string } }
400 — One of: incident.not_resolved, postmortem.not_found.401 — One of: auth.unauthenticated.403 — One of: request.host_not_allowed, permission.denied.404 — One of: incident.not_found.429 — One of: request.rate_limited.
Ejemplo
curl -X POST "https://api.nuvostatus.com/v1/incidents/0199e6a0-0000-7000-8000-000000000001/postmortem/publish" \
-H "Authorization: Bearer $NUVOSTATUS_KEY"
Unpublish the postmortem
POST /v1/incidents/{id}/postmortem/unpublishÁmbito: write
Removes its summary from every public page again without deleting a word: it becomes a draft that only the workspace reads.
Parámetros
id — en la ruta, obligatorio
Respuestas
200 — The answer.{ postmortem: { incidentId: string, rootCause: string, publicSummary: string, publishedAt: string | null, createdAt: string, updatedAt: string } }
400 — One of: incident.not_resolved, postmortem.not_found.401 — One of: auth.unauthenticated.403 — One of: request.host_not_allowed, permission.denied.404 — One of: incident.not_found.429 — One of: request.rate_limited.
Ejemplo
curl -X POST "https://api.nuvostatus.com/v1/incidents/0199e6a0-0000-7000-8000-000000000001/postmortem/unpublish" \
-H "Authorization: Bearer $NUVOSTATUS_KEY"
List the action items of a postmortem
GET /v1/incidents/{id}/action-itemsÁmbito: read
The work a resolved incident’s postmortem demands: each fix with its owner, its plain calendar due date, its state of open, done or dropped, and whether it is overdue. A viewer and a read key may ask; the list is scoped to the key’s workspace.
Parámetros
id — en la ruta, obligatorio
Respuestas
200 — The answer.{ items: { id: string, incidentId: string, title: string, detail: string | null, owner: { id: string, name: string }, dueOn: string | null, state: "open" | "done" | "dropped", completedAt: string | null, completedBy: { id: string, name: string }, createdAt: string, overdue: boolean }[], next: string | null }
401 — One of: auth.unauthenticated.403 — One of: request.host_not_allowed, permission.denied.404 — One of: incident.not_found.429 — One of: request.rate_limited.
Ejemplo
curl "https://api.nuvostatus.com/v1/incidents/0199e6a0-0000-7000-8000-000000000001/action-items" \
-H "Authorization: Bearer $NUVOSTATUS_KEY"
Add an action item to a postmortem
POST /v1/incidents/{id}/action-itemsÁmbito: write
Adds one fix with an optional detail, one owner who must be a member and a due date that cannot be in the past. The incident must be resolved and have a postmortem; at most fifty items exist per incident (`action_item.too_many`). The act is audited by the item’s id, never its title.
Parámetros
id — en la ruta, obligatorio
Cuerpo de la petición
{ title: string, detail?: string | null, ownerUserId?: string | null, dueOn?: string | null }
Respuestas
201 — The answer.{ item: { id: string, incidentId: string, title: string, detail: string | null, owner: { id: string, name: string }, dueOn: string | null, state: "open" | "done" | "dropped", completedAt: string | null, completedBy: { id: string, name: string }, createdAt: string, overdue: boolean } }
400 — One of: validation.failed, postmortem.not_found, action_item.incident_open, action_item.too_many, action_item.owner_not_member, action_item.due_in_past.401 — One of: auth.unauthenticated.403 — One of: request.host_not_allowed, permission.denied.404 — One of: incident.not_found.429 — One of: request.rate_limited.
Ejemplo
curl -X POST "https://api.nuvostatus.com/v1/incidents/0199e6a0-0000-7000-8000-000000000001/action-items" \
-H "Authorization: Bearer $NUVOSTATUS_KEY" \
-H "Content-Type: application/json" \
-d '{"title":"Raise the connection pool limit","detail":"From 20 to 80 connections, then alert at 70 percent.","ownerUserId":"0199a1c0-0000-7000-8000-000000000001","dueOn":"2026-11-20"}'
Change an action item
PATCH /v1/action-items/{id}Ámbito: write
Changes its words, its owner, its due date or its state. Only open→done, open→dropped and done→open are legal; a completion names the person and the moment, and a reopen clears both. A due date may be recorded in the past here. The act is audited by the item’s id, never its title.
Parámetros
id — en la ruta, obligatorio
Cuerpo de la petición
{ title?: string, detail?: string | null, ownerUserId?: string | null, dueOn?: string | null, state?: "open" | "done" | "dropped" }
Respuestas
200 — The answer.{ item: { id: string, incidentId: string, title: string, detail: string | null, owner: { id: string, name: string }, dueOn: string | null, state: "open" | "done" | "dropped", completedAt: string | null, completedBy: { id: string, name: string }, createdAt: string, overdue: boolean } }
400 — One of: validation.failed, action_item.not_found, action_item.owner_not_member.401 — One of: auth.unauthenticated.403 — One of: request.host_not_allowed, permission.denied.429 — One of: request.rate_limited.
Ejemplo
curl -X PATCH "https://api.nuvostatus.com/v1/action-items/0199e6a0-0000-7000-8000-000000000001" \
-H "Authorization: Bearer $NUVOSTATUS_KEY" \
-H "Content-Type: application/json" \
-d '{"state":"done"}'
List the workspace’s action items
GET /v1/action-itemsÁmbito: read
Everything the workspace’s postmortems demanded, across incidents, earliest due date first and undated ones last. Narrows by one state, one owner (`me`, `unassigned` or a member’s id) and `overdue=true`, which keeps only open work. A key has no person behind `me`.
Parámetros
state — en la cadena de consulta, opcionalowner — en la cadena de consulta, opcionaloverdue — en la cadena de consulta, opcionallimit — en la cadena de consulta, opcional
Respuestas
200 — The answer.{ items: { id: string, incidentId: string, title: string, detail: string | null, owner: { id: string, name: string }, dueOn: string | null, state: "open" | "done" | "dropped", completedAt: string | null, completedBy: { id: string, name: string }, createdAt: string, overdue: boolean }[], next: string | null }
400 — One of: validation.failed.401 — One of: auth.unauthenticated.403 — One of: request.host_not_allowed, permission.denied.429 — One of: request.rate_limited.
Ejemplo
curl "https://api.nuvostatus.com/v1/action-items" \
-H "Authorization: Bearer $NUVOSTATUS_KEY"
List the maintenance windows
GET /v1/maintenance-windowsÁmbito: read
The ones under way or to come, soonest first, then the last ten that are over.
Respuestas
200 — The answer.{ items: { id: string, name: string, startsAt: string, endsAt: string, recurrence: "none" | "daily" | "weekly" | "monthly", timeZone: string | null, monitorIds: string[], createdBy: string | null, createdAt: string, state: "scheduled" | "active" | "past" }[], next: string | null }
401 — One of: auth.unauthenticated.403 — One of: request.host_not_allowed.429 — One of: request.rate_limited.
Ejemplo
curl "https://api.nuvostatus.com/v1/maintenance-windows" \
-H "Authorization: Bearer $NUVOSTATUS_KEY"
Read a maintenance window
GET /v1/maintenance-windows/{id}Ámbito: read
One window, whether it is scheduled, under way or over.
Parámetros
id — en la ruta, obligatorio
Respuestas
200 — The answer.{ id: string, name: string, startsAt: string, endsAt: string, recurrence: "none" | "daily" | "weekly" | "monthly", timeZone: string | null, monitorIds: string[], createdBy: string | null, createdAt: string, state: "scheduled" | "active" | "past" }
401 — One of: auth.unauthenticated.403 — One of: request.host_not_allowed.404 — One of: maintenance.not_found.429 — One of: request.rate_limited.
Ejemplo
curl "https://api.nuvostatus.com/v1/maintenance-windows/0199e6a0-0000-7000-8000-000000000001" \
-H "Authorization: Bearer $NUVOSTATUS_KEY"
Schedule a maintenance window
POST /v1/maintenance-windowsÁmbito: write
Checks go on under a window; an incident that opens is recorded without an email, and the window's time counts for nothing in uptime. A retry with the same `Idempotency-Key` replays the first answer.
Parámetros
Idempotency-Key — en la cadena de consulta, opcional
Cuerpo de la petición
{ name: string, startsAt: string, endsAt: string, monitorIds: string[], groupIds?: string[], recurrence?: "none" | "daily" | "weekly" | "monthly", timeZone?: string | null }
Respuestas
201 — The answer.{ id: string, name: string, startsAt: string, endsAt: string, recurrence: "none" | "daily" | "weekly" | "monthly", timeZone: string | null, monitorIds: string[], createdBy: string | null, createdAt: string, state: "scheduled" | "active" | "past" }
400 — One of: validation.failed.401 — One of: auth.unauthenticated.403 — One of: request.host_not_allowed, permission.denied.404 — One of: maintenance.monitor_not_found.409 — One of: maintenance.limit_reached, idempotency.conflict, idempotency.in_progress.429 — One of: request.rate_limited.
Ejemplo
curl -X POST "https://api.nuvostatus.com/v1/maintenance-windows" \
-H "Authorization: Bearer $NUVOSTATUS_KEY" \
-H "Content-Type: application/json" \
-d '{"name":"Database upgrade","startsAt":"2026-10-12T22:00:00Z","endsAt":"2026-10-13T00:00:00Z","monitorIds":["0199e6a0-0000-7000-8000-000000000001"]}'
Schedule several maintenance windows at once
POST /v1/maintenance-windows/bulkÁmbito: write
Up to fifty windows in one request. Each is scheduled in its own transaction and answered with its own result: an invalid window, a monitor or group of another workspace, or a plan limit reached fails that item only, and the others are created. An omitted monitor or group list means every monitor.
Cuerpo de la petición
{ windows: any[] }
Respuestas
200 — The answer.{ results: { index: integer, id?: string, code?: "auth.cannot_revoke_current" | "auth.email_not_verified" | "auth.invalid_code" | "auth.invalid_credentials" | "auth.invalid_token" | "auth.password_too_long" | "auth.password_too_short" | "auth.totp_required" | "auth.two_factor_already_enabled" | "auth.two_factor_not_enabled" | "auth.unauthenticated" | "internal.error" | "invitation.already_member" | "invitation.limit_reached" | "invitation.not_found" | "account.password_incorrect" | "account.sole_owner" | "account.disabled" | "account.email_taken" | "account.email_unchanged" | "admin.not_an_operator" | "admin.permission_denied" | "admin.user_not_found" | "admin.workspace_not_found" | "admin.monitor_not_found" | "admin.incident_not_found" | "admin.plan_unknown" | "admin.plan_below_usage" | "admin.override_invalid" | "admin.subscription_not_found" | "alert_digest.invalid_window" | "alert_grouping.invalid" | "api.bulk_empty" | "audit.read_forbidden" | "billing.provider_unavailable" | "billing.plan_not_sold" | "billing.no_subscription" | "billing.subscription_state" | "billing.subscription_conflict" | "billing.webhook_rejected" | "entitlement.feature_not_included" | "escalation_steps.invalid" | "escalation.rotation_not_found" | "escalation_steps.contact_not_found" | "escalation_steps.channel_not_found" | "member.limit_reached" | "member.last_owner" | "member.not_found" | "member.role_not_assignable" | "monitor.account_limit_reached" | "monitor.confirmation_out_of_range" | "monitor.interval_not_allowed" | "monitor.limit_reached" | "monitor.timeout_not_allowed" | "monitor.update_forbidden" | "import.invalid_export" | "import.row_refused" | "import.secret_unavailable" | "import.source_key_refused" | "import.source_unavailable" | "import.unsupported_type" | "import.missing_target" | "import.invalid_target" | "import.invalid_name" | "import.unsupported_interval" | "import.too_many_rows" | "incident.not_found" | "incident.invalid_cursor" | "incident.impact_invalid" | "incident.assignee_not_member" | "incident.assignment_forbidden" | "incident.already_resolved" | "incident.not_resolved" | "incident.already_open" | "incident.not_manual" | "incident.cause_invalid" | "incident.declaration_forbidden" | "incident.export_too_large" | "action_item.not_found" | "action_item.too_many" | "action_item.incident_open" | "action_item.owner_not_member" | "action_item.due_in_past" | "postmortem.not_found" | "incident_comment.not_author" | "incident_comment.not_found" | "monitor.invalid_cursor" | "monitor.not_found" | "monitor.not_deleted" | "monitor.restore_window_expired" | "monitor.url_not_allowed" | "monitor.channel_not_found" | "monitor.keyword_needs_body" | "monitor.conditions_need_body" | "monitor.json_condition_needs_body" | "monitor.config_invalid" | "monitor.authorization_header_conflict" | "monitor.auth_value_has_scheme" | "monitor.domain_invalid" | "monitor.secrets_unavailable" | "monitor.host_not_allowed" | "monitor.not_a_heartbeat" | "monitor.slow_response_not_supported" | "monitor.baseline_not_supported" | "monitor.pause_until_in_past" | "monitor.pause_until_too_far" | "monitor.dependency_not_found" | "monitor.dependency_self" | "monitor.dependency_limit" | "monitor.dependency_duplicate" | "monitor.dependency_cycle" | "monitor.runbook_url_invalid" | "monitor.paused" | "monitor.check_too_soon" | "monitor.check_budget_spent" | "monitor.check_not_supported" | "monitor.no_capable_probe" | "manual_check.not_found" | "on_call.invalid_participant" | "on_call.invalid_window" | "on_call.invalid_name" | "on_call.name_taken" | "on_call.rotation_not_found" | "on_call.rotation_last" | "rotation.in_use" | "group.not_found" | "group.name_taken" | "group.limit_reached" | "group.order_invalid" | "idempotency.conflict" | "idempotency.in_progress" | "tag.not_found" | "tag.name_taken" | "tag.limit_reached" | "tag.limit_per_monitor" | "sla_policy.not_found" | "sla_policy.name_taken" | "sla_policy.monitor_already_covered" | "sla_report.not_found" | "sla_report.month_not_closed" | "sla_report.too_large" | "api_key.not_found" | "api_key.limit_reached" | "api_key.write_key_not_limited" | "api_key.monitor_not_allowed" | "api_key.not_rotatable" | "api_key.grace_out_of_range" | "contact.not_found" | "contact.already_exists" | "contact.limit_reached" | "contact.availability_invalid" | "contact.unavailable" | "maintenance.not_found" | "maintenance.not_editable" | "maintenance.limit_reached" | "maintenance.monitor_not_found" | "maintenance.group_not_found" | "maintenance.invalid_window" | "maintenance.skip_not_recurring" | "maintenance.skip_not_an_occurrence" | "maintenance.skip_started" | "maintenance.skip_already_skipped" | "maintenance.skip_not_found" | "maintenance_window.group_not_found" | "maintenance_window.limit_exceeded" | "maintenance_window.monitor_not_found" | "maintenance_window.not_active" | "maintenance_window.not_found" | "contact.not_verified" | "contact.unknown_contact" | "contact.verification_invalid" | "channel.not_found" | "channel.name_taken" | "channel.limit_reached" | "channel.config_invalid" | "channel.events_empty" | "channel.secret_unavailable" | "channel.secret_not_rotatable" | "delivery.not_found" | "delivery.not_retryable" | "delivery.paced" | "email.lane_budget_exhausted" | "email.suppression_not_found" | "email.webhook_rejected" | "alert_provider.not_configured" | "permission.denied" | "probe.enrolment_expired" | "probe.enrolment_invalid_key" | "probe.enrolment_invalid_request" | "probe.enrolment_revoked" | "probe.enrolment_unknown" | "probe.enrolment_used" | "request.content_type_not_allowed" | "request.cross_site" | "request.host_not_allowed" | "request.origin_missing" | "request.origin_not_allowed" | "request.rate_limited" | "resource.not_found" | "status_page.limit_reached" | "status_page.monitor_not_found" | "status_page.not_found" | "status_page.password_incorrect" | "status_page.slug_taken" | "status_page.unavailable" | "status_page.service_not_found" | "status_page.services_required" | "status_page.domain_invalid" | "status_page.domain_taken" | "status_page_announcement.invalid_window" | "status_page_announcement.limit_reached" | "status_page_announcement.not_found" | "status_page_subscriber.not_found" | "validation.failed" | "weekly_report.invalid_reader" | "workspace.limit_reached" | "workspace.not_found" | "workspace.nothing_to_change" | "workspace.import_limit_exceeded" }[] }
400 — One of: validation.failed, api.bulk_empty, maintenance.invalid_window.401 — One of: auth.unauthenticated.403 — One of: request.host_not_allowed, permission.denied.404 — One of: maintenance_window.monitor_not_found, maintenance_window.group_not_found.409 — One of: maintenance_window.limit_exceeded.429 — One of: request.rate_limited.
Ejemplo
curl -X POST "https://api.nuvostatus.com/v1/maintenance-windows/bulk" \
-H "Authorization: Bearer $NUVOSTATUS_KEY" \
-H "Content-Type: application/json" \
-d '{"windows":[{"name":"Database upgrade","startsAt":"2026-10-12T22:00:00Z","endsAt":"2026-10-13T00:00:00Z","monitorIds":["0199e6a0-0000-7000-8000-000000000001"]},{"name":"Certificate rotation","startsAt":"2026-10-14T22:00:00Z","endsAt":"2026-10-15T00:00:00Z"}]}'
End several maintenance windows now
POST /v1/maintenance-windows/bulk/endÁmbito: write
Up to a hundred windows. Only a window under way ends; one that has not begun, or is already over, answers `maintenance_window.not_active` in its own result. A window of another workspace is as absent as one that never existed, and no id of another workspace is returned.
Cuerpo de la petición
{ ids: string[] }
Respuestas
200 — The answer.{ results: { id: string, code?: "auth.cannot_revoke_current" | "auth.email_not_verified" | "auth.invalid_code" | "auth.invalid_credentials" | "auth.invalid_token" | "auth.password_too_long" | "auth.password_too_short" | "auth.totp_required" | "auth.two_factor_already_enabled" | "auth.two_factor_not_enabled" | "auth.unauthenticated" | "internal.error" | "invitation.already_member" | "invitation.limit_reached" | "invitation.not_found" | "account.password_incorrect" | "account.sole_owner" | "account.disabled" | "account.email_taken" | "account.email_unchanged" | "admin.not_an_operator" | "admin.permission_denied" | "admin.user_not_found" | "admin.workspace_not_found" | "admin.monitor_not_found" | "admin.incident_not_found" | "admin.plan_unknown" | "admin.plan_below_usage" | "admin.override_invalid" | "admin.subscription_not_found" | "alert_digest.invalid_window" | "alert_grouping.invalid" | "api.bulk_empty" | "audit.read_forbidden" | "billing.provider_unavailable" | "billing.plan_not_sold" | "billing.no_subscription" | "billing.subscription_state" | "billing.subscription_conflict" | "billing.webhook_rejected" | "entitlement.feature_not_included" | "escalation_steps.invalid" | "escalation.rotation_not_found" | "escalation_steps.contact_not_found" | "escalation_steps.channel_not_found" | "member.limit_reached" | "member.last_owner" | "member.not_found" | "member.role_not_assignable" | "monitor.account_limit_reached" | "monitor.confirmation_out_of_range" | "monitor.interval_not_allowed" | "monitor.limit_reached" | "monitor.timeout_not_allowed" | "monitor.update_forbidden" | "import.invalid_export" | "import.row_refused" | "import.secret_unavailable" | "import.source_key_refused" | "import.source_unavailable" | "import.unsupported_type" | "import.missing_target" | "import.invalid_target" | "import.invalid_name" | "import.unsupported_interval" | "import.too_many_rows" | "incident.not_found" | "incident.invalid_cursor" | "incident.impact_invalid" | "incident.assignee_not_member" | "incident.assignment_forbidden" | "incident.already_resolved" | "incident.not_resolved" | "incident.already_open" | "incident.not_manual" | "incident.cause_invalid" | "incident.declaration_forbidden" | "incident.export_too_large" | "action_item.not_found" | "action_item.too_many" | "action_item.incident_open" | "action_item.owner_not_member" | "action_item.due_in_past" | "postmortem.not_found" | "incident_comment.not_author" | "incident_comment.not_found" | "monitor.invalid_cursor" | "monitor.not_found" | "monitor.not_deleted" | "monitor.restore_window_expired" | "monitor.url_not_allowed" | "monitor.channel_not_found" | "monitor.keyword_needs_body" | "monitor.conditions_need_body" | "monitor.json_condition_needs_body" | "monitor.config_invalid" | "monitor.authorization_header_conflict" | "monitor.auth_value_has_scheme" | "monitor.domain_invalid" | "monitor.secrets_unavailable" | "monitor.host_not_allowed" | "monitor.not_a_heartbeat" | "monitor.slow_response_not_supported" | "monitor.baseline_not_supported" | "monitor.pause_until_in_past" | "monitor.pause_until_too_far" | "monitor.dependency_not_found" | "monitor.dependency_self" | "monitor.dependency_limit" | "monitor.dependency_duplicate" | "monitor.dependency_cycle" | "monitor.runbook_url_invalid" | "monitor.paused" | "monitor.check_too_soon" | "monitor.check_budget_spent" | "monitor.check_not_supported" | "monitor.no_capable_probe" | "manual_check.not_found" | "on_call.invalid_participant" | "on_call.invalid_window" | "on_call.invalid_name" | "on_call.name_taken" | "on_call.rotation_not_found" | "on_call.rotation_last" | "rotation.in_use" | "group.not_found" | "group.name_taken" | "group.limit_reached" | "group.order_invalid" | "idempotency.conflict" | "idempotency.in_progress" | "tag.not_found" | "tag.name_taken" | "tag.limit_reached" | "tag.limit_per_monitor" | "sla_policy.not_found" | "sla_policy.name_taken" | "sla_policy.monitor_already_covered" | "sla_report.not_found" | "sla_report.month_not_closed" | "sla_report.too_large" | "api_key.not_found" | "api_key.limit_reached" | "api_key.write_key_not_limited" | "api_key.monitor_not_allowed" | "api_key.not_rotatable" | "api_key.grace_out_of_range" | "contact.not_found" | "contact.already_exists" | "contact.limit_reached" | "contact.availability_invalid" | "contact.unavailable" | "maintenance.not_found" | "maintenance.not_editable" | "maintenance.limit_reached" | "maintenance.monitor_not_found" | "maintenance.group_not_found" | "maintenance.invalid_window" | "maintenance.skip_not_recurring" | "maintenance.skip_not_an_occurrence" | "maintenance.skip_started" | "maintenance.skip_already_skipped" | "maintenance.skip_not_found" | "maintenance_window.group_not_found" | "maintenance_window.limit_exceeded" | "maintenance_window.monitor_not_found" | "maintenance_window.not_active" | "maintenance_window.not_found" | "contact.not_verified" | "contact.unknown_contact" | "contact.verification_invalid" | "channel.not_found" | "channel.name_taken" | "channel.limit_reached" | "channel.config_invalid" | "channel.events_empty" | "channel.secret_unavailable" | "channel.secret_not_rotatable" | "delivery.not_found" | "delivery.not_retryable" | "delivery.paced" | "email.lane_budget_exhausted" | "email.suppression_not_found" | "email.webhook_rejected" | "alert_provider.not_configured" | "permission.denied" | "probe.enrolment_expired" | "probe.enrolment_invalid_key" | "probe.enrolment_invalid_request" | "probe.enrolment_revoked" | "probe.enrolment_unknown" | "probe.enrolment_used" | "request.content_type_not_allowed" | "request.cross_site" | "request.host_not_allowed" | "request.origin_missing" | "request.origin_not_allowed" | "request.rate_limited" | "resource.not_found" | "status_page.limit_reached" | "status_page.monitor_not_found" | "status_page.not_found" | "status_page.password_incorrect" | "status_page.slug_taken" | "status_page.unavailable" | "status_page.service_not_found" | "status_page.services_required" | "status_page.domain_invalid" | "status_page.domain_taken" | "status_page_announcement.invalid_window" | "status_page_announcement.limit_reached" | "status_page_announcement.not_found" | "status_page_subscriber.not_found" | "validation.failed" | "weekly_report.invalid_reader" | "workspace.limit_reached" | "workspace.not_found" | "workspace.nothing_to_change" | "workspace.import_limit_exceeded" }[] }
400 — One of: validation.failed, api.bulk_empty.401 — One of: auth.unauthenticated.403 — One of: request.host_not_allowed, permission.denied.404 — One of: maintenance_window.not_found.409 — One of: maintenance_window.not_active.429 — One of: request.rate_limited.
Ejemplo
curl -X POST "https://api.nuvostatus.com/v1/maintenance-windows/bulk/end" \
-H "Authorization: Bearer $NUVOSTATUS_KEY" \
-H "Content-Type: application/json" \
-d '{"ids":["0199e6a0-0000-7000-8000-000000000001","0199e6a0-0000-7000-8000-000000000002"]}'
Change a scheduled maintenance window
PATCH /v1/maintenance-windows/{id}Ámbito: write
Its name, its span or the monitors it covers, before it begins. Once under way a window can only end.
Parámetros
id — en la ruta, obligatorio
Cuerpo de la petición
{ name?: string, startsAt?: string, endsAt?: string, recurrence?: "none" | "daily" | "weekly" | "monthly", timeZone?: string | null, monitorIds?: string[], groupIds?: string[] }
Respuestas
200 — The answer.{ id: string, name: string, startsAt: string, endsAt: string, recurrence: "none" | "daily" | "weekly" | "monthly", timeZone: string | null, monitorIds: string[], createdBy: string | null, createdAt: string, state: "scheduled" | "active" | "past" }
400 — One of: validation.failed.401 — One of: auth.unauthenticated.403 — One of: request.host_not_allowed, permission.denied.404 — One of: maintenance.not_found, maintenance.monitor_not_found.409 — One of: maintenance.not_editable.429 — One of: request.rate_limited.
Ejemplo
curl -X PATCH "https://api.nuvostatus.com/v1/maintenance-windows/0199e6a0-0000-7000-8000-000000000001" \
-H "Authorization: Bearer $NUVOSTATUS_KEY" \
-H "Content-Type: application/json" \
-d '{"name":"Database upgrade, moved","startsAt":"2026-10-13T22:00:00Z","endsAt":"2026-10-14T00:00:00Z","monitorIds":null}'
End a maintenance window now
POST /v1/maintenance-windows/{id}/endÁmbito: write
A window under way ends at this moment; one that has not begun is removed.
Parámetros
id — en la ruta, obligatorio
Respuestas
204 — Done; no body.401 — One of: auth.unauthenticated.403 — One of: request.host_not_allowed, permission.denied.404 — One of: maintenance.not_found.429 — One of: request.rate_limited.
Ejemplo
curl -X POST "https://api.nuvostatus.com/v1/maintenance-windows/0199e6a0-0000-7000-8000-000000000001/end" \
-H "Authorization: Bearer $NUVOSTATUS_KEY"
List the next occurrences of a maintenance series
GET /v1/maintenance-windows/{id}/occurrencesÁmbito: read
The occurrences that intersect the next thirty days, soonest first, each with its state. A skipped occurrence is `skipped`, never `upcoming` or `active`; every other occurrence keeps the state its own times give it.
Parámetros
id — en la ruta, obligatoriodays — en la cadena de consulta, opcional
Respuestas
200 — The answer.{ occurrences: { startsAt: string, endsAt: string, state: "upcoming" | "active" | "past" | "skipped", skipId: string | null }[] }
401 — One of: auth.unauthenticated.403 — One of: request.host_not_allowed.404 — One of: maintenance.not_found.429 — One of: request.rate_limited.
Ejemplo
curl "https://api.nuvostatus.com/v1/maintenance-windows/0199e6a0-0000-7000-8000-000000000001/occurrences" \
-H "Authorization: Bearer $NUVOSTATUS_KEY"
Skip one occurrence of a maintenance series
POST /v1/maintenance-windows/{id}/skipsÁmbito: write
The occurrence never opens: no incident is recorded as maintenance under it, nobody is told, the public calendar does not list it, and a failure during it is an ordinary incident. The series and its past are untouched. A window that does not recur and an instant that is not one of its occurrences answer `maintenance.skip_not_recurring` and `maintenance.skip_not_an_occurrence`; one already skipped answers `maintenance.skip_already_skipped`.
Parámetros
id — en la ruta, obligatorio
Cuerpo de la petición
{ startsAt: string }
Respuestas
201 — The answer.{ skip: { id: string, maintenanceId: string, occurrenceStart: string, createdBy: string | null, createdAt: string } }
400 — One of: validation.failed, maintenance.skip_not_recurring, maintenance.skip_not_an_occurrence, maintenance.skip_started, maintenance.skip_already_skipped.401 — One of: auth.unauthenticated.403 — One of: request.host_not_allowed, permission.denied.404 — One of: maintenance.not_found.429 — One of: request.rate_limited.
Ejemplo
curl -X POST "https://api.nuvostatus.com/v1/maintenance-windows/0199e6a0-0000-7000-8000-000000000001/skips" \
-H "Authorization: Bearer $NUVOSTATUS_KEY" \
-H "Content-Type: application/json" \
-d '{"startsAt":"2026-10-19T22:00:00Z"}'
Remove a skip before the occurrence starts
DELETE /v1/maintenance-windows/{id}/skips/{skipId}Ámbito: write
The occurrence is scheduled again exactly as the series says. A skip that is gone answers `maintenance.skip_not_found`; one whose occurrence has already started answers `maintenance.skip_started`.
Parámetros
id — en la ruta, obligatorioskipId — en la ruta, obligatorio
Respuestas
204 — Done; no body.400 — One of: maintenance.skip_not_found, maintenance.skip_started.401 — One of: auth.unauthenticated.403 — One of: request.host_not_allowed, permission.denied.404 — One of: maintenance.not_found.429 — One of: request.rate_limited.
Ejemplo
curl -X DELETE "https://api.nuvostatus.com/v1/maintenance-windows/0199e6a0-0000-7000-8000-000000000001/skips/{skipId}" \
-H "Authorization: Bearer $NUVOSTATUS_KEY"
Delete a maintenance window
DELETE /v1/maintenance-windows/{id}Ámbito: write
A window under way ends now; one that has not begun is removed.
Parámetros
id — en la ruta, obligatorio
Respuestas
204 — Done; no body.401 — One of: auth.unauthenticated.403 — One of: request.host_not_allowed, permission.denied.404 — One of: maintenance.not_found.429 — One of: request.rate_limited.
Ejemplo
curl -X DELETE "https://api.nuvostatus.com/v1/maintenance-windows/0199e6a0-0000-7000-8000-000000000001" \
-H "Authorization: Bearer $NUVOSTATUS_KEY"
List the silenced email addresses
GET /v1/email/suppressionsÁmbito: write
The addresses of this workspace that a hard bounce or a complaint silenced, newest first, and the provider event that last silenced each. No message, body or secret is part of an answer. Only someone who administers the workspace may ask: a write key acts as an administrator, a read key as a viewer, which is refused.
Respuestas
200 — The answer.{ items: { address: string, reason: "hard_bounce" | "complaint", createdAt: string, lastEvent: { providerEventId: string, kind: "hard_bounce" | "complaint", receivedAt: string } }[], next: null }
401 — One of: auth.unauthenticated.403 — One of: request.host_not_allowed, permission.denied.429 — One of: request.rate_limited.
Ejemplo
curl "https://api.nuvostatus.com/v1/email/suppressions" \
-H "Authorization: Bearer $NUVOSTATUS_KEY"
Let a silenced address receive email again
DELETE /v1/email/suppressions/{address}Ámbito: write
Clears the suppression of one address, so a fixed mailbox receives alerts and reports again. An address that is not suppressed answers `email.suppression_not_found`. Each clear is recorded in the activity log. Only someone who administers the workspace may clear one.
Parámetros
address — en la ruta, obligatorio
Respuestas
204 — Done; no body.400 — One of: validation.failed.401 — One of: auth.unauthenticated.403 — One of: request.host_not_allowed, permission.denied.404 — One of: email.suppression_not_found.429 — One of: request.rate_limited.
Ejemplo
curl -X DELETE "https://api.nuvostatus.com/v1/email/suppressions/{address}" \
-H "Authorization: Bearer $NUVOSTATUS_KEY"