> For the complete documentation index, see [llms.txt](https://framework.pokerscript.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://framework.pokerscript.net/connector-apis/chips-update-api.md).

# Chips Update API

Update the account balance and store the ledger.

## Overview

The **Chips Update API** allows you to modify a player's chip balance in Pokerscript poker software. This API is essential for managing in-game transactions and adjusting chip amounts as needed.

## Endpoint

`POST http://admin.pokerurl.com/api/chips-update`

## Headers

| Key             | Value                | Description                        |
| --------------- | -------------------- | ---------------------------------- |
| `AuthKey`       | `489j4erwginerwgirn` | Client key provided by Pokerscript |
| `Accept`        | `application/JSON`   | Specifies response format          |
| `Content-Type`  | `application/JSON`   | Specifies request format           |
| `Authorization` | `Bearer <UserToken>` | User authentication token          |

## Request Body

The request body should be formatted in JSON and include the following fields:

```
{
    "chips": 100.00
}
```

#### Parameters

| Parameter | Type  | Description                        |
| --------- | ----- | ---------------------------------- |
| `chips`   | float | Updated chip balance of the player |

#### Note

* `UserToken` is obtained from the **Login API** and must be stored securely for future use.

## Success Response

Upon a successful chip update, the API returns a `200 OK` status with the following response:

```
{
    "status": true,
    "message": "Chips Updated Successfully",
    "data": {
        "chips": 100.00
    }
}
```

## Error Responses

If the request fails, an error response is returned with the corresponding status code:

#### `401 Unauthorized`

```
{
    "status": false,
    "message": "Invalid Authorization Token"
}
```

#### `404 Not Found`

```
{
    "status": false,
    "message": "User Not Found"
}
```

#### `500 Internal Server Error`

```
{
    "status": false,
    "message": "Something Went Wrong"
}
```

## Additional Notes

* Ensure that the `UserToken` is valid and not expired.
* The `AuthKey` should be provided by Pokerscript for API access.
* Always use secure storage for sensitive tokens and authentication keys.