Data -- Exports

Read Export

Returns the status of a single export job. For a SUCCEEDED job owned by the caller, files carries freshly-presigned download URLs; non-owners get the row with downloadable=false.

get/data/projects/{projectId}/exports/{exportId}

Request

  • Base URL: https://partner.peaka.studio/api/v1
  • URL: https://partner.peaka.studio/api/v1/data/projects/{projectId}/exports/{exportId}
  • Auth: HTTP bearer

Path parameters

projectIdstring required

ID of the Project

exportIdstring required

Export job id (UUID)

Response

Export job status

idstring

Export job id

status'PENDING' | 'RUNNING' | 'SUCCEEDED' | 'FAILED' | 'CANCELLED' | 'EXPIRED'

Job status. EXPIRED is derived when the artifacts have been removed by the lifecycle rule; exports are point-in-time snapshots and are never regenerated.

formatstring

Output format

compressionstring

Output compression

rowCountinteger

Number of exported rows

bytesinteger

Total output size in bytes

durationMsinteger

Execution time in milliseconds

expiresAtstring

Expiry of the presigned URLs (ISO-8601); re-call GET for fresh links

downloadableboolean

Whether the calling user may download this export (owner-only access)

errorstring

Error message when the job failed

createdAtstring

Submission time (ISO-8601)

queryIdstring

Source query id (query exports)

catalogIdstring

Source catalog id (table exports)

schemaNamestring

Source schema name (table exports)

tableNamestring

Source table name (table exports)

sourcestring

Quoted, fully-qualified source name for display

userIdstring

Initiator user id

userNamestring

Initiator user name

apiKeyPrefixstring

Public prefix of the initiator's API key

clientSourcestring

Client source (X-Trino-Source, falling back to User-Agent)

Example response

{
  "id": "4c9fcb44-126a-45f8-99a0-f1d245083d78",
  "status": "SUCCEEDED",
  "format": "JSONL",
  "compression": "NONE",
  "rowCount": 993,
  "bytes": 3706920,
  "durationMs": 1055,
  "files": [
    {
      "name": "query_709922802836177297_charges.jsonl",
      "url": "https://<minio>/export/...&X-Amz-Signature=...",
      "bytes": 3706920
    }
  ],
  "expiresAt": "2026-06-10T13:24:20Z",
  "downloadable": true,
  "createdAt": "2026-06-10T12:24:08Z",
  "queryId": "709922802836177297",
  "source": "peaka.query.\"charges_view\"",
  "userName": "user@example.com",
  "apiKeyPrefix": "hBWIQxjc",
  "clientSource": "peaka-studio"
}

Changes

No recorded changes to this operation across all 1 revision of this API.