files

Download File

Download file content.

Supports two authentication modes:

Bearer token: Standard authenticated request. Gated on organization readiness so the bearer path cannot reach tenant storage before bootstrap completes.
Signed URL: Include token and expires query parameters. Not gated — signed URLs must stay reachable to preserve the pre-existing public contract.

Returns: File content with appropriate content-type header.

Raises: HTTPException: 401 if authentication fails. HTTPException: 404 if file not found.

GET

files

{name}

download

Download File

curl --request GET \
  --url https://api.example.com/files/{name}/download

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}

Path Parameters

name

string

required

Query Parameters

token

string | null

expires

integer | null

Response

Successful Response

Delete FileDelete file content from storage. This only deletes the file content. The pragma/file resource must be deleted separately using the resources API. Idempotent: Returns 204 even if file doesn't exist.

Download File

curl --request GET \
  --url https://api.example.com/files/{name}/download

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}

Documentation Index

Path Parameters

Query Parameters

Response