POST

Insert Document

Add a document to your database. Vecstore automatically generates embeddings and indexes the content for semantic search.

Endpoint

POST /databases/{id}/documents

Path Parameters

idstring · requiredThe database ID

For text databases, send the text content you want to index.

contentstring · requiredText content to insert and index

metadataobject · optionalAdditional metadata as JSON object

Example Request

{
  "content": "How to fix a leaky kitchen faucet",
  "metadata": {
    "category": "home-repair",
    "tags": ["plumbing", "DIY"]
  }
}

Returns the insertion status and generated vector ID.

statusstringOperation status

vector_idstringUnique ID of the inserted document

Example Response

{
  "status": "success",
  "vector_id": "4de5bed5-e483-4bd7-9760-a54ec07aefd9"
}