GET/api/v1/usage/exports/{export_id}/download

Get a short-lived download link for an export

Re-authorizes, then returns a signed URL valid for at most 15 minutes (never past the file's own expiry). The URL itself needs no bearer key; do not log it. 409 means the job is not completed yet; 410 means the file expired and a new export is needed.

認証: AuthorizationヘッダーにBearer形式のAPIキー

パスパラメータ

  • export_idstring必須

    Export job id (uuid) from the create response.

レスポンス

  • 200

    A signed download link for the gzip JSONL file.

    レスポンス
    • urlstring必須

      Signed URL of the gzip JSONL file; needs no API key.

    • expires_atstring必須
  • 401

    Missing, unknown or revoked API key.

    レスポンス
    • errorstring必須

      Human-readable message.

    • codestring

      Stable machine reason, when the route defines one (for example pro_required).

    • actionstring

      Stable remediation action, when the route defines one.

    • detailsobject

      Customer-safe string facts the caller needs to act (for example a suggested identifier).

  • 404

    No export with this id for your organization.

    レスポンス
    • errorstring必須

      Human-readable message.

    • codestring

      Stable machine reason, when the route defines one (for example pro_required).

    • actionstring

      Stable remediation action, when the route defines one.

    • detailsobject

      Customer-safe string facts the caller needs to act (for example a suggested identifier).

  • 409

    The export is not ready.

    レスポンス
    • errorstring必須

      Human-readable message.

    • codestring

      Stable machine reason, when the route defines one (for example pro_required).

    • actionstring

      Stable remediation action, when the route defines one.

    • detailsobject

      Customer-safe string facts the caller needs to act (for example a suggested identifier).

  • 410

    The export file has expired.

    レスポンス
    • errorstring必須

      Human-readable message.

    • codestring

      Stable machine reason, when the route defines one (for example pro_required).

    • actionstring

      Stable remediation action, when the route defines one.

    • detailsobject

      Customer-safe string facts the caller needs to act (for example a suggested identifier).

  • 422

    The body or query failed validation.

    レスポンス
    • detailarray<object>必須
      detail
      • typestring
      • locarray<string | integer>
      • msgstring
  • 503

    The download link could not be minted.

    レスポンス
    • errorstring必須

      Human-readable message.

    • codestring

      Stable machine reason, when the route defines one (for example pro_required).

    • actionstring

      Stable remediation action, when the route defines one.

    • detailsobject

      Customer-safe string facts the caller needs to act (for example a suggested identifier).

リクエスト

curl https://api.experientiallabs.ai/api/v1/usage/exports/6e2b9c14-7d3a-4f01-8b5e-2c9a1d7f4e63/download \
  -H "Authorization: Bearer YOUR_API_KEY"

レスポンス

{
  "url": "https://storage.experientiallabs.ai/object/sign/usage-exports/6e2b9c14.jsonl.gz?token=eyJhbGciOi...",
  "expires_at": "2026-11-19T16:20:12.000Z"
}

https://api.experientiallabs.ai/api/v1/usage/exports/6e2b9c14-7d3a-4f01-8b5e-2c9a1d7f4e63/download