SynapseDocumentation

Create provider withdrawal intent

Locks provider receivables and creates a provider withdrawal ticket or manual-review request. Amounts must be strings at the API boundary.

POST/api/v1/providers/withdrawals/intentWallet JWTIdempotent

For AI agents

Provider self-service withdrawal. It never spends consumer balances; it only reserves provider receivable funds.

Requires: Valid JWT + X-Idempotency-Key + provider receivable balance

Generated OpenAPI reference

POST/api/v1/providers/withdrawals/intent

Authorization

bearerAuth
AuthorizationBearer <token>

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

[key: string]?any

Response Body

application/json

application/json

application/json

curl -X POST "https://api-staging.synapse-network.ai/api/v1/providers/withdrawals/intent" \  -H "Content-Type: application/json" \  -d '{    "amountUsdc": "12.50"  }'
{
  "status": "success",
  "ownerAddress": "0xProviderWallet",
  "withdrawalId": "wd_abc",
  "statusLabel": "APPROVED_AUTO",
  "ticket": {
    "to": "0xProviderWallet",
    "amount": "12500000",
    "deadline": 1770000000
  }
}
{
  "code": "INSUFFICIENT_PROVIDER_RECEIVABLE",
  "message": "Provider receivable balance is too low"
}
{
  "code": "WITHDRAW_VAULT_LIQUIDITY_CHECK_UNAVAILABLE",
  "message": "Gateway cannot verify vault liquidity"
}
Back to API Reference