AgentInvocationResponse

Fields

20 fields

agent_id · required

string

attempt · required

integer

config_snapshot

object or null

Credential-free resolved configuration accepted for this invocation.

created_at

string (date-time) or null

error

string or null

id · required

string (uuid)

input

object or null

The inline input as stored: secrets and personal data redacted before storage. None for stored_run.

input_kind

string

input_sha256

string or null

Sha256 of the redacted stored inline input; None for a stored-run invocation.

links · required

object

max_attempts · required

integer

mode · required

string

next_retry_at

string (date-time) or null

output

object or null

The invoked agent's stored stage output, once that stage has completed.

pipeline_run_id · required

string (uuid)

project_id · required

string (uuid)

requires_human_review · required

boolean

review · required

ReviewBlock

status · required

string

test_run_id · required

string (uuid)

Raw schema (JSON)

{
  "properties": {
    "agent_id": {
      "title": "Agent Id",
      "type": "string"
    },
    "attempt": {
      "title": "Attempt",
      "type": "integer"
    },
    "config_snapshot": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "description": "Credential-free resolved configuration accepted for this invocation.",
      "title": "Config Snapshot"
    },
    "created_at": {
      "anyOf": [
        {
          "format": "date-time",
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Created At"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Error"
    },
    "id": {
      "format": "uuid",
      "title": "Id",
      "type": "string"
    },
    "input": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "description": "The inline input as stored: secrets and personal data redacted before storage. None for stored_run.",
      "title": "Input"
    },
    "input_kind": {
      "default": "stored_run",
      "enum": [
        "stored_run",
        "inline"
      ],
      "title": "Input Kind",
      "type": "string"
    },
    "input_sha256": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "sha256 of the redacted stored inline input; None for a stored-run invocation.",
      "title": "Input Sha256"
    },
    "links": {
      "additionalProperties": {
        "type": "string"
      },
      "title": "Links",
      "type": "object"
    },
    "max_attempts": {
      "title": "Max Attempts",
      "type": "integer"
    },
    "mode": {
      "enum": [
        "sync",
        "async"
      ],
      "title": "Mode",
      "type": "string"
    },
    "next_retry_at": {
      "anyOf": [
        {
          "format": "date-time",
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Next Retry At"
    },
    "output": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "description": "The invoked agent's stored stage output, once that stage has completed.",
      "title": "Output"
    },
    "pipeline_run_id": {
      "format": "uuid",
      "title": "Pipeline Run Id",
      "type": "string"
    },
    "project_id": {
      "format": "uuid",
      "title": "Project Id",
      "type": "string"
    },
    "requires_human_review": {
      "title": "Requires Human Review",
      "type": "boolean"
    },
    "review": {
      "$ref": "#/components/schemas/ReviewBlock"
    },
    "status": {
      "enum": [
        "in_progress",
        "completed",
        "failed",
        "passed"
      ],
      "title": "Status",
      "type": "string"
    },
    "test_run_id": {
      "format": "uuid",
      "title": "Test Run Id",
      "type": "string"
    }
  },
  "required": [
    "id",
    "project_id",
    "agent_id",
    "test_run_id",
    "pipeline_run_id",
    "mode",
    "status",
    "attempt",
    "max_attempts",
    "requires_human_review",
    "review",
    "links"
  ],
  "title": "AgentInvocationResponse",
  "type": "object"
}

Used by endpoints

4 endpoints send or return this schema, on its own or inside another schema.

• POST /api/v1/agents/{agent_id}/invoke — Invoke Agent
• GET /api/v1/agents/invocations/{invocation_id} — Get Invocation
• POST /api/v1/agents/invocations/{invocation_id}/cancel — Cancel Invocation
• POST /api/v1/agents/invocations/{invocation_id}/retry — Retry Invocation

Used by schemas

No other schema contains this one.

More details

• Specification: OpenAPI JSON