GEgetaxonflow
MAP
Workflow Control Plane

List pending approvals (MAP plane)

List steps currently awaiting human approval for MAP-backed workflows — workflows whose metadata carries a plan_id (MAP confirm / step mode). Every returned entry has plan_id populated; this is the intentional asymmetry with the WCP-plane listing at /api/v1/workflows/approvals/pending, mirroring the approve/reject asymmetry established in Issue #1677 / ADR-046.

Reviewer integrators that need to render plan context can read plan_id directly without a second lookup; clients that want a plane-neutral view can use /api/v1/hitl/queue instead.

Reachable on Evaluation and above, the same resolve gate as the MAP /steps/{step_id}/approve and /steps/{step_id}/reject endpoints. Creating new approval entries requires Professional or above.

get/api/v1/plans/approvals/pending

Request

Query parameters

plan_idstring

Filter to a single plan_id — returns only steps waiting on that plan.

limitinteger

Maximum number of results to return

Response

List of pending plan approvals

countinteger

Total number of pending approvals matching the scope.

Example response

{
  "pending_approvals": [
    {
      "workflow_id": "wf_41231a72-9b0c-4f5e-8a13-6d2e0c7b4f91",
      "workflow_name": "code-review-pipeline",
      "plan_id": "plan-abc123",
      "step_id": "step-2",
      "step_index": 1,
      "step_name": "Deploy to Production",
      "step_type": "action",
      "decision": "require_approval",
      "decision_reason": "Human approval required for deployment steps",
      "approval_status": "pending"
    }
  ]
}

Changes

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