Actor Personas

List actor personas by role

Lists all active actor personas matching one role inside the resolved tenant scope.

get/api/agent-personas/by-role/:role

Request

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

Path parameters

rolestring required

Assigned role to resolve within the tenant persona registry.

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
rolestring 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
      }
    }
  ],
  "role": "billing@stadtwerk"
}

Changes

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