Skip to main content
GET
/
v1
/
files
/
{id}
Get a file (re-mints a fresh 1h signed URL)
curl --request GET \
  --url https://api.example.com/v1/files/{id} \
  --header 'X-Api-Key: <api-key>'
{
  "id": "file_01HXMQ7Z3K8Y2NABCDEFGHJKMN",
  "object": "file",
  "purpose": "reference",
  "mime_type": "image/jpeg",
  "size_bytes": 1247892,
  "width_px": 1024,
  "height_px": 768,
  "url": "https://...?token=...",
  "expires_at": "2026-05-04T14:00:00Z",
  "created_at": "2026-05-03T14:00:00Z",
  "metadata": {
    "campaign": "launch-2026"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.aurous-labs.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
X-Api-Key
string
header
required

Your team API key (starts with al_live_ — legacy keys may start with og_).

Headers

​
Aurous-Version
string

Optional API version pin (YYYY-MM-DD). Defaults to your team's pinned version, or the system default 2026-05-15 for unauthenticated requests.

Pattern: ^\d{4}-\d{2}-\d{2}$
Example:

"2026-05-15"

Path Parameters

​
id
string
required

Opaque file ID.

Example:

"file_01HXMQ7Z3K8Y2NABCDEFGHJKMN"

Response

File found

​
id
string
required

Opaque file ID.

Example:

"file_01HXMQ7Z3K8Y2NABCDEFGHJKMN"

​
object
string
required

Object discriminator.

Example:

"file"

​
purpose
enum<string>
required
Available options:
reference,
first_frame,
last_frame
Example:

"reference"

​
mime_type
enum<string>
required
Available options:
image/png,
image/jpeg,
image/webp
Example:

"image/jpeg"

​
size_bytes
number
required

File size in bytes.

Example:

1247892

​
width_px
object
required

Decoded image width in pixels (max 4096).

Example:

1024

​
height_px
object
required

Decoded image height in pixels (max 4096).

Example:

768

​
url
string
required

Time-limited signed URL valid for ~1h. Re-mint a fresh URL by re-fetching GET /v1/files/:id. Do NOT cache long-term — the underlying bucket is private.

Example:

"https://...?token=..."

​
expires_at
string
required

Hard 24h TTL — the file is automatically purged at this timestamp.

Example:

"2026-05-04T14:00:00Z"

​
created_at
string
required

Creation timestamp.

Example:

"2026-05-03T14:00:00Z"

​
metadata
object

Echoed metadata.

Example:
{ "campaign": "launch-2026" }