REST API

API OVERVIEW

AI ARTEDUSA exposes a REST API built with FastAPI, allowing you to integrate your AI call centre with your existing tools. The OpenAPI schema describes all endpoints.

The API uses JSON format for requests and responses, with standard HTTP status codes.

AUTHENTICATION

The API authenticates via the session token:

• Session JWT: include the token in the Authorization: Bearer <token> header. This token, obtained at login, authenticates all your requests.

MAIN ENDPOINTS

Here are the available endpoint categories:

• GET /api/v1/tenants/{tenant_id}/calls: list of calls (pagination + channel/date/search filters)
• GET /api/v1/tenants/{tenant_id}/calls/{call_id}: call details (transcript, summary, metadata)
• GET /api/v1/tenants/{tenant_id}/knowledge: list of knowledge base documents
• POST /api/v1/tenants/{tenant_id}/knowledge: add a document
• DELETE /api/v1/tenants/{tenant_id}/knowledge/{item_id}: delete a document
• POST /api/v1/tenants/{tenant_id}/knowledge/sync: launch knowledge base synchronisation
• GET /api/v1/ai-agents/{agent_id}: retrieve bot configuration
• PUT /api/v1/ai-agents/{agent_id}: modify bot configuration

LIMITS AND BEST PRACTICES

The API is subject to rate limits to guarantee service stability:

• 200 requests per minute per tenant on call and knowledge base endpoints
• 100 requests per minute (per IP address) on configuration endpoints (ai-agents, workspace)
• 10 document uploads per minute
• Excess requests receive a 429 (Too Many Requests) response