Storage endpoint

Create Download

POST/storages/{storageId}/downloads/

Path parameters

storageId

Identifier used by the registered route.

Example request

application/json

{
  "path": "/shared/project/result.csv"
}

cURL template

curl --fail-with-body \
  -H "Authorization: Bearer ${AKOFLOW_API_TOKEN}" \
  -H "Content-Type: application/json" \
  --data-binary @request.json \
  -X POST \
  "${AKOFLOW_API_URL}/storages/{storageId}/downloads/"

Supply a valid request.json before running this command.

Replace the path identifiers with IDs from your instance.

201 Createdapplication/json

Field shape inferred from Go types; inspect the returned JSON for actual values and optional fields.

{
  "id": "string",
  "storageId": "string",
  "path": "string",
  "status": "string",
  "strategy": "string",
  "url": "string",
  "sizeBytes": 0,
  "transferredBytes": 0,
  "error": "string",
  "createdAt": "2026-01-01T00:00:00Z",
  "updatedAt": "2026-01-01T00:00:00Z"
}

Handler-checked behavior

Replace the example path with an existing file within the selected storage's approved browse root; directories require the archive route. id is optional. The response is a ready download record, not a frozen copy: GET /storage-downloads/{downloadId}/content/ opens the path when you fetch it. See Browse and manage storage for download and checksum steps.

Related guide

See the Storage guide for related tasks and context.