Files

A file is a binary asset such as a profile picture or a company logo. URLs like pictureFileUrl point here and need the same bearer token as the rest of the API.

Every endpoint below shows its parameters and response fields in the middle and a request sample with an example response on the right.

Base URL https://api.sally.ioVersion v1.0 current, not frozen yetHow versioning works

Streams a file (e.g. a profile picture) by id

GET/v1.0/files/{fileId}

Returns the raw file bytes with the stored content type. Referenced by pictureFileUrl. Requires the same Bearer token as the rest of the API. 404 if the file does not exist.

Path parameters

• fileIdstringrequired

  Id of the file.

Status codes

• 200Raw file bytes.
• 400

  Invalid request (validation error).

• 401

  Missing or invalid bearer token.

• 404

  Resource not found or not accessible.

• 429

  Rate limit exceeded (per token/IP). Transcription uploads may also return code FUP_LIMIT_EXCEEDED or TOO_MANY_CONCURRENT_TRANSCRIPTIONS.

• 500

  Internal server error.

Request

cURL

curl "https://api.sally.io/v1.0/files/$FILE_ID" \
  -H "Authorization: Bearer $SALLY_TOKEN" \
  -o file

JavaScript

const response = await fetch(`https://api.sally.io/v1.0/files/${fileId}`, {
  headers: {
    Authorization: `Bearer ${process.env.SALLY_TOKEN}`,
  },
});
const file = await response.blob();

Python

import os
import requests

response = requests.get(
    f"https://api.sally.io/v1.0/files/{file_id}",
    headers={"Authorization": f"Bearer {os.environ['SALLY_TOKEN']}"},
)
content = response.content

Response example 200 OK

Returns the file itself as a binary stream, not JSON.