List timeline entries — StatusDashboard Docs

GET /app/events/{id}/timeline

Returns all timeline entries for the event, sorted by timestamp ascending (oldest first).

Path parameters

Parameter	Description
`id`	The event ID.

Request

See API Basics for required headers.

This endpoint takes no request body.

Sample request

curl https://api.statusdashboard.com/app/events/4f8b2e1a-3c7d-4e9f-a0b1-c2d3e4f56789/timeline \
  -H "Authorization: Bearer bcf847abf5c6:def456"

Sample response

Status: 200 OK

{
  "timeline": [
    {
      "statusId": "7a3f9d2e-1b4c-4e8a-90b2-c3d4e5f67890",
      "timestamp": "2026-04-25T09:45:00.000Z",
      "status": "Investigating",
      "message": "We are aware of elevated API response times and are investigating.",
      "author": "user@example.com",
      "isEdited": false
    }
  ]
}

Response fields

Field	Type	Description
`timeline`	array	Timeline entries sorted by `timestamp` ascending.

Timeline entry fields

Each timeline[] item matches Get timeline entry.

Field	Type	Description
`statusId`	string	Unique entry ID.
`timestamp`	string	ISO 8601 UTC timestamp for this entry. Set at creation; editable via PUT.
`status`	string	Workflow phase label at time of posting. Cannot be changed after posting.
`message`	string	Status message. Rich text field. See Rich text fields. Max 5,000 characters.
`author`	string	Email of the user who posted the entry.
`isEdited`	boolean	`true` if the message or timestamp has been edited since posting.

Error responses

Status	When
`403`	Insufficient permissions.
`404`	Event not found.