Download batch files

GET /api/batches/{batchId}/jobs/download

Requires batches:read.

curl "https://app.kalpana.one/api/batches/bat_123/jobs/download?workspace=acme" \
  --header "x-api-key: $KALPANA_API_KEY"

Response

{
  "batch": { "name": "September products" },
  "files": [
    {
      "id": "cre_123",
      "displayName": "september-products-1.png",
      "storageKey": "…",
      "s3Key": "…",
      "url": "https://cdn.example/temporary-url"
    }
  ]
}

storageKey and s3Key hold the same storage key. The list is not paginated and contains only rows that have produced a file, ordered by creation. Rows still rendering or failed are absent. A batch that is not in the workspace returns 404.

url is a presigned link that expires. Request the list shortly before downloading and never store url as a permanent address. To keep a stable reference, store the creative id and use List creatives.