Human-confirmation step: executes a staged coordinator pending action
POST/api/coordinator/pending-actions/:id/execute
Human-confirmation step: executes a staged coordinator pending action. A pending action is created by the coordinator brain when it suggests a write (create_task, link_to_existing, draft_spec_pr). This route is the ONLY write path — there is no direct-mutation bypass. The optional mutationPolicyOverride in the request body may tighten (never loosen) the code-declared confirm-required ceiling.
Request
Responses
- 200
- 400
- 401
- 403
- 404
- 409
- 410
- 501
Successful response
mutation_policy_escalation — mutationPolicyOverride attempts to widen beyond the code-declared ceiling, or unknown override value / missing path param.
Caller is not authenticated.
Coordinator is in read-only mode for this initiative.
Pending action not found (or not visible to the caller via RLS).
Pending action is already in a terminal status (executed / cancelled / failed).
Pending action TTL has elapsed (expires_at is in the past).
draft_spec_pr action kind — outbound GitHub PR creation is not yet implemented (follow-up: PLT-391).