Skip to main content
PATCH
Control fleet work or adopt reviewed goal criteria

Authorizations

Authorization
string
header
required

Send a dashboard session token, an account API key (agt_t), or a command-line credential (afc_) as a Bearer token. Each endpoint lists accepted credential types.

Headers

If-Match
string
required

Required current strong resource tag.

Path Parameters

workspace_id
string
required

Workspace identifier (version 7 universally unique identifier, or UUID).

fleet_id
string
required

Fleet identifier (version 7 universally unique identifier, or UUID).

task_id
string
required

Task UUIDv7.

Body

application/json

A conditional lifecycle control or explicit adoption of reviewed goal wording.

expected_generation
integer<int64>
required

Generation from the task's current native context.

Required range: x >= 0
state
enum<string>
required

Requested native lifecycle state.

Available options:
paused,
ready,
cancelled

Response

Current task

Task detail with immutable success criteria and cumulative progress.

context
object
required

Accepted objective, questions, cursors and remaining limits.

etag
string
required

Strong version shared with the response header and conditional writes.

resource_version
integer<int64>
required

Version used by the strong resource tag.

Required range: x >= 0
setup_revision
integer<int64>
required

Human-readable number of the immutable setup accepted by this task.

Required range: x >= 0
title
string
required

User-facing title.

dependency
object | null

Current native dependency and saved check results; no remote refresh is implied.

publication
object | null

Latest publication receipt; only a confirmed receipt establishes a published head.