API reference · schema

ToolControlRequest

5 fields · used by 0 operations

Last reviewed 2026-10-02

Fields

Field	Type	Meaning
`risk_level`	string	default `"medium"`
`requires_approval`	boolean	default `false`
`policy_id`	string or null
`allowed_agents`	array of string or null
`allowed_identities`	array of string or null

Smallest valid example

{
  "risk_level": "medium",
  "requires_approval": false
}

JSON Schema

Show the raw definition

{
  "properties": {
    "risk_level": {
      "type": "string",
      "title": "Risk Level",
      "default": "medium"
    },
    "requires_approval": {
      "type": "boolean",
      "title": "Requires Approval",
      "default": false
    },
    "policy_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Policy Id"
    },
    "allowed_agents": {
      "anyOf": [
        {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "title": "Allowed Agents"
    },
    "allowed_identities": {
      "anyOf": [
        {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "title": "Allowed Identities"
    }
  },
  "type": "object",
  "title": "ToolControlRequest"
}

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