Skip to main content
GET
Export Cluster Run Data (CSV / Parquet)

Authorizations

Authorization
string
header
required

Mixpeek API key, sent as Authorization: Bearer mxp_sk_.... Create one in Studio under Settings → API Keys, or with an admin key via POST /v1/organizations/users/{user_email}/api-keys. A missing header returns 403; an invalid or revoked key returns 401.

X-Namespace
string
header
required

Namespace id (ns_...), not the namespace name. This scopes the request rather than authenticating it, and it is required on every operation marked x-mixpeek-namespace-scoped.

Path Parameters

cluster_id
string
required

Cluster ID

run_id
string
required

Run ID whose data to export

Query Parameters

format
string
default:parquet

Export format: 'parquet' returns a presigned download URL (JSON), 'csv' streams the converted file

Pattern: ^(parquet|csv)$
cluster_label
string | null

CSV only: restrict rows to one cluster — accepts the run's cluster id (e.g. 'cl_3') or its current label

Response

Successful Response