Actor Personas

Deactivate an actor persona

Soft-deactivates an actor persona within the resolved tenant scope while preserving the record for auditability.

delete/api/agent-personas/:id

Request

  • Base URL: https://api.cernion.de
  • URL: https://api.cernion.de/api/agent-personas/:id
  • Auth: none declared

Path parameters

idstring required

Persona identifier within the tenant.

Query parameters

tenantIdstring

Optional tenant fallback when the X-Tenant-Id header is not provided.

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.

Headers

X-Tenant-Idstring

Tenant scope for the actor persona registry. The API gateway injects the resolved tenant into action params as tenantId.

Request body

tokenstring

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

Response

Successful response

successboolean required

Example response

{
  "success": true,
  "item": {
    "tenantId": "tenant-a",
    "id": "thorsten-human",
    "personaName": "Thorsten Zoerner",
    "personaType": "human",
    "openclawUserId": "openclaw-123",
    "assignedRoles": [
      "billing@stadtwerk",
      "management"
    ],
    "communicationChannels": [
      {
        "type": "email",
        "address": "thorsten@example.com"
      }
    ],
    "defaultPersonalAgentSessionId": "pa_12345678",
    "status": "active",
    "roleIds": [
      "grid_planner"
    ],
    "contextAffinities": {
      "workflowTypes": [
        "grid_connection_validation"
      ],
      "domainIntents": [
        "grid_planning"
      ]
    },
    "handoffTargets": [
      "governance-reviewer-agent"
    ],
    "resolutionPolicy": {
      "mode": "auto",
      "priority": 1
    }
  }
}

Changes

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