Skip to main content
Append or upsert documents into an existing index. This is an async operation — the response includes a jobId you can poll with getJobStatus. The service merges the new documents, rebuilds the index efficiently, and makes fresh artifacts available for further usage. Required fields: indexName, docs Optional fields: options.upsert (defaults to true). Example request 
curl -X POST "https://service.usemoss.dev/v1/manage" \
  -H "Content-Type: application/json" \
  -H "x-service-version: v1" \
  -H "x-project-key: moss_access_key_xxxxx" \
  -d '{
    "action": "addDocs",
    "projectId": "project_123",
    "indexName": "support-faq",
    "docs": [
      { "id": "faq-125", "text": "How do I change billing cycles?" }
    ],
    "options": {
      "upsert": true
    }
  }'
Responses 
{
  "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "status": "building"
}
Errors
  • 404 if the index cannot be located.
  • 500 when existing documents cannot be downloaded or the update fails.