---
search:
  tags:
    - Exports
    - POST
seo:
  description: >-
    Starts an export of every asset the caller can see into one gzipped JSON
    Lines file, one… Reference for the POST /assets/exports endpoint in the Sibi
    API.
sidebar:
  label: Create export
  badge: POST
title: Create export
type: openapi-operation
---
Starts an export of every asset the caller can see into one gzipped JSON Lines file, one asset per line in the same shape `GET /assets/{id}` serves. The export runs in the background: this responds `202` with the export in `in_progress` status and a `Location` header for it. Poll `GET /assets/exports/{id}` until the status is `succeeded`, then fetch `download.url`. Only one export can be in progress per organization at a time; a second request while one is `in_progress` responds `409` naming the running export. No request body.

`POST /assets/exports`

**Responses**

- `202` — The export has been queued
- `401` — The Authorization header is missing, or the bearer token could not be resolved (invalid, expired, or revoked)
- `403` — The token is missing the scope this operation requires (INSUFFICIENT\_SCOPE), is a GraphQL token rather than a REST API token (REST\_TOKEN\_REQUIRED), or it was minted for the other environment (TOKEN\_ENVIRONMENT\_MISMATCH)
- `409` — An export is already in progress for the caller’s organization (EXPORT\_IN\_PROGRESS). Poll that export instead; a new one can be requested once it has succeeded or failed
- `500` — Internal server error
- `503` — The token-exchange service is unavailable or misconfigured — retry shortly. Not a token problem.

Response example, 202:

```json
{
  "id": "ae_aBcD1234",
  "status": "in_progress",
  "createdAt": "2019-08-24T14:15:22Z",
  "startedAt": "2019-08-24T14:15:22Z",
  "completedAt": "2019-08-24T14:15:22Z",
  "rowCount": 0,
  "fileSize": 0,
  "download": {
    "url": "http://example.com",
    "method": "GET",
    "expiresAt": "2019-08-24T14:15:22Z"
  },
  "error": {
    "code": "EXPORT_GENERATION_FAILED",
    "message": "string"
  }
}
```