---
title: "Start a Workbench case from a guided case starter through the normal CET chat path"
method: POST
path: "/api/workbench/case-starters/:starterId/start"
tags: ["Workbench"]
---

# Start a Workbench case from a guided case starter through the normal CET chat path

`POST /api/workbench/case-starters/:starterId/start`

## Request

- Base URL: `https://api.cernion.de`
- URL: `https://api.cernion.de/api/workbench/case-starters/:starterId/start`
- Auth: none declared

CET-governed Workbench/Tenant-Gateway API for Open WebUI clients. Tokens stay server-side; CET remains case-state and governance authority.

## Path parameters

- `starterId` string, required

## Query parameters

- `token` string

## Request body

- object
  - `client` string: Workbench client, usually open-webui
  - `channel` string: Workbench channel, usually open-webui
  - `openWebuiConversationId` string: Open WebUI conversation id
  - `openWebuiUserId` string: Open WebUI mapped user id
  - `openWebuiOrgId` string: Open WebUI mapped organization id
  - `clientId` string: Registered delivery client id
  - `inputs` object: Allowlisted scalar starter inputs
  - `userRequest` string: Optional bounded user context
  - `asyncDelivery` object
    - `mode` 'none' | 'poll': Delivery mode
    - `clientId` string: Registered Workbench delivery client id
    - `ackMode` 'explicit': Acknowledgement mode
    - `supportedEventTypes` string[]
  - `requestId` string: Caller request id
  - `correlationId` string: Caller correlation id
  - `token` string: Optional Cernion MCP token for this request. Overrides CERNION_TOKEN when provided.

## Response `200`

Workbench response

- object
  - `schemaVersion` string: Case starter schema version
  - `starter` object
    - `starterId` string: Guided case starter id
    - `activityId` string: Canonical Workbench Activity Taxonomy activity id
    - `title` string: UI-safe starter title
    - `description` string: UI-safe starter description
    - `domainHint` string: Advisory domain hint; Domain Router remains authoritative
    - `initialPromptTemplate` string: Bounded prompt template assembled by CET
    - `requiredInputs` object[]
      - `key` string: Allowlisted input key
      - `label` string: UI-safe input label
      - `required` boolean: Whether this input is required
    - `suggestedEvidenceTypes` string[]
    - `noCallGuards` string[]
    - `defaultAsyncDelivery` object
      - `mode` 'none' | 'poll': Delivery mode
      - `clientId` string: Registered Workbench delivery client id
      - `ackMode` 'explicit': Acknowledgement mode
      - `supportedEventTypes` string[]
    - `expectedRoleFamilies` string[]
    - `allowedActions` string[]
    - `blockedActions` string[]
    - `handoffDomains` string[]
    - `nextSafeStep` string: Next safe step for missing inputs/evidence
  - `caseId` string: CET case id
  - `cetCaseId` string: CET case id
  - `caseStateVersion` number: Case-state version
  - `usedOperation` string: classify or continue
  - `primaryDomain` string: Primary CET domain
  - `alternativeDomains` object[]
    - `domain` string: Domain
    - `confidence` number: Confidence
  - `readinessState` string: Readiness state
  - `responseText` string: UI response text
  - `eventSummary` object
    - `pending` number: Pending events not yet delivered
    - `delivered` number: Delivered but not acknowledged events
    - `unacknowledged` number: Pending plus delivered events
    - `attention` number: Unacknowledged events requiring user attention
  - `pendingEvents` number: Pending event count

## Other responses

- `403`: Tenant, actor, role or sensitivity denied
- `404`: Workbench resource not found
- `409`: Stale or conflicting mapping
- `422`: Invalid workbench request

---

[API](https://skmtc.dev/cernion/apis/cernion-energy-tools-api.md) · [All operations](https://skmtc.dev/cernion/apis/cernion-energy-tools-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cernion/apis/cernion-energy-tools-api/revisions/cdb94473b538?raw)