Conversations
Upload file
Uploads a file to attach to messages.
POST
Upload file
Authorizations
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.
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.