---
title: "Request an export of all workspace data"
method: POST
path: "/api/workspaces/{workspace}/export"
tags: ["Data Export"]
---

# Request an export of all workspace data

`POST /api/workspaces/{workspace}/export`

## Request

- Base URL: `https://www.audioscrape.com`
- URL: `https://www.audioscrape.com/api/workspaces/{workspace}/export`
- Auth: HTTP bearer

Creates an asynchronous job to package the workspace's audio files,
transcripts, items, and metadata into a single downloadable archive.
Only workspace `owner` or `admin` members may call this endpoint.

At most one job per workspace can be in `queued` or `running` status at
any time; further requests return `429` until the active job finishes.
Poll `GET /api/workspaces/{workspace}/export/{job_id}` for status.

## Path parameters

- `workspace` integer, required

## Response `201`

Export job created and queued for processing

- CreateExportJobResponse: Response from `POST /api/workspaces/{workspace}/export`.
  - `job_id` integer, required: Numeric ID of the newly created export job.
  - `status` string, required: Always `"queued"` immediately after creation.
  - `status_url` string, required: Relative URL clients should poll for status + the eventual download URL.

## Other responses

- `401`: Missing or invalid session / key
- `403`: Caller is not an owner or admin of the workspace
- `404`: Workspace not found
- `429`: Another export for this workspace is already queued or running

---

[API](https://skmtc.dev/audioscrape/apis/audioscrape-rest-api.md) · [All operations](https://skmtc.dev/audioscrape/apis/audioscrape-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/audioscrape/apis/audioscrape-rest-api/revisions/29b5788227cf?raw)