AgentInvokeRequest

Fields

6 fields

config_overrides

AgentConfigPatch or null

Per-invocation tighten-only overrides. Provider, endpoint, mode, temperature, max_tokens, escalation, and other ambiguous fields are rejected.

correlation_id

string or null

inline_input

object or null

Inline input for an agent that accepts it (catalog: inline_input_supported). input.payload must then name a stored test run of project_id, which anchors tenancy, review and retention. ≤ 262144 bytes; redacted before storage.

input · required

object

The agent's <StageName>InvokeInput, as published by GET /api/v1/agents/catalog/{agent_id}.

mode

string

Sync waits for the result, and only for sync-eligible agents (see the catalog); any other agent runs async and answers 202.

project_id · required

string (uuid)

Assertion: must equal the project of the test run named in input, else 400.

Raw schema (JSON)

{
  "additionalProperties": false,
  "properties": {
    "config_overrides": {
      "anyOf": [
        {
          "$ref": "#/components/schemas/AgentConfigPatch"
        },
        {
          "type": "null"
        }
      ],
      "description": "Per-invocation tighten-only overrides. Provider, endpoint, mode, temperature, max_tokens, escalation, and other ambiguous fields are rejected."
    },
    "correlation_id": {
      "anyOf": [
        {
          "maxLength": 128,
          "pattern": "^[A-Za-z0-9._:-]+$",
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Correlation Id"
    },
    "inline_input": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "description": "Inline input for an agent that accepts it (catalog: inline_input_supported). input.payload must then name a stored test run of project_id, which anchors tenancy, review and retention. ≤ 262144 bytes; redacted before storage.",
      "title": "Inline Input"
    },
    "input": {
      "additionalProperties": true,
      "description": "The agent's <StageName>InvokeInput, as published by GET /api/v1/agents/catalog/{agent_id}.",
      "title": "Input",
      "type": "object"
    },
    "mode": {
      "default": "async",
      "description": "sync waits for the result, and only for sync-eligible agents (see the catalog); any other agent runs async and answers 202.",
      "enum": [
        "async",
        "sync"
      ],
      "title": "Mode",
      "type": "string"
    },
    "project_id": {
      "description": "Assertion: must equal the project of the test run named in input, else 400.",
      "format": "uuid",
      "title": "Project Id",
      "type": "string"
    }
  },
  "required": [
    "project_id",
    "input"
  ],
  "title": "AgentInvokeRequest",
  "type": "object"
}

Used by endpoints

One endpoint sends or returns this schema, on its own or inside another schema.

• POST /api/v1/agents/{agent_id}/invoke — Invoke Agent

Used by schemas

No other schema contains this one.

More details

• Specification: OpenAPI JSON