---
title: "Link an Open WebUI conversation to a CET case"
method: POST
path: "/api/workbench/conversations/link-case"
tags: ["Workbench"]
---

# Link an Open WebUI conversation to a CET case

`POST /api/workbench/conversations/link-case`

## Request

- Base URL: `https://api.cernion.de`
- URL: `https://api.cernion.de/api/workbench/conversations/link-case`
- Auth: none declared

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

## Query parameters

- `token` string

## Request body

- object
  - `client` string: Workbench client
  - `conversationId` string: Client conversation id
  - `openWebuiConversationId` string: Open WebUI conversation id
  - `openWebuiUserId` string: Open WebUI user id
  - `openWebuiOrgId` string: Open WebUI organization id
  - `caseId` string: CET case id
  - `cetCaseId` string: CET case id
  - `clientId` string: Registered delivery client id
  - `overwrite` boolean: Allow refreshing an existing mapping to the same case
  - `token` string: Optional Cernion MCP token for this request. Overrides CERNION_TOKEN when provided.

## Response `200`

Workbench response

- object
  - `linked` unknown
  - `conversationRef` unknown

## 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)
