Goal

Advance a node's status

A leaf node moving to a terminal "done" status requires evidence (EvidenceRequiredError -> 400) unless the node is sync-owned.

patch/api/goal/nodes/{id}/advance

Request

  • Base URL: http://localhost:38200
  • URL: http://localhost:38200/api/goal/nodes/{id}/advance
  • Auth: one of:
    • HTTP bearer
    • API key in cookie token

Path parameters

idinteger required

Request body

statusstring required
evidencestring
payloadobject

Shallow-merged into the existing payload.

external_refobject

Shallow-merged into the existing external_ref.

order_indexinteger
titlestring
session_idinteger

Agent session recorded on the node's history row (T926).

Response

Updated node.

idinteger
tenantIdinteger
projectIdinteger nullable
parentIdinteger nullable
kindstring

objective | milestone | goal | work_item | relay

ownerRolestring nullable
statusstring

draft | not_started | ready | in_progress | blocked | done | superseded

originstring nullable

greenfield | leverage | migrate | unknown

titlestring
contextIdinteger nullable
verifyCmdstring nullable
evidencestring nullable
targetWeeksinteger nullable
startsAtstring date-time nullable
endsAtstring date-time nullable
sizestring nullable
effortWeeksnumber nullable
externalRefobject
orderIndexinteger
fromRolestring nullable

Relay routing (kind='relay' only).

toRolestring nullable

Relay routing (kind='relay' only).

claimedBySessionIdinteger nullable
nudgeCountinteger
lastNudgedAtstring date-time nullable
nudgedBySessionIdinteger nullable
payloadobject
doneAtstring date-time nullable
archivedAtstring date-time nullable
createdAtstring date-time
updatedAtstring date-time
syncOwnedboolean

Server-only marker set exclusively by POST /api/goal/sync.

objectiveRunIdstring nullable

Example response

{
  "kind": "work_item",
  "status": "not_started"
}

Changes

No recorded changes to this operation across all 1 revision of this API.