API Reference

The Senda Platform API provides programmatic access to AI agents, knowledge bases, actions, and analytics. All endpoints use JSON and return standard HTTP status codes.

Base URL

https://senda.telar.ai/api/v1/

Authentication

All requests require an API key in the Authorization header:

Authorization: Bearer sk_live_YOUR_KEY

See Authentication for details on scopes and key management.

Endpoints

Method	Endpoint	Scope	Description
POST	/v1/chat/completions	chat	Send message, receive SSE stream
GET	/v1/chat/history/:chatId	chat	Get chat message history
GET	/v1/agents	agents	List agents
GET	/v1/agents/:id	agents	Agent detail with actions & knowledge
GET	/v1/knowledge	files	List knowledge files
POST	/v1/knowledge/ingest	files	Upload document to RAG
GET	/v1/actions	actions	List available actions
POST	/v1/actions/:id/execute	actions	Execute action directly
GET	/v1/usage	analytics	Consumption metrics
GET	/v1/keys	JWT only	List API keys
POST	/v1/keys	JWT only	Create API key
DELETE	/v1/keys/:id	JWT only	Revoke API key

Response Format

All responses are JSON:

{
  "agents": [...]
}

Errors return a standard format:

{
  "error": "Human-readable error message"
}

Rate Limiting

All API key requests are rate-limited. See Rate Limits for details. Headers included in every response:

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 58