Skip to content
Faber Faber

List stored files

GET
/file

Authorizations

Section titled “Authorizations ”

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Stored files

object
files
required
Array<object>
object
id
required

Lowercase hex SHA-256 of the file content

string
/^[0-9a-f]{64}$/
filename
string | null
content_type
string | null
size
required
integer format: int64
created_at
required

RFC 3339 UTC timestamp

string format: date-time

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

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