Goal

Atomically claim a work item for a session (T879)

Cross-machine atomic claim. The conditional UPDATE's WHERE clause is the lock, so exactly one concurrent caller wins. Losing is a 200 with claimed: false naming the holder, NOT a 409 — a fanned-out agent treats an error status as a transport failure and retries, while "someone else has it" is a final answer to act on. The claim does not move status; status is advanced through /advance.

post/api/goal/nodes/claim

Request

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

Request body

idinteger required

Node id to claim

session_idinteger required

The claiming agent session

Response

Claim resolved. Check claimed — false means another session holds it.

nodeobject
claimedboolean
heldByinteger nullable

Changes

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