Zielnetzplanung (ZNP)

Create a new ZNP project workspace

Allocates a new in-memory graphology graph for the given geographic bounding box. Returns a projectId (UUID) that must be passed to all subsequent layer-loading and analysis calls. The virtual aggregation substation SUB_1 is pre-seeded into the graph. Graph state is persisted to PouchDB (znp:meta: + znp:graph: documents) and hydrated on service start. Sessions survive server restarts as of v0.23.

post/api/znp/projects

Request

  • Base URL: https://api.cernion.de
  • URL: https://api.cernion.de/api/znp/projects
  • Auth: none declared

Query parameters

tokenstring

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.

Request body

namestring
municipalityKeystring nullable

Optional 8-digit AGS (Amtlicher Gemeindeschlüssel) municipality code.

tokenstring

Optional Cernion MCP token for this request. Overrides CERNION_TOKEN when provided.

Example request

{
  "bbox": {
    "south": 49.47,
    "west": 8.43,
    "north": 49.52,
    "east": 8.52
  },
  "name": "Ludwigshafen Nord Q3-2026",
  "municipalityKey": "05513000"
}

Response

Project created

projectIdstring
namestring
bboxobject
createdAtstring date-time
tenantIdstring nullable
municipalityKeystring nullable
graphStatsobject

Example response

{
  "projectId": "a1b2c3d4-...",
  "municipalityKey": "05513000"
}

Changes

No recorded changes to this operation across all 2 revisions of this API.