amazon-chime — quality + safety report

---
name: amazon-chime
description: "Amazon Chime API skill. Use when working with Amazon Chime for accounts, voice-connectors, voice-connector-groups. Covers 191 endpoints."
version: 1.0.0
generator: lapsh
---

# Amazon Chime
API version: 2018-05-01

## Auth
AWS SigV4

## Base URL
Not specified.

## Setup
1. Configure auth: AWS SigV4
2. GET /settings -- verify access
3. POST /accounts/{accountId}/users/{userId}?operation=associate-phone-number -- create first users

## Endpoints

191 endpoints across 25 groups. See references/api-spec.lap for full details.

### accounts
| Method | Path | Description |
|--------|------|-------------|
| POST | /accounts/{accountId}/users/{userId}?operation=associate-phone-number | Associates a phone number with the specified Amazon Chime user. |
| POST | /accounts/{accountId}?operation=associate-signin-delegate-groups | Associates the specified sign-in delegate groups with the specified Amazon Chime account. |
| POST | /accounts/{accountId}/rooms/{roomId}/memberships?operation=batch-create | Adds up to 50 members to a chat room in an Amazon Chime Enterprise account. Members can be users or bots. The member role designates whether the member is a chat room administrator or a general chat room member. |
| 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 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. |
| POST | /accounts/{accountId}/users?operation=unsuspend | Removes the suspension from up to 50 previously suspended users for the specified Amazon Chime EnterpriseLWA account. Only users on EnterpriseLWA accounts can be unsuspended using this action. For more information about different account types, see  Managing Your Amazon Chime Accounts  in the account types, in the Amazon Chime Administration Guide.  Previously suspended users who are unsuspended using this action are returned to Registered status. Users who are not previously suspended are ignored. |
| POST | /accounts/{accountId}/users | Updates user details within the UpdateUserRequestItem object for up to 20 users for the specified Amazon Chime account. Currently, only LicenseType updates are supported for this action. |
| POST | /accounts | Creates an Amazon Chime account under the administrator's AWS account. Only Team account types are currently supported for this action. For more information about different account types, see Managing Your Amazon Chime Accounts in the Amazon Chime Administration Guide. |
| POST | /accounts/{accountId}/bots | Creates a bot for an Amazon Chime Enterprise account. |
| POST | /accounts/{accountId}/rooms | Creates a chat room for the specified Amazon Chime Enterprise account. |
| POST | /accounts/{accountId}/rooms/{roomId}/memberships | Adds a member to a chat room in an Amazon Chime Enterprise account. A member can be either a user or a bot. The member role designates whether the member is a chat room administrator or a general chat room member. |
| POST | /accounts/{accountId}/users?operation=create | Creates a user under the specified Amazon Chime account. |
| DELETE | /accounts/{accountId} | Deletes the specified Amazon Chime account. You must suspend all users before deleting Team account. You can use the BatchSuspendUser action to dodo. For EnterpriseLWA and EnterpriseAD accounts, you must release the claimed domains for your Amazon Chime account before deletion. As soon as you release the domain, all users under that account are suspended. Deleted accounts appear in your Disabled accounts list for 90 days. To restore deleted account from your Disabled accounts list, you must contact AWS Support. After 90 days, deleted accounts are permanently removed from your Disabled accounts list. |
| DELETE | /accounts/{accountId}/bots/{botId}/events-configuration | Deletes the events configuration that allows a bot to receive outgoing events. |
| DELETE | /accounts/{accountId}/rooms/{roomId} | Deletes a chat room in an Amazon Chime Enterprise account. |
| DELETE | /accounts/{accountId}/rooms/{roomId}/memberships/{memberId} | Removes a member from a chat room in an Amazon Chime Enterprise account. |
| POST | /accounts/{accountId}/users/{userId}?operation=disassociate-phone-number | Disassociates the primary provisioned phone number from the specified Amazon Chime user. |
| POST | /accounts/{accountId}?operation=disassociate-signin-delegate-groups | Disassociates the specified sign-in delegate groups from the specified Amazon Chime account. |
| GET | /accounts/{accountId} | Retrieves details for the specified Amazon Chime account, such as account type and supported licenses. |
| GET | /accounts/{accountId}/settings | Retrieves account settings for the specified Amazon Chime account ID, such as remote control and dialout settings. For more information about these settings, see Use the Policies Page in the Amazon Chime Administration Guide. |
| GET | /accounts/{accountId}/bots/{botId} | Retrieves details for the specified bot, such as bot email address, bot type, status, and display name. |
| GET | /accounts/{accountId}/bots/{botId}/events-configuration | Gets details for an events configuration that allows a bot to receive outgoing events, such as an HTTPS endpoint or Lambda function ARN. |
| GET | /accounts/{accountId}/retention-settings | Gets the retention settings for the specified Amazon Chime Enterprise account. For more information about retention settings, see Managing Chat Retention Policies in the Amazon Chime Administration Guide. |
| GET | /accounts/{accountId}/rooms/{roomId} | Retrieves room details, such as the room name, for a room in an Amazon Chime Enterprise account. |
| GET | /accounts/{accountId}/users/{userId} | Retrieves details for the specified user ID, such as primary email address, license type,and personal meeting PIN.  To retrieve user details with an email address instead of a user ID, use the ListUsers action, and then filter by email address. |
| GET | /accounts/{accountId}/users/{userId}/settings | Retrieves settings for the specified user ID, such as any associated phone number settings. |
| POST | /accounts/{accountId}/users?operation=add | Sends email to a maximum of 50 users, inviting them to the specified Amazon Chime Team account. Only Team account types are currently supported for this action. |
| GET | /accounts | Lists the Amazon Chime accounts under the administrator's AWS account. You can filter accounts by account name prefix. To find out which Amazon Chime account a user belongs to, you can filter by the user's email address, which returns one account result. |
| GET | /accounts/{accountId}/bots | Lists the bots associated with the administrator's Amazon Chime Enterprise account ID. |
| GET | /accounts/{accountId}/rooms/{roomId}/memberships | Lists the membership details for the specified room in an Amazon Chime Enterprise account, such as the members' IDs, email addresses, and names. |
| GET | /accounts/{accountId}/rooms | Lists the room details for the specified Amazon Chime Enterprise account. Optionally, filter the results by a member ID (user ID or bot ID) to see a list of rooms that the member belongs to. |
| GET | /accounts/{accountId}/users | Lists the users that belong to the specified Amazon Chime account. You can specify an email address to list only the user that the email address belongs to. |
| POST | /accounts/{accountId}/users/{userId}?operation=logout | Logs out the specified user from all of the devices they are currently logged into. |
| PUT | /accounts/{accountId}/bots/{botId}/events-configuration | Creates an events configuration that allows a bot to receive outgoing events sent by Amazon Chime. Choose either an HTTPS endpoint or a Lambda function ARN. For more information, see Bot. |
| PUT | /accounts/{accountId}/retention-settings | Puts retention settings for the specified Amazon Chime Enterprise account. We recommend using AWS CloudTrail to monitor usage of this API for your account. For more information, see Logging Amazon Chime API Calls with AWS CloudTrail in the Amazon Chime Administration Guide.  To turn off existing retention settings, remove the number of days from the corresponding RetentionDays field in the RetentionSettings object. For more information about retention settings, see Managing Chat Retention Policies in the Amazon Chime Administration Guide. |
| POST | /accounts/{accountId}/conversations/{conversationId}/messages/{messageId}?operation=redact | Redacts the specified message from the specified Amazon Chime conversation. |
| POST | /accounts/{accountId}/rooms/{roomId}/messages/{messageId}?operation=redact | Redacts the specified message from the specified Amazon Chime channel. |
| POST | /accounts/{accountId}/bots/{botId}?operation=regenerate-security-token | Regenerates the security token for a bot. |
| POST | /accounts/{accountId}/users/{userId}?operation=reset-personal-pin | Resets the personal meeting PIN for the specified user on an Amazon Chime account. Returns the User object with the updated personal meeting PIN. |
| POST | /accounts/{accountId} | Updates account details for the specified Amazon Chime account. Currently, only account name and default license updates are supported for this action. |
| PUT | /accounts/{accountId}/settings | Updates the settings for the specified Amazon Chime account. You can update settings for remote control of shared screens, or for the dial-out option. For more information about these settings, see Use the Policies Page in the Amazon Chime Administration Guide. |
| POST | /accounts/{accountId}/bots/{botId} | Updates the status of the specified bot, such as starting or stopping the bot from running in your Amazon Chime Enterprise account. |
| POST | /accounts/{accountId}/rooms/{roomId} | Updates room details, such as the room name, for a room in an Amazon Chime Enterprise account. |
| POST | /accounts/{accountId}/rooms/{roomId}/memberships/{memberId} | Updates room membership details, such as the member role, for a room in an Amazon Chime Enterprise account. The member role designates whether the member is a chat room administrator or a general chat room member. The member role can be updated only for user IDs. |
| POST | /accounts/{accountId}/users/{userId} | Updates user details for a specified user ID. Currently, only LicenseType updates are supported for this action. |
| PUT | /accounts/{accountId}/users/{userId}/settings | Updates the settings for the specified user, such as phone number settings. |

### voice-connectors
| Method | Path | Description |
|--------|------|-------------|
| POST | /voice-connectors/{voiceConnectorId}?operation=associate-phone-numbers | Associates phone numbers with the specified Amazon Chime Voice Connector.   This API is is no longer supported and will not be updated. We recommend using the latest version, AssociatePhoneNumbersWithVoiceConnector, in the Amazon Chime SDK. Using the latest version requires migrating to a dedicated namespace. For more information, refer to Migrating from the Amazon Chime namespace in the Amazon Chime SDK Developer Guide. |
| POST | /voice-connectors/{voiceConnectorId}/proxy-sessions | Creates a proxy session on the specified Amazon Chime Voice Connector for the specified participant phone numbers.   This API is is no longer supported and will no

… (truncated)