Skydive API | Drive your agents from your own code
Agents you can curl
Create, manage, and run agents from anywhere with internet. Compliant with A2A, ACP, and other protocols. Pluggable anywhere. Your agents can live wherever you want.
skydive — quickstart
cURL
# List your agents
curl -s https://www.skydive.com/api/v2/agents \
-H "Authorization: Bearer $SKYDIVE_API_KEY" | jq
# Send a message
curl -s https://www.skydive.com/api/v1/chat/send \
-H "Authorization: Bearer $SKYDIVE_API_KEY" \
-H "Content-Type: application/json" \
-d "{\n \"agentId\": \"$AGENT_ID\",\n \"conversationId\": null,\n \"content\": \"Hey! In one sentence, what do you do?\"\n }" | jq
JavaScript
// List your agents
const agents = await fetch(`${BASE_URL}/api/v2/agents`, {
headers: { Authorization: `Bearer ${process.env.SKYDIVE_API_KEY}` },
}).then((r) => r.json());
// Send a message
const reply = await fetch(`${BASE_URL}/api/v1/chat/send`, {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.SKYDIVE_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
agentId: agents[0].id,
conversationId: null, // null starts a new conversation
content: "Hey! In one sentence, what do you do?",
}),
}).then((r) => r.json());
Python
# List your agents
agents = requests.get(
f"{BASE_URL}/api/v2/agents",
headers={"Authorization": f"Bearer {os.environ['SKYDIVE_API_KEY']}"},
).json()
# Send a message
reply = requests.post(
f"{BASE_URL}/api/v1/chat/send",
headers={"Authorization": f"Bearer {os.environ['SKYDIVE_API_KEY']}"},
json={
"agentId": agents[0]["id"],
"conversationId": None,
"content": "Hey! In one sentence, what do you do?",
},
).json()
Capabilities
Create, manage, and invoke agents in sandboxes via REST API and webhooks.
GET /v1/agents
- 200
- rate limit · per key
- 412 / 600
Public developer API
Your keys call here, fronted by a gateway and rate-limited per API key.
- slack.message 12 ms
- email.received 31 ms
- slack.retry queued ×2
/api/webhooks
Webhooks
Inbound Slack, email, and more, verified and built to absorb bursty retries.
agent · sandbox
- running
- cpu
- mem
- isolated · billed to acme
/sandbox
Agent sandbox
The agent-execution firehose, isolated and cost-weighted per agent and org.
Put your agents in your codebase
Create a per-agent key and start driving your Skydive agents from code.