API reference · schema

AuthorizeReq

5 fields · used by 0 operations

Last reviewed 2026-10-02

Fields

Field	Type	Meaning
`client_id`	string	max length `64` · default `"visitor"`
`tool`	string	max length `64` · default `"demo_tool"`
`action` required	string	max length `64`
`resource` required	string	max length `128`
`requested_authority`	one of `"standard"`, `"elevated"`	default `"standard"`

Smallest valid example

{
  "client_id": "visitor",
  "tool": "demo_tool",
  "action": "action",
  "resource": "resource",
  "requested_authority": "standard"
}

JSON Schema

Show the raw definition

{
  "properties": {
    "client_id": {
      "type": "string",
      "maxLength": 64,
      "title": "Client Id",
      "default": "visitor"
    },
    "tool": {
      "type": "string",
      "maxLength": 64,
      "title": "Tool",
      "default": "demo_tool"
    },
    "action": {
      "type": "string",
      "maxLength": 64,
      "title": "Action"
    },
    "resource": {
      "type": "string",
      "maxLength": 128,
      "title": "Resource"
    },
    "requested_authority": {
      "type": "string",
      "enum": [
        "standard",
        "elevated"
      ],
      "title": "Requested Authority",
      "default": "standard"
    }
  },
  "type": "object",
  "required": [
    "action",
    "resource"
  ],
  "title": "AuthorizeReq"
}

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