REST API

The Tavora REST API provides direct HTTP access to all platform capabilities. The Go SDK wraps this API, but you can also call it directly from any language.

Base URL

http://localhost:8080/api

Authentication

All API requests require an API key passed via the X-API-Key header:

curl -H "X-API-Key: tvr_your_api_key" \
  http://localhost:8080/api/documents

Endpoints

Documents

Method	Path	Description
GET	/api/documents	List documents
POST	/api/documents	Create a document
GET	/api/documents/:id	Get a document
DELETE	/api/documents/:id	Delete a document
POST	/api/search	Semantic search

Chat

Method	Path	Description
POST	/api/chat/completions	Create a chat completion
GET	/api/conversations	List conversations
GET	/api/conversations/:id	Get conversation with messages

Agents

Method	Path	Description
POST	/api/agents/run	Start an agent session
GET	/api/agents/sessions	List agent sessions
GET	/api/agents/sessions/:id	Get session details

Skills

Method	Path	Description
GET	/api/skills	List skills
POST	/api/skills	Create a skill
PUT	/api/skills/:id	Update a skill
DELETE	/api/skills/:id	Delete a skill

Stores

Method	Path	Description
GET	/api/stores	List document stores
POST	/api/stores	Create a store
PUT	/api/stores/:id	Update a store
DELETE	/api/stores/:id	Delete a store

Response format

All responses return JSON. Successful responses include the data directly:

{
  "id": "doc_abc123",
  "title": "My Document",
  "status": "ready",
  "created_at": "2025-01-15T10:30:00Z"
}

Error responses include a message:

{
  "error": "document not found"
}