Skip to navigation

Read export job status

Required scopes: presentation.export.

Read-only polling, with Retry-After: 2. Only the requesting service credential can read the job; secret rotation preserves access. Current authority and presentation access are required; expiry, consumption, foreign presentation or other requester return 404. Failed jobs expose only a stable safe error code. This GET does not consume a file.

Response headers:

  • Cache-Control (200).
  • Retry-After (200).

Authentication

AuthorizationBearer

Organization-owned service token. Issue the initial token in organization credential settings. Scopes are documented per operation via x-required-scopes; they are not OAuth scopes.

Path parameters

presentation_idstringRequiredformat: "uuid"

Organization-owned presentation UUID. Foreign decks return 404.

export_idstringRequiredformat: "^[a-f0-9]{32}$"

Requester-private export job ID.

Response headers

X-Request-IdstringOptional
Cache-Control"no-store"Optional
Retry-AfterintegerOptional

Response

Successful operation.
idstringformat: "^[a-f0-9]{32}$"
presentation_idstringformat: "uuid"
organization_idstringformat: "uuid"
revisioninteger0-2147483647
formatenum
Allowed values:
statusenum
Allowed values:
errorenum
Allowed values:
bytesinteger or null0-536870912
created_atinteger>=0
expires_atinteger>=0
download_urlstring or null
Relative POST downloads URL, available only when completed. Requires the requesting credential and current presentation.export scope. Never a public URL.

Errors

401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
429
Too Many Requests Error
503
Service Unavailable Error