API reference · schema

RunRequest

6 fields · used by 0 operations

Last reviewed 2026-11-06

Fields

Field	Type	Meaning
`suite_id` required	string	min length `1` · max length `120`
`target_url` required	string	the agent endpoint under test min length `1` · max length `500`
`cases`	array of object	suite definition; required on first run
`workspace_id`	string or null	max length `64`
`label`	string or null	max length `120`
`seed`	integer or null

Smallest valid example

{
  "suite_id": "suite-id",
  "target_url": "target-url"
}

JSON Schema

Show the raw definition

{
  "properties": {
    "suite_id": {
      "type": "string",
      "maxLength": 120,
      "minLength": 1,
      "title": "Suite Id"
    },
    "target_url": {
      "type": "string",
      "maxLength": 500,
      "minLength": 1,
      "title": "Target Url",
      "description": "the agent endpoint under test"
    },
    "cases": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "type": "array",
      "title": "Cases",
      "description": "suite definition; required on first run"
    },
    "workspace_id": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 64
        },
        {
          "type": "null"
        }
      ],
      "title": "Workspace Id"
    },
    "label": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 120
        },
        {
          "type": "null"
        }
      ],
      "title": "Label"
    },
    "seed": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Seed"
    }
  },
  "type": "object",
  "required": [
    "suite_id",
    "target_url"
  ],
  "title": "RunRequest"
}

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