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.

​
Authentication

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

​
Where to find your API key

You can generate and copy API keys from the SuperU dashboard.
  1. Go to workspace.superu.ai
  2. Open the API keys section
  3. Copy the existing key and use it
How to get API keys

​
Installation

pip install superu

​
Quick Start Example

Python
import superu

client = superu.SuperU("your_api_key")

# 1) List existing agents
agents = client.agents.list(limit=5)
print(agents)

# 2) Start an outbound call
call = client.calls.create_outbound_call(
    assistant_id="assistant_id_from_dashboard",
    to="+15557654321",
    campaign_id="demo_call",
    customer_name="Ava",
    customer_id="cust_123"
)
print(call)

​
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

​
Endpoint Groups