API reference · schema

MandateRunRequest

5 fields · used by 0 operations

Last reviewed 2026-10-11

Fields

Field	Type	Meaning
`preset`	string or null
`mandate`	object or null	Mandate body; the drill signs it. `ttl_seconds` sets expires_at.
`merchant_registry`	map of string to object or null
`agent_id`	string	max length `128` · default `"agent:shopping-assistant"`
`steps`	array of `MandateStep`

Smallest valid example

{
  "agent_id": "agent:shopping-assistant"
}

Nested schemas

MandateStep

JSON Schema

Show the raw definition

{
  "properties": {
    "preset": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Preset"
    },
    "mandate": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "title": "Mandate",
      "description": "Mandate body; the drill signs it. `ttl_seconds` sets expires_at."
    },
    "merchant_registry": {
      "anyOf": [
        {
          "additionalProperties": {
            "additionalProperties": true,
            "type": "object"
          },
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "title": "Merchant Registry"
    },
    "agent_id": {
      "type": "string",
      "maxLength": 128,
      "title": "Agent Id",
      "default": "agent:shopping-assistant"
    },
    "steps": {
      "items": {
        "$ref": "#/components/schemas/MandateStep"
      },
      "type": "array",
      "title": "Steps"
    }
  },
  "type": "object",
  "title": "MandateRunRequest"
}

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