AxonPush

Appearance

Webhooks ​

Webhook endpoints receive HTTP POST callbacks when events are published to a channel.

Create Endpoint ​

python
endpoint = client.webhooks.create_endpoint(
    url="https://your-app.com/webhook",
    channel_id=1,
)
print(endpoint.id, endpoint.url)

List Endpoints ​

python
endpoints = client.webhooks.list_endpoints()
for ep in endpoints:
    print(ep.id, ep.url, ep.channel_id)

Delete Endpoint ​

python
client.webhooks.delete_endpoint(endpoint_id=1)

Delivery History ​

python
deliveries = client.webhooks.get_deliveries(endpoint_id=1)
for d in deliveries:
    print(d.status_code, d.created_at)

Webhook Payload ​

When an event is published, AxonPush sends a POST request to your endpoint with:

json
{
  "id": 42,
  "identifier": "task.completed",
  "payload": {"result": "success"},
  "agentId": "planner-01",
  "traceId": "tr_abc123",
  "eventType": "agent.end",
  "channelId": 1,
  "createdAt": "2026-03-31T12:00:00.000Z"
}

Your endpoint should return a 2xx status code to acknowledge receipt. Failed deliveries are visible in the dashboard.