List Files

GET/v1/files

Overview

Files in the key's workspace, newest first. Requires llm.write. Batch outputs have purpose batch_output.

Authorization

Authorizationstring · headerRequired

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

Parameters

purposequery · string

limitquery · integer

afterquery · string

File ID to list after.

Responses

200One page of files.

application/json

objectstringRequired

dataobject[]Required

Show nested fields

idstringRequired

Example: "file-abc123"

objectstringRequired

bytesintegerRequired

created_atintegerRequired

Unix seconds.

filenamestringRequired

purposestringRequired

Values: "batch""batch_output"

statusstringRequired

expires_atnull

Files are kept until deleted.

has_morebooleanRequired

401Invalid API key.

403Missing llm.write scope.

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" \
  --header "Authorization: Bearer $AUDIOLAB_API_KEY"

{
  "object": "VALUE",
  "data": [
    {
      "id": "file-abc123",
      "object": "VALUE",
      "bytes": 1,
      "created_at": 1,
      "filename": "VALUE",
      "purpose": "batch",
      "status": "VALUE",
      "expires_at": "VALUE"
    }
  ],
  "has_more": false
}

Example responses · See schemas for all fields