Interfaces
Webhooks
Get notified the moment something happens, an agent ships a deployment, a task finishes, or a key hits its spend cap.
Subscribe
POST /webhooks
curl -X POST https://api.server4agent.com/webhooks \
-H "Authorization: Bearer $AGENTSERVER_KEY" \
-d '{
"url": "https://example.com/hooks/server4agent",
"events": ["deployment.live", "task.completed", "quota.cap_reached"]
}'Event payload
Every event is delivered as JSON with a signature header you can verify.
deployment.live
{
"event": "deployment.live",
"server_id": "srv_2k9",
"url": "https://srv_2k9.apps.server4agent.com",
"created_at": "2026-05-27T10:21:00Z"
}Event types
events
task.created · task.completed · task.failed
deployment.live · deployment.removed
server.created · server.stopped · server.deleted
quota.threshold · quota.cap_reached