---
title: "Export Cluster Run Data (CSV / Parquet)"
method: GET
path: "/v1/clusters/{cluster_id}/executions/{run_id}/export"
tags: ["Cluster Executions"]
---

# Export Cluster Run Data (CSV / Parquet)

`GET /v1/clusters/{cluster_id}/executions/{run_id}/export`

One-click export of a clustering run's data — the exact rows behind the
    visualization (one row per member plus one per centroid: document id,
    cluster id and current label, x/y[/z] layout coordinates, per-cluster
    stats, and any custom LLM fields).

    Formats:
    - **`format=parquet`** (default): returns JSON with a short-lived
      presigned download URL for the run's `cluster_documents.parquet`
      artifact — the full-fidelity file (includes centroid vectors), any
      size. Download it promptly; the URL expires.
    - **`format=csv`**: streams a spreadsheet-friendly CSV conversion —
      stable column order, current (renamed) cluster labels, no raw vectors.
      Capped at 100,000 rows; bigger runs get a clear 413 pointing to
      parquet. Scope to one cluster with `cluster_label` (accepts the run's
      cluster id like `cl_3` OR its current label).

    Exports are strictly per-run: the run you pass is the run you get.
    Runs that completed before artifacts existed, failed before the export
    step, or whose artifacts have aged out of object storage return 404
    with a message saying exactly what's missing.

## Path parameters

- `cluster_id` string, required — Cluster ID
- `run_id` string, required — Run ID whose data to export

## Query parameters

- `format` string — Export format: 'parquet' returns a presigned download URL (JSON), 'csv' streams the converted file
- `cluster_label` string, nullable — CSV only: restrict rows to one cluster — accepts the run's cluster id (e.g. 'cl_3') or its current label

## Response `200`

Successful Response

- unknown

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `422` — Validation Error
- `500` — Internal Server Error

## Changes

- **2026-08-09** `5d4c905106b4` — 1 info
  - the endpoint scheme security `BearerAuth AND NamespaceHeader` was added to the API

[Change history](https://skmtc.dev/mixpeek/apis/mixpeek-api/changes/v1/clusters/:cluster_id/executions/:run_id/export/get.md)

---

[API](https://skmtc.dev/mixpeek/apis/mixpeek-api.md) · [All operations](https://skmtc.dev/mixpeek/apis/mixpeek-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/mixpeek/mixpeek-api/revisions/66113d7c4f9f/schema)