Skip to main content
GET
Retrieve file
This page documents the Legacy API. For new integrations, use Retrieve File in the Current API.

Autorisationer

Authorization
string
header
påkrævet

An Account API key, account-scoped JWT, App API key, or user OAuth token. Prepend the key or token with Bearer, for example Bearer ***************************.

Sti-parametre

id
string
påkrævet

The unique identifier of the file to retrieve.

Eksempel:

"file_xxxxxxxxxxxxx"

Svar

A successful response

A file that has been uploaded or is pending upload.

content_type
string | null
påkrævet

The MIME type of the uploaded file (e.g., image/jpeg, video/mp4, audio/mpeg).

Eksempel:

"image/jpeg"

filename
string | null
påkrævet

The original filename of the uploaded file, including its file extension.

Eksempel:

"document.pdf"

id
string
påkrævet

The unique identifier for the file.

Eksempel:

"file_xxxxxxxxxxxxx"

size
string | null
påkrævet

The file size in bytes. Null if the file has not finished uploading.

Eksempel:

"123.45"

upload_status
enum<string>
påkrævet

The current upload status of the file (e.g., pending, ready).

Tilgængelige muligheder:
pending,
processing,
ready,
failed
url
string | null
påkrævet

The URL for accessing the file. For public files, this is a permanent CDN URL. For private files, this is a signed URL that expires. Null if the file has not finished uploading.

visibility
enum<string>
påkrævet

Whether the file is publicly accessible or requires authentication.

Tilgængelige muligheder:
public,
private