Download Export
POST/api/v1/exports/{export_id}/download
Get a short-lived presigned URL to download a completed export's file. Call this once the export's status is completed. Downloading does not charge credits.
Authentication#
Requires a token with the read scope, sent as Authorization: Bearer cornect_….
Request#
Path parameters:
| Name | Type | Required | Description |
|---|---|---|---|
export_id | string (UUID) | Yes | The id of a completed export job. |
Response#
Returns a presigned URL (and its expiry). Fetch the URL directly to download the CSV/JSON — it's a plain HTTPS GET, no auth header needed on the presigned URL itself.
{
"download_url": "https://s3.amazonaws.com/cornect-exports/9f1c…?X-Amz-…",
"expires_at": "2026-05-28T12:15:00Z"
}Code samples#
curl -X POST https://api.cornect.io/api/v1/exports/9f1c0000-0000-0000-0000-000000000000/download \
-H "Authorization: Bearer cornect_your_token_here"Errors#
See Errors for the full table. Codes you're most likely to see here:
| Code | Status | When |
|---|---|---|
— | 404 | No export with that id in your workspace. |
— | 400 | Export isn't completed yet (nothing to download). |
| — | 429 | Rate limit exceeded (30/min). |
Interactive reference#
Loading interactive reference…