---
title: "POST /accounts/{accountId}/users#operation=suspend"
method: POST
path: "/accounts/{accountId}/users#operation=suspend"
---

# POST /accounts/{accountId}/users#operation=suspend

`POST /accounts/{accountId}/users#operation=suspend`

Suspends up to 50 users from a `Team` or `EnterpriseLWA` Amazon Chime account. For more information about different account types, see [Managing Your Amazon Chime Accounts](https://docs.aws.amazon.com/chime/latest/ag/manage-chime-account.html) in the _Amazon Chime Administration Guide_.

Users suspended from a `Team` account are disassociated from the account,but they can continue to use Amazon Chime as free users. To remove the suspension from suspended `Team` account users, invite them to the `Team` account again. You can use the InviteUsers action to do so.

Users suspended from an `EnterpriseLWA` account are immediately signed out of Amazon Chime and can no longer sign in. To remove the suspension from suspended `EnterpriseLWA` account users, use the BatchUnsuspendUser action.

To sign out users without suspending them, use the LogoutUser action.

## Path parameters

- `accountId` string, required

## Query parameters

- `operation` 'suspend', required

## Request body

- object
  - `UserIdList` NonEmptyString[], required — The request containing the user IDs to suspend.

## Response `200`

Success

- BatchSuspendUserResponse
  - `UserErrors` UserError[] — If the <a>BatchSuspendUser</a> action fails for one or more of the user IDs in the request, a list of the user IDs is returned, along with error codes and error messages.
    - `UserId` string — The user ID for which the action failed.
    - `ErrorCode` 'BadRequest' | 'Conflict' | 'Forbidden' | 'NotFound' | 'PreconditionFailed' | 'ResourceLimitExceeded' | 'ServiceFailure' | 'AccessDenied' | 'ServiceUnavailable' | 'Throttled' | 'Throttling' | 'Unauthorized' | 'Unprocessable' | 'VoiceConnectorGroupAssociationsExist' | 'PhoneNumberAssociationsExist' — The error code.
    - `ErrorMessage` string — The error message.

## Other responses

- `480` — UnauthorizedClientException
- `481` — NotFoundException
- `482` — ForbiddenException
- `483` — BadRequestException
- `484` — ThrottledClientException
- `485` — ServiceUnavailableException
- `486` — ServiceFailureException

---

[API](https://skmtc.net/aws/apis/chime.md) · [All operations](https://skmtc.net/aws/apis/chime/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/chime/revisions/40da18840201/schema)