Actor Personas

Create an actor persona

Creates a tenant-scoped actor persona for HITL routing, notification delivery, and persona inbox resolution.

post/api/agent-personas

Request

  • Base URL: https://api.cernion.de
  • URL: https://api.cernion.de/api/agent-personas
  • 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.

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

idstring required
personaNamestring required
personaType'human' | 'specialized-agent' required
openclawUserIdstring nullable
assignedRolesstring[]
defaultPersonalAgentSessionIdstring nullable
status'active' | 'inactive' | 'on-leave'
tokenstring

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

Example request

{
  "id": "thorsten-human",
  "personaName": "Thorsten Zoerner",
  "personaType": "human",
  "openclawUserId": "openclaw-123",
  "assignedRoles": [
    "billing@stadtwerk"
  ],
  "communicationChannels": [
    {
      "type": "email",
      "address": "thorsten@example.com"
    }
  ],
  "defaultPersonalAgentSessionId": "pa_12345678",
  "status": "active"
}

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.