Resolve a parked action

POST
/v1/threads/{thread_id}/parked/{effect_key}/resolve

Accepts duplicate risk, so it needs approval authority under the ROOT run's approver set, as decideApproval does; otherwise 403 forbidden and nothing is appended. The accepting principal is recorded as effect_resolved's actor.principal.

AuthorizationBearer <token>

Checked by host({authenticate}), which maps the request to a Principal or rejects it.

In: header

Path Parameters

thread_id*string

Lowercase UUID string. Writers MUST generate UUIDv7; readers accept any lowercase UUID, so the version is not an admission rule.

Match^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
effect_key*string
Length1 <= length

Query Parameters

branch_id?string

Default: the thread's main branch.

Match^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

A human settling an unknown effect (C3). Recorded as effect_resolved{by: human}.

Response Body

application/json

application/json

curl -X POST "https://example.com/v1/threads/string/parked/string/resolve" \  -H "Content-Type: application/json" \  -d '{    "resolution": "assume_done"  }'
{  "event_id": "string"}
Edit on GitHub