usage

List Api Events

Changed on Nov 3, 2026

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

Request

Base URL
https://api.moda.app/v1
URL
https://api.moda.app/v1/events
Auth
HTTP bearer

Query parameters

api_key_idstring nullable

Optional API-key UUID filter.

operation_idstring nullable

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

trigger_source'api' | 'mcp' nullable

Restrict to api or mcp origin rows.

client_surface'api' | 'cli' | 'mcp_connector' nullable

Restrict to generic REST, the Moda CLI, or the new MCP connector.

status'succeeded' | 'failed' nullable

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

fromstring date-time nullable

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

tostring date-time nullable

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

limitinteger

Max rows per page (cap: 200).

cursorstring nullable

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.

returnedinteger

Number of items in this page (always len(data); derived server-side).

has_moreboolean

true when more items exist beyond this page — keep requesting with next_cursor until this is false. Never trust len(data) < limit alone.

limitinteger nullable

The effective page-size limit this response was computed with.

totalinteger nullable

True total number of items in the collection (after filters), when the endpoint can count cheaply. null on log/search lanes — use has_more there.

Changes

Nov 3, 20269ac6a3abc0f8 Revision changes
- info
  added the new optional query request parameter client_surface
- info
  added the non-success response with the status
- info
  added the optional property // to the response with the status
- info
  added the optional property // to the response with the status
- info
  added the optional property // to the response with the status
- info
  added the optional property // to the response with the status
- info
  added the optional property // to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status

Operation history