Skip to main content

Documents API

Manage indexed documents programmatically.

Get Document Content

Endpoint

GET /api/v1/documents/{id}/content

Response

{
"data": {
"id": "doc_abc123",
"title": "Getting Started Guide",
"content": "Full document content...",
"status": "indexed",
"collection": "Documentation",
"source": "Confluence",
"metadata": {
"author": "John Doe",
"url": "https://...",
"pages": 5
}
}
}

Get Document Summary

Endpoint

GET /api/v1/documents/{id}/summary

Response

{
"data": {
"id": "doc_abc123",
"title": "Getting Started Guide",
"summary": "This guide covers...",
"metadata": {
"author": "John Doe",
"url": "https://..."
}
}
}

Delete Document

Endpoint

DELETE /api/v1/documents/{id}

Response

{
"data": {
"id": "doc_abc123",
"deleted": true
}
}

Document Status

StatusDescription
pendingWaiting for processing
processingCurrently being indexed
indexedSuccessfully indexed
failedIndexing failed
deletedRemoved from index

Example Usage

Get Document Content

const doc = await client.documents.getContent('doc_xyz789');
console.log(doc.title, doc.content);

Get Document Summary

const summary = await client.documents.getSummary('doc_xyz789');
console.log(summary.summary);

Delete Document

await client.documents.delete('doc_xyz789');

Next Steps