API reference · schema

PrincipalCreate

4 fields · used by 1 operations

Last reviewed 2026-10-03

Fields

Field	Type	Meaning
`kind` required	string	agent \| human \| service
`display_name` required	string	min length `1` · max length `200`
`public_key`	string or null	base64 Ed25519 public key (32 bytes)
`metadata`	object

Smallest valid example

{
  "kind": "kind",
  "display_name": "display-name"
}

Used by 1 operation

POST /fabric/identity/principals Register a principal

JSON Schema

Show the raw definition

{
  "properties": {
    "kind": {
      "type": "string",
      "title": "Kind",
      "description": "agent | human | service"
    },
    "display_name": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "title": "Display Name"
    },
    "public_key": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Public Key",
      "description": "base64 Ed25519 public key (32 bytes)"
    },
    "metadata": {
      "additionalProperties": true,
      "type": "object",
      "title": "Metadata"
    }
  },
  "type": "object",
  "required": [
    "kind",
    "display_name"
  ],
  "title": "PrincipalCreate"
}

Try CAIN-42 on your own agents

Create a free account and every new account starts with a 7-day trial of the full platform. Or try the sandbox first, with no account at all.

Create a free account → · Try the sandbox · See the whole ecosystem