Skip to content
Faber Faber

Download a stored file

GET
/file/{id}

Authorizations

Section titled “Authorizations ”

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters ”
id
required

Lowercase hex SHA-256 of the file content

string
/^[0-9a-f]{64}$/

Lowercase hex SHA-256 of the file content

Responses

Section titled “ Responses ”

200

Section titled “200 ”

File content with its stored content type

string format: binary

400

Section titled “400 ”

Malformed request body or parameters (invalid_request)

object
error
required

Human-readable message

string
code
required

Stable machine-readable error code. Clients should treat unknown codes as internal_error.

string
Allowed values: invalid_request unauthorized not_found file_not_found payload_too_large limits_exceeded profile_not_allowed capacity_exhausted rate_limited shutting_down cancelled deadline_exceeded sandbox_setup_failed cache_disabled internal_error
Example
{
  "error": "Failed to deserialize the JSON body into the target type: missing field `cmd`",
  "code": "invalid_request"
}

401

Section titled “401 ”

Missing or wrong API key (unauthorized)

object
error
required

Human-readable message

string
code
required

Stable machine-readable error code. Clients should treat unknown codes as internal_error.

string
Allowed values: invalid_request unauthorized not_found file_not_found payload_too_large limits_exceeded profile_not_allowed capacity_exhausted rate_limited shutting_down cancelled deadline_exceeded sandbox_setup_failed cache_disabled internal_error
Example
{
  "error": "Missing or invalid API key",
  "code": "unauthorized"
}

Headers

Section titled “Headers ”
WWW-Authenticate
string

404

Section titled “404 ”

No such resource (not_found)

object
error
required

Human-readable message

string
code
required

Stable machine-readable error code. Clients should treat unknown codes as internal_error.

string
Allowed values: invalid_request unauthorized not_found file_not_found payload_too_large limits_exceeded profile_not_allowed capacity_exhausted rate_limited shutting_down cancelled deadline_exceeded sandbox_setup_failed cache_disabled internal_error
Example
{
  "error": "File not found: 9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08",
  "code": "not_found"
}

429

Section titled “429 ”

The API key has used up its requests (rate_limited). Sent only when the service enables per-key rate limiting (RATE_LIMIT_PER_MINUTE). Retry after the Retry-After header.

object
error
required

Human-readable message

string
code
required

Stable machine-readable error code. Clients should treat unknown codes as internal_error.

string
Allowed values: invalid_request unauthorized not_found file_not_found payload_too_large limits_exceeded profile_not_allowed capacity_exhausted rate_limited shutting_down cancelled deadline_exceeded sandbox_setup_failed cache_disabled internal_error
Example
{
  "error": "Rate limit exceeded for this API key",
  "code": "rate_limited"
}

Headers

Section titled “Headers ”
Retry-After
integer

Seconds until the key may make another request