---
title: "Assign a client"
method: POST
path: "/api/ai-credits/wallets/{wallet_id}/accounts"
tags: ["AI credit client wallets"]
---

# Assign a client

`POST /api/ai-credits/wallets/{wallet_id}/accounts`

## Request

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

Puts one of your client accounts on this wallet and returns the wallet. Repeating it for a client already on this wallet returns the same wallet. One client per wallet, one wallet per client: moving a client is an unassign and an assign. Errors: wallet_not_found, account_not_client, account_already_assigned (the client is on another wallet), wallet_has_account, invalid_value.

## Path parameters

- `wallet_id` string, required

## Request body

- ApiAssignAccountRequest
  - `account_name` string, required: The name the client account was created with through the Accounts API.

## Response `200`

OK

- ApiSubWalletResponse
  - `assigned_accounts` ApiAccountRefInfo[]: The client accounts drawing from this wallet, empty when none is. Moved by assign and unassign.
    - `account_name` string: The client's account name, as the Accounts API returns it.
  - `created_at` string, date-time
  - `id` string: Minted by Duda and immutable. Store it against your own customer record.
  - `name` string: The id when no name was set.
  - `recurrence_amount` string: The recurring allowance, as a decimal string.
  - `recurrence_balance` string: What is left of the recurring allowance this cycle, as a decimal string. Moved by POST /credits.
  - `recurrence_day` integer: Day of the month (1-31) the cycle turns over. Clamps to the month's length.
  - `topup_balance` string: A single flat top-up figure, as a decimal string. It never expires.
  - `updated_at` string, date-time

## Other responses

- `400`: Bad request. The request is malformed or failed validation.
- `401`: Unauthorized. The credentials are missing or invalid.
- `429`: Too many requests. The rate limit was exceeded.

---

[API](https://skmtc.dev/duda/apis/duda-partner-api.md) - [All operations](https://skmtc.dev/duda/apis/duda-partner-api/llms.txt) - [OpenAPI document](https://skmtc.dev/duda/apis/duda-partner-api/revisions/52be4d41cb12?raw)