Human approval gate

​

How it works

1. Create a key with requires_approval: true.
2. When that key triggers a spend action (e.g. send a campaign), the Gateway does not dispatch. It returns a job in pending_approval:
   { "data": { "job_id": "…", "status": "pending_approval", "poll": "/agent/v1/jobs/…" } }
   
3. An approval.requested webhook fires (if subscribed). A human reviews and resolves it:
   curl -X POST https://api.platformdtc.com/api/v1/agent/v1/approvals/$JOB_ID/resolve \
     -H "X-Agent-Key: sq_agt_admin" -H "Content-Type: application/json" \
     -d '{"decision":"approve"}'   # or "deny"
   
4. On approve, the deferred action is released (the real pipeline dispatches) and the job moves to queued → succeeded. On deny, the job becomes cancelled with APPROVAL_DENIED.