tasks

List Task Mutations

Return the paginated mutation log for a task.

Each entry surfaces a full before/after snapshot plus the list of fields that changed. Entries are ordered newest first and can be paged forward via next_cursor. Sensitive fields on the snapshots are masked by default. Pass reveal=true to return actual values, matching the /resources endpoint’s convention.

Returns: TaskMutationPage with the current page and a cursor for the next page (None when there are no more entries).

Raises: NotFoundError: If task not found or belongs to another organization. InvalidCursorError: If the cursor is malformed.

GET

agents

tasks

{task_id}

mutations

List Task Mutations

curl --request GET \
  --url https://api.example.com/agents/tasks/{task_id}/mutations

{
  "items": [
    {
      "edge_id": "<string>",
      "timestamp": "2023-11-07T05:31:56Z",
      "operation": "create",
      "resource_table": "<string>",
      "resource_id": "<string>",
      "actor_type": "user",
      "before": {},
      "after": {},
      "fields_changed": [],
      "version_before": 123,
      "version_after": 123,
      "actor_id": "<string>"
    }
  ],
  "next_cursor": "<string>"
}

Path Parameters

task_id

string

required

Query Parameters

limit

integer

default:50

Maximum mutations to return per page

Required range: 1 <= x <= 200

cursor

string | null

Composite cursor '|'; returns mutations strictly older than this point under (timestamp DESC, edge_id DESC).

reveal

boolean

default:false

Reveal sensitive field values on before/after snapshots

Response

Successful Response

Paginated page of mutation log entries.

Attributes: items: Mutation entries for the current page, newest first. next_cursor: Composite cursor for the next page, or None when no more entries exist. Built as "<iso-timestamp>|<edge-id>" over the last entry in items.

items

ResourceMutation · object[]

required

Show child attributes

next_cursor

string | null

Task Graph DiffReturn the net delta per resource for a task. Every ``task->mutated->resource`` edge is rolled up server-side into a per-resource net delta: create + many updates collapses to a single ``create``; create + delete collapses to a ``noop``; etc. The fields_changed list on each entry is the union of top-level fields that differ between the earliest before and the latest after snapshots. The endpoint scans up to ``settings.MAX_GRAPH_DIFF_MUTATIONS`` edges per request. Tasks with more mutations than the cap return a partial rollup marked ``truncated=true`` — use the paginated ``/mutations`` endpoint for the full audit trail. Sensitive fields on the snapshots are masked by default. Pass ``reveal=true`` to return actual values, matching the ``/resources`` endpoint's convention. Returns: ``GraphDiff`` with per-resource net deltas and the raw mutation count. Raises: NotFoundError: If task not found or belongs to another organization.

List Task Mutations

curl --request GET \
  --url https://api.example.com/agents/tasks/{task_id}/mutations

{
  "items": [
    {
      "edge_id": "<string>",
      "timestamp": "2023-11-07T05:31:56Z",
      "operation": "create",
      "resource_table": "<string>",
      "resource_id": "<string>",
      "actor_type": "user",
      "before": {},
      "after": {},
      "fields_changed": [],
      "version_before": 123,
      "version_after": 123,
      "actor_id": "<string>"
    }
  ],
  "next_cursor": "<string>"
}

Overview

API Reference

agents

agent-instances

agent-types

auth

canvas

conversation-routing

events

fleet

graph

files

internal

ops

organizations

patches

presence

providers

resources

runtime

tasks

triggers

webhooks

List Task Mutations

Path Parameters

Query Parameters

Response