Skip to main content
POST
Upload file

Authorizations

Authorization
string
header
required

Pass Authorization: Bearer <credential>, where the credential is either:

  • an API key (sk_…), generated by an organization admin in Settings, for scripts and automation;
  • an access token from tth auth login (the TalkToHumans CLI), which any member of the workspace can use.

Both resolve to the same organization and user. A login token acts in the user's workspace: one with no workspace yet returns 403 workspace_setup_required, and one in several workspaces returns 403 forbidden (use an API key instead).

Body

The file itself, sent as multipart/form-data.

file
file
required

The file: an image (such as a GIF), a video, a PDF, or M4A audio, up to 20 MB.

Response

File uploaded. Attach it by its file_id; files nothing uses are deleted after 30 days.

data
object
required