Record a decision about this session's result, or what became of it [write]

Changed on

Writes one mark on the session; never a turn, never a status change. type human.decision takes payload {kind: adopt|rerun|revise|discard|vote|did_the_job|approve, target_session_id?, value? (required for did_the_job and approve), reason? (≤2000 chars), surface?}; For a Mac Create PR adoption, optional payload.github_pr takes {url, head_sha, export_receipt}; the receipt comes from workspace/patch with record_provenance: true and is verified against the exact GitHub result before storing provenance. type outcome.observed takes {kind: pr_merged|deployed|reopened|later_failure|shipped, ref? (≤500 chars), observer?}. An Idempotency-Key header makes a repeat answer 200 with the same event; without one, the same decision by the same caller within a minute lands once. 404 when the session, or a named target_session_id, is not one the caller can see. Nothing writes a decision on a person's behalf: a session without one is undecided.

post/sessions/{id}/record

Request

  • Base URL
    https://api.agentsky.dev/v1
  • URL
    https://api.agentsky.dev/v1/sessions/{id}/record
  • Auth
    HTTP bearer

Path parameters

idstring required

The session id

Headers

Idempotency-Keystring

Makes a repeated write return the first row

Request body

type'human.decision' | 'outcome.observed' required
payloadobject required

Response

Already recorded

eventobject

Changes