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.

Interactive API Explorer

You can explore and test the entire Senda API directly in your browser using our Swagger UI, or import it into Postman.

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
ALL	/v1/scim/*	JWT only	SCIM 2.0 User & Group provisioning
WEBHOOK	Events	N/A	Subscribed Webhook payload deliveries

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