Agent Requests API
Submit new requirements and check the build status of your AI voice agents.
Submit New Request
POST
/agents/requestsDescription
Creates a new ticket in the KantaSwara Delivery Console for our AI Solutions team to begin building your custom agent.
Permissions
Requires Admin role.
Request Body
{
"name": "Outbound Lead Qualifier",
"objective": "Call new leads from HubSpot and ask 3 qualifying questions.",
"target_audience": "B2B Marketing Managers",
"required_integrations": ["hubspot", "calendly"]
}
Response
{
"request_id": "req_778899",
"status": "pending_review",
"message": "Your request has been submitted successfully."
}
Error Codes
400 Bad Request- Missing required fields (e.g., objective).422 Unprocessable Entity- Integration specified is not supported.
Check Build Status
GET
/agents/requests/{request_id}Description
Checks the current development phase of an agent build request.
Response
{
"request_id": "req_778899",
"status": "in_development",
"assigned_engineer": "Alex M.",
"estimated_uat_date": "2026-08-01T00:00:00Z"
}