List Documents

GET

/org/:org_id/project/:project_id/document

GET

/api/v1/org/:org_id/project/:project_id/document

$ curl https://app.rightbrain.ai/api/v1/org/org_id/project/project_id/document \
>      -H "Authorization: Bearer <token>"

1 {
2   "results": [
3     {
4       "title": "Driver Safety SOP",
5       "project_id": "019a2f10-8b2d-7e43-9c64-1c9d4e7b6f02",
6       "strategy": "pdf",
7       "id": "019a2f10-b1b6-7e60-95fd-1c9d4e7b6f30",
8       "chunks": 42,
9       "original_mime": "application/pdf",
10       "embedding_instances": [
11         {
12           "id": "019a2f10-c1d8-7e70-971f-1c9d4e7b6f40",
13           "chat_document_id": "019a2f10-b1b6-7e60-95fd-1c9d4e7b6f30",
14           "is_active": true,
15           "config": {}
16         }
17       ],
18       "description": "Standard operating procedure for pre-trip vehicle checks and incident reporting.",
19       "source": "upload",
20       "source_meta": {},
21       "connection_id": null
22     },
23     {
24       "title": "Union Pacific Rate Agreement 2026",
25       "project_id": "019a2f10-8b2d-7e43-9c64-1c9d4e7b6f02",
26       "strategy": "pdf",
27       "id": "019a2f10-b2c7-7e61-960e-1c9d4e7b6f31",
28       "chunks": 18,
29       "original_mime": "application/pdf",
30       "embedding_instances": [
31         {
32           "id": "019a2f10-c2e9-7e71-9820-1c9d4e7b6f41",
33           "chat_document_id": "019a2f10-b2c7-7e61-960e-1c9d4e7b6f31",
34           "is_active": true,
35           "config": {}
36         }
37       ],
38       "description": "Signed rate agreement and service-level terms with Union Pacific for the 2026 contract year.",
39       "source": "upload",
40       "source_meta": {},
41       "connection_id": null
42     }
43   ],
44   "pagination": {
45     "next_cursor": "0190a234-8dc6-6d08-aea9-928fcecad8f2",
46     "has_next": true,
47     "page_limit": 25
48   }
49 }

List all documents in a project with optional filtering.

Filter options:

By connection/datasource
By title (partial match)
By collection membership
By source type
By processing strategy

Results are paginated and include document metadata.

List all documents in a project with optional filtering. Filter options: - By connection/datasource - By title (partial match) - By collection membership - By source type - By processing strategy Results are paginated and include document metadata.

Authentication

AuthorizationBearer

API key or access token, sent as Authorization: Bearer <token>. The simplest option: create an API key in your dashboard under Settings, then paste it here.

AuthorizationBearer

API key or access token, sent as Authorization: Bearer <token>. The simplest option: create an API key in your dashboard under Settings, then paste it here.

Path parameters

org_idstringRequiredformat: "uuid"

project_idstringRequiredformat: "uuid"

Query parameters

connection_idstringOptionalformat: "uuid"

Filter by datasource connection

titlestringOptional

Filter by title (partial match)

cursorstringOptionalformat: "uuid"

Pagination cursor

collection_idstringOptionalformat: "uuid"

Filter by collection membership

page_limitintegerOptional1-100Defaults to 25

Results per page

sourceenum or nullOptional

Filter by where the document came from. Documents created through either upload endpoint have source: upload; the remaining values belong to documents synced from a datasource connection.

strategystringOptional

Filter by processing strategy

Response

Successfully retrieved documents

resultslist of objects

The list of items returned for the current page.

paginationobject or nullOptional

Contains pagination information for the result set.

Errors

400

Bad Request Error

403

Forbidden Error

422

Unprocessable Entity Error