Query events for the authenticated tenant

GET

/v1/events

Returns events scoped to the authenticated tenant only. Only tenant-accessible event types are returned (budget., reservation., tenant.*).
PERMISSIONS: - Requires events:read permission on the API key.

Authorizations

ApiKeyAuth

Tenant-scoped API key for runtime operations (consistent with Cycles Protocol)

Type

API Key (header: X-Cycles-API-Key)

Parameters

Query Parameters

event_type

Type

string

Valid values

"budget.created""budget.updated""budget.funded""budget.debited""budget.reset""budget.debt_repaid""budget.frozen""budget.unfrozen""budget.closed""budget.threshold_crossed""budget.exhausted""budget.over_limit_entered""budget.over_limit_exited""budget.debt_incurred""budget.burn_rate_anomaly""reservation.denied""reservation.denial_rate_spike""reservation.expired""reservation.expiry_rate_spike""reservation.commit_overage""tenant.created""tenant.updated""tenant.suspended""tenant.reactivated""tenant.closed""tenant.settings_changed""api_key.created""api_key.revoked""api_key.expired""api_key.permissions_changed""api_key.auth_failed""api_key.auth_failure_rate_spike""policy.created""policy.updated""policy.deleted""system.store_connection_lost""system.store_connection_restored""system.high_latency""system.webhook_delivery_failed""system.webhook_test"

category

Type

string

Valid values

"budget""tenant""api_key""policy""reservation""system"

scope

Type

string

correlation_id

Type

string

from

Type

string

Format

"date-time"

to

Type

string

Format

"date-time"

cursor

Type

string

limit

Type

integer

Minimum

1

Maximum

100

Default

50

Responses

Event list (tenant-scoped)

Content-Type

application/json

{

  

"events": [

  

  

{

  

  

  

"event_id": "string",

  

  

  

"event_type": "string",

  

  

  

"category": "string",

  

  

  

"timestamp": "string",

  

  

  

"tenant_id": "string",

  

  

  

"scope": "string",

  

  

  

"actor": {

  

  

  

  

"type": "string",

  

  

  

  

"key_id": "string",

  

  

  

  

"source_ip": "string"

  

  

  

},

  

  

  

"source": "string",

  

  

  

"data": {

  

  

  

  

"additionalProperties": "string"

  

  

  

},

  

  

  

"correlation_id": "string",

  

  

  

"request_id": "string",

  

  

  

"metadata": {

  

  

  

  

"additionalProperties": "string"

  

  

  

}

  

  

}

  

],

  

"next_cursor": "string",

  

"has_more": true

}

GET

/v1/events

Playground

Authorization

ApiKeyAuth

Variables

Key

Value

event_type

category

scope

correlation_id

from

to

cursor

limit

Samples

Powered by VitePress OpenAPI