API reference · schema

DecisionRequest

6 fields · used by 0 operations

Last reviewed 2026-10-02

Fields

Field	Type	Meaning
`action` required	string	min length `1`
`resource` required	string	min length `1`
`principal`	string or null	default `"anonymous"`
`agent_id`	string or null
`tenant_id`	string or null	default `"demo"`
`metadata`	object or null	default `{}`

Smallest valid example

{
  "action": "action",
  "resource": "resource",
  "principal": "anonymous",
  "tenant_id": "demo",
  "metadata": {}
}

JSON Schema

Show the raw definition

{
  "properties": {
    "action": {
      "type": "string",
      "minLength": 1,
      "title": "Action"
    },
    "resource": {
      "type": "string",
      "minLength": 1,
      "title": "Resource"
    },
    "principal": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Principal",
      "default": "anonymous"
    },
    "agent_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Agent Id"
    },
    "tenant_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Tenant Id",
      "default": "demo"
    },
    "metadata": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "title": "Metadata",
      "default": {}
    }
  },
  "type": "object",
  "required": [
    "action",
    "resource"
  ],
  "title": "DecisionRequest"
}

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