Disconnect the owner Link wallet

Human owner only. Revokes the refresh grant at Link and removes encrypted credentials and pending authorization after success. Repeated disconnection is harmless. Provider failure preserves local state for retry. Available when purchasing is disabled.

POST/v1/payments/link/disconnect

Authorization

AuthorizationBearer token (JWT) · headerrequired

Clerk human owner session JWT; iss must equal the configured Clerk issuer and the identity must be a human (not agent) owner with a verified email.

AuthorizationOAuth2 access token · headerrequired

Scopes:agentsub:owner

Responses

200

Wallet grant disconnected

connectedbooleanrequired

403

owner_required

codestringrequired

Allowed:owner_requiredagent_mismatchidempotency_requiredinvalid_inputstripe_signature_requiredpayment_unavailable

statusintegerrequired

503

payment_unavailable

codestringrequired

Allowed:owner_requiredagent_mismatchidempotency_requiredinvalid_inputstripe_signature_requiredpayment_unavailable

statusintegerrequired

Request

curl -X POST 'https://api.agentsub.dev/v1/payments/link/disconnect' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Accept: application/json'

const response = await fetch("https://api.agentsub.dev/v1/payments/link/disconnect", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Accept": "application/json"
  }
});

import requests

response = requests.post(
    "https://api.agentsub.dev/v1/payments/link/disconnect",
    headers={
        "Authorization": "Bearer YOUR_TOKEN",
        "Accept": "application/json"
    },
)

Response

{
  "connected": false
}

{
  "code": "owner_required",
  "status": 0
}

{
  "code": "owner_required",
  "status": 0
}