---
title: "Add or upsert documents"
method: POST
path: "/indexes/{indexName}/documents"
---

# Add or upsert documents

`POST /indexes/{indexName}/documents`

## Request body

- object
  - `documents` DocumentInfo[], required
    - `id` string, required
    - `text` string, required
    - `metadata` object
    - `embedding` number[]
  - `upsert` boolean

## Response `202`

Mutation queued

- MutationResult
  - `jobId` string, required

---

[API](https://skmtc.dev/moss/apis/moss-control-plane-api.md) · [All operations](https://skmtc.dev/moss/apis/moss-control-plane-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/moss/moss-control-plane-api/revisions/95ef164ff2d7/schema)