API reference · schema

DelegationCreateRequest

5 fields · used by 1 operations

Last reviewed 2026-10-03

Fields

Field	Type	Meaning
`delegate_id` required	string	Identity ID of the delegate
`capabilities` required	array of string	Capabilities to delegate min items `1`
`constraints`	object or null
`ttl_seconds`	integer	Delegation TTL in seconds default `3600`
`max_depth`	integer	Maximum delegation chain depth default `3`

Smallest valid example

{
  "delegate_id": "delegate-id",
  "capabilities": [
    "capabilities"
  ],
  "ttl_seconds": 3600,
  "max_depth": 3
}

Used by 1 operation

POST /fabric/identity/{identity_id}/delegate Create Delegation

JSON Schema

Show the raw definition

{
  "properties": {
    "delegate_id": {
      "type": "string",
      "title": "Delegate Id",
      "description": "Identity ID of the delegate"
    },
    "capabilities": {
      "items": {
        "type": "string"
      },
      "type": "array",
      "minItems": 1,
      "title": "Capabilities",
      "description": "Capabilities to delegate"
    },
    "constraints": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "title": "Constraints"
    },
    "ttl_seconds": {
      "type": "integer",
      "title": "Ttl Seconds",
      "description": "Delegation TTL in seconds",
      "default": 3600
    },
    "max_depth": {
      "type": "integer",
      "title": "Max Depth",
      "description": "Maximum delegation chain depth",
      "default": 3
    }
  },
  "type": "object",
  "required": [
    "delegate_id",
    "capabilities"
  ],
  "title": "DelegationCreateRequest"
}

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