Skip to main content
POST
One page of gateway request-log rows (metadata only, max 20) — who called which model, when, cost, status

Authorizations

Authorization
string
header
required

A management token: minted by the OAuth flow (aireserve login, or an MCP client's Authenticate step) or on the portal Keys page under Management Keys. Inference API keys are refused.

Body

application/json
clientId
string<uuid>

Target organization id — platform admins only; omit otherwise

Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
startDate
string

Window start, UTC day (YYYY-MM-DD)

Pattern: ^\d{4}-\d{2}-\d{2}$
endDate
string

Window end, UTC day (YYYY-MM-DD)

Pattern: ^\d{4}-\d{2}-\d{2}$
model
string

Exact model value from get_gateway_filter_options

Required string length: 1 - 200
provider
string

Exact provider value from get_gateway_filter_options

Required string length: 1 - 200
status
string

Exact status value from get_gateway_filter_options

Required string length: 1 - 50
user
string

Exact user value from get_gateway_filter_options

Required string length: 1 - 200
limit
integer

Rows per page, up to 20 (the default)

Required range: 0 < x <= 20
cursor
string

nextCursor from the previous page

Maximum string length: 500
snapshotTime
string

snapshotTime echoed from the first page so later pages read a stable snapshot

Maximum string length: 100

Response

Executed successfully (ok: true).

status
enum<string>
required
Available options:
executed
ok
boolean
required

Whether the operation succeeded.

summary
string
required

The consent line describing what was done, built from resolved labels.

message
string
required

Human-readable result line.

data
any

Operation payload (reads) or detail worth relaying (writes).

secret
string

A one-time secret the operation minted (API key, credential). Shown once; store it now.

sensitive
enum<boolean>

Present exactly when secret is: redact this response from logs.

Available options:
true