--- title: "Create User Data Export" method: POST path: "/v1/users/me/data-export" tags: ["users"] --- # Create User Data Export `POST /v1/users/me/data-export` ## Request - Base URL: `https://api.pioneer.ai` (the document declares no server; this is the origin it was published from) - URL: `https://api.pioneer.ai/v1/users/me/data-export` - Auth: one of: - API key in header `X-API-Key` - HTTP bearer - TypeScript: (a function with typed inputs; its response is checked against the schema) Kick off a GDPR Subject Access Request (SAR) export for the caller. Enqueues a background worker that zips the caller's personal data into the user-exports S3 bucket. One non-expired export per user per 24h; a request inside that window returns 429 with ``Retry-After`` set from the existing job. Args: auth: Authenticated user context. Returns: 202 Accepted with the job id and initial ``pending`` status. Raises: HTTPException: 429 inside the 24h rate-limit window; 500 on failure. ## Response `202` Successful Response - CreateDataExportResponse: Response to ``POST /users/me/data-export``. Attributes: job_id: UUID of the newly created (or already-running) export job. status: ``pending``, or ``running`` if the worker claimed the row before the response was assembled. Clients poll ``GET /users/me/data-export/{job_id}`` until ``ready`` or ``failed``. - `job_id` string, required: UUID of the export job. - `status` 'pending' | 'running' | 'ready' | 'expired' | 'failed', required: Lifecycle state of the export job. ## Changes - **2026-09-24** `0e5e86e2bae5`: 1 info - endpoint added [Operation history](https://skmtc.dev/pioneer/apis/brain-api/changes/v1/users/me/data-export/post.md) --- [API](https://skmtc.dev/pioneer/apis/brain-api.md) - [All operations](https://skmtc.dev/pioneer/apis/brain-api/llms.txt) - [OpenAPI document](https://skmtc.dev/pioneer/apis/brain-api/revisions/0e5e86e2bae5?raw)