> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fluz.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Editar cuentas de gasto

# Descripción general

Cada cuenta de saldo en efectivo tiene su propio apodo para que el usuario pueda distinguirlas fácilmente, en caso de que haya varias.

# Editar cuenta de saldo en efectivo del usuario

## Ejemplo de solicitud

Puedes actualizar una cuenta de saldo en efectivo de un usuario con la mutación `updateUserCashBalance`. Esta mutación te permite editar el apodo de la cuenta de gasto para ayudar a organizar tus fondos. La consulta recibe un objeto de entrada `UpdateUserCashBalanceInput`.

```json theme={null}
mutation updateUserCashBalance($input: UpdateUserCashBalanceInput!) {
    updateUserCashBalance(input: $input) {
        userCashBalanceId
        totalCashBalance
        availableCashBalance
        lifetimeCashBalance
        nickname
        status
        createdAt
    }
}
```

Esta mutación requiere el tipo de entrada `UpdateUserCashBalanceInput`. Cualquier campo marcado con un signo de exclamación (`!`) en el esquema es obligatorio y debe incluirse en la solicitud.

| Nombre del campo  | Tipo    | Descripción                                                                                                                                                   |
| :---------------- | :------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| userCashBalanceId | UUID!   | Un identificador único para la cuenta de saldo en efectivo.                                                                                                   |
| nickname          | String! | Un nombre personalizado para la cuenta de saldo en efectivo. Ayuda a identificar el propósito de la cuenta. Debe tener al menos 2 caracteres y no más de 100. |

## UpdateUserCashBalanceInput

```json theme={null}
{
  "userCashBalanceId": "f8a3c9e1-7b2d-4f5e-9c8a-1d2e3f4g5h6i",
  "nickname": "New Team Travel"
}
```

## Ejemplo de respuesta

La respuesta de la mutación `updateUserCashBalance` incluirá los detalles de la cuenta de saldo en efectivo recién creada, incluido su identificador único e información del saldo inicial.

```json theme={null}
{
  "data": {
    "updateUserCashBalance": {
      "userCashBalanceId": "f8a3c9e1-7b2d-4f5e-9c8a-1d2e3f4g5h6i",
      "totalCashBalance": "0",
      "availableCashBalance": "0",
      "lifetimeCashBalance": "0",
      "nickname": "New Team Travel",
      "status": "ACTIVE",
      "createdAt": "2025-01-15T10:30:00.000Z"
    }
  }
}
```

### Campos de la respuesta

| Nombre del campo     | Tipo                   | Descripción                                                     |
| :------------------- | :--------------------- | :-------------------------------------------------------------- |
| userCashBalanceId    | UUID!                  | Identificador único de la cuenta de saldo en efectivo           |
| totalCashBalance     | String!                | Saldo total en efectivo en la cuenta (comienza en 0)            |
| availableCashBalance | String!                | Saldo en efectivo disponible para uso inmediato (comienza en 0) |
| lifetimeCashBalance  | String!                | Total acumulado de todos los fondos depositados (comienza en 0) |
| nickname             | String                 | El nombre personalizado asignado a la cuenta                    |
| status               | UserCashBalanceStatus! | Estado actual de la cuenta (ACTIVE, CLOSED o SUSPENDED)         |
| createdAt            | DateTime!              | Marca de tiempo cuando se creó la cuenta                        |

> ❗️ Autorización requerida
>
> Esta mutación requiere el alcance `MANAGE_PAYMENT`. Asegúrate de que tu token de acceso tenga concedido este alcance antes de intentar crear una cuenta de saldo en efectivo.