Upload Document

Deprecated

POST

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

POST

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

$ curl -X POST https://app.rightbrain.ai/api/v1/org/org_id/project/project_id/document/upload \
>      -H "Authorization: Bearer <token>" \
>      -H "Content-Type: multipart/form-data" \
>      -F data="[{\"strategy\": \"txt\"}]" \
>      -F "files[]"=@"Binary file content"

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

Upload and process documents synchronously, returning the created documents directly in the response body.

Deprecated in favor of POST /document, which processes documents asynchronously and returns a job ID for tracking status.

Each item in the data array must include a strategy, one of: csv, docx, git, pdf, txt, url, xlsx, youtube, zip.

Descriptors are matched positionally to the uploaded files: the first data item corresponds to the first uploaded file, and so on. target is optional for a descriptor paired with an uploaded file. It is required only for descriptors with no corresponding uploaded file (for example, a url or youtube strategy that fetches content directly), where it must contain the source location to fetch.

A descriptor paired with an uploaded file does not name the document: title and description sent in the descriptor are ignored for uploaded files. The created document’s title is the uploaded filename and its description is null. Rename it afterwards with POST /document/{document_id}.

Upload and process documents synchronously, returning the created documents directly in the response body. Deprecated in favor of `POST /document`, which processes documents asynchronously and returns a job ID for tracking status. Each item in the `data` array must include a `strategy`, one of: `csv`, `docx`, `git`, `pdf`, `txt`, `url`, `xlsx`, `youtube`, `zip`. Descriptors are matched positionally to the uploaded `files`: the first `data` item corresponds to the first uploaded file, and so on. `target` is optional for a descriptor paired with an uploaded file. It is required only for descriptors with no corresponding uploaded file (for example, a `url` or `youtube` strategy that fetches content directly), where it must contain the source location to fetch. A descriptor paired with an uploaded file does not name the document: `title` and `description` sent in the descriptor are ignored for uploaded files. The created document's `title` is the uploaded filename and its `description` is `null`. Rename it afterwards with `POST /document/{document_id}`.

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 a multipart form with multiple files.

datastringRequired

filesfilesOptional

Response

Documents uploaded and processed

titlestring

project_idstringformat: "uuid"

strategystring

idstringformat: "uuid"

chunksinteger

original_mimestring

embedding_instanceslist of objects or null

descriptionstring or nullOptional

sourceenum or nullOptional

Source types for documents in the system.

source_metamap from strings to any or nullOptional

connection_idstring or nullOptionalformat: "uuid"

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

413

Content Too Large Error

422

Unprocessable Entity Error

500

Internal Server Error