Goal

Add a goal node

post/api/goal/nodes

Request

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

Request body

project_idinteger nullable
parent_idinteger nullable
titlestring required
kindstring

objective | milestone | goal | work_item | relay

owner_rolestring
statusstring
originstring
sizestring
effort_weeksnumber
target_weeksinteger
verify_cmdstring
external_refobject
payloadobject
contentstring
order_indexinteger
dostring

One-sentence work order

session_idinteger

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

Response

Created node. A work_item in a project whose board uses T<NN> ids gets the next one in externalRef.local_id (T926). A work_item created without a brief also carries hint, the brief template with one filled example (T925).

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.