List files

Lists runtime file metadata. Requires files:read. Use run_id to filter files for one run.

GET/files

Authorization

AuthorizationBearer <token>

Query parameters

run_idstring

Filter to files for a run.

pattern: "^run_[A-Za-z0-9]+$"

purposestring

limitinteger

minimum: 1
maximum: 100
default: 20

afterstring

Response

application/json

File list

union

All of these rules apply

object1

object

objectstringrequired

const: "list"

dataarrayrequired

Show nested schema

Array items

any

has_morebooleanrequired

first_idstring | nullrequired

last_idstring | nullrequired

object2

object

dataarray

Show nested schema

Array items

object

idstringrequired

objectstringrequired

const: "file"

bytesintegerrequired

created_atintegerrequired

expires_atinteger | nullrequired

filenamestringrequired

purposestringrequired

enum: ["input","output"]

media_typestringrequired

curl --request GET \
  --url 'https://YOUR_SALAMBO_BASE_URL/api/v1/files' \
  --header 'Authorization: Bearer YOUR_API_KEY'

Replace placeholders with your values.

Response

{
  "object": "list",
  "data": [
    {
      "id": "<string>",
      "object": "file",
      "bytes": 123,
      "created_at": 123,
      "expires_at": 123,
      "filename": "<string>",
      "purpose": "input",
      "media_type": "<string>"
    }
  ],
  "has_more": true,
  "first_id": "<string | null>",
  "last_id": "<string | null>"
}