An event is a notice that something happened in the organisation: a run finished, a review was decided, billing was paused. The same events are sent to your webhook endpoints; these calls list them, so you can catch up after downtime.
Returns the organisation’s recent events, newest first: the same notices a webhook endpoint is sent. Only events in areas your key can read are listed, and billing events only to owners. Page with before set to the previous page’s next, an opaque value.
The key is missing, unknown, revoked or expired (code invalid_token). Send it as Authorization: Bearer <key>.
403
wrong_key
403 for a role below the route’s minimum (“Your role (<role>) can’t <action>.”, or “Choose an organisation first.”), or, for an API key without the permission this call needs, code wrong_key with “This key needs the <Area> · <Read|Write> permission.” (for example “This key needs the Reviews · Write permission.”), or “This key can’t do that.” for a call only the Mestra apps make.
404
not_found
not_found: “Not found.” An unknown id, or webhooks are off.
409
api_off
409 with code api_off (“Turn on the API in Developer → API and MCP first.”): an owner hasn’t turned the API on for this organisation, so no API key works yet. An owner turns it on in Settings, then API.
The key is missing, unknown, revoked or expired (code invalid_token). Send it as Authorization: Bearer <key>.
403
wrong_key
403 for a role below the route’s minimum (“Your role (<role>) can’t <action>.”, or “Choose an organisation first.”), or, for an API key without the permission this call needs, code wrong_key with “This key needs the <Area> · <Read|Write> permission.” (for example “This key needs the Reviews · Write permission.”), or “This key can’t do that.” for a call only the Mestra apps make.
404
not_found
not_found: “Not found.” An unknown id, or webhooks are off.
409
api_off
409 with code api_off (“Turn on the API in Developer → API and MCP first.”): an owner hasn’t turned the API on for this organisation, so no API key works yet. An owner turns it on in Settings, then API.