# Update account

Update the organization's business name or accept the Terms of Service.

Source: https://statusdashboard.com/docs/api/account-management/account/update

`PATCH /app/account`

Updates the organization's business name.

***

## Request
See [API Basics](/docs/api) for required headers.

### Request body
| Field          | Type    | Required | Description                                                                                                          |
| -------------- | ------- | -------- | -------------------------------------------------------------------------------------------------------------------- |
| `businessName` | string  | No       | Display name for the organization. 2–30 characters.                                                                  |
| `tosAccepted`  | boolean | No       | Set `true` to accept the Terms of Service. Required during initial onboarding when `status` is `pending_onboarding`. |

***

## Sample request
```bash
curl -X PATCH https://api.statusdashboard.com/app/account \
  -H "Authorization: Bearer bcf847abf5c6:def456" \
  -H "Content-Type: application/json" \
  -d '{"businessName": "Acme Plumbing Co."}'
```

## Sample response
**Status: `200 OK`**

```json
{
  "org": {
    "orgId": "a1b2c3d4-0000-4000-8000-e5f6a7b8c9d0",
    "name": "Acme Plumbing Co.",
    "status": "active",
    "tier": "pro",
    "createdAt": "2026-01-15T09:00:00.000Z",
    "tosAcceptedAt": "2026-01-16T10:30:00.000Z",
    "tosVersion": "2026-01-01"
  }
}
```

`tosAcceptedAt` and `tosVersion` are omitted when the ToS has not been accepted.

***

## Error responses
| Status | When                                                                             |
| ------ | -------------------------------------------------------------------------------- |
| `400`  | Validation failure — e.g. `businessName` is required when completing onboarding. |
| `403`  | Insufficient permissions.                                                        |
| `404`  | Organization not found.                                                          |
| `409`  | An organization with that name already exists. Choose a different name.          |