Documentation

Everything you need to get started with Callio.

Quick Start

1. Create an account

Create account

2. Generate an API key

Go to your dashboard and generate a Callio API key. This single key works across all APIs.

callio_a1b2c3d4e5f6...

3. Make your first API call

Use your key to call any API through the Callio proxy:

curl -X GET "https://callio.dev/api/proxy/jsonplaceholder/posts/1" \
  -H "Authorization: Bearer callio_your_key_here"

Authentication

All API requests through Callio are authenticated using your Callio API key. Pass it as a Bearer token in the Authorization header:

Authorization: Bearer callio_your_key_here

For APIs that require provider authentication (e.g., Stripe, OpenAI), save your provider API key in the API detail page. Callio will automatically attach it when proxying your requests.

API Proxy

Callio acts as a proxy between your application and upstream APIs. The proxy URL pattern is:

https://callio.dev/api/proxy/<api-slug>/<path>

For APIs with custom base URLs, you can also use the forwarding mode:

https://callio.dev/api/proxy/<api-slug>/forward?target=<encoded-url>

Supported methods

GETPOSTPUTPATCHDELETE

Response headers

Callio proxy responses include these headers:

x-callio-proxy: true
x-callio-api: <slug>
x-callio-upstream-status: <status>

Agent Integration

Give your AI agent access to any API in the Callio marketplace. Use the "Add to Agent" button on any API page, or configure manually:

{
  "callio": {
    "api_key": "callio_your_key_here",
    "proxy_url": "https://callio.dev/api/proxy"
  }
}

Your agent can then call any API through the proxy endpoint with the single key.

Code Examples

Python

import requests

headers = {"Authorization": "Bearer callio_your_key"}
response = requests.get(
    "https://callio.dev/api/proxy/jsonplaceholder/posts/1",
    headers=headers
)
print(response.json())

JavaScript

const response = await fetch(
  "https://callio.dev/api/proxy/jsonplaceholder/posts/1",
  { headers: { Authorization: "Bearer callio_your_key" } }
);
const data = await response.json();
console.log(data);

Need help? Contact us at hello@callio.dev