Create Collection

POST

/org/:org_id/project/:project_id/collection

Create a new collection for organizing document embeddings.

Collections serve as knowledge bases for RAG-enabled features:

Group related documents together
Enable contextual AI responses
Support multiple embedding instances
Organize information by topic or use case

You can add documents to the collection after creation.

Create a new collection for organizing document embeddings. Collections serve as knowledge bases for RAG-enabled features: - Group related documents together - Enable contextual AI responses - Support multiple embedding instances - Organize information by topic or use case You can add documents to the collection after creation.

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"

The unique identifier of the organization.

project_idstringRequiredformat: "uuid"

The unique identifier of the project.

Request

This endpoint expects an object.

titlestringRequired

document_embedding_instance_idslist of stringsOptionalDefaults to []

Response

Collection created successfully

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

$	curl -X POST https://app.rightbrain.ai/api/v1/org/org_id/project/project_id/collection \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"title": "Carrier Contracts 2026",
>	"document_embedding_instance_ids": []
>	}'

1	{
2	"title": "Carrier Contracts 2026",
3	"project_id": "019a2f10-8b2d-7e43-9c64-1c9d4e7b6f02",
4	"id": "019a2f10-a2a5-7e51-94ec-1c9d4e7b6f21",
5	"created": "2026-07-20T10:00:00Z",
6	"modified": "2026-07-20T10:00:00Z",
7	"summary": "Signed carrier rate agreements and service-level terms for the 2026 contract year.",
8	"embedding_instances": [],
9	"task_ids": []
10	}