Skip to main content
GET
Get upload

Authorizations

Authorization
string
header
required

Use a JWT bearer token or a Veryfront API key in the Authorization header.

Path Parameters

project_reference
string
required

Project slug, UUID, or domain that identifies the project.

upload_reference
string
required

Upload ID (UUID) or URL-encoded file path

Response

File metadata (when Accept: application/json)

id
string
required

Upload UUID.

path
string
required

Project-relative storage path, without a leading slash.

file_name
string
required

File name from the upload record.

content_type
string | null
required

Stored MIME type, or null when unspecified.

size
number
required

Declared file size in bytes.

url
string | null
required

API URL for downloading the upload; access depends on its visibility.

status
enum<string>
required

Upload lifecycle state: pending until finalized, active when available, or failed.

Available options:
pending,
active,
failed
visibility
enum<string>
required

Effective access policy for the upload or folder.

Available options:
project,
public,
private
created_at
string
required

Creation timestamp in ISO 8601 format.

updated_at
string
required

Last update timestamp in ISO 8601 format.

deleted_at
string | null
required

Soft deletion timestamp in ISO 8601 format, or null for an undeleted upload.