AgentTaskV1

Fields

22 fields

attempt

integer

budget

TaskBudgetV1

capability_id · required

string

completed_at

string (date-time) or null

dependencies

array of string

enrichment_stop_reason

string or null

error

string or null

evidence_ids

array of string

failure_cluster_id

string or null

finding_ids

array of string

parent_task_id

string or null

required

boolean

schema_version

integer

selected · required

boolean

selection_reason · required

string

source_pipeline_run_id

string or null

stage_name · required

string

started_at

string (date-time) or null

status · required

string

stop_reason

string or null

task_id · required

string

usage

TaskUsageV1

Raw schema (JSON)

{
  "additionalProperties": false,
  "properties": {
    "attempt": {
      "default": 1,
      "minimum": 1,
      "title": "Attempt",
      "type": "integer"
    },
    "budget": {
      "$ref": "#/components/schemas/TaskBudgetV1"
    },
    "capability_id": {
      "title": "Capability Id",
      "type": "string"
    },
    "completed_at": {
      "anyOf": [
        {
          "format": "date-time",
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Completed At"
    },
    "dependencies": {
      "default": [],
      "items": {
        "type": "string"
      },
      "title": "Dependencies",
      "type": "array"
    },
    "enrichment_stop_reason": {
      "anyOf": [
        {
          "enum": [
            "cancelled",
            "llm_call_budget_exhausted",
            "token_budget_exhausted",
            "wall_clock_budget_exhausted",
            "investigation_not_found",
            "budget_reservation_failed",
            "duplicate_reservation",
            "budget_ledger_invalid",
            "budget_reservation_identity_mismatch",
            "budget_settlement_failed",
            "budget_settlement_pending",
            "budget_overrun",
            "reservation_lease_expired",
            "cost_budget_exhausted",
            "cluster_child_join_timeout",
            "cluster_child_cancelled",
            "cluster_child_failed",
            "cluster_child_dispatch_exhausted",
            "project_child_capacity_exhausted"
          ],
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Enrichment Stop Reason"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Error"
    },
    "evidence_ids": {
      "default": [],
      "items": {
        "type": "string"
      },
      "title": "Evidence Ids",
      "type": "array"
    },
    "failure_cluster_id": {
      "anyOf": [
        {
          "maxLength": 200,
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Failure Cluster Id"
    },
    "finding_ids": {
      "default": [],
      "items": {
        "type": "string"
      },
      "title": "Finding Ids",
      "type": "array"
    },
    "parent_task_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Parent Task Id"
    },
    "required": {
      "default": false,
      "title": "Required",
      "type": "boolean"
    },
    "schema_version": {
      "const": 1,
      "default": 1,
      "title": "Schema Version",
      "type": "integer"
    },
    "selected": {
      "title": "Selected",
      "type": "boolean"
    },
    "selection_reason": {
      "title": "Selection Reason",
      "type": "string"
    },
    "source_pipeline_run_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Source Pipeline Run Id"
    },
    "stage_name": {
      "title": "Stage Name",
      "type": "string"
    },
    "started_at": {
      "anyOf": [
        {
          "format": "date-time",
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Started At"
    },
    "status": {
      "enum": [
        "pending",
        "running",
        "completed",
        "failed",
        "skipped",
        "cancelled",
        "partial"
      ],
      "title": "Status",
      "type": "string"
    },
    "stop_reason": {
      "anyOf": [
        {
          "enum": [
            "completed",
            "policy_skip",
            "not_selected",
            "budget_exhausted",
            "timeout",
            "capability_error",
            "cancelled",
            "partial"
          ],
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Stop Reason"
    },
    "task_id": {
      "title": "Task Id",
      "type": "string"
    },
    "usage": {
      "$ref": "#/components/schemas/TaskUsageV1"
    }
  },
  "required": [
    "task_id",
    "capability_id",
    "stage_name",
    "status",
    "selected",
    "selection_reason"
  ],
  "title": "AgentTaskV1",
  "type": "object"
}

Used by endpoints

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

• GET /api/v1/agents/pipelines/{pipeline_id}/agentic-runtime — Get Agentic Runtime

Used by schemas

• AgenticRunV1

More details

• Specification: OpenAPI JSON