POST /download-sessions/{downloadSessionId}/presigned-get-url-batches

← Artifacts and export

POST

/v1/download-sessions/{downloadSessionId}/presigned-get-url-batches

Presigned GET URLs for CLI / scripts; auth = download sessionToken only.

Host

https://api.embodiflow.com/v1
https://api.embodiflow.dev/v1

Authentication

Authorization: Bearer PAT

Parameters

Name	In	Type	Required	Description
downloadSessionId	path	string	Yes	Not published in OpenAPI
Idempotency-Key	header	string	No	Optional idempotency key, at most 255 characters (UUIDv4 recommended). A repeated key returns the first response byte-for-byte, including a 5xx. The same key with a different body, or a second in-flight request, returns 409 IDEMPOTENCY_CONFLICT. Keys are unique per tenant and retained for 24 hours.

Request body

Content-Type: application/json
Schema: object

{
  "type": "object",
  "properties": {
    "sessionToken": {
      "type": "string",
      "minLength": 10
    }
  },
  "required": [
    "sessionToken"
  ]
}

Responses

Status	Description	Content-Type	Schema
201	Success	application/json	object
400	Bad request. Enumerated catalog codes for this operation.	application/problem+json	union
404	Not found. Enumerated catalog codes for this operation.	application/problem+json	union
409	Conflict. Enumerated catalog codes for this operation.	application/problem+json	union

{
  "type": "object",
  "properties": {
    "data": {
      "$ref": "#/components/schemas/CreateDownloadSessionPresignedGetUrlBatchResponseDto"
    }
  },
  "required": [
    "data"
  ]
}

{
  "allOf": [
    {
      "$ref": "#/components/schemas/ProblemJson"
    },
    {
      "type": "object",
      "properties": {
        "status": {
          "type": "integer",
          "enum": [
            400
          ]
        },
        "code": {
          "type": "string",
          "enum": [
            "BAD_REQUEST",
            "DATASET_VERSION_CONTRACT_BLOCKED",
            "DATASET_VERSION_MANIFEST_MISSING",
            "DATASET_VERSION_QUALITY_BLOCKED",
            "DATASET_VERSION_STATS_STALE",
            "EXPORT_BLOCKED_BY_PII_POLICY",
            "IDEMPOTENCY_KEY_INVALID",
            "IF_MATCH_INVALID",
            "TENANT_CONTEXT_MISMATCH",
            "TENANT_REQUIRED",
            "VALIDATION_ERROR"
          ]
        }
      }
    }
  ]
}

{
  "allOf": [
    {
      "$ref": "#/components/schemas/ProblemJson"
    },
    {
      "type": "object",
      "properties": {
        "status": {
          "type": "integer",
          "enum": [
            404
          ]
        },
        "code": {
          "type": "string",
          "enum": [
            "ARTIFACT_NOT_FOUND",
            "DATASET_EXPORT_JOB_NOT_FOUND",
            "DEPLOYMENT_PACKAGE_NOT_FOUND",
            "DOWNLOAD_SESSION_NOT_FOUND",
            "EXPORT_NOT_FOUND",
            "NOT_FOUND",
            "TRAINING_JOB_NOT_FOUND",
            "USER_NOTIFICATION_NOT_FOUND"
          ]
        }
      }
    }
  ]
}

{
  "allOf": [
    {
      "$ref": "#/components/schemas/ProblemJson"
    },
    {
      "type": "object",
      "properties": {
        "status": {
          "type": "integer",
          "enum": [
            409
          ]
        },
        "code": {
          "type": "string",
          "enum": [
            "EXPORT_ALREADY_FINALIZED",
            "IDEMPOTENCY_CONFLICT"
          ]
        }
      }
    }
  ]
}

Example

curl -X POST 'https://api.embodiflow.com/v1/download-sessions/{downloadSessionId}/presigned-get-url-batches' \
  -H 'Authorization: Bearer $EMBODIFLOW_PAT' \
  -H 'Content-Type: application/json' \
  -d '{}'

Parameters

Name	In	Type	Required	Description
downloadSessionId	path	string	Yes	Not published in OpenAPI
Idempotency-Key	header	string	No	Optional idempotency key, at most 255 characters (UUIDv4 recommended). A repeated key returns the first response byte-for-byte, including a 5xx. The same key with a different body, or a second in-flight request, returns 409 IDEMPOTENCY_CONFLICT. Keys are unique per tenant and retained for 24 hours.

Responses

Status	Description	Content-Type	Schema
201	Success	application/json	object
400	Bad request. Enumerated catalog codes for this operation.	application/problem+json	union
404	Not found. Enumerated catalog codes for this operation.	application/problem+json	union
409	Conflict. Enumerated catalog codes for this operation.	application/problem+json	union

{ "type": "object", "properties": { "data": { "$ref": "#/components/schemas/CreateDownloadSessionPresignedGetUrlBatchResponseDto" } }, "required": [ "data" ] }

{ "allOf": [ { "$ref": "#/components/schemas/ProblemJson" }, { "type": "object", "properties": { "status": { "type": "integer", "enum": [ 400 ] }, "code": { "type": "string", "enum": [ "BAD_REQUEST", "DATASET_VERSION_CONTRACT_BLOCKED", "DATASET_VERSION_MANIFEST_MISSING", "DATASET_VERSION_QUALITY_BLOCKED", "DATASET_VERSION_STATS_STALE", "EXPORT_BLOCKED_BY_PII_POLICY", "IDEMPOTENCY_KEY_INVALID", "IF_MATCH_INVALID", "TENANT_CONTEXT_MISMATCH", "TENANT_REQUIRED", "VALIDATION_ERROR" ] } } } ] }

{ "allOf": [ { "$ref": "#/components/schemas/ProblemJson" }, { "type": "object", "properties": { "status": { "type": "integer", "enum": [ 404 ] }, "code": { "type": "string", "enum": [ "ARTIFACT_NOT_FOUND", "DATASET_EXPORT_JOB_NOT_FOUND", "DEPLOYMENT_PACKAGE_NOT_FOUND", "DOWNLOAD_SESSION_NOT_FOUND", "EXPORT_NOT_FOUND", "NOT_FOUND", "TRAINING_JOB_NOT_FOUND", "USER_NOTIFICATION_NOT_FOUND" ] } } } ] }

{ "allOf": [ { "$ref": "#/components/schemas/ProblemJson" }, { "type": "object", "properties": { "status": { "type": "integer", "enum": [ 409 ] }, "code": { "type": "string", "enum": [ "EXPORT_ALREADY_FINALIZED", "IDEMPOTENCY_CONFLICT" ] } } } ] }

curl -X POST 'https://api.embodiflow.com/v1/download-sessions/{downloadSessionId}/presigned-get-url-batches' \ -H 'Authorization: Bearer $EMBODIFLOW_PAT' \ -H 'Content-Type: application/json' \ -d '{}'