Uptimely
API referenceStatus pages

Show a monitor on a status page

POST
/v1/status-pages/{status_page_id}/resources

Adds a monitor to the end of the status page's list, the same way the dashboard's Resources tab does. The monitor must belong to the same project. Attaching a monitor the page already shows answers 400 validation_failed rather than creating a duplicate row. Send an Idempotency-Key header to make retries safe.

Authorization

bearerAuth
AuthorizationBearer <token>

An uptimely_live_ project API key (Settings → API Keys).

In: header

Path Parameters

status_page_id*string

Status page id.

Match^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
Formatuuid

Header Parameters

Idempotency-Key?string

Optional client-generated key (1-255 visible ASCII characters; a UUID works) making this POST safely retryable. Retrying with the SAME key and byte-identical body within 24h replays the stored first response. The same key with a different body answers 422 idempotency_key_reused; a retry racing the first execution answers 409 idempotency_in_progress. Omitting the header executes normally with no idempotency guarantee.

Length1 <= length <= 255

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

curl -X POST "https://example.com/v1/status-pages/497f6eca-6276-4993-bfeb-53cbbbba6f08/resources" \  -H "Content-Type: application/json" \  -d '{    "monitor_id": "ff93e0f3-22fc-4809-8875-a2d24a9803b1"  }'
{  "id": "string",  "monitor": {    "id": "string",    "name": "string"  },  "display_name": "string",  "display_description": "string",  "show_uptime_percent": true,  "order": -9007199254740991,  "created_at": "2019-08-24T14:15:22Z"}