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. On the right you find request samples in cURL, JavaScript and Python, an example response and Try it, which sends the request for real with your own token.

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

GET/v1.0/files/{fileId}Try it →

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.

Try it

Send this request for real, with your own token and your own data.

Request

cURL

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

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.