Webhooks API

Webhooks deliver Modelux events to your own infrastructure. Each endpoint subscribes to one or more event types and is called asynchronously with HMAC-signed payloads.

List endpoints

GET /manage/v1/webhooks/endpoints

Get an endpoint

GET /manage/v1/webhooks/endpoints/{endpoint_id}

Create an endpoint

POST /manage/v1/webhooks/endpoints

Request body

{
  "url": "https://your-app.example.com/hooks/modelux",
  "event_types": [
    "budget.threshold_reached",
    "routing_config.updated"
  ],
  "description": "Production webhook"
}

Returns the endpoint with a generated signing_secret. Shown once — save it for verifying delivery signatures.

Update an endpoint

PATCH /manage/v1/webhooks/endpoints/{endpoint_id}

Supports updating url, event_types, description, and active flag.

Delete an endpoint

DELETE /manage/v1/webhooks/endpoints/{endpoint_id}

Soft-delete. In-flight deliveries still complete.

Rotate signing secret

POST /manage/v1/webhooks/endpoints/{endpoint_id}/rotate-secret

Generates a new signing secret. Returned once in the response. The old secret remains valid for 24 hours to allow graceful rollover in your verifier.

Send test event

POST /manage/v1/webhooks/endpoints/{endpoint_id}/test

Request body

{
  "event_type": "budget.threshold_reached"
}

Sends a synthetic event to the endpoint for connectivity testing.

List deliveries

GET /manage/v1/webhooks/deliveries

Query parameters

Name	Type	Description
`endpoint_id`	string	Filter to one endpoint
`status`	enum	`pending`, `delivered`, `failed`
`event_type`	string	Filter by event type
`cursor`	string	Pagination

Get a delivery

GET /manage/v1/webhooks/deliveries/{delivery_id}

Returns the delivery payload, response status, response body, and attempt history.

Replay a delivery

POST /manage/v1/webhooks/deliveries/{delivery_id}/replay

Re-send the same payload. Useful after fixing an endpoint outage.

List event types

GET /manage/v1/webhooks/event-types

Returns all event types with a short description. Useful for building configuration UIs.

MCP tools

Tool	Maps to
`list_webhook_endpoints`	`GET /manage/v1/webhooks/endpoints`
`get_webhook_endpoint`	`GET /manage/v1/webhooks/endpoints/{id}`
`create_webhook_endpoint`	`POST /manage/v1/webhooks/endpoints`
`update_webhook_endpoint`	`PATCH /manage/v1/webhooks/endpoints/{id}`
`delete_webhook_endpoint`	`DELETE /manage/v1/webhooks/endpoints/{id}`
`rotate_webhook_secret`	`POST /manage/v1/webhooks/endpoints/{id}/rotate-secret`
`send_webhook_test`	`POST /manage/v1/webhooks/endpoints/{id}/test`
`list_webhook_deliveries`	`GET /manage/v1/webhooks/deliveries`
`get_webhook_delivery`	`GET /manage/v1/webhooks/deliveries/{id}`
`replay_webhook_delivery`	`POST /manage/v1/webhooks/deliveries/{id}/replay`
`list_webhook_event_types`	`GET /manage/v1/webhooks/event-types`