API Reference
Complete documentation of all ThreadHound API endpoints, request/response schemas, and parameters.
Interactive Documentation
OpenAPI (Swagger) Documentation
Explore our full API specification with an interactive interface. Test endpoints directly from your browser, view request/response examples, and understand all available parameters.
Attachments & Media
Files sent in a chat — images, voice notes, video, documents — are copied into ThreadHound’s own storage as messages are ingested, so they outlive the short-lived links the source channel provides. Every message payload lists its attachments, and the API can hand you a temporary URL for downloading any of them.
| File type | Stored | AI content summary |
|---|---|---|
| Images | Yes | A description of what the image depicts |
| Audio and voice notes | Yes | A summary of the transcribed speech |
| Documents and other files | Yes | An overview of the contents |
| Video | Yes | None. Video is never sent to an AI model, so the summary always reads “Content summary not available - download video file to view it” |
Downloading a file
Downloads are a two-step process. Message payloads give each attachment an attachmentIndex and a hasStoredFile flag; passing that index to the download-url endpoint mints a URL that points straight at our file storage. Nothing is signed until you ask for a specific file, so listing messages never creates download credentials for files you do not want.
A download URL lasts one hour and needs no API key of its own — anyone holding it can fetch that file until it expires. Fetch it promptly, and request a fresh one next time rather than storing or sharing it.
Size limits
Very large files are not stored. The ceiling is 25 MB for most attachments and 64 MB for video, and a community that has reached its file storage quota also stops storing new attachments. In both cases the attachment still appears on the message with hasStoredFile: false, its contentSummary explains what happened, and the download endpoint returns 409 with a storageStatus.
Rate Limits
| Tier | Requests/Minute | Requests/Day |
|---|---|---|
| Basic | 60 | 1,000 |
| Pro | 300 | 10,000 |
| Enterprise | Custom | Custom |
Need Help?
Have questions about the API or need assistance with your integration? Our team is here to help.