> ## Documentation Index
> Fetch the complete documentation index at: https://docs.linquid.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Exports API

> Async export job queue, status polling, and secure file download

# Exports API

Exports run as async jobs and are workspace-scoped.

## Endpoint matrix

| Method | Path                    | Purpose                        |
| ------ | ----------------------- | ------------------------------ |
| `POST` | `/exports`              | Create export job              |
| `GET`  | `/exports`              | List latest workspace exports  |
| `GET`  | `/exports/:id`          | Get one export status/details  |
| `GET`  | `/exports/:id/download` | Download completed export file |

## Create payload

* `type`: `links | partners | commissions | events`
* `format`: `csv | json`
* `programId` (optional)
* `filters` (optional)
* `columns` (optional)

Creation returns `202 Accepted` with export ID and initial `pending` state.

## Job lifecycle

Typical statuses:

* `pending`
* `processing`
* `completed`
* `failed`

## Download behavior

* available only when status is completed
* file can expire based on retention policy
* download response streams file from object storage

## Permission model

* Requires workspace auth.
* Requires `links:read`.

## Typical failures

* `404`: export not found in workspace scope
* `400`: export not ready yet
* `410`: export file expired
* `503`: export workflow service unavailable

Related docs:

* `/user-guides/manual/data/exports-and-operational-checks`
* `/user-guides/manual/data/data-retention-and-lifecycle`