Skip to main content
DELETE
Clear a user's spend limits
Removes your limits on one user. Limits another company set on the same user stay in place. Your limits stop at once. The wallet provider can take a little longer to let go of the per-transaction limit: until it has, wallet_provider_policy.status reads pending or failed, and no single transfer is larger than the wallet provider still allows. Agentcard retries on its own every few minutes, and sending the same request again retries right away. When the user disconnects from your company, your limits on them are removed the same way. You can still clear a limit you left on a user who disconnected. The answer then carries spent as null, since what that user spends is no longer yours to read, and a read of their limits answers 404.

Authorizations

Authorization
string
header
required

A platform access token. Get one on the Create an access token endpoint by exchanging your client_id + client_secret, then send it as Authorization: Bearer <token>. Tokens live one hour.

Query Parameters

user_id
string
required

The connected user.

Response

The user's spend limits, with yours removed.

object
enum<string>
required

Always wallet_spend_limit.

Available options:
wallet_spend_limit
user_id
string
required

The connected user.

stricter_limit_applies
boolean
required

true when another company set a smaller figure for one of the three limits, or a limit you left unset. The user's balance obeys the smaller figure of each limit across every company; that company's figures are not shown.

spent
object | null
required

What left the user's balance onto their cards, in cents, across every company. A refunded purchase stops counting. null when you clear a limit on a user who disconnected from your company.

wallet_provider_policy
object
required

Whether the wallet provider that holds the user's balance refuses a transfer above the per-transaction limit that holds for the user.

per_transaction_cents
integer | null

Your most for one movement, in cents. null is no limit.

daily_cents
integer | null

Your most for any 24 hours, in cents.

monthly_cents
integer | null

Your most for any 30 days, in cents.

updated_at
string<date-time> | null

When you last set your limits.