---
title: "List Agent (via MCP) tasks visible to this credential"
method: GET
path: "/v1/agent-tasks"
tags: ["Agent Tasks"]
---

# List Agent (via MCP) tasks visible to this credential

`GET /v1/agent-tasks`

## Request

- Base URL: `https://api.talonic.com`
- URL: `https://api.talonic.com/v1/agent-tasks`
- Auth: HTTP bearer

## Query parameters

- `status` 'available' | 'claimed' | 'submitted' | 'timed_out' | 'cancelled'
- `grain` 'document' | 'product'
- `pipeline_id` string, uuid
- `limit` integer
- `cursor` string

## Response `200`

Cursor-paginated task metadata across both grains. Payloads are fetched individually and audited.

- object
  - `data` AgentTaskMetadata[]
    - `id` string, uuid, required
    - `customer_id` string, uuid, required
    - `pipeline_id` string, uuid, required
    - `grain` 'document' | 'product', required: document = one parked document at an Agent (via MCP) rail stage; product = one composed record at the post-assembly Agentic Review stage.
    - `pipeline_document_id` string, uuid, nullable, required: Set on document-grain tasks only.
    - `document_id` string, uuid, nullable, required: Set on document-grain tasks only.
    - `record_id` string, uuid, nullable, required: The composed record under review; set on product-grain tasks only.
    - `stage_id` string, required
    - `phase_index` integer, required
    - `status` 'available' | 'claimed' | 'submitted' | 'timed_out' | 'cancelled', required
    - `execution_epoch` integer, required
    - `claimed_at` string, date-time, nullable
    - `lease_expires_at` string, date-time, nullable
    - `timeout_at` string, date-time, required
    - `submitted_at` string, date-time, nullable
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `result_summary` AgentTaskResultSummary, nullable: Present only on a task the caller itself submitted (the submit response, and `GET /v1/agent-tasks/{id}` by the claim holder). What the platform did with the submit; keys with nothing to report are omitted.
      - `fields` string[]: Fields written as submitted.
      - `summary` string
      - `demoted_below_floor` string[]: Values under the autonomy contract's confidence floor; recorded
      - `skipped_cells` object[]: Fields the cell-write guard withheld. `review_authority` = a review decision outranks the agent; `pending_approval` = the cell is held for review. Under `releaseHolds`, a `pending_approval` field also appears in `released_holds` or `release_failed`.
        - `field_key` string
        - `reason` 'review_authority' | 'pending_approval'
      - `escalated` object[]: Fields handed to a human (agent escalation or an unverified quote).
        - `field_key` string
        - `reason` string
        - `proposed` unknown
      - `released_holds` object[]: Product grain with the autonomy contract's `releaseHolds`: held fields the submit settled through the review path (`approve` = held value kept, `correct` = submitted value written; a null value clears the field).
        - `field_key` string
        - `action` 'approve' | 'correct'
        - `pipeline_document_id` string, uuid
      - `release_failed` object[]: Held fields the release could not settle; they stay held for a human.
        - `field_key` string
        - `reason` string
      - `anchor_election` string, uuid
      - `autonomy_mode` 'propose' | 'observe'
  - `pagination` CursorPagination
    - `has_more` boolean, required
    - `next_cursor` string, nullable, required

## Other responses

- `401`: Missing or invalid API key.
- `429`: Daily rate limit exceeded.

---

[API](https://skmtc.dev/talonic/apis/talonic-api.md) · [All operations](https://skmtc.dev/talonic/apis/talonic-api/llms.txt) · [OpenAPI document](https://skmtc.dev/talonic/apis/talonic-api/revisions/678fe5f8c9c3?raw)