Cernion Interface Placeholder API
Explicit gap markers for unresolved interfaces, evidence, and ownership
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
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.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/cernion-de:cernion-de-interface-placeholder-api"
All apis
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.
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.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Cernion Energy Tools Interface Placeholder 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: Interface Placeholder
description: Explicit gap markers for unresolved interfaces, evidence, and ownership
paths:
/api/interface-placeholder/mark-gap:
post:
summary: Create an explicit interface placeholder gap
tags:
- Interface Placeholder
operationId: interface_placeholder_markGap
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:
- role
- reason
properties:
role:
type: string
example: grid_connection_validator
reason:
type: string
example: NEEDS_INTERFACE
blockingLevel:
type: string
example: soft
replacementCriteria:
type: object
example:
kind: process
capabilityHint: znp.assessPortfolio
deadline: '2026-06-01T00:00:00.000Z'
properties:
kind:
type: string
example: process
capabilityHint:
type: string
example: znp.assessPortfolio
deadline:
type: string
format: date-time
example: '2026-06-01T00:00:00.000Z'
signalCodes:
type: array
items:
type: string
example:
- NEEDS_INTERFACE
- REQUEST_INTERFACE_CONTRACT
placeholderGapKey:
type: string
example: kaufmaennische_freigabe_fnav
requiredResolverRoles:
type: array
items:
type: string
example:
- ROLE_KAUFMAENNISCHE_LEITUNG
- ROLE_NETZPLANUNG
token:
type: string
description: Optional Cernion MCP token for this request. Overrides CERNION_TOKEN when provided.
examples:
default:
value:
role: grid_connection_validator
reason: NEEDS_INTERFACE
blockingLevel: soft
replacementCriteria:
kind: process
capabilityHint: znp.assessPortfolio
deadline: '2026-06-01T00:00:00.000Z'
signalCodes:
- NEEDS_INTERFACE
- REQUEST_INTERFACE_CONTRACT
/api/interface-placeholder/request-evidence:
post:
summary: Return evidence signals required to replace a placeholder
tags:
- Interface Placeholder
operationId: interface_placeholder_requestEvidence
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:
- placeholderId
properties:
placeholderId:
type: string
example: ph_1234567890abcdef
token:
type: string
description: Optional Cernion MCP token for this request. Overrides CERNION_TOKEN when provided.
examples:
default:
value:
placeholderId: ph_1234567890abcdef
/api/interface-placeholder/gaps/:placeholderId/status:
get:
summary: Return low-confidence minimal status for a placeholder
tags:
- Interface Placeholder
operationId: interface_placeholder_returnMinimalStatus
parameters:
- name: placeholderId
in: path
required: true
schema:
type: string
example: ph_1234567890abcdef
- $ref: '#/components/parameters/TokenQuery'
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
/api/interface-placeholder/gaps:
get:
summary: List tenant-scoped interface placeholder gaps
tags:
- Interface Placeholder
operationId: interface_placeholder_listGaps
parameters:
- name: reason
in: query
required: false
schema:
type: string
example: NEEDS_EVIDENCE
- name: blockingLevel
in: query
required: false
schema:
type: string
example: hard
- name: role
in: query
required: false
schema:
type: string
example: grid_connection_validator
- name: includeResolved
in: query
required: false
schema:
type: boolean
default: false
- name: limit
in: query
required: false
schema:
type: integer
default: 100
maximum: 250
- $ref: '#/components/parameters/TokenQuery'
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
/api/interface-placeholder/gaps/:placeholderId/resolve:
post:
summary: Resolve an interface placeholder gap
tags:
- Interface Placeholder
operationId: interface_placeholder_resolveGap
parameters:
- name: placeholderId
in: path
required: true
schema:
type: string
example: ph_1234567890abcdef
- $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:
- resolution
properties:
resolution:
example:
summary: Manual approval documented
approvedBy: user-123
oneOf:
- type: string
example: Manual approval documented
- type: object
properties:
summary:
type: string
example: Manual approval documented
approvedBy:
type: string
example: user-123
approvedRoles:
type: array
items:
type: string
example:
- ROLE_KAUFMAENNISCHE_LEITUNG
- ROLE_NETZPLANUNG
token:
type: string
description: Optional Cernion MCP token for this request. Overrides CERNION_TOKEN when provided.
examples:
default:
value:
resolution:
summary: Manual approval documented
approvedBy: user-123
approvedRoles:
- ROLE_KAUFMAENNISCHE_LEITUNG
- ROLE_NETZPLANUNG
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.'