Skip to main content
POST
Export token access logs

Authorizations

x-api-key
string
header
required

API Key authentication. Format: 'x-api-key: api_key'

Body

The period to export and, optionally, the same filters the list accepts.

start_date
string<date>
required

First day to export (UTC), inclusive.

end_date
string<date>
required

Last day to export (UTC), inclusive. At most 31 days after start_date.

token_id
string<uuid>[]

One token id or a list of them.

token_kind
enum<string>[]
  • api-token - API token
  • mcp-token - MCP token
Available options:
api-token,
mcp-token
token_owner_id
integer[]
action
string[]
Maximum string length: 128
transport
enum<string>[]
  • http - HTTP
  • websocket - WebSocket
Available options:
http,
websocket
status_code
integer
status_code__lt
integer
status_code__gte
integer

Response

202 - application/json

A token access log export.

Poll it until status is succeeded or failed. Once it has succeeded, download_url is a signed link to the Parquet file in your workspace's lakehouse bucket, valid until download_url_expires_at; read the export again for a fresh one.

id
string<uuid>
required
read-only
status
enum<string>
required
  • pending - Pending
  • running - Running
  • succeeded - Succeeded
  • failed - Failed
Available options:
pending,
running,
succeeded,
failed
start_date
string<date>
required
read-only

Inclusive, UTC.

end_date
string<date>
required
read-only

Inclusive, UTC.

filters
any
required
read-only

The list filters the export was asked for, already validated: lists of values per key.

row_count
integer | null
required
read-only
file_name
string
required
read-only
error
string
required
read-only

Shown to the customer; no internals.

created_at
string<date-time>
required
read-only
started_at
string<date-time> | null
required
read-only
finished_at
string<date-time> | null
required
read-only
download_url
string | null
required
read-only
download_url_expires_at
string<date-time> | null
required
read-only