events

List breaker state transition history.

GET /v1/projects/:project_id/events

List recent breaker state transitions

Auth: User API key

Parameters

Name	In	Type	Required	Description
`project_id`	path	uuid	Yes	Project ID
`since_ms`	query	integer	No	Return events newer than this timestamp
`breaker_id`	query	uuid	No	Filter to a specific breaker
`cursor`	query	string	No	Pagination cursor from previous response
`limit`	query	integer	No	Max events to return (default 50, max 200)

Responses

200 List of events

events

- Array of event objects

next_cursor

- Cursor for next page (null if no more)

returned

- Number of events returned

Headers: X-Latest-Timestamp: Timestamp of most recent event

400 Invalid parameter

429 Rate limited

Example

Request

curl "https://api.tripswitch.dev/v1/projects/PROJECT_ID/events?since_ms=1705312200000&limit=10" \
  -H "Authorization: Bearer YOUR_USER_API_KEY"

Response

{
  "events": [
    {
      "breaker_id": "660e8400-e29b-41d4-a716-446655440001",
      "name": "API Latency",
      "prev": "closed",
      "curr": "open",
      "ts_ms": 1705312300000,
      "rule": {
        "metric": "api.latency_ms",
        "kind": "p95",
        "threshold": 500,
        "window_ms": 60000
      }
    }
  ],
  "next_cursor": null,
  "returned": 1
}

← All API resources