Call an x402 Endpoint

Use B3OS to pay for and call an x402 protected resource from a workflow.

Use this recipe when a workflow needs to call an API that requires x402 payment before returning a response.

B3OS public x402 integration page

Pattern

text
trigger -> prepare request -> call x402 protected resource -> process response -> notify or continue
x402 protected call
startpolicy inputsapproved paymentrequest payloadresponse Trigger Manual, schedule, API, or upstream event Prepare request URL, method, headers, body, limits Wallet policy Connector, budget, chain, payment guardrail x402 call Pay and execute protected resource Process response Parse result, alert, continue workflow

Action

Use the x402 action when you want a workflow node to handle payment and request execution.

json
{  "type": "call-x402-protected-resource",  "connector": {    "type": "wallet",    "id": "conn_wallet"  },  "payload": {    "url": "https://api.example.com/protected-resource",    "method": "GET",    "headers": {},    "body": {}  },  "children": ["process_response"]}

x402 calls can spend value. Use a dedicated wallet, explicit limits, and monitoring before enabling fully automated production calls.

API Surfaces

TaskEndpoint
List endpointsGET /v1/x402-endpoints
Create an endpointPOST /v1/x402-endpoints
Probe endpoint requirementsPOST /v1/x402-endpoints/probe
Execute a paid callPOST /v1/x402-endpoints/execute
Test an endpointPOST /v1/x402-endpoints/test
x402 action reference

Action schema for workflow node usage.

Learn More
x402 API reference

Exact REST request and response shape for paid endpoint execution.

Learn More
Ask a question... ⌘I