Cernion Webhooks API
Outbound webhook subscriptions with signed delivery, retry backoff, replay, and dead-letter tracking.
Outbound webhook subscriptions with signed delivery, retry backoff, replay, and dead-letter tracking.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/cernion-de:cernion-de-webhooks-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Cernion Energy Tools Webhooks API
version: 0.99.22
description: 'MicroService Agent System for Energy Markets - REST API with AI integration.
CERNION_TOKEN: request at https://cernion.de/ or by email: dev@stromdao.com.
For the public instance at https://api.cernion.de/, create your token at https://cernion.de/cet-token/.'
servers:
- url: https://api.cernion.de
description: API Server
tags:
- name: Webhooks
description: Outbound webhook subscriptions with signed delivery, retry backoff, replay, and dead-letter tracking.
paths:
/api/webhooks:
post:
summary: Create webhook subscription
tags:
- Webhooks
operationId: webhooks_create
parameters:
- $ref: '#/components/parameters/TokenQuery'
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- url
- events
properties:
url:
type: string
example: https://example.com/hooks/cernion
events:
type: array
items:
type: string
example:
- cya.a2a.consensus.failed
secret:
type: string
example: my-shared-secret
headers:
type: object
example:
X-Customer: tenant-a
isActive:
type: boolean
default: true
token:
type: string
description: Optional Cernion MCP token for this request. Overrides CERNION_TOKEN when provided.
examples:
default:
value:
url: https://example.com/hooks/cernion
events:
- cya.a2a.consensus.failed
- hitl.item.created
secret: my-shared-secret
headers:
X-Customer: tenant-a
isActive: true
get:
summary: List webhook subscriptions
tags:
- Webhooks
operationId: webhooks_list
parameters:
- name: event
in: query
schema:
type: string
example: cya.a2a.consensus.failed
- $ref: '#/components/parameters/TokenQuery'
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
/api/webhooks/:id:
delete:
summary: Delete webhook subscription
tags:
- Webhooks
operationId: webhooks_remove
parameters:
- name: id
in: path
required: true
schema:
type: string
example: 00000000-0000-4000-8000-000000000010
- $ref: '#/components/parameters/TokenQuery'
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
requestBody:
required: false
content:
application/json:
schema:
type: object
properties:
token:
type: string
description: Optional Cernion MCP token for this request. Overrides CERNION_TOKEN when provided.
/api/webhooks/:id/test:
post:
summary: Send test webhook delivery
tags:
- Webhooks
operationId: webhooks_test
parameters:
- name: id
in: path
required: true
schema:
type: string
example: 00000000-0000-4000-8000-000000000010
- $ref: '#/components/parameters/TokenQuery'
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
requestBody:
required: false
content:
application/json:
schema:
type: object
properties:
token:
type: string
description: Optional Cernion MCP token for this request. Overrides CERNION_TOKEN when provided.
examples:
default:
value: {}
/api/webhooks/:id/deliveries:
get:
summary: List webhook deliveries
tags:
- Webhooks
operationId: webhooks_listDeliveries
parameters:
- name: id
in: path
required: true
schema:
type: string
example: 00000000-0000-4000-8000-000000000010
- name: status
in: query
schema:
type: string
example: failed
- name: limit
in: query
schema:
type: integer
default: 50
maximum: 200
- $ref: '#/components/parameters/TokenQuery'
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
/api/webhooks/:id/deliveries/:deliveryId/replay:
post:
summary: Replay webhook delivery
tags:
- Webhooks
operationId: webhooks_replay
parameters:
- name: id
in: path
required: true
schema:
type: string
example: 00000000-0000-4000-8000-000000000010
- name: deliveryId
in: path
required: true
schema:
type: string
example: 00000000-0000-4000-8000-000000000011
- $ref: '#/components/parameters/TokenQuery'
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
requestBody:
required: false
content:
application/json:
schema:
type: object
properties:
token:
type: string
description: Optional Cernion MCP token for this request. Overrides CERNION_TOKEN when provided.
examples:
default:
value: {}
components:
parameters:
TokenQuery:
name: token
in: query
required: false
schema:
type: string
description: Optional Cernion MCP token as URL query parameter. If provided, it overrides CERNION_TOKEN for this request. Prefer Authorization Bearer header in production to reduce token exposure in URLs/logs.
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: X-API-Key
BearerAuth:
type: http
scheme: bearer
bearerFormat: JWT
description: 'Optional Cernion MCP token. If not provided, falls back to CERNION_TOKEN from environment. Request token at https://cernion.de/ or by email: dev@stromdao.com.'