Appearance
All API Endpoints
Complete reference of every endpoint on Universal API.
Base URL: https://api.universalapi.coStreaming URL: https://stream.api.universalapi.co
All authenticated endpoints use: Authorization: Bearer YOUR_TOKEN
MCP Servers
| Method | Endpoint | Auth | Description |
|---|---|---|---|
POST | /mcp-admin/create | Required | Create a new MCP server |
GET | /mcp-admin/list | Optional | List MCP servers |
GET | /mcp-admin/{serverId} | Optional | Get server details |
GET | /mcp-admin/s/{owner}/{slug} | Optional | Get server by slug |
PUT | /mcp-admin/update | Required | Update a server |
DELETE | /mcp-admin/delete | Required | Delete a server |
POST/GET | /mcp/{serverId} | Optional | MCP protocol endpoint |
POST/GET | /mcp/s/{owner}/{slug} | Optional | MCP protocol (slug) |
Agents
| Method | Endpoint | Auth | Description |
|---|---|---|---|
POST | /agent/create | Required | Create a new agent |
GET | /agent/list | Optional | List agents |
GET | /agent/{agentId} | Optional | Get agent details |
GET | /agent/s/{owner}/{slug} | Optional | Get agent by slug |
PUT | /agent/update | Required | Update an agent |
DELETE | /agent/delete | Required | Delete an agent |
POST | stream.../agent/{agentId}/chat | Required | Chat with agent (streaming) |
GET | /agent/{agentId}/conversations | Required | List conversations |
GET | /agent/{agentId}/conversations/{convId} | Required | Get conversation history |
INFO
Agent chat uses the streaming domain: https://stream.api.universalapi.co
User & Account
| Method | Endpoint | Auth | Description |
|---|---|---|---|
GET | /user/info | Required | Get user profile, credits, alias |
POST | /user/alias | Required | Set your alias (username) |
Access Tokens
| Method | Endpoint | Auth | Description |
|---|---|---|---|
POST | /user/token/create | Required | Create a Bearer token |
GET | /user/token/list | Required | List your tokens |
POST | /user/token/revoke | Required | Revoke a token |
Third-Party Keys
| Method | Endpoint | Auth | Description |
|---|---|---|---|
POST | /keys/store | Required | Store an API key |
GET | /keys/list | Required | List stored keys (metadata only) |
GET | /keys/check/{serviceName} | Required | Check if a key exists |
OAuth
| Method | Endpoint | Auth | Description |
|---|---|---|---|
GET | /oauth/authorize/{provider} | Required | Get OAuth authorization URL |
Providers: google, microsoft, github
Search
| Method | Endpoint | Auth | Description |
|---|---|---|---|
GET | /search?q={query} | Optional | Semantic search across resources |
Query parameters: q (query), type (all, mcp, mcp-tool, agent), limit
Knowledge Storage
| Method | Endpoint | Auth | Description |
|---|---|---|---|
GET | /knowledge/list | Required | List files and folders |
POST | /knowledge/upload | Required | Upload file directly (5MB max) |
POST | /knowledge/upload-url | Required | Get presigned upload URL |
POST | /knowledge/download-url | Required | Get presigned download URL |
ANY | /knowledge/delete | Required | Delete a file |
POST | /knowledge/delete-folder | Required | Delete a folder |
POST | /knowledge/create-folder | Required | Create a folder |
POST | /knowledge/search | Required | Semantic search across files |
Subscriptions & Billing
| Method | Endpoint | Auth | Description |
|---|---|---|---|
GET | /user/subscription | Required | Get subscription details |
POST | /subscription/checkout | Required | Create Stripe checkout session |
POST | /subscription/portal | Required | Get Stripe customer portal URL |
Author Dashboard
| Method | Endpoint | Auth | Description |
|---|---|---|---|
GET | /author/earnings | Required | Get earnings breakdown |
GET | /author/resources | Required | Get authored resources with metrics |
POST | /author/stripe/connect | Required | Start Stripe Connect onboarding |
GET | /author/stripe/status | Required | Get Connect account status |
GET | /author/stripe/dashboard | Required | Get Stripe Express dashboard URL |
GET | /author/payouts/history | Required | Get payout history |
POST | /author/payouts/process | Required | Manually trigger payout |
Code Server
| Method | Endpoint | Auth | Description |
|---|---|---|---|
GET | /code-server/status | Required | Get instance status |
POST | /code-server/launch | Required | Launch a new instance |
POST | /code-server/start | Required | Start a stopped instance |
POST | /code-server/stop | Required | Stop a running instance |
POST | /code-server/terminate | Required | Terminate an instance |
POST | /code-server/setup | Required | Save/run a setup script with credential injection |
INFO
Code Server requires an active subscription (Starter or Professional plan). Billed at 1 credit/minute while running.
Logs
| Method | Endpoint | Auth | Description |
|---|---|---|---|
GET | /logs | Required | Get usage logs |
GET | /logs/{requestId} | Required | Get detailed log for a request |