Skip to main content
SuperU API lets you create and manage voice agents, place calls, handle tools, organize folders, and work with contacts, audiences, and knowledge bases.

​
Base URL

https://voip-middlware.superu.ai

​
Authentication

Use your API key in the superU-Api-Key header for all secured endpoints. 
superU-Api-Key: su_live_xxxxxxxxxxxxx

​
API Playground

Every endpoint page in this section includes:
  • Interactive Try it requests
  • Auto-generated request examples
  • Copy-ready code examples in cURL and Python
  • Success and error response blocks

​
Common Status Codes

These status codes are now documented across the API, including endpoint-level error examples.
  • 200 Success
  • 201 Created
  • 400 Bad Request
  • 401 Unauthorized
  • 404 Not Found
  • 500 Internal Server Error
  • 501 Not Implemented

​
Quick Start Example

cURL
curl --request POST \
  --url https://voip-middlware.superu.ai/agent/list \
  --header 'superU-Api-Key: su_live_xxxxxxxxxxxxx' \
  --data '{
    "search_query": "sales"
  }'
Python
from superu import SuperU

client = SuperU("YOUR_SUPERU_API_KEY")
response = client.agents.list(search_query="sales")
print(response)

​
Endpoint Groups

  • Calls
  • Agents
  • Agent Versions
  • Phone Numbers
  • Call Logs
  • Tools
  • Folders
  • Contacts
  • Audiences
  • Knowledge Base