All workflows

Agent Task State Transition Gate

Reject illegal task-state changes and terminal-state regressions before an orchestrator mutates durable MCP/A2A-style task state.

1 credit per call · $0.005 USDC with x402

Sample input

{
  "from": "working",
  "to": "completed"
}

Worked sample output

{
  "ok": true,
  "mode": "task_state_transition_gate",
  "decision": "allow",
  "from": "working",
  "to": "completed",
  "known_from_state": true,
  "allowed_targets": [
    "input_required",
    "completed",
    "failed",
    "cancelled"
  ],
  "reason": "allowed_transition",
  "limitations": [
    "The default state machine is a generic agent-task profile. Supply allowed_transitions when a specific protocol or application uses different states."
  ]
}

Worked example using published sample data only. Own-data execution is paid.

Connect in curl

Set BOUNTY_API_KEY privately after your payment is verified. Change the retry key for each new logical request.

curl 'https://bounty-engineer-x402-prod.onrender.com/v1/prepaid/task-state-transition-gate' \
  -H "Authorization: Bearer $BOUNTY_API_KEY" \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: workflow-request-001' \
  -H 'X-Max-Credits: 1' \
  --data '{"from":"working","to":"completed"}'

Connect in n8n

Download the inactive n8n template. Import it, configure the private Header Auth credential, inspect the sample and run it manually. A new execution creates a new billable request; there is no automatic schedule.

Use an HTTP POST to https://bounty-engineer-x402-prod.onrender.com/v1/prepaid/task-state-transition-gate. Send JSON and these headers; store the Bearer token as a private credential.

{
  "method": "POST",
  "headers": {
    "Authorization": "Bearer YOUR_PRIVATE_API_KEY",
    "Content-Type": "application/json",
    "Idempotency-Key": "UNIQUE_PER_LOGICAL_REQUEST",
    "X-Max-Credits": "1"
  },
  "body": {
    "from": "working",
    "to": "completed"
  }
}

Reuse a retry key only for the same input. Failed execution returns reserved credits. Full integration and recovery guide · Machine-readable recipe