All workflows

Agent Handoff Capsule

Package objective, completed work, pending work, blockers, artifacts and state into a compact hashed handoff capsule so another agent can continue without replaying the whole conversation.

1 credit per call · $0.01 USDC with x402

Sample input

{
  "task_id": "t-42",
  "objective": "Publish verified report",
  "completed_steps": [
    "sources fetched"
  ],
  "pending_steps": [
    "validate output"
  ],
  "blockers": [],
  "artifacts": [
    {
      "id": "report",
      "url": "https://example.com/report"
    }
  ],
  "state": {
    "attempt": 2
  }
}

Worked sample output

{
  "ok": true,
  "mode": "agent_handoff_capsule",
  "capsule": {
    "version": "agent-handoff-v1",
    "task_id": "t-42",
    "objective": "Publish verified report",
    "completed": [
      "sources fetched"
    ],
    "pending": [
      "validate output"
    ],
    "blockers": [],
    "artifacts": [
      {
        "id": "report",
        "url": "https://example.com/report",
        "sha256": null
      }
    ],
    "state": {
      "attempt": 2
    }
  },
  "capsule_sha256": "299645a615a75645e8fad78f9ab3f03a755d94fd3da0265c7b766754f0fe552e",
  "next_action": {
    "type": "continue_step",
    "value": "validate output"
  },
  "limitations": [
    "Packages caller-supplied state without inventing missing progress or summarizing hidden context."
  ]
}

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/agent-handoff-capsule' \
  -H "Authorization: Bearer $BOUNTY_API_KEY" \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: workflow-request-001' \
  -H 'X-Max-Credits: 1' \
  --data '{"task_id":"t-42","objective":"Publish verified report","completed_steps":["sources fetched"],"pending_steps":["validate output"],"blockers":[],"artifacts":[{"id":"report","url":"https://example.com/report"}],"state":{"attempt":2}}'

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/agent-handoff-capsule. 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": {
    "task_id": "t-42",
    "objective": "Publish verified report",
    "completed_steps": [
      "sources fetched"
    ],
    "pending_steps": [
      "validate output"
    ],
    "blockers": [],
    "artifacts": [
      {
        "id": "report",
        "url": "https://example.com/report"
      }
    ],
    "state": {
      "attempt": 2
    }
  }
}

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