Zeabur RAG Edit

RAG — Edit

Update the content of an existing chunk in place. Embedding is recomputed automatically when the searchable text changes, and the BM25 cache is cleared so the change is live on the next query.

Base URL: $ZEABUR_RAG_URL Auth: Authorization: Bearer $RAG_API_KEY — admin scope required

When to use

API

PATCH /api/admin/chunks/:id — pass any subset of editable fields.

curl -s -X PATCH "$ZEABUR_RAG_URL/api/admin/chunks/<chunk_id>" \
  -H "Authorization: Bearer $RAG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Updated title",
    "answer": "Corrected content",
    "text_content": "Updated title\nCorrected content"
  }'

Critical rule — keep the embedding in sync

If you update any of title / question / answer, you MUST also pass a new text_content. The server enforces this and returns 400 otherwise. The reason: embedding and BM25 index are built from text_content, not from the display fields — letting them drift apart silently corrupts search quality.

Construct text_content using the same format as the adapter that produced the chunk. When in doubt, read the existing text_content first, then rewrite it in the same shape.

Edits that don't need text_content

Pure metadata changes — tags, url, status — don't touch the embedding, so text_content is not required:

curl -s -X PATCH "$ZEABUR_RAG_URL/api/admin/chunks/DOC-example" \
  -H "Authorization: Bearer $RAG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tags": ["deployment"], "status": "verified"}'

Workflow

1. Find the chunk — search via zeabur-rag-search or GET /api/admin/chunks?search=... to get its ID and current contents.
2. Read it — GET /api/admin/chunks/:id returns the full record including text_content. Confirm you're editing what you think you're editing.
3. PATCH — send only the fields you want to change. Include text_content if any of title/question/answer are in the patch.
4. Verify — re-search to confirm the new content surfaces.

Response

{
  "success": true,
  "id": "DOC-example",
  "updated_fields": ["title", "answer", "text_content"],
  "embedding_updated": true
}

embedding_updated: true means the chunk was re-embedded. Every edit is logged to rag_audit_log with action edit and a diff of old vs new values, and the BM25 cache is cleared so the next query sees the change.

Errors

Guidelines

• One coherent edit at a time. Don't rewrite three unrelated chunks in one batch — each edit should be auditable.
• Don't paraphrase for style. Edit only when the content is wrong, stale, or unclear. Cosmetic rewrites churn the embedding for no quality gain.
• Verified chunks should stay accurate. If you're unsure whether your fix is correct, file a zeabur-rag-report instead of patching.
• Source access is controlled by API-key source permissions. Do not encode access policy inside chunk text or tags.