Actor Personas

List actor personas

Lists all actor personas for the resolved tenant scope.

get/api/agent-personas

Request

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

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.

Response

Successful response

successboolean required
tenantIdstring required
countinteger required

Example response

{
  "success": true,
  "tenantId": "tenant-a",
  "count": 1,
  "items": [
    {
      "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.