API reference · schema

IdentityCreateRequest

7 fields · used by 1 operations

Last reviewed 2026-10-02

Fields

Field	Type	Meaning
`kind` required	string	Identity kind: agent, human, service, mcp_server, tool, sub_agent
`display_name` required	string	min length `1` · max length `255`
`tenant`	string or null	Tenant ID (resolved from API key if omitted)
`capabilities`	array of string or null	Capabilities to grant
`metadata`	object or null
`parent_id`	string or null	Parent identity for delegation
`ttl_seconds`	integer or null	Credential TTL in seconds default `86400`

Smallest valid example

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

Used by 1 operation

POST /fabric/identity/create Create Identity

JSON Schema

Show the raw definition

{
  "properties": {
    "kind": {
      "type": "string",
      "title": "Kind",
      "description": "Identity kind: agent, human, service, mcp_server, tool, sub_agent"
    },
    "display_name": {
      "type": "string",
      "maxLength": 255,
      "minLength": 1,
      "title": "Display Name"
    },
    "tenant": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Tenant",
      "description": "Tenant ID (resolved from API key if omitted)"
    },
    "capabilities": {
      "anyOf": [
        {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "title": "Capabilities",
      "description": "Capabilities to grant"
    },
    "metadata": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "title": "Metadata"
    },
    "parent_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Parent Id",
      "description": "Parent identity for delegation"
    },
    "ttl_seconds": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Ttl Seconds",
      "description": "Credential TTL in seconds",
      "default": 86400
    }
  },
  "type": "object",
  "required": [
    "kind",
    "display_name"
  ],
  "title": "IdentityCreateRequest"
}

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