For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Logo
DocumentationAPI ReferenceChangelog
DocumentationAPI ReferenceChangelog
  • API Reference
      • GETGet Research Files
      • POSTCreate a Research File
      • GETGet Collections
      • POSTCreate a Collection
      • GETGet a Collection
      • PATCHUpdate a Collection
API ReferenceFiles

Create a Research File

POST
https://api.caesar.xyz/research/files
POST
/research/files
$curl -X POST https://api.caesar.xyz/research/files \
>     -H "Authorization: Bearer <token>" \
>     -H "Content-Type: multipart/form-data"
1{
2  "id": "d290f1ee-6c54-4b01-90e6-d701748f0851",
3  "file_name": "research_paper_2024.pdf",
4  "content_type": "application/pdf",
5  "collection_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
6}
Upload a file via multipart form and create a Research File object. Optionally assign to a collection.
Built with

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects a multipart form containing a file.
filefileRequired
collection_idstringOptionalformat: "uuid"
Optional collection ID to assign the file to.

Response

The created file object.
idstringformat: "uuid"
Unique identifier for the file.
file_namestring
Original uploaded filename.
content_typestring

MIME type of the file as detected/stored.

collection_idstringformat: "uuid"
ID of the collection this file belongs to, if any.

Errors

400
Bad Request Error
401
Unauthorized Error
429
Too Many Requests Error
500
Internal Server Error