Add Documents to Collection

POST

/org/:org_id/project/:project_id/collection/:collection_id/add

POST

/api/v1/org/:org_id/project/:project_id/collection/:collection_id/add

$ curl -X POST https://app.rightbrain.ai/api/v1/org/org_id/project/project_id/collection/collection_id/add \
>      -H "Authorization: Bearer <token>" \
>      -H "Content-Type: application/json" \
>      -d '{
>   "embedding_instance_ids": [
>     "019a2f10-c3fa-7e72-9931-1c9d4e7b6f42"
>   ]
> }'

1 {
2   "title": "Operations Handbook",
3   "project_id": "019a2f10-8b2d-7e43-9c64-1c9d4e7b6f02",
4   "id": "019a2f10-a194-7e50-93db-1c9d4e7b6f20",
5   "created": "2026-01-08T09:15:00Z",
6   "modified": "2026-06-02T11:40:00Z",
7   "summary": "Standard operating procedures covering dispatch, driver safety, and warehouse workflows.",
8   "embedding_instances": [
9     {
10       "id": "019a2f10-c1d8-7e70-971f-1c9d4e7b6f40",
11       "chat_document_id": "019a2f10-b1b6-7e60-95fd-1c9d4e7b6f30",
12       "is_active": true,
13       "config": {}
14     },
15     {
16       "id": "019a2f10-c3fa-7e72-9931-1c9d4e7b6f42",
17       "chat_document_id": "019a2f10-b3d8-7e62-9721-1c9d4e7b6f32",
18       "is_active": true,
19       "config": {}
20     }
21   ],
22   "task_ids": [
23     "019a2f10-e11c-7e90-9b53-1c9d4e7b6f60"
24   ]
25 }

Add embedding instances (documents) to an existing collection.

Expands the collection’s knowledge base by including additional documents. The documents must already exist as embedding instances in the system.

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

collection_idstringRequiredformat: "uuid"

org_idstringRequiredformat: "uuid"

The unique identifier of the organization.

project_idstringRequiredformat: "uuid"

The unique identifier of the project.

Request

This endpoint expects an object.

embedding_instance_idslist of stringsRequired

Response

Documents added to the collection

titlestring

project_idstringformat: "uuid"

idstringformat: "uuid"

createdstring

modifiedstring

summarystring or nullOptional

embedding_instanceslist of objectsOptionalDefaults to []

task_idslist of stringsOptionalDefaults to []

Errors

400

Bad Request Error

403

Forbidden Error

422

Unprocessable Entity Error