Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API 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.
openapi: 3.2.0
info:
title: Cernion Energy Tools Governance 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: Governance
paths:
/api/governance/role-workbench:
get:
summary: Role Workbench Projection — role-specific VDMI task overview
tags:
- Governance
operationId: governance_roleWorkbenchProjection
parameters:
- name: role
in: query
required: true
schema:
type: string
example: ROLE_NETZPLANUNG
- name: includeResolved
in: query
schema:
type: boolean
default: false
description: Include tasks from completed/resolved matrices
- $ref: '#/components/parameters/TokenQuery'
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
description: 'Returns a read-only workbench projection for a role: all VDMI matrix tasks where the role appears as verantwortlich/durchfuehrend/mitwirkend/information, enriched with governance policy evaluation, HITL role derivation, evidence gaps, and curated next-action hints. No writes; suitable as a Budibase datasource.'
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.'