v1

latestOpenAPI 3.1.02026-07-223261135.0 KB
usage

List Api Events

Cursor-paginated activity log for the caller's team.

Role-scoped identically to GET /v1/usage: admins/owners see every row in the team, members see only rows attributable to their own API keys plus their own MCP-origin rows. Sort is (timestamp DESC, id DESC); iterate next_cursor until null to drain.

get/events

Query parameters

api_key_idstring nullable

Optional API-key UUID filter.

Optional API-key UUID filter.

operation_idstring nullable

Optional exact-match filter on the event's OpenAPI operationId.

Optional exact-match filter on the event's OpenAPI operationId.

trigger_source'api' | 'mcp' nullable

Restrict to api or mcp origin rows.

Restrict to api or mcp origin rows.

status'succeeded' | 'failed' nullable

succeeded → 200-399; failed → status >= 400.

succeeded → 200-399; failed → status >= 400.

fromstring date-time nullable

ISO8601 UTC lower bound (inclusive). Defaults to to - 7d.

ISO8601 UTC lower bound (inclusive). Defaults to to - 7d.

tostring date-time nullable

ISO8601 UTC upper bound (exclusive). Defaults to now.

ISO8601 UTC upper bound (exclusive). Defaults to now.

limitinteger

Max rows per page (cap: 200).

Max rows per page (cap: 200).

cursorstring nullable

Opaque cursor from the previous page's next_cursor.

Opaque cursor from the previous page's next_cursor.

Headers

Moda-Version'2026-04-12' | '2026-05-01'
Example:2026-05-01

Calendar-dated API version pin. New integrations should pin 2026-05-01 to opt into the newest response shapes. For back-compat the server also accepts requests with no header and resolves them to the current default (today: 2026-04-12); that default advances on each sunset date. Any unsupported value returns 400 unsupported_version.

Response

Successful Response

next_cursorstring nullable

Opaque cursor to pass as ?cursor= on the next request. null means you've reached the end of the collection.