Actor Personas

Get an actor persona

Returns one actor persona by id within the resolved tenant scope.

get/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.

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.