Remove Documents from Collection

POST

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

POST

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

$ curl -X POST https://app.rightbrain.ai/api/v1/org/org_id/project/project_id/collection/collection_id/remove \
>      -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   "task_ids": [
17     "019a2f10-e11c-7e90-9b53-1c9d4e7b6f60"
18   ]
19 }

Remove embedding instances (documents) from a collection.

Reduces the collection’s scope by excluding specific documents. Documents are not deleted, only their association with the collection is removed.

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 removed from 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

404

Not Found Error

422

Unprocessable Entity Error