API reference · schema

CommitPlanRequest

6 fields · used by 0 operations

Last reviewed 2026-10-03

Fields

Field	Type	Meaning
`agent_id` required	string
`tenant` required	string
`goal` required	string
`steps` required	array of `PlanStep`
`max_cumulative_risk_budget` required	number	min `0.0`
`authorized_authority_ceiling` required	string

Smallest valid example

{
  "agent_id": "agent-id",
  "tenant": "tenant",
  "goal": "goal",
  "steps": [
    {
      "step_number": 1,
      "action_type": "action-type",
      "target_resource": "target-resource",
      "is_irreversible": false,
      "estimated_risk": 0.0,
      "required_authority": "required-authority",
      "expected_outcome": "expected-outcome"
    }
  ],
  "max_cumulative_risk_budget": 0.0,
  "authorized_authority_ceiling": "authorized-authority-ceiling"
}

Nested schemas

PlanStep

JSON Schema

Show the raw definition

{
  "properties": {
    "agent_id": {
      "type": "string",
      "title": "Agent Id"
    },
    "tenant": {
      "type": "string",
      "title": "Tenant"
    },
    "goal": {
      "type": "string",
      "title": "Goal"
    },
    "steps": {
      "items": {
        "$ref": "#/components/schemas/PlanStep"
      },
      "type": "array",
      "title": "Steps"
    },
    "max_cumulative_risk_budget": {
      "type": "number",
      "minimum": 0.0,
      "title": "Max Cumulative Risk Budget"
    },
    "authorized_authority_ceiling": {
      "type": "string",
      "title": "Authorized Authority Ceiling"
    }
  },
  "type": "object",
  "required": [
    "agent_id",
    "tenant",
    "goal",
    "steps",
    "max_cumulative_risk_budget",
    "authorized_authority_ceiling"
  ],
  "title": "CommitPlanRequest"
}

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