Notice Updates

Manage timeline entries for a notice

Add an update to a notice

post

/status_pages/{subdomain}/notices/{notice_id}/updates

Appends a timeline entry. Optionally transitions the notice to a new status in the same request (e.g., investigating → identified → resolved). A notify: true update (the default) triggers email/Slack notifications.

Authorizations

AuthorizationstringRequired

Organization API key — issue one via the Rails console (management UI coming soon)

Path parameters

subdomainstringRequired

Status page subdomain (e.g. acme-status)

notice_idstring · uuidRequired

Body

statusstringOptional

Transitions the notice to this status. Defaults to the current notice status (i.e. adds an update without changing status).

bodystring · max: 10000Required

HTML or plain-text content for the update.

posted_atstring · date-timeOptional

Defaults to current time.

notifybooleanOptional

Whether to send email/Slack notifications for this update.

Default: true

Responses

201

Created

application/json

401

Missing or invalid API key

application/json

403

The account is pending activation. A newly created account must be activated by an administrator before its API key can be used.

application/json

404

Resource not found

application/json

422

Validation failed

application/json

post/status_pages/{subdomain}/notices/{notice_id}/updates

POST /api/v1/status_pages/{subdomain}/notices/{notice_id}/updates HTTP/1.1
Host: next.statuspal.io
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 255

{
  "status": "resolved",
  "body": "The issue has been resolved. All systems are operational.",
  "notify": true,
  "service_statuses": [
    {
      "service_slug": "api",
      "container_slug": "eu-region",
      "status": "ok"
    },
    {
      "service_slug": "api",
      "container_slug": "us-region",
      "status": "ok"
    }
  ]
}

{
  "data": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "status": "text",
    "body": "text",
    "posted_at": "2026-01-01T00:00:00.000Z",
    "service_statuses": [
      {
        "service_slug": "text",
        "service_name": "text",
        "container_slug": "text",
        "container_name": "text",
        "status": "ok"
      }
    ]
  }
}

Delete a notice update

delete

/status_pages/{subdomain}/notices/{notice_id}/updates/{update_id}

Authorizations

AuthorizationstringRequired

Organization API key — issue one via the Rails console (management UI coming soon)

Path parameters

subdomainstringRequired

Status page subdomain (e.g. acme-status)

notice_idstring · uuidRequired

update_idstring · uuidRequired

Responses

204

Deleted

No content

401

Missing or invalid API key

application/json

403

The account is pending activation. A newly created account must be activated by an administrator before its API key can be used.

application/json

404

Resource not found

application/json

delete/status_pages/{subdomain}/notices/{notice_id}/updates/{update_id}

DELETE /api/v1/status_pages/{subdomain}/notices/{notice_id}/updates/{update_id} HTTP/1.1
Host: next.statuspal.io
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content

Edit a notice update

patch

/status_pages/{subdomain}/notices/{notice_id}/updates/{update_id}

Authorizations

AuthorizationstringRequired

Organization API key — issue one via the Rails console (management UI coming soon)

Path parameters

subdomainstringRequired

Status page subdomain (e.g. acme-status)

notice_idstring · uuidRequired

update_idstring · uuidRequired

Body

statusstringOptional

bodystring · max: 10000Optional

posted_atstring · date-timeOptional

notifybooleanOptional

Responses

200

OK

application/json

401

Missing or invalid API key

application/json

403

The account is pending activation. A newly created account must be activated by an administrator before its API key can be used.

application/json

404

Resource not found

application/json

422

Validation failed

application/json

patch/status_pages/{subdomain}/notices/{notice_id}/updates/{update_id}

PATCH /api/v1/status_pages/{subdomain}/notices/{notice_id}/updates/{update_id} HTTP/1.1
Host: next.statuspal.io
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 171

{
  "status": "text",
  "body": "text",
  "posted_at": "2026-01-01T00:00:00.000Z",
  "notify": true,
  "service_statuses": [
    {
      "service_slug": "api",
      "container_slug": "eu-region",
      "status": "ok"
    }
  ]
}

{
  "data": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "status": "text",
    "body": "text",
    "posted_at": "2026-01-01T00:00:00.000Z",
    "service_statuses": [
      {
        "service_slug": "text",
        "service_name": "text",
        "container_slug": "text",
        "container_name": "text",
        "status": "ok"
      }
    ]
  }
}