Webhooks and Public Routes

Webhook Management Routes

Athena exposes webhook management under the admin surface:

• GET /admin/webhooks
• POST /admin/webhooks
• GET /admin/webhooks/events
• GET /admin/webhooks/{id}
• PATCH /admin/webhooks/{id}
• DELETE /admin/webhooks/{id}
• GET /admin/webhooks/{id}/deliveries
• POST /admin/webhooks/{id}/test

Auth requirements:

• X-Athena-Client
• x-athena-admin-key

Public Route Management

Public route registration is managed via admin endpoints:

• GET /admin/public-routes
• POST /admin/public-routes
• PATCH /admin/public-routes/{route_key}
• DELETE /admin/public-routes/{route_key}

Public invocation is served through:

• POST /public/{route_key}/{op} where {op} is one of query, fetch, insert, update, delete.

Recommended Workflow

1. Create webhook endpoint and secret handling in your receiving service.
2. Register webhook via /admin/webhooks.
3. Trigger test delivery via /admin/webhooks/{id}/test.
4. Inspect delivery logs using /admin/webhooks/{id}/deliveries.
5. Register public routes only for operations that are explicitly safe to expose.

Reference

Use Reference -> Athena API Reference -> admin and public sections for operation-level schemas and response envelopes.

Operation Links

• GET /admin/webhooks
• POST /admin/webhooks
• GET /admin/webhooks/:id
• PATCH /admin/webhooks/:id
• DELETE /admin/webhooks/:id
• GET /admin/public-routes
• POST /admin/public-routes
• PATCH /admin/public-routes/:route_key
• DELETE /admin/public-routes/:route_key
• POST /public/:route_key/:op