API reference · schema

ExpectationCreateRequest

18 fields · used by 0 operations

Last reviewed 2026-10-02

Fields

Field	Type	Meaning
`tenant`	string	default `"demo"`
`decision_id` required	string
`identity_id` required	string
`agent_id` required	string
`action` required	string
`resource` required	string
`expected_outcome`	string	default `"success"`
`expected_outcome_confidence`	number	default `0.95`
`expected_risk_score`	number	default `0.1`
`expected_risk_factors`	array of string	default `[]`
`expected_resource_impact`	object	default `{}`
`expected_trajectory_steps`	integer	default `1`
`expected_trajectory_transitions`	array of string	default `[]`
`expected_authorization_state`	string	default `"ALLOW"`
`expected_side_effects`	array of string	default `[]`
`expected_duration_ms`	number	default `50.0`
`expected_cost_cents`	number	default `0.01`
`trajectory_id`	string or null

Smallest valid example

{
  "tenant": "demo",
  "decision_id": "decision-id",
  "identity_id": "identity-id",
  "agent_id": "agent-id",
  "action": "action",
  "resource": "resource",
  "expected_outcome": "success",
  "expected_outcome_confidence": 0.95,
  "expected_risk_score": 0.1,
  "expected_risk_factors": [],
  "expected_resource_impact": {},
  "expected_trajectory_steps": 1,
  "expected_trajectory_transitions": [],
  "expected_authorization_state": "ALLOW",
  "expected_side_effects": [],
  "expected_duration_ms": 50.0,
  "expected_cost_cents": 0.01
}

JSON Schema

Show the raw definition

{
  "properties": {
    "tenant": {
      "type": "string",
      "title": "Tenant",
      "default": "demo"
    },
    "decision_id": {
      "type": "string",
      "title": "Decision Id"
    },
    "identity_id": {
      "type": "string",
      "title": "Identity Id"
    },
    "agent_id": {
      "type": "string",
      "title": "Agent Id"
    },
    "action": {
      "type": "string",
      "title": "Action"
    },
    "resource": {
      "type": "string",
      "title": "Resource"
    },
    "expected_outcome": {
      "type": "string",
      "title": "Expected Outcome",
      "default": "success"
    },
    "expected_outcome_confidence": {
      "type": "number",
      "title": "Expected Outcome Confidence",
      "default": 0.95
    },
    "expected_risk_score": {
      "type": "number",
      "title": "Expected Risk Score",
      "default": 0.1
    },
    "expected_risk_factors": {
      "items": {
        "type": "string"
      },
      "type": "array",
      "title": "Expected Risk Factors",
      "default": []
    },
    "expected_resource_impact": {
      "additionalProperties": true,
      "type": "object",
      "title": "Expected Resource Impact",
      "default": {}
    },
    "expected_trajectory_steps": {
      "type": "integer",
      "title": "Expected Trajectory Steps",
      "default": 1
    },
    "expected_trajectory_transitions": {
      "items": {
        "type": "string"
      },
      "type": "array",
      "title": "Expected Trajectory Transitions",
      "default": []
    },
    "expected_authorization_state": {
      "type": "string",
      "title": "Expected Authorization State",
      "default": "ALLOW"
    },
    "expected_side_effects": {
      "items": {
        "type": "string"
      },
      "type": "array",
      "title": "Expected Side Effects",
      "default": []
    },
    "expected_duration_ms": {
      "type": "number",
      "title": "Expected Duration Ms",
      "default": 50.0
    },
    "expected_cost_cents": {
      "type": "number",
      "title": "Expected Cost Cents",
      "default": 0.01
    },
    "trajectory_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Trajectory Id"
    }
  },
  "type": "object",
  "required": [
    "decision_id",
    "identity_id",
    "agent_id",
    "action",
    "resource"
  ],
  "title": "ExpectationCreateRequest"
}

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