Get a File

GET/v1/files/{file_id}

Overview

A file's metadata. Requires llm.write.

Authorization

Authorizationstring · headerRequired

AudioLab API key sent as Bearer <token>. Authentication guide

Parameters

file_idpath · stringRequired

Responses

200The file.

application/json

idstringRequired

Example: "file-abc123"

objectstringRequired

bytesintegerRequired

created_atintegerRequired

Unix seconds.

filenamestringRequired

purposestringRequired

Values: "batch""batch_output"

statusstringRequired

expires_atnull

Files are kept until deleted.

401Invalid API key.

404File not found in this workspace.

Replace uppercase placeholders before running. JavaScript examples require Node.js 22 or later; Python examples require requests. WebSocket examples require the Node.js ws package. See setup for credentials.

curl --fail --show-error --request GET \
  --url "$AUDIOLAB_API_URL/v1/files/YOUR_FILE_ID" \
  --header "Authorization: Bearer $AUDIOLAB_API_KEY"

{
  "id": "file-abc123",
  "object": "VALUE",
  "bytes": 1,
  "created_at": 1,
  "filename": "VALUE",
  "purpose": "batch",
  "status": "VALUE",
  "expires_at": "VALUE"
}

Example responses · See schemas for all fields