# Update account settings (tradelink, access token, proxy, steam API, and webhook)

`POST /v1/update-account`

Unified endpoint to update multiple account settings in one request. This is useful for partners who need to manage accounts that are waiting for trade verification and balance unfreezing without keeping socket connections open. At least one field must be provided.

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `api` | query | string | required | Your [WAXPEER API](https://waxpeer.com/profile/user) |

## Request body

```json
{
  "tradelink": "https://steamcommunity.com/tradeoffer/new/?partner=123456789&token=abcdefgh",
  "access_token": "ZXlKaGJHY2lPaUpJVXpJMU5pSXNJblI1Y0NJNklrcFhWQ0o5...",
  "refresh_token": "ZXlKaGJHY2lPaUpJVXpJMU5pSXNJblI1Y0NJNklrcFhWQ0o5...",
  "proxy": "user123:pass456@proxy.example.com:8080",
  "steam_api": "12345678901234567890123456789012",
  "webhook": "https://your-site.com/webhook",
  "reset_api": true
}
```

## Example (curl)

```bash
curl -X POST 'https://api.waxpeer.com/v1/update-account?api=%7B%7BAPI_KEY%7D%7D' \
  -H 'Content-Type: application/json' \
  -d '{
  "tradelink": "https://steamcommunity.com/tradeoffer/new/?partner=123456789&token=abcdefgh",
  "access_token": "ZXlKaGJHY2lPaUpJVXpJMU5pSXNJblI1Y0NJNklrcFhWQ0o5...",
  "refresh_token": "ZXlKaGJHY2lPaUpJVXpJMU5pSXNJblI1Y0NJNklrcFhWQ0o5...",
  "proxy": "user123:pass456@proxy.example.com:8080",
  "steam_api": "12345678901234567890123456789012",
  "webhook": "https://your-site.com/webhook",
  "reset_api": true
}'
```

## Example response

```json
{
  "success": true,
  "tradelink_updated": true,
  "access_token_updated": true,
  "proxy_updated": true,
  "steam_api_updated": true,
  "steam_api_msg": "same_api",
  "webhook_updated": true,
  "webhook_msg": "same_value",
  "api_reset": true,
  "msg": "Invalid tradelink"
}
```

## Responses

- `200` successful operation
- `400` Bad request - no fields provided

## Notes for agents

- Auth is the query parameter `api`, not an Authorization header.
- See [/statuses.md](/statuses.md) for numeric trade status plus `escrow_status` / `release_date`.
- Prefer GET /v2/search-items-by-name over v1.
- Do not use GET /v1/ready-to-transfer-p2p; use the [trade websocket](/websocket.md).