DUduda
AI credit client wallets

Update a wallet

Send any subset; omitted fields are left alone. Raising recurrence_amount adds the difference to recurrence_balance now; lowering it clamps recurrence_balance to the new amount. Errors: wallet_not_found, invalid_value.

put/api/ai-credits/wallets/{wallet_id}

Request

  • Base URL
    https://api.duda.co
  • URL
    https://api.duda.co/api/ai-credits/wallets/{wallet_id}
  • Auth
    HTTP basic

Path parameters

wallet_idstring required

Request body

namestring

Free text, up to 255 characters. No effect on credits or assignment.

recurrence_amountstring

As a decimal string. Takes effect immediately: raising it adds the difference to recurrence_balance now; lowering it clamps recurrence_balance to the new amount. Cannot be negative, at most 2 decimals and 99999999.99.

recurrence_dayinteger

1-31.

Example request

{
  "name": "Acme Corp",
  "recurrence_amount": "150.0",
  "recurrence_day": 1
}

Response

OK

created_atstring date-time
idstring

Minted by Duda and immutable. Store it against your own customer record.

namestring

The id when no name was set.

recurrence_amountstring

The recurring allowance, as a decimal string.

recurrence_balancestring

What is left of the recurring allowance this cycle, as a decimal string. Moved by POST /credits.

recurrence_dayinteger

Day of the month (1-31) the cycle turns over. Clamps to the month's length.

topup_balancestring

A single flat top-up figure, as a decimal string. It never expires.

updated_atstring date-time

Example response

{
  "assigned_accounts": [
    {
      "account_name": "acme-corp"
    }
  ],
  "id": "3f9c1a7e-4b21-4d9a-9f0e-8c2d1a5b7e33",
  "name": "Acme Corp",
  "recurrence_amount": "500.0",
  "recurrence_balance": "320.0",
  "recurrence_day": 15,
  "topup_balance": "100.0"
}

Changes

No recorded changes to this operation across all 1 revision of this API.