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
| Status | Description |
|---|---|
pending | Waiting for processing |
processing | Currently being indexed |
indexed | Successfully indexed |
failed | Indexing failed |
deleted | Removed 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
- Collections API - Manage collections
- Search API - Search documents