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

Get a Collection

GET
https://api.caesar.xyz/research/collections/:id
GET
/research/collections/:id
$curl https://api.caesar.xyz/research/collections/id \
>     -H "Authorization: Bearer <token>"
1{
2  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
3  "name": "Genomic Data Set Alpha",
4  "created_at": "2024-01-15T09:30:00Z",
5  "updated_at": "2024-04-10T14:45:00Z",
6  "description": "A comprehensive collection of genomic sequences from the 2023 cancer research cohort."
7}
Retrieve a single collection by ID.
Built with

Authentication

AuthorizationBearer

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

Path parameters

idstringRequiredformat: "uuid"
Collection identifier.

Response

The collection.
idstringformat: "uuid"
Unique identifier for the collection.
namestring
Name of the collection.
created_atdatetime
ISO 8601 timestamp when the collection was created.
updated_atdatetime
ISO 8601 timestamp when the collection was last updated.
descriptionstring
Description of the collection.

Errors

401
Unauthorized Error
404
Not Found Error
500
Internal Server Error