Sign in
x402

Create or update an x402 EVM chain. (admin access required)

Creates or updates an EVM chain configuration, keyed by its CAIP-2 id.

post/x402/networks

Request

  • Base URL: ./../api/v1/ (relative, and the document was published on a file host, not at the API’s origin)
  • URL: ./../api/v1/x402/networks
  • Auth: API key in header token

Request body

caip2Idstring required
displayNamestring required
rpcUrlstring required
isTestnetboolean
isEnabledboolean
defaultAssetstring nullable
defaultAssetDecimalsinteger nullable
facilitatorWalletIdstring nullable

Self-hosted facilitator: owned Selling wallet id (null clears it)

facilitatorUrlstring nullable

Remote facilitator: HTTPS endpoint (null clears it)

facilitatorAuthstring nullable

Authorization header value for the remote facilitator, stored encrypted at rest. Omit to preserve it only when the URL origin is unchanged; changing origin clears it. Send a string to set/rotate it, or null to clear it. Requires a remote facilitator URL (existing or set in the same request).

Example request

{
  "caip2Id": "eip155:8453",
  "displayName": "Base",
  "rpcUrl": "https://mainnet.base.org",
  "isTestnet": false,
  "isEnabled": true,
  "defaultAsset": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
  "defaultAssetDecimals": 6,
  "facilitatorWalletId": "clmanagedwallet0002"
}

Response

Chain configuration saved

status'success' required

Example response

{
  "status": "success",
  "data": {
    "id": "clx402network0001",
    "caip2Id": "eip155:8453",
    "displayName": "Base",
    "rpcUrl": "https://mainnet.base.org",
    "isTestnet": false,
    "isEnabled": true,
    "defaultAsset": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
    "defaultAssetDecimals": 6,
    "facilitatorWalletId": "clmanagedwallet0002",
    "facilitatorWalletAddress": "0x5555555555555555555555555555555555555555",
    "facilitatorUrl": null,
    "createdById": "api_key_id",
    "createdAt": "2026-06-02T12:00:00.000Z",
    "updatedAt": "2026-06-02T12:00:00.000Z"
  }
}

Changes

No recorded changes to this operation across all 50 revisions of this API.