API reference · schema

CreateRequest

13 fields · used by 0 operations

Last reviewed 2026-10-04

Fields

Field	Type	Meaning
`agent_id` required	string	max length `128`
`product` required	string	max length `32`
`kind` required	string	max length `32`
`resource` required	string	max length `512`
`purpose` required	string	max length `1024`
`max_uses`	integer	min `1.0` · max `1000.0` · default `1`
`ttl_ms`	integer	min `1000.0` · max `86400000.0` · default `300000`
`conditions`	array of object	max items `32`
`request`	object or null
`risk_class`	string or null
`scitt_required`	boolean	default `true`
`audience`	string	max length `256` · default `""`
`annotations`	object

Smallest valid example

{
  "agent_id": "agent-id",
  "product": "product",
  "kind": "kind",
  "resource": "resource",
  "purpose": "purpose",
  "max_uses": 1,
  "ttl_ms": 300000,
  "scitt_required": true,
  "audience": ""
}

JSON Schema

Show the raw definition

{
  "properties": {
    "agent_id": {
      "type": "string",
      "maxLength": 128,
      "title": "Agent Id"
    },
    "product": {
      "type": "string",
      "maxLength": 32,
      "title": "Product"
    },
    "kind": {
      "type": "string",
      "maxLength": 32,
      "title": "Kind"
    },
    "resource": {
      "type": "string",
      "maxLength": 512,
      "title": "Resource"
    },
    "purpose": {
      "type": "string",
      "maxLength": 1024,
      "title": "Purpose"
    },
    "max_uses": {
      "type": "integer",
      "maximum": 1000.0,
      "minimum": 1.0,
      "title": "Max Uses",
      "default": 1
    },
    "ttl_ms": {
      "type": "integer",
      "maximum": 86400000.0,
      "minimum": 1000.0,
      "title": "Ttl Ms",
      "default": 300000
    },
    "conditions": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "type": "array",
      "maxItems": 32,
      "title": "Conditions"
    },
    "request": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "title": "Request"
    },
    "risk_class": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Risk Class"
    },
    "scitt_required": {
      "type": "boolean",
      "title": "Scitt Required",
      "default": true
    },
    "audience": {
      "type": "string",
      "maxLength": 256,
      "title": "Audience",
      "default": ""
    },
    "annotations": {
      "additionalProperties": true,
      "type": "object",
      "title": "Annotations"
    }
  },
  "type": "object",
  "required": [
    "agent_id",
    "product",
    "kind",
    "resource",
    "purpose"
  ],
  "title": "CreateRequest"
}

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