API reference · schema

GrantRequest

5 fields · used by 0 operations

Last reviewed 2026-10-02

Fields

Field	Type	Meaning
`tenant` required	string	max length `256`
`principal_id` required	string	max length `256`
`agent_id` required	string	max length `256`
`capabilities` required	array of array of string	max items `256`
`ttl_s`	integer	default `120`

Smallest valid example

{
  "tenant": "tenant",
  "principal_id": "principal-id",
  "agent_id": "agent-id",
  "capabilities": [
    [
      "capabilities"
    ]
  ],
  "ttl_s": 120
}

JSON Schema

Show the raw definition

{
  "properties": {
    "tenant": {
      "type": "string",
      "maxLength": 256,
      "title": "Tenant"
    },
    "principal_id": {
      "type": "string",
      "maxLength": 256,
      "title": "Principal Id"
    },
    "agent_id": {
      "type": "string",
      "maxLength": 256,
      "title": "Agent Id"
    },
    "capabilities": {
      "items": {
        "items": {
          "type": "string"
        },
        "type": "array"
      },
      "type": "array",
      "maxItems": 256,
      "title": "Capabilities"
    },
    "ttl_s": {
      "type": "integer",
      "title": "Ttl S",
      "default": 120
    }
  },
  "type": "object",
  "required": [
    "tenant",
    "principal_id",
    "agent_id",
    "capabilities"
  ],
  "title": "GrantRequest"
}

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