Skip to main content

Overview

Retrieve all updates for a specific incident. The updates show the complete history of how the incident was communicated to users, from initial discovery through resolution.

Authentication

All requests must include authentication via API Key:
  • API Key: X-API-Key: YOUR_API_KEY

Request

curl -X GET "https://api.uptimeio.com/api/projects/660e8400-e29b-41d4-a716-446655440001/status-pages/550e8400-e29b-41d4-a716-446655440000/incidents/990e8400-e29b-41d4-a716-446655440050/updates?page=1&limit=20" \
  -H "X-API-Key: YOUR_API_KEY"

Path Parameters

ParameterTypeRequiredDescription
projectIdUUIDYesProject UUID
statusPageIdUUIDYesStatus page UUID
idUUIDYesIncident UUID

Query Parameters

ParameterTypeDefaultDescription
pageinteger1Page number for pagination
limitinteger20Updates per page (1-100)
sort_orderstringdescSort order: asc (oldest first), desc (newest first)

Response

Returns a paginated list of incident updates.
{
  "success": true,
  "data": {
    "updates": [
      {
        "id": "aa0e8400-e29b-41d4-a716-446655440060",
        "incident_id": "990e8400-e29b-41d4-a716-446655440050",
        "message": "Service fully restored. All API endpoints responding normally.",
        "status": "resolved",
        "created_at": "2024-12-26T13:30:00Z",
        "created_by": "user"
      },
      {
        "id": "aa0e8400-e29b-41d4-a716-446655440061",
        "incident_id": "990e8400-e29b-41d4-a716-446655440050",
        "message": "Fix has been deployed to production. Monitoring for stability.",
        "status": "monitoring",
        "created_at": "2024-12-26T12:45:00Z",
        "created_by": "user"
      },
      {
        "id": "aa0e8400-e29b-41d4-a716-446655440062",
        "incident_id": "990e8400-e29b-41d4-a716-446655440050",
        "message": "Root cause identified: misconfigured load balancer. Deploying fix.",
        "status": "identified",
        "created_at": "2024-12-26T12:15:00Z",
        "created_by": "user"
      },
      {
        "id": "aa0e8400-e29b-41d4-a716-446655440063",
        "incident_id": "990e8400-e29b-41d4-a716-446655440050",
        "message": "We are investigating elevated response times. Thank you for your patience.",
        "status": "investigating",
        "created_at": "2024-12-26T11:00:00Z",
        "created_by": "user"
      }
    ],
    "pagination": {
      "page": 1,
      "pageSize": 20,
      "total": 4,
      "totalPages": 1,
      "hasNext": false,
      "hasPrevious": false
    }
  }
}

Response Fields

Updates Array - List of update objects:
FieldTypeDescription
idstringUnique update identifier
incident_idstringParent incident ID
messagestringUpdate message
statusstringStatus at time of update
created_attimestampCreation timestamp
created_bystringUser ID or “system”
Pagination - Pagination metadata:
FieldTypeDescription
pageintegerCurrent page number
pageSizeintegerItems per page
totalintegerTotal updates
totalPagesintegerTotal pages
hasNextbooleanMore pages available
hasPreviousbooleanPrevious pages available

Error Codes

CodeStatusDescription
AUTHENTICATION_REQUIRED401Missing or invalid authentication
ACCESS_DENIED403User does not have access to this project
NOT_FOUND404Incident or status page not found
VALIDATION_ERROR400Invalid query parameters

Examples

# Get all updates for an incident
curl -X GET https://api.uptimeio.com/api/projects/660e8400-e29b-41d4-a716-446655440001/status-pages/550e8400-e29b-41d4-a716-446655440000/incidents/990e8400-e29b-41d4-a716-446655440050/updates \
  -H "X-API-Key: YOUR_API_KEY"

# Get most recent updates (newest first)
curl -X GET "https://api.uptimeio.com/api/projects/660e8400-e29b-41d4-a716-446655440001/status-pages/550e8400-e29b-41d4-a716-446655440000/incidents/990e8400-e29b-41d4-a716-446655440050/updates?sort_order=desc&limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

# Get oldest updates first
curl -X GET "https://api.uptimeio.com/api/projects/660e8400-e29b-41d4-a716-446655440001/status-pages/550e8400-e29b-41d4-a716-446655440000/incidents/990e8400-e29b-41d4-a716-446655440050/updates?sort_order=asc" \
  -H "X-API-Key: YOUR_API_KEY"

Error Examples

Incident Not Found

{
  "success": false,
  "error": {
    "code": "NOT_FOUND",
    "message": "Incident not found"
  }
}

Status Page Not Found

{
  "success": false,
  "error": {
    "code": "NOT_FOUND",
    "message": "Status page not found"
  }
}

Invalid Pagination

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid query parameters",
    "details": [
      {
        "field": "limit",
        "message": "Limit must be between 1 and 100"
      }
    ]
  }
}

Unauthorized

{
  "success": false,
  "error": {
    "code": "AUTHENTICATION_REQUIRED",
    "message": "Authentication required"
  }
}