API reference · schema

SupplyChainRunRequest

6 fields · used by 0 operations

Last reviewed 2026-10-11

Fields

Field	Type	Meaning
`preset`	string or null	Run a built-in scenario instead of `actions`
`actions`	array of `AgentAction`
`allowlist`	map of string to array of string	ecosystem -> your lockfile names
`trusted_index_hosts`	array of string
`require_pins`	boolean	default `false`
`registry`	map of string to map of string to object	scenario registry facts: ecosystem -> name -> {exists, age_days, malicious}

Smallest valid example

{
  "require_pins": false
}

Nested schemas

AgentAction

JSON Schema

Show the raw definition

{
  "properties": {
    "preset": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Preset",
      "description": "Run a built-in scenario instead of `actions`"
    },
    "actions": {
      "items": {
        "$ref": "#/components/schemas/AgentAction"
      },
      "type": "array",
      "title": "Actions"
    },
    "allowlist": {
      "additionalProperties": {
        "items": {
          "type": "string"
        },
        "type": "array"
      },
      "type": "object",
      "title": "Allowlist",
      "description": "ecosystem -> your lockfile names"
    },
    "trusted_index_hosts": {
      "items": {
        "type": "string"
      },
      "type": "array",
      "title": "Trusted Index Hosts"
    },
    "require_pins": {
      "type": "boolean",
      "title": "Require Pins",
      "default": false
    },
    "registry": {
      "additionalProperties": {
        "additionalProperties": {
          "additionalProperties": true,
          "type": "object"
        },
        "type": "object"
      },
      "type": "object",
      "title": "Registry",
      "description": "scenario registry facts: ecosystem -> name -> {exists, age_days, malicious}"
    }
  },
  "type": "object",
  "title": "SupplyChainRunRequest"
}

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