Retrieve file metadata

Retrieves metadata for one runtime file. Requires files:read.

Use this before downloading when you need filename, MIME type, purpose, or size.

GET/files/{fileId}

Authorization

AuthorizationBearer <token>

Path parameters

fileIdstringrequired

Response

application/json

File metadata

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/{fileId}' \
  --header 'Authorization: Bearer YOUR_API_KEY'

Replace placeholders with your values.

Response

{
  "id": "<string>",
  "object": "file",
  "bytes": 123,
  "created_at": 123,
  "expires_at": 123,
  "filename": "<string>",
  "purpose": "input",
  "media_type": "<string>"
}