Skip to content

Upload Documents to Collection

POST
/api/v3/organizations/{organisation}/ai/vector-db/collections/{collectionId}/documents

Uploads documents to a vector database collection with automatic embedding generation. Documents are chunked (if needed), embedded using the collection’s embedding model, and stored. * * Supported Content: * - Plain text content * - URLs to fetch content from * - Markdown documents * * Metadata: * Each document can include metadata (title, source_url, section, tags) that is returned with search results.

Authorizations

Parameters

Path Parameters

organisation
required
string

The organisation ID

collectionId
required
string format: uuid

The collection ID

Request Body required

object
documents
required
Array<object>
object
content
required

Document text content

string
metadata
object
title
string
source_url
string
section
string
tags
Array<string>

Responses

200

Documents uploaded successfully

object
success
boolean
true
documentIds
Array<string>
chunksCreated
integer
message
string

400

Invalid request parameters

403

Access denied

404

Collection not found

500

Failed to upload documents