API reference · schema

CreateContextRequest

16 fields · used by 0 operations

Last reviewed 2026-11-06

Fields

Field	Type	Meaning
`tenant` required	string
`principal` required	string
`agent`	string or null
`session_id`	string or null
`authority`	string	default `"system"`
`delegation_chain`	array of map of string to string
`intent`	string or null
`policy_id`	string or null
`policy_version`	integer or null
`trust_state`	string or null
`trust_version`	integer or null
`risk`	string	default `"low"`
`resource`	string or null
`action`	string or null
`audience`	string or null
`constraints`	object

Smallest valid example

{
  "tenant": "tenant",
  "principal": "principal",
  "authority": "system",
  "risk": "low"
}

JSON Schema

Show the raw definition

{
  "properties": {
    "tenant": {
      "type": "string",
      "title": "Tenant"
    },
    "principal": {
      "type": "string",
      "title": "Principal"
    },
    "agent": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Agent"
    },
    "session_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Session Id"
    },
    "authority": {
      "type": "string",
      "title": "Authority",
      "default": "system"
    },
    "delegation_chain": {
      "items": {
        "additionalProperties": {
          "type": "string"
        },
        "type": "object"
      },
      "type": "array",
      "title": "Delegation Chain"
    },
    "intent": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Intent"
    },
    "policy_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Policy Id"
    },
    "policy_version": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Policy Version"
    },
    "trust_state": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Trust State"
    },
    "trust_version": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Trust Version"
    },
    "risk": {
      "type": "string",
      "title": "Risk",
      "default": "low"
    },
    "resource": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Resource"
    },
    "action": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Action"
    },
    "audience": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Audience"
    },
    "constraints": {
      "additionalProperties": true,
      "type": "object",
      "title": "Constraints"
    }
  },
  "type": "object",
  "required": [
    "tenant",
    "principal"
  ],
  "title": "CreateContextRequest"
}

Try CAIN-42 on your own agents

Create a free account and every new account starts with a 30-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