# Actions
<a name="API_Operations"></a>

The following actions are supported:
+  [AssociateToConfiguration](API_AssociateToConfiguration.md) 
+  [CreateChimeWebhookConfiguration](API_CreateChimeWebhookConfiguration.md) 
+  [CreateCustomAction](API_CreateCustomAction.md) 
+  [CreateMicrosoftTeamsChannelConfiguration](API_CreateMicrosoftTeamsChannelConfiguration.md) 
+  [CreateSlackChannelConfiguration](API_CreateSlackChannelConfiguration.md) 
+  [DeleteChimeWebhookConfiguration](API_DeleteChimeWebhookConfiguration.md) 
+  [DeleteCustomAction](API_DeleteCustomAction.md) 
+  [DeleteMicrosoftTeamsChannelConfiguration](API_DeleteMicrosoftTeamsChannelConfiguration.md) 
+  [DeleteMicrosoftTeamsConfiguredTeam](API_DeleteMicrosoftTeamsConfiguredTeam.md) 
+  [DeleteMicrosoftTeamsUserIdentity](API_DeleteMicrosoftTeamsUserIdentity.md) 
+  [DeleteSlackChannelConfiguration](API_DeleteSlackChannelConfiguration.md) 
+  [DeleteSlackUserIdentity](API_DeleteSlackUserIdentity.md) 
+  [DeleteSlackWorkspaceAuthorization](API_DeleteSlackWorkspaceAuthorization.md) 
+  [DescribeChimeWebhookConfigurations](API_DescribeChimeWebhookConfigurations.md) 
+  [DescribeSlackChannelConfigurations](API_DescribeSlackChannelConfigurations.md) 
+  [DescribeSlackUserIdentities](API_DescribeSlackUserIdentities.md) 
+  [DescribeSlackWorkspaces](API_DescribeSlackWorkspaces.md) 
+  [DisassociateFromConfiguration](API_DisassociateFromConfiguration.md) 
+  [GetAccountPreferences](API_GetAccountPreferences.md) 
+  [GetCustomAction](API_GetCustomAction.md) 
+  [GetMicrosoftTeamsChannelConfiguration](API_GetMicrosoftTeamsChannelConfiguration.md) 
+  [ListAssociations](API_ListAssociations.md) 
+  [ListCustomActions](API_ListCustomActions.md) 
+  [ListMicrosoftTeamsChannelConfigurations](API_ListMicrosoftTeamsChannelConfigurations.md) 
+  [ListMicrosoftTeamsConfiguredTeams](API_ListMicrosoftTeamsConfiguredTeams.md) 
+  [ListMicrosoftTeamsUserIdentities](API_ListMicrosoftTeamsUserIdentities.md) 
+  [ListTagsForResource](API_ListTagsForResource.md) 
+  [TagResource](API_TagResource.md) 
+  [UntagResource](API_UntagResource.md) 
+  [UpdateAccountPreferences](API_UpdateAccountPreferences.md) 
+  [UpdateChimeWebhookConfiguration](API_UpdateChimeWebhookConfiguration.md) 
+  [UpdateCustomAction](API_UpdateCustomAction.md) 
+  [UpdateMicrosoftTeamsChannelConfiguration](API_UpdateMicrosoftTeamsChannelConfiguration.md) 
+  [UpdateSlackChannelConfiguration](API_UpdateSlackChannelConfiguration.md) 

# AssociateToConfiguration
<a name="API_AssociateToConfiguration"></a>

Links a resource (for example, a custom action) to a channel configuration.

## Request Syntax
<a name="API_AssociateToConfiguration_RequestSyntax"></a>

```
POST /associate-to-configuration HTTP/1.1
Content-type: application/json

{
   "ChatConfiguration": "string",
   "Resource": "string"
}
```

## URI Request Parameters
<a name="API_AssociateToConfiguration_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_AssociateToConfiguration_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [ChatConfiguration](#API_AssociateToConfiguration_RequestSyntax) **   <a name="qdevinchatapps-AssociateToConfiguration-request-ChatConfiguration"></a>
The channel configuration to associate with the resource.  
Type: String  
Length Constraints: Minimum length of 19. Maximum length of 1169.  
Pattern: `arn:aws:(wheatley|chatbot):[A-Za-z0-9_/.-]{0,63}:[A-Za-z0-9_/.-]{0,63}:[A-Za-z0-9][A-Za-z0-9:_/+=,@.-]{0,1023}`   
Required: Yes

 ** [Resource](#API_AssociateToConfiguration_RequestSyntax) **   <a name="qdevinchatapps-AssociateToConfiguration-request-Resource"></a>
The resource Amazon Resource Name (ARN) to link.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 1011.  
Pattern: `arn:aws:chatbot:[A-Za-z0-9_/.-]{0,63}:[A-Za-z0-9_/.-]{0,63}:custom-action/[a-zA-Z0-9_-]{1,64}`   
Required: Yes

## Response Syntax
<a name="API_AssociateToConfiguration_ResponseSyntax"></a>

```
HTTP/1.1 201
```

## Response Elements
<a name="API_AssociateToConfiguration_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 201 response with an empty HTTP body.

## Errors
<a name="API_AssociateToConfiguration_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InternalServiceError **   
Unexpected error during processing of request.  
HTTP Status Code: 500

 ** InvalidRequestException **   
Your request input doesn't meet the constraints required by Amazon Q Developer.  
HTTP Status Code: 400

 ** UnauthorizedException **   
The request was rejected because it doesn't have valid credentials for the target resource.  
HTTP Status Code: 403

## See Also
<a name="API_AssociateToConfiguration_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/chatbot-2017-10-11/AssociateToConfiguration) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/chatbot-2017-10-11/AssociateToConfiguration) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/chatbot-2017-10-11/AssociateToConfiguration) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/chatbot-2017-10-11/AssociateToConfiguration) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/chatbot-2017-10-11/AssociateToConfiguration) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/chatbot-2017-10-11/AssociateToConfiguration) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/chatbot-2017-10-11/AssociateToConfiguration) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/chatbot-2017-10-11/AssociateToConfiguration) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/chatbot-2017-10-11/AssociateToConfiguration) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/chatbot-2017-10-11/AssociateToConfiguration) 

# CreateChimeWebhookConfiguration
<a name="API_CreateChimeWebhookConfiguration"></a>

Creates an Amazon Q Developer configuration for Amazon Chime.

## Request Syntax
<a name="API_CreateChimeWebhookConfiguration_RequestSyntax"></a>

```
POST /create-chime-webhook-configuration HTTP/1.1
Content-type: application/json

{
   "ConfigurationName": "string",
   "IamRoleArn": "string",
   "LoggingLevel": "string",
   "SnsTopicArns": [ "string" ],
   "Tags": [ 
      { 
         "TagKey": "string",
         "TagValue": "string"
      }
   ],
   "WebhookDescription": "string",
   "WebhookUrl": "string"
}
```

## URI Request Parameters
<a name="API_CreateChimeWebhookConfiguration_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_CreateChimeWebhookConfiguration_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [ConfigurationName](#API_CreateChimeWebhookConfiguration_RequestSyntax) **   <a name="qdevinchatapps-CreateChimeWebhookConfiguration-request-ConfigurationName"></a>
The name of the configuration.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 128.  
Pattern: `[A-Za-z0-9-_]+`   
Required: Yes

 ** [IamRoleArn](#API_CreateChimeWebhookConfiguration_RequestSyntax) **   <a name="qdevinchatapps-CreateChimeWebhookConfiguration-request-IamRoleArn"></a>
A user-defined role that Amazon Q Developer assumes. This is not the service-linked role.  
For more information, see [IAM policies for Amazon Q Developer](https://docs.aws.amazon.com/chatbot/latest/adminguide/chatbot-iam-policies.html) in the * Amazon Q Developer Administrator Guide*.   
Type: String  
Length Constraints: Minimum length of 12. Maximum length of 1224.  
Pattern: `arn:aws:[A-Za-z0-9][A-Za-z0-9_/.-]{0,62}:[A-Za-z0-9_/.-]{0,63}:[A-Za-z0-9_/.-]{0,63}:[A-Za-z0-9][A-Za-z0-9:_/+=,@.-]{0,1023}`   
Required: Yes

 ** [LoggingLevel](#API_CreateChimeWebhookConfiguration_RequestSyntax) **   <a name="qdevinchatapps-CreateChimeWebhookConfiguration-request-LoggingLevel"></a>
Logging levels include `ERROR`, `INFO`, or `NONE`.  
Type: String  
Length Constraints: Minimum length of 4. Maximum length of 5.  
Pattern: `(ERROR|INFO|NONE)`   
Required: No

 ** [SnsTopicArns](#API_CreateChimeWebhookConfiguration_RequestSyntax) **   <a name="qdevinchatapps-CreateChimeWebhookConfiguration-request-SnsTopicArns"></a>
The Amazon Resource Names (ARNs) of the SNS topics that deliver notifications to Amazon Q Developer.  
Type: Array of strings  
Length Constraints: Minimum length of 12. Maximum length of 1224.  
Pattern: `arn:aws:[A-Za-z0-9][A-Za-z0-9_/.-]{0,62}:[A-Za-z0-9_/.-]{0,63}:[A-Za-z0-9_/.-]{0,63}:[A-Za-z0-9][A-Za-z0-9:_/+=,@.-]{0,1023}`   
Required: Yes

 ** [Tags](#API_CreateChimeWebhookConfiguration_RequestSyntax) **   <a name="qdevinchatapps-CreateChimeWebhookConfiguration-request-Tags"></a>
A map of tags assigned to a resource. A tag is a string-to-string map of key-value pairs.  
Type: Array of [Tag](API_Tag.md) objects  
Required: No

 ** [WebhookDescription](#API_CreateChimeWebhookConfiguration_RequestSyntax) **   <a name="qdevinchatapps-CreateChimeWebhookConfiguration-request-WebhookDescription"></a>
A description of the webhook. We recommend using the convention `RoomName/WebhookName`.  
For more information, see [Tutorial: Get started with Amazon Chime](https://docs.aws.amazon.com/chatbot/latest/adminguide/chime-setup.html) in the * Amazon Q Developer Administrator Guide*.   
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 255.  
Required: Yes

 ** [WebhookUrl](#API_CreateChimeWebhookConfiguration_RequestSyntax) **   <a name="qdevinchatapps-CreateChimeWebhookConfiguration-request-WebhookUrl"></a>
The URL for the Amazon Chime webhook.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 255.  
Pattern: `https://hooks\.chime\.aws/incomingwebhooks/[A-Za-z0-9\-]+?\?token=[A-Za-z0-9\-]+`   
Required: Yes

## Response Syntax
<a name="API_CreateChimeWebhookConfiguration_ResponseSyntax"></a>

```
HTTP/1.1 201
Content-type: application/json

{
   "WebhookConfiguration": { 
      "ChatConfigurationArn": "string",
      "ConfigurationName": "string",
      "IamRoleArn": "string",
      "LoggingLevel": "string",
      "SnsTopicArns": [ "string" ],
      "State": "string",
      "StateReason": "string",
      "Tags": [ 
         { 
            "TagKey": "string",
            "TagValue": "string"
         }
      ],
      "WebhookDescription": "string"
   }
}
```

## Response Elements
<a name="API_CreateChimeWebhookConfiguration_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 201 response.

The following data is returned in JSON format by the service.

 ** [WebhookConfiguration](#API_CreateChimeWebhookConfiguration_ResponseSyntax) **   <a name="qdevinchatapps-CreateChimeWebhookConfiguration-response-WebhookConfiguration"></a>
An Amazon Chime webhook configuration.  
Type: [ChimeWebhookConfiguration](API_ChimeWebhookConfiguration.md) object

## Errors
<a name="API_CreateChimeWebhookConfiguration_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** ConflictException **   
There was an issue processing your request.  
HTTP Status Code: 409

 ** CreateChimeWebhookConfigurationException **   
We can’t process your request right now because of a server issue. Try again later.  
HTTP Status Code: 500

 ** InvalidParameterException **   
Your request input doesn't meet the constraints required by Amazon Q Developer.  
HTTP Status Code: 400

 ** InvalidRequestException **   
Your request input doesn't meet the constraints required by Amazon Q Developer.  
HTTP Status Code: 400

 ** LimitExceededException **   
You have exceeded a service limit for Amazon Q Developer.  
HTTP Status Code: 403

## See Also
<a name="API_CreateChimeWebhookConfiguration_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/chatbot-2017-10-11/CreateChimeWebhookConfiguration) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/chatbot-2017-10-11/CreateChimeWebhookConfiguration) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/chatbot-2017-10-11/CreateChimeWebhookConfiguration) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/chatbot-2017-10-11/CreateChimeWebhookConfiguration) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/chatbot-2017-10-11/CreateChimeWebhookConfiguration) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/chatbot-2017-10-11/CreateChimeWebhookConfiguration) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/chatbot-2017-10-11/CreateChimeWebhookConfiguration) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/chatbot-2017-10-11/CreateChimeWebhookConfiguration) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/chatbot-2017-10-11/CreateChimeWebhookConfiguration) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/chatbot-2017-10-11/CreateChimeWebhookConfiguration) 

# CreateCustomAction
<a name="API_CreateCustomAction"></a>

Creates a custom action that can be invoked as an alias or as a button on a notification.

## Request Syntax
<a name="API_CreateCustomAction_RequestSyntax"></a>

```
POST /create-custom-action HTTP/1.1
Content-type: application/json

{
   "ActionName": "string",
   "AliasName": "string",
   "Attachments": [ 
      { 
         "ButtonText": "string",
         "Criteria": [ 
            { 
               "Operator": "string",
               "Value": "string",
               "VariableName": "string"
            }
         ],
         "NotificationType": "string",
         "Variables": { 
            "string" : "string" 
         }
      }
   ],
   "ClientToken": "string",
   "Definition": { 
      "CommandText": "string"
   },
   "Tags": [ 
      { 
         "TagKey": "string",
         "TagValue": "string"
      }
   ]
}
```

## URI Request Parameters
<a name="API_CreateCustomAction_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_CreateCustomAction_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [ActionName](#API_CreateCustomAction_RequestSyntax) **   <a name="qdevinchatapps-CreateCustomAction-request-ActionName"></a>
The name of the custom action. This name is included in the Amazon Resource Name (ARN).  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 64.  
Pattern: `[a-zA-Z0-9_-]{1,64}`   
Required: Yes

 ** [AliasName](#API_CreateCustomAction_RequestSyntax) **   <a name="qdevinchatapps-CreateCustomAction-request-AliasName"></a>
The name used to invoke this action in a chat channel. For example, `@Amazon Q run my-alias`.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 30.  
Pattern: `[A-Za-z0-9-_]+`   
Required: No

 ** [Attachments](#API_CreateCustomAction_RequestSyntax) **   <a name="qdevinchatapps-CreateCustomAction-request-Attachments"></a>
Defines when this custom action button should be attached to a notification.  
Type: Array of [CustomActionAttachment](API_CustomActionAttachment.md) objects  
Required: No

 ** [ClientToken](#API_CreateCustomAction_RequestSyntax) **   <a name="qdevinchatapps-CreateCustomAction-request-ClientToken"></a>
A unique, case-sensitive identifier that you provide to ensure the idempotency of the request. Idempotency ensures that an API request completes only once. With an idempotent request, if the original request completes successfully, subsequent retries with the same client token returns the result from the original successful request.  
If you do not specify a client token, one is automatically generated by the SDK.  
Type: String  
Length Constraints: Minimum length of 33. Maximum length of 126.  
Pattern: `[\x21-\x7F]+`   
Required: No

 ** [Definition](#API_CreateCustomAction_RequestSyntax) **   <a name="qdevinchatapps-CreateCustomAction-request-Definition"></a>
The definition of the command to run when invoked as an alias or as an action button.  
Type: [CustomActionDefinition](API_CustomActionDefinition.md) object  
Required: Yes

 ** [Tags](#API_CreateCustomAction_RequestSyntax) **   <a name="qdevinchatapps-CreateCustomAction-request-Tags"></a>
A map of tags assigned to a resource. A tag is a string-to-string map of key-value pairs.  
Type: Array of [Tag](API_Tag.md) objects  
Array Members: Minimum number of 0 items. Maximum number of 200 items.  
Required: No

## Response Syntax
<a name="API_CreateCustomAction_ResponseSyntax"></a>

```
HTTP/1.1 201
Content-type: application/json

{
   "CustomActionArn": "string"
}
```

## Response Elements
<a name="API_CreateCustomAction_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 201 response.

The following data is returned in JSON format by the service.

 ** [CustomActionArn](#API_CreateCustomAction_ResponseSyntax) **   <a name="qdevinchatapps-CreateCustomAction-response-CustomActionArn"></a>
The fully defined ARN of the custom action.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 1011.  
Pattern: `arn:aws:chatbot::[0-9]{12}:custom-action/[a-zA-Z0-9_-]{1,64}` 

## Errors
<a name="API_CreateCustomAction_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** ConflictException **   
There was an issue processing your request.  
HTTP Status Code: 409

 ** InternalServiceError **   
Unexpected error during processing of request.  
HTTP Status Code: 500

 ** InvalidRequestException **   
Your request input doesn't meet the constraints required by Amazon Q Developer.  
HTTP Status Code: 400

 ** LimitExceededException **   
You have exceeded a service limit for Amazon Q Developer.  
HTTP Status Code: 403

 ** UnauthorizedException **   
The request was rejected because it doesn't have valid credentials for the target resource.  
HTTP Status Code: 403

## See Also
<a name="API_CreateCustomAction_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/chatbot-2017-10-11/CreateCustomAction) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/chatbot-2017-10-11/CreateCustomAction) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/chatbot-2017-10-11/CreateCustomAction) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/chatbot-2017-10-11/CreateCustomAction) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/chatbot-2017-10-11/CreateCustomAction) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/chatbot-2017-10-11/CreateCustomAction) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/chatbot-2017-10-11/CreateCustomAction) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/chatbot-2017-10-11/CreateCustomAction) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/chatbot-2017-10-11/CreateCustomAction) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/chatbot-2017-10-11/CreateCustomAction) 

# CreateMicrosoftTeamsChannelConfiguration
<a name="API_CreateMicrosoftTeamsChannelConfiguration"></a>

Creates an Amazon Q Developer configuration for Microsoft Teams.

## Request Syntax
<a name="API_CreateMicrosoftTeamsChannelConfiguration_RequestSyntax"></a>

```
POST /create-ms-teams-channel-configuration HTTP/1.1
Content-type: application/json

{
   "ChannelId": "string",
   "ChannelName": "string",
   "ConfigurationName": "string",
   "GuardrailPolicyArns": [ "string" ],
   "IamRoleArn": "string",
   "LoggingLevel": "string",
   "SnsTopicArns": [ "string" ],
   "Tags": [ 
      { 
         "TagKey": "string",
         "TagValue": "string"
      }
   ],
   "TeamId": "string",
   "TeamName": "string",
   "TenantId": "string",
   "UserAuthorizationRequired": boolean
}
```

## URI Request Parameters
<a name="API_CreateMicrosoftTeamsChannelConfiguration_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_CreateMicrosoftTeamsChannelConfiguration_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [ChannelId](#API_CreateMicrosoftTeamsChannelConfiguration_RequestSyntax) **   <a name="qdevinchatapps-CreateMicrosoftTeamsChannelConfiguration-request-ChannelId"></a>
The ID of the Microsoft Teams channel.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 255.  
Pattern: `([a-zA-Z0-9-_=+\/.,])*%3[aA]([a-zA-Z0-9-_=+\/.,])*%40([a-zA-Z0-9-_=+\/.,])*`   
Required: Yes

 ** [ChannelName](#API_CreateMicrosoftTeamsChannelConfiguration_RequestSyntax) **   <a name="qdevinchatapps-CreateMicrosoftTeamsChannelConfiguration-request-ChannelName"></a>
The name of the Microsoft Teams channel.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 1000.  
Pattern: `(.*)`   
Required: No

 ** [ConfigurationName](#API_CreateMicrosoftTeamsChannelConfiguration_RequestSyntax) **   <a name="qdevinchatapps-CreateMicrosoftTeamsChannelConfiguration-request-ConfigurationName"></a>
The name of the configuration.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 128.  
Pattern: `[A-Za-z0-9-_]+`   
Required: Yes

 ** [GuardrailPolicyArns](#API_CreateMicrosoftTeamsChannelConfiguration_RequestSyntax) **   <a name="qdevinchatapps-CreateMicrosoftTeamsChannelConfiguration-request-GuardrailPolicyArns"></a>
The list of IAM policy ARNs that are applied as channel guardrails. The AWS managed `AdministratorAccess` policy is applied by default if this is not set.   
Type: Array of strings  
Length Constraints: Minimum length of 11. Maximum length of 1163.  
Pattern: `(^$|(?!.*\/aws-service-role\/.*)arn:aws:iam:[A-Za-z0-9_\/.-]{0,63}:[A-Za-z0-9_\/.-]{0,63}:[A-Za-z0-9][A-Za-z0-9:_\/+=,@.-]{0,1023})`   
Required: No

 ** [IamRoleArn](#API_CreateMicrosoftTeamsChannelConfiguration_RequestSyntax) **   <a name="qdevinchatapps-CreateMicrosoftTeamsChannelConfiguration-request-IamRoleArn"></a>
A user-defined role that Amazon Q Developer assumes. This is not the service-linked role.  
For more information, see [IAM policies for Amazon Q Developer](https://docs.aws.amazon.com/chatbot/latest/adminguide/chatbot-iam-policies.html) in the * Amazon Q Developer Administrator Guide*.   
Type: String  
Length Constraints: Minimum length of 12. Maximum length of 1224.  
Pattern: `arn:aws:[A-Za-z0-9][A-Za-z0-9_/.-]{0,62}:[A-Za-z0-9_/.-]{0,63}:[A-Za-z0-9_/.-]{0,63}:[A-Za-z0-9][A-Za-z0-9:_/+=,@.-]{0,1023}`   
Required: Yes

 ** [LoggingLevel](#API_CreateMicrosoftTeamsChannelConfiguration_RequestSyntax) **   <a name="qdevinchatapps-CreateMicrosoftTeamsChannelConfiguration-request-LoggingLevel"></a>
Logging levels include `ERROR`, `INFO`, or `NONE`.  
Type: String  
Length Constraints: Minimum length of 4. Maximum length of 5.  
Pattern: `(ERROR|INFO|NONE)`   
Required: No

 ** [SnsTopicArns](#API_CreateMicrosoftTeamsChannelConfiguration_RequestSyntax) **   <a name="qdevinchatapps-CreateMicrosoftTeamsChannelConfiguration-request-SnsTopicArns"></a>
The Amazon Resource Names (ARNs) of the SNS topics that deliver notifications to Amazon Q Developer.  
Type: Array of strings  
Length Constraints: Minimum length of 12. Maximum length of 1224.  
Pattern: `arn:aws:[A-Za-z0-9][A-Za-z0-9_/.-]{0,62}:[A-Za-z0-9_/.-]{0,63}:[A-Za-z0-9_/.-]{0,63}:[A-Za-z0-9][A-Za-z0-9:_/+=,@.-]{0,1023}`   
Required: No

 ** [Tags](#API_CreateMicrosoftTeamsChannelConfiguration_RequestSyntax) **   <a name="qdevinchatapps-CreateMicrosoftTeamsChannelConfiguration-request-Tags"></a>
A map of tags assigned to a resource. A tag is a string-to-string map of key-value pairs.  
Type: Array of [Tag](API_Tag.md) objects  
Required: No

 ** [TeamId](#API_CreateMicrosoftTeamsChannelConfiguration_RequestSyntax) **   <a name="qdevinchatapps-CreateMicrosoftTeamsChannelConfiguration-request-TeamId"></a>
 The ID of the Microsoft Teams authorized with Amazon Q Developer.  
To get the team ID, you must perform the initial authorization flow with Microsoft Teams in the Amazon Q Developer console. Then you can copy and paste the team ID from the console. For more information, see [Step 1: Configure a Microsoft Teams client](https://docs.aws.amazon.com/chatbot/latest/adminguide/teams-setup.html#teams-client-setup) in the * Amazon Q Developer Administrator Guide*.   
Type: String  
Length Constraints: Fixed length of 36.  
Pattern: `[0-9A-Fa-f]{8}(?:-[0-9A-Fa-f]{4}){3}-[0-9A-Fa-f]{12}`   
Required: Yes

 ** [TeamName](#API_CreateMicrosoftTeamsChannelConfiguration_RequestSyntax) **   <a name="qdevinchatapps-CreateMicrosoftTeamsChannelConfiguration-request-TeamName"></a>
The name of the Microsoft Teams Team.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 255.  
Pattern: `(.*)`   
Required: No

 ** [TenantId](#API_CreateMicrosoftTeamsChannelConfiguration_RequestSyntax) **   <a name="qdevinchatapps-CreateMicrosoftTeamsChannelConfiguration-request-TenantId"></a>
The ID of the Microsoft Teams tenant.  
Type: String  
Length Constraints: Fixed length of 36.  
Pattern: `[0-9A-Fa-f]{8}(?:-[0-9A-Fa-f]{4}){3}-[0-9A-Fa-f]{12}`   
Required: Yes

 ** [UserAuthorizationRequired](#API_CreateMicrosoftTeamsChannelConfiguration_RequestSyntax) **   <a name="qdevinchatapps-CreateMicrosoftTeamsChannelConfiguration-request-UserAuthorizationRequired"></a>
Enables use of a user role requirement in your chat configuration.  
Type: Boolean  
Required: No

## Response Syntax
<a name="API_CreateMicrosoftTeamsChannelConfiguration_ResponseSyntax"></a>

```
HTTP/1.1 201
Content-type: application/json

{
   "ChannelConfiguration": { 
      "ChannelId": "string",
      "ChannelName": "string",
      "ChatConfigurationArn": "string",
      "ConfigurationName": "string",
      "GuardrailPolicyArns": [ "string" ],
      "IamRoleArn": "string",
      "LoggingLevel": "string",
      "SnsTopicArns": [ "string" ],
      "State": "string",
      "StateReason": "string",
      "Tags": [ 
         { 
            "TagKey": "string",
            "TagValue": "string"
         }
      ],
      "TeamId": "string",
      "TeamName": "string",
      "TenantId": "string",
      "UserAuthorizationRequired": boolean
   }
}
```

## Response Elements
<a name="API_CreateMicrosoftTeamsChannelConfiguration_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 201 response.

The following data is returned in JSON format by the service.

 ** [ChannelConfiguration](#API_CreateMicrosoftTeamsChannelConfiguration_ResponseSyntax) **   <a name="qdevinchatapps-CreateMicrosoftTeamsChannelConfiguration-response-ChannelConfiguration"></a>
The configuration for a Microsoft Teams channel configured with Amazon Q Developer.  
Type: [TeamsChannelConfiguration](API_TeamsChannelConfiguration.md) object

## Errors
<a name="API_CreateMicrosoftTeamsChannelConfiguration_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** ConflictException **   
There was an issue processing your request.  
HTTP Status Code: 409

 ** CreateTeamsChannelConfigurationException **   
We can’t process your request right now because of a server issue. Try again later.  
HTTP Status Code: 500

 ** InvalidParameterException **   
Your request input doesn't meet the constraints required by Amazon Q Developer.  
HTTP Status Code: 400

 ** InvalidRequestException **   
Your request input doesn't meet the constraints required by Amazon Q Developer.  
HTTP Status Code: 400

 ** LimitExceededException **   
You have exceeded a service limit for Amazon Q Developer.  
HTTP Status Code: 403

## See Also
<a name="API_CreateMicrosoftTeamsChannelConfiguration_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/chatbot-2017-10-11/CreateMicrosoftTeamsChannelConfiguration) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/chatbot-2017-10-11/CreateMicrosoftTeamsChannelConfiguration) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/chatbot-2017-10-11/CreateMicrosoftTeamsChannelConfiguration) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/chatbot-2017-10-11/CreateMicrosoftTeamsChannelConfiguration) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/chatbot-2017-10-11/CreateMicrosoftTeamsChannelConfiguration) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/chatbot-2017-10-11/CreateMicrosoftTeamsChannelConfiguration) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/chatbot-2017-10-11/CreateMicrosoftTeamsChannelConfiguration) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/chatbot-2017-10-11/CreateMicrosoftTeamsChannelConfiguration) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/chatbot-2017-10-11/CreateMicrosoftTeamsChannelConfiguration) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/chatbot-2017-10-11/CreateMicrosoftTeamsChannelConfiguration) 

# CreateSlackChannelConfiguration
<a name="API_CreateSlackChannelConfiguration"></a>

Creates an Amazon Q Developer configuration for Slack.

## Request Syntax
<a name="API_CreateSlackChannelConfiguration_RequestSyntax"></a>

```
POST /create-slack-channel-configuration HTTP/1.1
Content-type: application/json

{
   "ConfigurationName": "string",
   "GuardrailPolicyArns": [ "string" ],
   "IamRoleArn": "string",
   "LoggingLevel": "string",
   "SlackChannelId": "string",
   "SlackChannelName": "string",
   "SlackTeamId": "string",
   "SnsTopicArns": [ "string" ],
   "Tags": [ 
      { 
         "TagKey": "string",
         "TagValue": "string"
      }
   ],
   "UserAuthorizationRequired": boolean
}
```

## URI Request Parameters
<a name="API_CreateSlackChannelConfiguration_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_CreateSlackChannelConfiguration_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [ConfigurationName](#API_CreateSlackChannelConfiguration_RequestSyntax) **   <a name="qdevinchatapps-CreateSlackChannelConfiguration-request-ConfigurationName"></a>
The name of the configuration.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 128.  
Pattern: `[A-Za-z0-9-_]+`   
Required: Yes

 ** [GuardrailPolicyArns](#API_CreateSlackChannelConfiguration_RequestSyntax) **   <a name="qdevinchatapps-CreateSlackChannelConfiguration-request-GuardrailPolicyArns"></a>
The list of IAM policy ARNs that are applied as channel guardrails. The AWS managed `AdministratorAccess` policy is applied by default if this is not set.   
Type: Array of strings  
Length Constraints: Minimum length of 11. Maximum length of 1163.  
Pattern: `(^$|(?!.*\/aws-service-role\/.*)arn:aws:iam:[A-Za-z0-9_\/.-]{0,63}:[A-Za-z0-9_\/.-]{0,63}:[A-Za-z0-9][A-Za-z0-9:_\/+=,@.-]{0,1023})`   
Required: No

 ** [IamRoleArn](#API_CreateSlackChannelConfiguration_RequestSyntax) **   <a name="qdevinchatapps-CreateSlackChannelConfiguration-request-IamRoleArn"></a>
A user-defined role that Amazon Q Developer assumes. This is not the service-linked role.  
For more information, see [IAM policies for Amazon Q Developer](https://docs.aws.amazon.com/chatbot/latest/adminguide/chatbot-iam-policies.html) in the * Amazon Q Developer Administrator Guide*.   
Type: String  
Length Constraints: Minimum length of 12. Maximum length of 1224.  
Pattern: `arn:aws:[A-Za-z0-9][A-Za-z0-9_/.-]{0,62}:[A-Za-z0-9_/.-]{0,63}:[A-Za-z0-9_/.-]{0,63}:[A-Za-z0-9][A-Za-z0-9:_/+=,@.-]{0,1023}`   
Required: Yes

 ** [LoggingLevel](#API_CreateSlackChannelConfiguration_RequestSyntax) **   <a name="qdevinchatapps-CreateSlackChannelConfiguration-request-LoggingLevel"></a>
Logging levels include `ERROR`, `INFO`, or `NONE`.  
Type: String  
Length Constraints: Minimum length of 4. Maximum length of 5.  
Pattern: `(ERROR|INFO|NONE)`   
Required: No

 ** [SlackChannelId](#API_CreateSlackChannelConfiguration_RequestSyntax) **   <a name="qdevinchatapps-CreateSlackChannelConfiguration-request-SlackChannelId"></a>
The ID of the Slack channel.  
To get this ID, open Slack, right click on the channel name in the left pane, then choose Copy Link. The channel ID is the 9-character string at the end of the URL. For example, ABCBBLZZZ.   
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 255.  
Pattern: `[A-Za-z0-9]+`   
Required: Yes

 ** [SlackChannelName](#API_CreateSlackChannelConfiguration_RequestSyntax) **   <a name="qdevinchatapps-CreateSlackChannelConfiguration-request-SlackChannelName"></a>
The name of the Slack channel.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 255.  
Required: No

 ** [SlackTeamId](#API_CreateSlackChannelConfiguration_RequestSyntax) **   <a name="qdevinchatapps-CreateSlackChannelConfiguration-request-SlackTeamId"></a>
The ID of the Slack workspace authorized with Amazon Q Developer.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 255.  
Pattern: `[0-9A-Z]{1,255}`   
Required: Yes

 ** [SnsTopicArns](#API_CreateSlackChannelConfiguration_RequestSyntax) **   <a name="qdevinchatapps-CreateSlackChannelConfiguration-request-SnsTopicArns"></a>
The Amazon Resource Names (ARNs) of the SNS topics that deliver notifications to Amazon Q Developer.  
Type: Array of strings  
Length Constraints: Minimum length of 12. Maximum length of 1224.  
Pattern: `arn:aws:[A-Za-z0-9][A-Za-z0-9_/.-]{0,62}:[A-Za-z0-9_/.-]{0,63}:[A-Za-z0-9_/.-]{0,63}:[A-Za-z0-9][A-Za-z0-9:_/+=,@.-]{0,1023}`   
Required: No

 ** [Tags](#API_CreateSlackChannelConfiguration_RequestSyntax) **   <a name="qdevinchatapps-CreateSlackChannelConfiguration-request-Tags"></a>
A map of tags assigned to a resource. A tag is a string-to-string map of key-value pairs.  
Type: Array of [Tag](API_Tag.md) objects  
Required: No

 ** [UserAuthorizationRequired](#API_CreateSlackChannelConfiguration_RequestSyntax) **   <a name="qdevinchatapps-CreateSlackChannelConfiguration-request-UserAuthorizationRequired"></a>
Enables use of a user role requirement in your chat configuration.  
Type: Boolean  
Required: No

## Response Syntax
<a name="API_CreateSlackChannelConfiguration_ResponseSyntax"></a>

```
HTTP/1.1 201
Content-type: application/json

{
   "ChannelConfiguration": { 
      "ChatConfigurationArn": "string",
      "ConfigurationName": "string",
      "GuardrailPolicyArns": [ "string" ],
      "IamRoleArn": "string",
      "LoggingLevel": "string",
      "SlackChannelId": "string",
      "SlackChannelName": "string",
      "SlackTeamId": "string",
      "SlackTeamName": "string",
      "SnsTopicArns": [ "string" ],
      "State": "string",
      "StateReason": "string",
      "Tags": [ 
         { 
            "TagKey": "string",
            "TagValue": "string"
         }
      ],
      "UserAuthorizationRequired": boolean
   }
}
```

## Response Elements
<a name="API_CreateSlackChannelConfiguration_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 201 response.

The following data is returned in JSON format by the service.

 ** [ChannelConfiguration](#API_CreateSlackChannelConfiguration_ResponseSyntax) **   <a name="qdevinchatapps-CreateSlackChannelConfiguration-response-ChannelConfiguration"></a>
The configuration for a Slack channel configured with Amazon Q Developer.  
Type: [SlackChannelConfiguration](API_SlackChannelConfiguration.md) object

## Errors
<a name="API_CreateSlackChannelConfiguration_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** ConflictException **   
There was an issue processing your request.  
HTTP Status Code: 409

 ** CreateSlackChannelConfigurationException **   
We can’t process your request right now because of a server issue. Try again later.  
HTTP Status Code: 500

 ** InvalidParameterException **   
Your request input doesn't meet the constraints required by Amazon Q Developer.  
HTTP Status Code: 400

 ** InvalidRequestException **   
Your request input doesn't meet the constraints required by Amazon Q Developer.  
HTTP Status Code: 400

 ** LimitExceededException **   
You have exceeded a service limit for Amazon Q Developer.  
HTTP Status Code: 403

## See Also
<a name="API_CreateSlackChannelConfiguration_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/chatbot-2017-10-11/CreateSlackChannelConfiguration) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/chatbot-2017-10-11/CreateSlackChannelConfiguration) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/chatbot-2017-10-11/CreateSlackChannelConfiguration) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/chatbot-2017-10-11/CreateSlackChannelConfiguration) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/chatbot-2017-10-11/CreateSlackChannelConfiguration) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/chatbot-2017-10-11/CreateSlackChannelConfiguration) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/chatbot-2017-10-11/CreateSlackChannelConfiguration) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/chatbot-2017-10-11/CreateSlackChannelConfiguration) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/chatbot-2017-10-11/CreateSlackChannelConfiguration) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/chatbot-2017-10-11/CreateSlackChannelConfiguration) 

# DeleteChimeWebhookConfiguration
<a name="API_DeleteChimeWebhookConfiguration"></a>

Deletes a Amazon Chime webhook configuration for Amazon Q Developer.

## Request Syntax
<a name="API_DeleteChimeWebhookConfiguration_RequestSyntax"></a>

```
POST /delete-chime-webhook-configuration HTTP/1.1
Content-type: application/json

{
   "ChatConfigurationArn": "string"
}
```

## URI Request Parameters
<a name="API_DeleteChimeWebhookConfiguration_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_DeleteChimeWebhookConfiguration_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [ChatConfigurationArn](#API_DeleteChimeWebhookConfiguration_RequestSyntax) **   <a name="qdevinchatapps-DeleteChimeWebhookConfiguration-request-ChatConfigurationArn"></a>
The Amazon Resource Name (ARN) of the ChimeWebhookConfiguration to delete.  
Type: String  
Length Constraints: Minimum length of 19. Maximum length of 1169.  
Pattern: `arn:aws:(wheatley|chatbot):[A-Za-z0-9_/.-]{0,63}:[A-Za-z0-9_/.-]{0,63}:[A-Za-z0-9][A-Za-z0-9:_/+=,@.-]{0,1023}`   
Required: Yes

## Response Syntax
<a name="API_DeleteChimeWebhookConfiguration_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## Response Elements
<a name="API_DeleteChimeWebhookConfiguration_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 204 response with an empty HTTP body.

## Errors
<a name="API_DeleteChimeWebhookConfiguration_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** DeleteChimeWebhookConfigurationException **   
We can’t process your request right now because of a server issue. Try again later.  
HTTP Status Code: 500

 ** InvalidParameterException **   
Your request input doesn't meet the constraints required by Amazon Q Developer.  
HTTP Status Code: 400

 ** InvalidRequestException **   
Your request input doesn't meet the constraints required by Amazon Q Developer.  
HTTP Status Code: 400

 ** ResourceNotFoundException **   
We were unable to find the resource for your request  
HTTP Status Code: 404

## See Also
<a name="API_DeleteChimeWebhookConfiguration_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/chatbot-2017-10-11/DeleteChimeWebhookConfiguration) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/chatbot-2017-10-11/DeleteChimeWebhookConfiguration) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/chatbot-2017-10-11/DeleteChimeWebhookConfiguration) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/chatbot-2017-10-11/DeleteChimeWebhookConfiguration) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/chatbot-2017-10-11/DeleteChimeWebhookConfiguration) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/chatbot-2017-10-11/DeleteChimeWebhookConfiguration) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/chatbot-2017-10-11/DeleteChimeWebhookConfiguration) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/chatbot-2017-10-11/DeleteChimeWebhookConfiguration) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/chatbot-2017-10-11/DeleteChimeWebhookConfiguration) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/chatbot-2017-10-11/DeleteChimeWebhookConfiguration) 

# DeleteCustomAction
<a name="API_DeleteCustomAction"></a>

Deletes a custom action.

## Request Syntax
<a name="API_DeleteCustomAction_RequestSyntax"></a>

```
POST /delete-custom-action HTTP/1.1
Content-type: application/json

{
   "CustomActionArn": "string"
}
```

## URI Request Parameters
<a name="API_DeleteCustomAction_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_DeleteCustomAction_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [CustomActionArn](#API_DeleteCustomAction_RequestSyntax) **   <a name="qdevinchatapps-DeleteCustomAction-request-CustomActionArn"></a>
The fully defined ARN of the custom action.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 1011.  
Pattern: `arn:aws:chatbot::[0-9]{12}:custom-action/[a-zA-Z0-9_-]{1,64}`   
Required: Yes

## Response Syntax
<a name="API_DeleteCustomAction_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## Response Elements
<a name="API_DeleteCustomAction_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 204 response with an empty HTTP body.

## Errors
<a name="API_DeleteCustomAction_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InternalServiceError **   
Unexpected error during processing of request.  
HTTP Status Code: 500

 ** InvalidRequestException **   
Your request input doesn't meet the constraints required by Amazon Q Developer.  
HTTP Status Code: 400

 ** ResourceNotFoundException **   
We were unable to find the resource for your request  
HTTP Status Code: 404

 ** UnauthorizedException **   
The request was rejected because it doesn't have valid credentials for the target resource.  
HTTP Status Code: 403

## See Also
<a name="API_DeleteCustomAction_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/chatbot-2017-10-11/DeleteCustomAction) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/chatbot-2017-10-11/DeleteCustomAction) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/chatbot-2017-10-11/DeleteCustomAction) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/chatbot-2017-10-11/DeleteCustomAction) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/chatbot-2017-10-11/DeleteCustomAction) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/chatbot-2017-10-11/DeleteCustomAction) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/chatbot-2017-10-11/DeleteCustomAction) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/chatbot-2017-10-11/DeleteCustomAction) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/chatbot-2017-10-11/DeleteCustomAction) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/chatbot-2017-10-11/DeleteCustomAction) 

# DeleteMicrosoftTeamsChannelConfiguration
<a name="API_DeleteMicrosoftTeamsChannelConfiguration"></a>

Deletes a Microsoft Teams channel configuration for Amazon Q Developer.

## Request Syntax
<a name="API_DeleteMicrosoftTeamsChannelConfiguration_RequestSyntax"></a>

```
POST /delete-ms-teams-channel-configuration HTTP/1.1
Content-type: application/json

{
   "ChatConfigurationArn": "string"
}
```

## URI Request Parameters
<a name="API_DeleteMicrosoftTeamsChannelConfiguration_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_DeleteMicrosoftTeamsChannelConfiguration_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [ChatConfigurationArn](#API_DeleteMicrosoftTeamsChannelConfiguration_RequestSyntax) **   <a name="qdevinchatapps-DeleteMicrosoftTeamsChannelConfiguration-request-ChatConfigurationArn"></a>
The Amazon Resource Name (ARN) of the MicrosoftTeamsChannelConfiguration associated with the user identity to delete.  
Type: String  
Length Constraints: Minimum length of 19. Maximum length of 1169.  
Pattern: `arn:aws:(wheatley|chatbot):[A-Za-z0-9_/.-]{0,63}:[A-Za-z0-9_/.-]{0,63}:[A-Za-z0-9][A-Za-z0-9:_/+=,@.-]{0,1023}`   
Required: Yes

## Response Syntax
<a name="API_DeleteMicrosoftTeamsChannelConfiguration_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## Response Elements
<a name="API_DeleteMicrosoftTeamsChannelConfiguration_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 204 response with an empty HTTP body.

## Errors
<a name="API_DeleteMicrosoftTeamsChannelConfiguration_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** DeleteTeamsChannelConfigurationException **   
We can’t process your request right now because of a server issue. Try again later.  
HTTP Status Code: 500

 ** InvalidParameterException **   
Your request input doesn't meet the constraints required by Amazon Q Developer.  
HTTP Status Code: 400

 ** InvalidRequestException **   
Your request input doesn't meet the constraints required by Amazon Q Developer.  
HTTP Status Code: 400

 ** ResourceNotFoundException **   
We were unable to find the resource for your request  
HTTP Status Code: 404

## See Also
<a name="API_DeleteMicrosoftTeamsChannelConfiguration_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/chatbot-2017-10-11/DeleteMicrosoftTeamsChannelConfiguration) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/chatbot-2017-10-11/DeleteMicrosoftTeamsChannelConfiguration) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/chatbot-2017-10-11/DeleteMicrosoftTeamsChannelConfiguration) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/chatbot-2017-10-11/DeleteMicrosoftTeamsChannelConfiguration) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/chatbot-2017-10-11/DeleteMicrosoftTeamsChannelConfiguration) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/chatbot-2017-10-11/DeleteMicrosoftTeamsChannelConfiguration) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/chatbot-2017-10-11/DeleteMicrosoftTeamsChannelConfiguration) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/chatbot-2017-10-11/DeleteMicrosoftTeamsChannelConfiguration) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/chatbot-2017-10-11/DeleteMicrosoftTeamsChannelConfiguration) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/chatbot-2017-10-11/DeleteMicrosoftTeamsChannelConfiguration) 

# DeleteMicrosoftTeamsConfiguredTeam
<a name="API_DeleteMicrosoftTeamsConfiguredTeam"></a>

Deletes the Microsoft Teams team authorization allowing for channels to be configured in that Microsoft Teams team. Note that the Microsoft Teams team must have no channels configured to remove it. 

## Request Syntax
<a name="API_DeleteMicrosoftTeamsConfiguredTeam_RequestSyntax"></a>

```
POST /delete-ms-teams-configured-teams HTTP/1.1
Content-type: application/json

{
   "TeamId": "string"
}
```

## URI Request Parameters
<a name="API_DeleteMicrosoftTeamsConfiguredTeam_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_DeleteMicrosoftTeamsConfiguredTeam_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [TeamId](#API_DeleteMicrosoftTeamsConfiguredTeam_RequestSyntax) **   <a name="qdevinchatapps-DeleteMicrosoftTeamsConfiguredTeam-request-TeamId"></a>
The ID of the Microsoft Teams team authorized with Amazon Q Developer.  
To get the team ID, you must perform the initial authorization flow with Microsoft Teams in the Amazon Q Developer in chat applications console. Then you can copy and paste the team ID from the console. For more information, see [Step 1: Configure a Microsoft Teams client](https://docs.aws.amazon.com/chatbot/latest/adminguide/teams-setup.html#teams-client-setup) in the * Amazon Q Developer Administrator Guide*.   
Type: String  
Length Constraints: Fixed length of 36.  
Pattern: `[0-9A-Fa-f]{8}(?:-[0-9A-Fa-f]{4}){3}-[0-9A-Fa-f]{12}`   
Required: Yes

## Response Syntax
<a name="API_DeleteMicrosoftTeamsConfiguredTeam_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## Response Elements
<a name="API_DeleteMicrosoftTeamsConfiguredTeam_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 204 response with an empty HTTP body.

## Errors
<a name="API_DeleteMicrosoftTeamsConfiguredTeam_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** DeleteTeamsConfiguredTeamException **   
We can’t process your request right now because of a server issue. Try again later.  
HTTP Status Code: 500

 ** InvalidParameterException **   
Your request input doesn't meet the constraints required by Amazon Q Developer.  
HTTP Status Code: 400

## See Also
<a name="API_DeleteMicrosoftTeamsConfiguredTeam_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/chatbot-2017-10-11/DeleteMicrosoftTeamsConfiguredTeam) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/chatbot-2017-10-11/DeleteMicrosoftTeamsConfiguredTeam) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/chatbot-2017-10-11/DeleteMicrosoftTeamsConfiguredTeam) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/chatbot-2017-10-11/DeleteMicrosoftTeamsConfiguredTeam) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/chatbot-2017-10-11/DeleteMicrosoftTeamsConfiguredTeam) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/chatbot-2017-10-11/DeleteMicrosoftTeamsConfiguredTeam) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/chatbot-2017-10-11/DeleteMicrosoftTeamsConfiguredTeam) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/chatbot-2017-10-11/DeleteMicrosoftTeamsConfiguredTeam) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/chatbot-2017-10-11/DeleteMicrosoftTeamsConfiguredTeam) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/chatbot-2017-10-11/DeleteMicrosoftTeamsConfiguredTeam) 

# DeleteMicrosoftTeamsUserIdentity
<a name="API_DeleteMicrosoftTeamsUserIdentity"></a>

Identifes a user level permission for a channel configuration.

## Request Syntax
<a name="API_DeleteMicrosoftTeamsUserIdentity_RequestSyntax"></a>

```
POST /delete-ms-teams-user-identity HTTP/1.1
Content-type: application/json

{
   "ChatConfigurationArn": "string",
   "UserId": "string"
}
```

## URI Request Parameters
<a name="API_DeleteMicrosoftTeamsUserIdentity_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_DeleteMicrosoftTeamsUserIdentity_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [ChatConfigurationArn](#API_DeleteMicrosoftTeamsUserIdentity_RequestSyntax) **   <a name="qdevinchatapps-DeleteMicrosoftTeamsUserIdentity-request-ChatConfigurationArn"></a>
The ARN of the MicrosoftTeamsChannelConfiguration associated with the user identity to delete.  
Type: String  
Length Constraints: Minimum length of 19. Maximum length of 1169.  
Pattern: `arn:aws:(wheatley|chatbot):[A-Za-z0-9_/.-]{0,63}:[A-Za-z0-9_/.-]{0,63}:[A-Za-z0-9][A-Za-z0-9:_/+=,@.-]{0,1023}`   
Required: Yes

 ** [UserId](#API_DeleteMicrosoftTeamsUserIdentity_RequestSyntax) **   <a name="qdevinchatapps-DeleteMicrosoftTeamsUserIdentity-request-UserId"></a>
The Microsoft Teams user ID.  
Type: String  
Length Constraints: Fixed length of 36.  
Pattern: `[0-9A-Fa-f]{8}(?:-[0-9A-Fa-f]{4}){3}-[0-9A-Fa-f]{12}`   
Required: Yes

## Response Syntax
<a name="API_DeleteMicrosoftTeamsUserIdentity_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## Response Elements
<a name="API_DeleteMicrosoftTeamsUserIdentity_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 204 response with an empty HTTP body.

## Errors
<a name="API_DeleteMicrosoftTeamsUserIdentity_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** DeleteMicrosoftTeamsUserIdentityException **   
We can’t process your request right now because of a server issue. Try again later.  
HTTP Status Code: 500

 ** InvalidParameterException **   
Your request input doesn't meet the constraints required by Amazon Q Developer.  
HTTP Status Code: 400

 ** ResourceNotFoundException **   
We were unable to find the resource for your request  
HTTP Status Code: 404

## See Also
<a name="API_DeleteMicrosoftTeamsUserIdentity_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/chatbot-2017-10-11/DeleteMicrosoftTeamsUserIdentity) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/chatbot-2017-10-11/DeleteMicrosoftTeamsUserIdentity) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/chatbot-2017-10-11/DeleteMicrosoftTeamsUserIdentity) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/chatbot-2017-10-11/DeleteMicrosoftTeamsUserIdentity) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/chatbot-2017-10-11/DeleteMicrosoftTeamsUserIdentity) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/chatbot-2017-10-11/DeleteMicrosoftTeamsUserIdentity) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/chatbot-2017-10-11/DeleteMicrosoftTeamsUserIdentity) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/chatbot-2017-10-11/DeleteMicrosoftTeamsUserIdentity) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/chatbot-2017-10-11/DeleteMicrosoftTeamsUserIdentity) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/chatbot-2017-10-11/DeleteMicrosoftTeamsUserIdentity) 

# DeleteSlackChannelConfiguration
<a name="API_DeleteSlackChannelConfiguration"></a>

Deletes a Slack channel configuration for Amazon Q Developer.

## Request Syntax
<a name="API_DeleteSlackChannelConfiguration_RequestSyntax"></a>

```
POST /delete-slack-channel-configuration HTTP/1.1
Content-type: application/json

{
   "ChatConfigurationArn": "string"
}
```

## URI Request Parameters
<a name="API_DeleteSlackChannelConfiguration_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_DeleteSlackChannelConfiguration_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [ChatConfigurationArn](#API_DeleteSlackChannelConfiguration_RequestSyntax) **   <a name="qdevinchatapps-DeleteSlackChannelConfiguration-request-ChatConfigurationArn"></a>
The Amazon Resource Name (ARN) of the SlackChannelConfiguration to delete.  
Type: String  
Length Constraints: Minimum length of 19. Maximum length of 1169.  
Pattern: `arn:aws:(wheatley|chatbot):[A-Za-z0-9_/.-]{0,63}:[A-Za-z0-9_/.-]{0,63}:[A-Za-z0-9][A-Za-z0-9:_/+=,@.-]{0,1023}`   
Required: Yes

## Response Syntax
<a name="API_DeleteSlackChannelConfiguration_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## Response Elements
<a name="API_DeleteSlackChannelConfiguration_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 204 response with an empty HTTP body.

## Errors
<a name="API_DeleteSlackChannelConfiguration_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** DeleteSlackChannelConfigurationException **   
We can’t process your request right now because of a server issue. Try again later.  
HTTP Status Code: 500

 ** InvalidParameterException **   
Your request input doesn't meet the constraints required by Amazon Q Developer.  
HTTP Status Code: 400

 ** InvalidRequestException **   
Your request input doesn't meet the constraints required by Amazon Q Developer.  
HTTP Status Code: 400

 ** ResourceNotFoundException **   
We were unable to find the resource for your request  
HTTP Status Code: 404

## See Also
<a name="API_DeleteSlackChannelConfiguration_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/chatbot-2017-10-11/DeleteSlackChannelConfiguration) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/chatbot-2017-10-11/DeleteSlackChannelConfiguration) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/chatbot-2017-10-11/DeleteSlackChannelConfiguration) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/chatbot-2017-10-11/DeleteSlackChannelConfiguration) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/chatbot-2017-10-11/DeleteSlackChannelConfiguration) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/chatbot-2017-10-11/DeleteSlackChannelConfiguration) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/chatbot-2017-10-11/DeleteSlackChannelConfiguration) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/chatbot-2017-10-11/DeleteSlackChannelConfiguration) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/chatbot-2017-10-11/DeleteSlackChannelConfiguration) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/chatbot-2017-10-11/DeleteSlackChannelConfiguration) 

# DeleteSlackUserIdentity
<a name="API_DeleteSlackUserIdentity"></a>

Deletes a user level permission for a Slack channel configuration.

## Request Syntax
<a name="API_DeleteSlackUserIdentity_RequestSyntax"></a>

```
POST /delete-slack-user-identity HTTP/1.1
Content-type: application/json

{
   "ChatConfigurationArn": "string",
   "SlackTeamId": "string",
   "SlackUserId": "string"
}
```

## URI Request Parameters
<a name="API_DeleteSlackUserIdentity_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_DeleteSlackUserIdentity_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [ChatConfigurationArn](#API_DeleteSlackUserIdentity_RequestSyntax) **   <a name="qdevinchatapps-DeleteSlackUserIdentity-request-ChatConfigurationArn"></a>
The ARN of the SlackChannelConfiguration associated with the user identity to delete.  
Type: String  
Length Constraints: Minimum length of 19. Maximum length of 1169.  
Pattern: `arn:aws:(wheatley|chatbot):[A-Za-z0-9_/.-]{0,63}:[A-Za-z0-9_/.-]{0,63}:[A-Za-z0-9][A-Za-z0-9:_/+=,@.-]{0,1023}`   
Required: Yes

 ** [SlackTeamId](#API_DeleteSlackUserIdentity_RequestSyntax) **   <a name="qdevinchatapps-DeleteSlackUserIdentity-request-SlackTeamId"></a>
The ID of the Slack workspace authorized with Amazon Q Developer.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 255.  
Pattern: `[0-9A-Z]{1,255}`   
Required: Yes

 ** [SlackUserId](#API_DeleteSlackUserIdentity_RequestSyntax) **   <a name="qdevinchatapps-DeleteSlackUserIdentity-request-SlackUserId"></a>
The ID of the user in Slack  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 255.  
Pattern: `(.*)`   
Required: Yes

## Response Syntax
<a name="API_DeleteSlackUserIdentity_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## Response Elements
<a name="API_DeleteSlackUserIdentity_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 204 response with an empty HTTP body.

## Errors
<a name="API_DeleteSlackUserIdentity_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** DeleteSlackUserIdentityException **   
We can’t process your request right now because of a server issue. Try again later.  
HTTP Status Code: 500

 ** InvalidParameterException **   
Your request input doesn't meet the constraints required by Amazon Q Developer.  
HTTP Status Code: 400

 ** ResourceNotFoundException **   
We were unable to find the resource for your request  
HTTP Status Code: 404

## See Also
<a name="API_DeleteSlackUserIdentity_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/chatbot-2017-10-11/DeleteSlackUserIdentity) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/chatbot-2017-10-11/DeleteSlackUserIdentity) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/chatbot-2017-10-11/DeleteSlackUserIdentity) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/chatbot-2017-10-11/DeleteSlackUserIdentity) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/chatbot-2017-10-11/DeleteSlackUserIdentity) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/chatbot-2017-10-11/DeleteSlackUserIdentity) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/chatbot-2017-10-11/DeleteSlackUserIdentity) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/chatbot-2017-10-11/DeleteSlackUserIdentity) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/chatbot-2017-10-11/DeleteSlackUserIdentity) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/chatbot-2017-10-11/DeleteSlackUserIdentity) 

# DeleteSlackWorkspaceAuthorization
<a name="API_DeleteSlackWorkspaceAuthorization"></a>

Deletes the Slack workspace authorization that allows channels to be configured in that workspace. This requires all configured channels in the workspace to be deleted. 

## Request Syntax
<a name="API_DeleteSlackWorkspaceAuthorization_RequestSyntax"></a>

```
POST /delete-slack-workspace-authorization HTTP/1.1
Content-type: application/json

{
   "SlackTeamId": "string"
}
```

## URI Request Parameters
<a name="API_DeleteSlackWorkspaceAuthorization_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_DeleteSlackWorkspaceAuthorization_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [SlackTeamId](#API_DeleteSlackWorkspaceAuthorization_RequestSyntax) **   <a name="qdevinchatapps-DeleteSlackWorkspaceAuthorization-request-SlackTeamId"></a>
The ID of the Slack workspace authorized with Amazon Q Developer.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 255.  
Pattern: `[0-9A-Z]{1,255}`   
Required: Yes

## Response Syntax
<a name="API_DeleteSlackWorkspaceAuthorization_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## Response Elements
<a name="API_DeleteSlackWorkspaceAuthorization_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 204 response with an empty HTTP body.

## Errors
<a name="API_DeleteSlackWorkspaceAuthorization_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** DeleteSlackWorkspaceAuthorizationFault **   
There was an issue deleting your Slack workspace.  
HTTP Status Code: 500

 ** InvalidParameterException **   
Your request input doesn't meet the constraints required by Amazon Q Developer.  
HTTP Status Code: 400

## See Also
<a name="API_DeleteSlackWorkspaceAuthorization_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/chatbot-2017-10-11/DeleteSlackWorkspaceAuthorization) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/chatbot-2017-10-11/DeleteSlackWorkspaceAuthorization) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/chatbot-2017-10-11/DeleteSlackWorkspaceAuthorization) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/chatbot-2017-10-11/DeleteSlackWorkspaceAuthorization) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/chatbot-2017-10-11/DeleteSlackWorkspaceAuthorization) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/chatbot-2017-10-11/DeleteSlackWorkspaceAuthorization) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/chatbot-2017-10-11/DeleteSlackWorkspaceAuthorization) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/chatbot-2017-10-11/DeleteSlackWorkspaceAuthorization) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/chatbot-2017-10-11/DeleteSlackWorkspaceAuthorization) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/chatbot-2017-10-11/DeleteSlackWorkspaceAuthorization) 

# DescribeChimeWebhookConfigurations
<a name="API_DescribeChimeWebhookConfigurations"></a>

Lists Amazon Chime webhook configurations optionally filtered by ChatConfigurationArn.

## Request Syntax
<a name="API_DescribeChimeWebhookConfigurations_RequestSyntax"></a>

```
POST /describe-chime-webhook-configurations HTTP/1.1
Content-type: application/json

{
   "ChatConfigurationArn": "string",
   "MaxResults": number,
   "NextToken": "string"
}
```

## URI Request Parameters
<a name="API_DescribeChimeWebhookConfigurations_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_DescribeChimeWebhookConfigurations_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [ChatConfigurationArn](#API_DescribeChimeWebhookConfigurations_RequestSyntax) **   <a name="qdevinchatapps-DescribeChimeWebhookConfigurations-request-ChatConfigurationArn"></a>
An optional Amazon Resource Name (ARN) of a ChimeWebhookConfiguration to describe.  
Type: String  
Length Constraints: Minimum length of 19. Maximum length of 1169.  
Pattern: `arn:aws:(wheatley|chatbot):[A-Za-z0-9_/.-]{0,63}:[A-Za-z0-9_/.-]{0,63}:[A-Za-z0-9][A-Za-z0-9:_/+=,@.-]{0,1023}`   
Required: No

 ** [MaxResults](#API_DescribeChimeWebhookConfigurations_RequestSyntax) **   <a name="qdevinchatapps-DescribeChimeWebhookConfigurations-request-MaxResults"></a>
The maximum number of results to include in the response. If more results exist than the specified MaxResults value, a token is included in the response so that the remaining results can be retrieved.   
Type: Integer  
Valid Range: Minimum value of 1. Maximum value of 100.  
Required: No

 ** [NextToken](#API_DescribeChimeWebhookConfigurations_RequestSyntax) **   <a name="qdevinchatapps-DescribeChimeWebhookConfigurations-request-NextToken"></a>
An optional token returned from a prior request. Use this token for pagination of results from this action. If this parameter is specified, the response includes only results beyond the token, up to the value specified by MaxResults.   
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 1276.  
Pattern: `[a-zA-Z0-9=\/+_.\-,#:\\"{}]{4,1276}`   
Required: No

## Response Syntax
<a name="API_DescribeChimeWebhookConfigurations_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "NextToken": "string",
   "WebhookConfigurations": [ 
      { 
         "ChatConfigurationArn": "string",
         "ConfigurationName": "string",
         "IamRoleArn": "string",
         "LoggingLevel": "string",
         "SnsTopicArns": [ "string" ],
         "State": "string",
         "StateReason": "string",
         "Tags": [ 
            { 
               "TagKey": "string",
               "TagValue": "string"
            }
         ],
         "WebhookDescription": "string"
      }
   ]
}
```

## Response Elements
<a name="API_DescribeChimeWebhookConfigurations_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [NextToken](#API_DescribeChimeWebhookConfigurations_ResponseSyntax) **   <a name="qdevinchatapps-DescribeChimeWebhookConfigurations-response-NextToken"></a>
An optional token returned from a prior request. Use this token for pagination of results from this action. If this parameter is specified, the response includes only results beyond the token, up to the value specified by MaxResults.   
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 1276.  
Pattern: `[a-zA-Z0-9=\/+_.\-,#:\\"{}]{4,1276}` 

 ** [WebhookConfigurations](#API_DescribeChimeWebhookConfigurations_ResponseSyntax) **   <a name="qdevinchatapps-DescribeChimeWebhookConfigurations-response-WebhookConfigurations"></a>
A list of Amazon Chime webhooks associated with the account.  
Type: Array of [ChimeWebhookConfiguration](API_ChimeWebhookConfiguration.md) objects

## Errors
<a name="API_DescribeChimeWebhookConfigurations_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** DescribeChimeWebhookConfigurationsException **   
We can’t process your request right now because of a server issue. Try again later.  
HTTP Status Code: 500

 ** InvalidParameterException **   
Your request input doesn't meet the constraints required by Amazon Q Developer.  
HTTP Status Code: 400

 ** InvalidRequestException **   
Your request input doesn't meet the constraints required by Amazon Q Developer.  
HTTP Status Code: 400

## See Also
<a name="API_DescribeChimeWebhookConfigurations_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/chatbot-2017-10-11/DescribeChimeWebhookConfigurations) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/chatbot-2017-10-11/DescribeChimeWebhookConfigurations) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/chatbot-2017-10-11/DescribeChimeWebhookConfigurations) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/chatbot-2017-10-11/DescribeChimeWebhookConfigurations) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/chatbot-2017-10-11/DescribeChimeWebhookConfigurations) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/chatbot-2017-10-11/DescribeChimeWebhookConfigurations) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/chatbot-2017-10-11/DescribeChimeWebhookConfigurations) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/chatbot-2017-10-11/DescribeChimeWebhookConfigurations) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/chatbot-2017-10-11/DescribeChimeWebhookConfigurations) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/chatbot-2017-10-11/DescribeChimeWebhookConfigurations) 

# DescribeSlackChannelConfigurations
<a name="API_DescribeSlackChannelConfigurations"></a>

Lists Slack channel configurations optionally filtered by ChatConfigurationArn

## Request Syntax
<a name="API_DescribeSlackChannelConfigurations_RequestSyntax"></a>

```
POST /describe-slack-channel-configurations HTTP/1.1
Content-type: application/json

{
   "ChatConfigurationArn": "string",
   "MaxResults": number,
   "NextToken": "string"
}
```

## URI Request Parameters
<a name="API_DescribeSlackChannelConfigurations_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_DescribeSlackChannelConfigurations_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [ChatConfigurationArn](#API_DescribeSlackChannelConfigurations_RequestSyntax) **   <a name="qdevinchatapps-DescribeSlackChannelConfigurations-request-ChatConfigurationArn"></a>
An optional Amazon Resource Name (ARN) of a SlackChannelConfiguration to describe.  
Type: String  
Length Constraints: Minimum length of 19. Maximum length of 1169.  
Pattern: `arn:aws:(wheatley|chatbot):[A-Za-z0-9_/.-]{0,63}:[A-Za-z0-9_/.-]{0,63}:[A-Za-z0-9][A-Za-z0-9:_/+=,@.-]{0,1023}`   
Required: No

 ** [MaxResults](#API_DescribeSlackChannelConfigurations_RequestSyntax) **   <a name="qdevinchatapps-DescribeSlackChannelConfigurations-request-MaxResults"></a>
The maximum number of results to include in the response. If more results exist than the specified MaxResults value, a token is included in the response so that the remaining results can be retrieved.   
Type: Integer  
Valid Range: Minimum value of 1. Maximum value of 100.  
Required: No

 ** [NextToken](#API_DescribeSlackChannelConfigurations_RequestSyntax) **   <a name="qdevinchatapps-DescribeSlackChannelConfigurations-request-NextToken"></a>
An optional token returned from a prior request. Use this token for pagination of results from this action. If this parameter is specified, the response includes only results beyond the token, up to the value specified by MaxResults.   
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 1276.  
Pattern: `[a-zA-Z0-9=\/+_.\-,#:\\"{}]{4,1276}`   
Required: No

## Response Syntax
<a name="API_DescribeSlackChannelConfigurations_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "NextToken": "string",
   "SlackChannelConfigurations": [ 
      { 
         "ChatConfigurationArn": "string",
         "ConfigurationName": "string",
         "GuardrailPolicyArns": [ "string" ],
         "IamRoleArn": "string",
         "LoggingLevel": "string",
         "SlackChannelId": "string",
         "SlackChannelName": "string",
         "SlackTeamId": "string",
         "SlackTeamName": "string",
         "SnsTopicArns": [ "string" ],
         "State": "string",
         "StateReason": "string",
         "Tags": [ 
            { 
               "TagKey": "string",
               "TagValue": "string"
            }
         ],
         "UserAuthorizationRequired": boolean
      }
   ]
}
```

## Response Elements
<a name="API_DescribeSlackChannelConfigurations_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [NextToken](#API_DescribeSlackChannelConfigurations_ResponseSyntax) **   <a name="qdevinchatapps-DescribeSlackChannelConfigurations-response-NextToken"></a>
An optional token returned from a prior request. Use this token for pagination of results from this action. If this parameter is specified, the response includes only results beyond the token, up to the value specified by MaxResults.   
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 1276.  
Pattern: `[a-zA-Z0-9=\/+_.\-,#:\\"{}]{4,1276}` 

 ** [SlackChannelConfigurations](#API_DescribeSlackChannelConfigurations_ResponseSyntax) **   <a name="qdevinchatapps-DescribeSlackChannelConfigurations-response-SlackChannelConfigurations"></a>
A list of Slack channel configurations.  
Type: Array of [SlackChannelConfiguration](API_SlackChannelConfiguration.md) objects

## Errors
<a name="API_DescribeSlackChannelConfigurations_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** DescribeSlackChannelConfigurationsException **   
We can’t process your request right now because of a server issue. Try again later.  
HTTP Status Code: 500

 ** InvalidParameterException **   
Your request input doesn't meet the constraints required by Amazon Q Developer.  
HTTP Status Code: 400

 ** InvalidRequestException **   
Your request input doesn't meet the constraints required by Amazon Q Developer.  
HTTP Status Code: 400

## See Also
<a name="API_DescribeSlackChannelConfigurations_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/chatbot-2017-10-11/DescribeSlackChannelConfigurations) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/chatbot-2017-10-11/DescribeSlackChannelConfigurations) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/chatbot-2017-10-11/DescribeSlackChannelConfigurations) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/chatbot-2017-10-11/DescribeSlackChannelConfigurations) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/chatbot-2017-10-11/DescribeSlackChannelConfigurations) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/chatbot-2017-10-11/DescribeSlackChannelConfigurations) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/chatbot-2017-10-11/DescribeSlackChannelConfigurations) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/chatbot-2017-10-11/DescribeSlackChannelConfigurations) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/chatbot-2017-10-11/DescribeSlackChannelConfigurations) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/chatbot-2017-10-11/DescribeSlackChannelConfigurations) 

# DescribeSlackUserIdentities
<a name="API_DescribeSlackUserIdentities"></a>

Lists all Slack user identities with a mapped role.

## Request Syntax
<a name="API_DescribeSlackUserIdentities_RequestSyntax"></a>

```
POST /describe-slack-user-identities HTTP/1.1
Content-type: application/json

{
   "ChatConfigurationArn": "string",
   "MaxResults": number,
   "NextToken": "string"
}
```

## URI Request Parameters
<a name="API_DescribeSlackUserIdentities_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_DescribeSlackUserIdentities_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [ChatConfigurationArn](#API_DescribeSlackUserIdentities_RequestSyntax) **   <a name="qdevinchatapps-DescribeSlackUserIdentities-request-ChatConfigurationArn"></a>
The Amazon Resource Name (ARN) of the SlackChannelConfiguration associated with the user identities to describe.  
Type: String  
Length Constraints: Minimum length of 19. Maximum length of 1169.  
Pattern: `arn:aws:(wheatley|chatbot):[A-Za-z0-9_/.-]{0,63}:[A-Za-z0-9_/.-]{0,63}:[A-Za-z0-9][A-Za-z0-9:_/+=,@.-]{0,1023}`   
Required: No

 ** [MaxResults](#API_DescribeSlackUserIdentities_RequestSyntax) **   <a name="qdevinchatapps-DescribeSlackUserIdentities-request-MaxResults"></a>
The maximum number of results to include in the response. If more results exist than the specified MaxResults value, a token is included in the response so that the remaining results can be retrieved.   
Type: Integer  
Valid Range: Minimum value of 1. Maximum value of 100.  
Required: No

 ** [NextToken](#API_DescribeSlackUserIdentities_RequestSyntax) **   <a name="qdevinchatapps-DescribeSlackUserIdentities-request-NextToken"></a>
 An optional token returned from a prior request. Use this token for pagination of results from this action. If this parameter is specified, the response includes only results beyond the token, up to the value specified by MaxResults.   
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 1276.  
Pattern: `[a-zA-Z0-9=\/+_.\-,#:\\"{}]{4,1276}`   
Required: No

## Response Syntax
<a name="API_DescribeSlackUserIdentities_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "NextToken": "string",
   "SlackUserIdentities": [ 
      { 
         "AwsUserIdentity": "string",
         "ChatConfigurationArn": "string",
         "IamRoleArn": "string",
         "SlackTeamId": "string",
         "SlackUserId": "string"
      }
   ]
}
```

## Response Elements
<a name="API_DescribeSlackUserIdentities_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [NextToken](#API_DescribeSlackUserIdentities_ResponseSyntax) **   <a name="qdevinchatapps-DescribeSlackUserIdentities-response-NextToken"></a>
 An optional token returned from a prior request. Use this token for pagination of results from this action. If this parameter is specified, the response includes only results beyond the token, up to the value specified by MaxResults.   
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 1276.  
Pattern: `[a-zA-Z0-9=\/+_.\-,#:\\"{}]{4,1276}` 

 ** [SlackUserIdentities](#API_DescribeSlackUserIdentities_ResponseSyntax) **   <a name="qdevinchatapps-DescribeSlackUserIdentities-response-SlackUserIdentities"></a>
A list of Slack User Identities.  
Type: Array of [SlackUserIdentity](API_SlackUserIdentity.md) objects

## Errors
<a name="API_DescribeSlackUserIdentities_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** DescribeSlackUserIdentitiesException **   
We can’t process your request right now because of a server issue. Try again later.  
HTTP Status Code: 500

 ** InvalidParameterException **   
Your request input doesn't meet the constraints required by Amazon Q Developer.  
HTTP Status Code: 400

 ** InvalidRequestException **   
Your request input doesn't meet the constraints required by Amazon Q Developer.  
HTTP Status Code: 400

## See Also
<a name="API_DescribeSlackUserIdentities_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/chatbot-2017-10-11/DescribeSlackUserIdentities) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/chatbot-2017-10-11/DescribeSlackUserIdentities) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/chatbot-2017-10-11/DescribeSlackUserIdentities) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/chatbot-2017-10-11/DescribeSlackUserIdentities) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/chatbot-2017-10-11/DescribeSlackUserIdentities) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/chatbot-2017-10-11/DescribeSlackUserIdentities) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/chatbot-2017-10-11/DescribeSlackUserIdentities) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/chatbot-2017-10-11/DescribeSlackUserIdentities) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/chatbot-2017-10-11/DescribeSlackUserIdentities) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/chatbot-2017-10-11/DescribeSlackUserIdentities) 

# DescribeSlackWorkspaces
<a name="API_DescribeSlackWorkspaces"></a>

List all authorized Slack workspaces connected to the AWS Account onboarded with Amazon Q Developer.

## Request Syntax
<a name="API_DescribeSlackWorkspaces_RequestSyntax"></a>

```
POST /describe-slack-workspaces HTTP/1.1
Content-type: application/json

{
   "MaxResults": number,
   "NextToken": "string"
}
```

## URI Request Parameters
<a name="API_DescribeSlackWorkspaces_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_DescribeSlackWorkspaces_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [MaxResults](#API_DescribeSlackWorkspaces_RequestSyntax) **   <a name="qdevinchatapps-DescribeSlackWorkspaces-request-MaxResults"></a>
The maximum number of results to include in the response. If more results exist than the specified MaxResults value, a token is included in the response so that the remaining results can be retrieved.   
Type: Integer  
Valid Range: Minimum value of 1. Maximum value of 100.  
Required: No

 ** [NextToken](#API_DescribeSlackWorkspaces_RequestSyntax) **   <a name="qdevinchatapps-DescribeSlackWorkspaces-request-NextToken"></a>
 An optional token returned from a prior request. Use this token for pagination of results from this action. If this parameter is specified, the response includes only results beyond the token, up to the value specified by MaxResults.   
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 1276.  
Pattern: `[a-zA-Z0-9=\/+_.\-,#:\\"{}]{4,1276}`   
Required: No

## Response Syntax
<a name="API_DescribeSlackWorkspaces_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "NextToken": "string",
   "SlackWorkspaces": [ 
      { 
         "SlackTeamId": "string",
         "SlackTeamName": "string",
         "State": "string",
         "StateReason": "string"
      }
   ]
}
```

## Response Elements
<a name="API_DescribeSlackWorkspaces_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [NextToken](#API_DescribeSlackWorkspaces_ResponseSyntax) **   <a name="qdevinchatapps-DescribeSlackWorkspaces-response-NextToken"></a>
 An optional token returned from a prior request. Use this token for pagination of results from this action. If this parameter is specified, the response includes only results beyond the token, up to the value specified by MaxResults.   
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 1276.  
Pattern: `[a-zA-Z0-9=\/+_.\-,#:\\"{}]{4,1276}` 

 ** [SlackWorkspaces](#API_DescribeSlackWorkspaces_ResponseSyntax) **   <a name="qdevinchatapps-DescribeSlackWorkspaces-response-SlackWorkspaces"></a>
A list of Slack workspaces registered with Amazon Q Developer.  
Type: Array of [SlackWorkspace](API_SlackWorkspace.md) objects

## Errors
<a name="API_DescribeSlackWorkspaces_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** DescribeSlackWorkspacesException **   
We can’t process your request right now because of a server issue. Try again later.  
HTTP Status Code: 500

 ** InvalidParameterException **   
Your request input doesn't meet the constraints required by Amazon Q Developer.  
HTTP Status Code: 400

 ** InvalidRequestException **   
Your request input doesn't meet the constraints required by Amazon Q Developer.  
HTTP Status Code: 400

## See Also
<a name="API_DescribeSlackWorkspaces_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/chatbot-2017-10-11/DescribeSlackWorkspaces) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/chatbot-2017-10-11/DescribeSlackWorkspaces) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/chatbot-2017-10-11/DescribeSlackWorkspaces) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/chatbot-2017-10-11/DescribeSlackWorkspaces) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/chatbot-2017-10-11/DescribeSlackWorkspaces) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/chatbot-2017-10-11/DescribeSlackWorkspaces) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/chatbot-2017-10-11/DescribeSlackWorkspaces) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/chatbot-2017-10-11/DescribeSlackWorkspaces) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/chatbot-2017-10-11/DescribeSlackWorkspaces) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/chatbot-2017-10-11/DescribeSlackWorkspaces) 

# DisassociateFromConfiguration
<a name="API_DisassociateFromConfiguration"></a>

Unlink a resource, for example a custom action, from a channel configuration.

## Request Syntax
<a name="API_DisassociateFromConfiguration_RequestSyntax"></a>

```
POST /disassociate-from-configuration HTTP/1.1
Content-type: application/json

{
   "ChatConfiguration": "string",
   "Resource": "string"
}
```

## URI Request Parameters
<a name="API_DisassociateFromConfiguration_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_DisassociateFromConfiguration_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [ChatConfiguration](#API_DisassociateFromConfiguration_RequestSyntax) **   <a name="qdevinchatapps-DisassociateFromConfiguration-request-ChatConfiguration"></a>
The channel configuration the resource is being disassociated from.  
Type: String  
Length Constraints: Minimum length of 19. Maximum length of 1169.  
Pattern: `arn:aws:(wheatley|chatbot):[A-Za-z0-9_/.-]{0,63}:[A-Za-z0-9_/.-]{0,63}:[A-Za-z0-9][A-Za-z0-9:_/+=,@.-]{0,1023}`   
Required: Yes

 ** [Resource](#API_DisassociateFromConfiguration_RequestSyntax) **   <a name="qdevinchatapps-DisassociateFromConfiguration-request-Resource"></a>
The resource (for example, a custom action) Amazon Resource Name (ARN) to unlink.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 1011.  
Pattern: `arn:aws:chatbot:[A-Za-z0-9_/.-]{0,63}:[A-Za-z0-9_/.-]{0,63}:custom-action/[a-zA-Z0-9_-]{1,64}`   
Required: Yes

## Response Syntax
<a name="API_DisassociateFromConfiguration_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## Response Elements
<a name="API_DisassociateFromConfiguration_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 204 response with an empty HTTP body.

## Errors
<a name="API_DisassociateFromConfiguration_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InternalServiceError **   
Unexpected error during processing of request.  
HTTP Status Code: 500

 ** InvalidRequestException **   
Your request input doesn't meet the constraints required by Amazon Q Developer.  
HTTP Status Code: 400

 ** UnauthorizedException **   
The request was rejected because it doesn't have valid credentials for the target resource.  
HTTP Status Code: 403

## See Also
<a name="API_DisassociateFromConfiguration_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/chatbot-2017-10-11/DisassociateFromConfiguration) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/chatbot-2017-10-11/DisassociateFromConfiguration) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/chatbot-2017-10-11/DisassociateFromConfiguration) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/chatbot-2017-10-11/DisassociateFromConfiguration) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/chatbot-2017-10-11/DisassociateFromConfiguration) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/chatbot-2017-10-11/DisassociateFromConfiguration) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/chatbot-2017-10-11/DisassociateFromConfiguration) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/chatbot-2017-10-11/DisassociateFromConfiguration) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/chatbot-2017-10-11/DisassociateFromConfiguration) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/chatbot-2017-10-11/DisassociateFromConfiguration) 

# GetAccountPreferences
<a name="API_GetAccountPreferences"></a>

Returns Amazon Q Developer account preferences.

## Request Syntax
<a name="API_GetAccountPreferences_RequestSyntax"></a>

```
POST /get-account-preferences HTTP/1.1
```

## URI Request Parameters
<a name="API_GetAccountPreferences_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_GetAccountPreferences_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_GetAccountPreferences_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "AccountPreferences": { 
      "TrainingDataCollectionEnabled": boolean,
      "UserAuthorizationRequired": boolean
   }
}
```

## Response Elements
<a name="API_GetAccountPreferences_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [AccountPreferences](#API_GetAccountPreferences_ResponseSyntax) **   <a name="qdevinchatapps-GetAccountPreferences-response-AccountPreferences"></a>
The preferences related to Amazon Q Developer usage in the calling AWS account.  
Type: [AccountPreferences](API_AccountPreferences.md) object

## Errors
<a name="API_GetAccountPreferences_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** GetAccountPreferencesException **   
We can’t process your request right now because of a server issue. Try again later.  
HTTP Status Code: 500

 ** InvalidRequestException **   
Your request input doesn't meet the constraints required by Amazon Q Developer.  
HTTP Status Code: 400

## See Also
<a name="API_GetAccountPreferences_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/chatbot-2017-10-11/GetAccountPreferences) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/chatbot-2017-10-11/GetAccountPreferences) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/chatbot-2017-10-11/GetAccountPreferences) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/chatbot-2017-10-11/GetAccountPreferences) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/chatbot-2017-10-11/GetAccountPreferences) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/chatbot-2017-10-11/GetAccountPreferences) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/chatbot-2017-10-11/GetAccountPreferences) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/chatbot-2017-10-11/GetAccountPreferences) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/chatbot-2017-10-11/GetAccountPreferences) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/chatbot-2017-10-11/GetAccountPreferences) 

# GetCustomAction
<a name="API_GetCustomAction"></a>

Returns a custom action.

## Request Syntax
<a name="API_GetCustomAction_RequestSyntax"></a>

```
POST /get-custom-action HTTP/1.1
Content-type: application/json

{
   "CustomActionArn": "string"
}
```

## URI Request Parameters
<a name="API_GetCustomAction_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_GetCustomAction_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [CustomActionArn](#API_GetCustomAction_RequestSyntax) **   <a name="qdevinchatapps-GetCustomAction-request-CustomActionArn"></a>
Returns the fully defined Amazon Resource Name (ARN) of the custom action.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 1011.  
Pattern: `arn:aws:chatbot::[0-9]{12}:custom-action/[a-zA-Z0-9_-]{1,64}`   
Required: Yes

## Response Syntax
<a name="API_GetCustomAction_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "CustomAction": { 
      "ActionName": "string",
      "AliasName": "string",
      "Attachments": [ 
         { 
            "ButtonText": "string",
            "Criteria": [ 
               { 
                  "Operator": "string",
                  "Value": "string",
                  "VariableName": "string"
               }
            ],
            "NotificationType": "string",
            "Variables": { 
               "string" : "string" 
            }
         }
      ],
      "CustomActionArn": "string",
      "Definition": { 
         "CommandText": "string"
      }
   }
}
```

## Response Elements
<a name="API_GetCustomAction_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [CustomAction](#API_GetCustomAction_ResponseSyntax) **   <a name="qdevinchatapps-GetCustomAction-response-CustomAction"></a>
Returns the custom action.  
Type: [CustomAction](API_CustomAction.md) object

## Errors
<a name="API_GetCustomAction_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InternalServiceError **   
Unexpected error during processing of request.  
HTTP Status Code: 500

 ** InvalidRequestException **   
Your request input doesn't meet the constraints required by Amazon Q Developer.  
HTTP Status Code: 400

 ** ResourceNotFoundException **   
We were unable to find the resource for your request  
HTTP Status Code: 404

 ** UnauthorizedException **   
The request was rejected because it doesn't have valid credentials for the target resource.  
HTTP Status Code: 403

## See Also
<a name="API_GetCustomAction_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/chatbot-2017-10-11/GetCustomAction) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/chatbot-2017-10-11/GetCustomAction) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/chatbot-2017-10-11/GetCustomAction) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/chatbot-2017-10-11/GetCustomAction) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/chatbot-2017-10-11/GetCustomAction) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/chatbot-2017-10-11/GetCustomAction) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/chatbot-2017-10-11/GetCustomAction) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/chatbot-2017-10-11/GetCustomAction) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/chatbot-2017-10-11/GetCustomAction) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/chatbot-2017-10-11/GetCustomAction) 

# GetMicrosoftTeamsChannelConfiguration
<a name="API_GetMicrosoftTeamsChannelConfiguration"></a>

Returns a Microsoft Teams channel configuration in an AWS account.

## Request Syntax
<a name="API_GetMicrosoftTeamsChannelConfiguration_RequestSyntax"></a>

```
POST /get-ms-teams-channel-configuration HTTP/1.1
Content-type: application/json

{
   "ChatConfigurationArn": "string"
}
```

## URI Request Parameters
<a name="API_GetMicrosoftTeamsChannelConfiguration_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_GetMicrosoftTeamsChannelConfiguration_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [ChatConfigurationArn](#API_GetMicrosoftTeamsChannelConfiguration_RequestSyntax) **   <a name="qdevinchatapps-GetMicrosoftTeamsChannelConfiguration-request-ChatConfigurationArn"></a>
The Amazon Resource Name (ARN) of the MicrosoftTeamsChannelConfiguration to retrieve.  
Type: String  
Length Constraints: Minimum length of 19. Maximum length of 1169.  
Pattern: `arn:aws:(wheatley|chatbot):[A-Za-z0-9_/.-]{0,63}:[A-Za-z0-9_/.-]{0,63}:[A-Za-z0-9][A-Za-z0-9:_/+=,@.-]{0,1023}`   
Required: Yes

## Response Syntax
<a name="API_GetMicrosoftTeamsChannelConfiguration_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "ChannelConfiguration": { 
      "ChannelId": "string",
      "ChannelName": "string",
      "ChatConfigurationArn": "string",
      "ConfigurationName": "string",
      "GuardrailPolicyArns": [ "string" ],
      "IamRoleArn": "string",
      "LoggingLevel": "string",
      "SnsTopicArns": [ "string" ],
      "State": "string",
      "StateReason": "string",
      "Tags": [ 
         { 
            "TagKey": "string",
            "TagValue": "string"
         }
      ],
      "TeamId": "string",
      "TeamName": "string",
      "TenantId": "string",
      "UserAuthorizationRequired": boolean
   }
}
```

## Response Elements
<a name="API_GetMicrosoftTeamsChannelConfiguration_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [ChannelConfiguration](#API_GetMicrosoftTeamsChannelConfiguration_ResponseSyntax) **   <a name="qdevinchatapps-GetMicrosoftTeamsChannelConfiguration-response-ChannelConfiguration"></a>
The configuration for a Microsoft Teams channel configured with Amazon Q Developer.  
Type: [TeamsChannelConfiguration](API_TeamsChannelConfiguration.md) object

## Errors
<a name="API_GetMicrosoftTeamsChannelConfiguration_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** GetTeamsChannelConfigurationException **   
We can’t process your request right now because of a server issue. Try again later.  
HTTP Status Code: 500

 ** InvalidParameterException **   
Your request input doesn't meet the constraints required by Amazon Q Developer.  
HTTP Status Code: 400

 ** InvalidRequestException **   
Your request input doesn't meet the constraints required by Amazon Q Developer.  
HTTP Status Code: 400

## See Also
<a name="API_GetMicrosoftTeamsChannelConfiguration_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/chatbot-2017-10-11/GetMicrosoftTeamsChannelConfiguration) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/chatbot-2017-10-11/GetMicrosoftTeamsChannelConfiguration) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/chatbot-2017-10-11/GetMicrosoftTeamsChannelConfiguration) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/chatbot-2017-10-11/GetMicrosoftTeamsChannelConfiguration) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/chatbot-2017-10-11/GetMicrosoftTeamsChannelConfiguration) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/chatbot-2017-10-11/GetMicrosoftTeamsChannelConfiguration) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/chatbot-2017-10-11/GetMicrosoftTeamsChannelConfiguration) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/chatbot-2017-10-11/GetMicrosoftTeamsChannelConfiguration) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/chatbot-2017-10-11/GetMicrosoftTeamsChannelConfiguration) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/chatbot-2017-10-11/GetMicrosoftTeamsChannelConfiguration) 

# ListAssociations
<a name="API_ListAssociations"></a>

Lists resources associated with a channel configuration.

## Request Syntax
<a name="API_ListAssociations_RequestSyntax"></a>

```
POST /list-associations HTTP/1.1
Content-type: application/json

{
   "ChatConfiguration": "string",
   "MaxResults": number,
   "NextToken": "string"
}
```

## URI Request Parameters
<a name="API_ListAssociations_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_ListAssociations_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [ChatConfiguration](#API_ListAssociations_RequestSyntax) **   <a name="qdevinchatapps-ListAssociations-request-ChatConfiguration"></a>
The channel configuration to list associations for.  
Type: String  
Length Constraints: Minimum length of 19. Maximum length of 1169.  
Pattern: `arn:aws:(wheatley|chatbot):[A-Za-z0-9_/.-]{0,63}:[A-Za-z0-9_/.-]{0,63}:[A-Za-z0-9][A-Za-z0-9:_/+=,@.-]{0,1023}`   
Required: Yes

 ** [MaxResults](#API_ListAssociations_RequestSyntax) **   <a name="qdevinchatapps-ListAssociations-request-MaxResults"></a>
The maximum number of results to include in the response. If more results exist than the specified MaxResults value, a token is included in the response so that the remaining results can be retrieved.  
Type: Integer  
Valid Range: Minimum value of 1. Maximum value of 100.  
Required: No

 ** [NextToken](#API_ListAssociations_RequestSyntax) **   <a name="qdevinchatapps-ListAssociations-request-NextToken"></a>
An optional token returned from a prior request. Use this token for pagination of results from this action. If this parameter is specified, the response includes only results beyond the token, up to the value specified by MaxResults.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 1024.  
Pattern: `[\x20-\x7F]+`   
Required: No

## Response Syntax
<a name="API_ListAssociations_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "Associations": [ 
      { 
         "Resource": "string"
      }
   ],
   "NextToken": "string"
}
```

## Response Elements
<a name="API_ListAssociations_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [Associations](#API_ListAssociations_ResponseSyntax) **   <a name="qdevinchatapps-ListAssociations-response-Associations"></a>
The resources associated with this channel configuration.  
Type: Array of [AssociationListing](API_AssociationListing.md) objects

 ** [NextToken](#API_ListAssociations_ResponseSyntax) **   <a name="qdevinchatapps-ListAssociations-response-NextToken"></a>
An optional token returned from a prior request. Use this token for pagination of results from this action. If this parameter is specified, the response includes only results beyond the token, up to the value specified by MaxResults.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 1024.  
Pattern: `[\x20-\x7F]+` 

## Errors
<a name="API_ListAssociations_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

## See Also
<a name="API_ListAssociations_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/chatbot-2017-10-11/ListAssociations) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/chatbot-2017-10-11/ListAssociations) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/chatbot-2017-10-11/ListAssociations) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/chatbot-2017-10-11/ListAssociations) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/chatbot-2017-10-11/ListAssociations) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/chatbot-2017-10-11/ListAssociations) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/chatbot-2017-10-11/ListAssociations) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/chatbot-2017-10-11/ListAssociations) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/chatbot-2017-10-11/ListAssociations) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/chatbot-2017-10-11/ListAssociations) 

# ListCustomActions
<a name="API_ListCustomActions"></a>

Lists custom actions defined in this account.

## Request Syntax
<a name="API_ListCustomActions_RequestSyntax"></a>

```
POST /list-custom-actions HTTP/1.1
Content-type: application/json

{
   "MaxResults": number,
   "NextToken": "string"
}
```

## URI Request Parameters
<a name="API_ListCustomActions_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_ListCustomActions_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [MaxResults](#API_ListCustomActions_RequestSyntax) **   <a name="qdevinchatapps-ListCustomActions-request-MaxResults"></a>
The maximum number of results to include in the response. If more results exist than the specified MaxResults value, a token is included in the response so that the remaining results can be retrieved.  
Type: Integer  
Valid Range: Minimum value of 1. Maximum value of 100.  
Required: No

 ** [NextToken](#API_ListCustomActions_RequestSyntax) **   <a name="qdevinchatapps-ListCustomActions-request-NextToken"></a>
An optional token returned from a prior request. Use this token for pagination of results from this action. If this parameter is specified, the response includes only results beyond the token, up to the value specified by MaxResults.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 1024.  
Pattern: `[\x20-\x7F]+`   
Required: No

## Response Syntax
<a name="API_ListCustomActions_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "CustomActions": [ "string" ],
   "NextToken": "string"
}
```

## Response Elements
<a name="API_ListCustomActions_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [CustomActions](#API_ListCustomActions_ResponseSyntax) **   <a name="qdevinchatapps-ListCustomActions-response-CustomActions"></a>
A list of custom actions.  
Type: Array of strings  
Length Constraints: Minimum length of 1. Maximum length of 1011.  
Pattern: `arn:aws:chatbot::[0-9]{12}:custom-action/[a-zA-Z0-9_-]{1,64}` 

 ** [NextToken](#API_ListCustomActions_ResponseSyntax) **   <a name="qdevinchatapps-ListCustomActions-response-NextToken"></a>
An optional token returned from a prior request. Use this token for pagination of results from this action. If this parameter is specified, the response includes only results beyond the token, up to the value specified by MaxResults.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 1024.  
Pattern: `[\x20-\x7F]+` 

## Errors
<a name="API_ListCustomActions_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InternalServiceError **   
Unexpected error during processing of request.  
HTTP Status Code: 500

 ** InvalidRequestException **   
Your request input doesn't meet the constraints required by Amazon Q Developer.  
HTTP Status Code: 400

 ** UnauthorizedException **   
The request was rejected because it doesn't have valid credentials for the target resource.  
HTTP Status Code: 403

## See Also
<a name="API_ListCustomActions_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/chatbot-2017-10-11/ListCustomActions) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/chatbot-2017-10-11/ListCustomActions) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/chatbot-2017-10-11/ListCustomActions) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/chatbot-2017-10-11/ListCustomActions) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/chatbot-2017-10-11/ListCustomActions) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/chatbot-2017-10-11/ListCustomActions) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/chatbot-2017-10-11/ListCustomActions) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/chatbot-2017-10-11/ListCustomActions) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/chatbot-2017-10-11/ListCustomActions) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/chatbot-2017-10-11/ListCustomActions) 

# ListMicrosoftTeamsChannelConfigurations
<a name="API_ListMicrosoftTeamsChannelConfigurations"></a>

Lists all Amazon Q Developer Microsoft Teams channel configurations in an AWS account.

## Request Syntax
<a name="API_ListMicrosoftTeamsChannelConfigurations_RequestSyntax"></a>

```
POST /list-ms-teams-channel-configurations HTTP/1.1
Content-type: application/json

{
   "MaxResults": number,
   "NextToken": "string",
   "TeamId": "string"
}
```

## URI Request Parameters
<a name="API_ListMicrosoftTeamsChannelConfigurations_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_ListMicrosoftTeamsChannelConfigurations_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [MaxResults](#API_ListMicrosoftTeamsChannelConfigurations_RequestSyntax) **   <a name="qdevinchatapps-ListMicrosoftTeamsChannelConfigurations-request-MaxResults"></a>
The maximum number of results to include in the response. If more results exist than the specified MaxResults value, a token is included in the response so that the remaining results can be retrieved.  
Type: Integer  
Valid Range: Minimum value of 1. Maximum value of 100.  
Required: No

 ** [NextToken](#API_ListMicrosoftTeamsChannelConfigurations_RequestSyntax) **   <a name="qdevinchatapps-ListMicrosoftTeamsChannelConfigurations-request-NextToken"></a>
An optional token returned from a prior request. Use this token for pagination of results from this action. If this parameter is specified, the response includes only results beyond the token, up to the value specified by MaxResults.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 1276.  
Pattern: `[a-zA-Z0-9=\/+_.\-,#:\\"{}]{4,1276}`   
Required: No

 ** [TeamId](#API_ListMicrosoftTeamsChannelConfigurations_RequestSyntax) **   <a name="qdevinchatapps-ListMicrosoftTeamsChannelConfigurations-request-TeamId"></a>
 The ID of the Microsoft Teams authorized with Amazon Q Developer.  
To get the team ID, you must perform the initial authorization flow with Microsoft Teams in the Amazon Q Developer in chat applications console. Then you can copy and paste the team ID from the console. For more information, see [Step 1: Configure a Microsoft Teams client](https://docs.aws.amazon.com/chatbot/latest/adminguide/teams-setup.html#teams-client-setup) in the * Amazon Q Developer Administrator Guide*.   
Type: String  
Length Constraints: Fixed length of 36.  
Pattern: `[0-9A-Fa-f]{8}(?:-[0-9A-Fa-f]{4}){3}-[0-9A-Fa-f]{12}`   
Required: No

## Response Syntax
<a name="API_ListMicrosoftTeamsChannelConfigurations_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "NextToken": "string",
   "TeamChannelConfigurations": [ 
      { 
         "ChannelId": "string",
         "ChannelName": "string",
         "ChatConfigurationArn": "string",
         "ConfigurationName": "string",
         "GuardrailPolicyArns": [ "string" ],
         "IamRoleArn": "string",
         "LoggingLevel": "string",
         "SnsTopicArns": [ "string" ],
         "State": "string",
         "StateReason": "string",
         "Tags": [ 
            { 
               "TagKey": "string",
               "TagValue": "string"
            }
         ],
         "TeamId": "string",
         "TeamName": "string",
         "TenantId": "string",
         "UserAuthorizationRequired": boolean
      }
   ]
}
```

## Response Elements
<a name="API_ListMicrosoftTeamsChannelConfigurations_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [NextToken](#API_ListMicrosoftTeamsChannelConfigurations_ResponseSyntax) **   <a name="qdevinchatapps-ListMicrosoftTeamsChannelConfigurations-response-NextToken"></a>
An optional token returned from a prior request. Use this token for pagination of results from this action. If this parameter is specified, the response includes only results beyond the token, up to the value specified by MaxResults.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 1276.  
Pattern: `[a-zA-Z0-9=\/+_.\-,#:\\"{}]{4,1276}` 

 ** [TeamChannelConfigurations](#API_ListMicrosoftTeamsChannelConfigurations_ResponseSyntax) **   <a name="qdevinchatapps-ListMicrosoftTeamsChannelConfigurations-response-TeamChannelConfigurations"></a>
A list of Amazon Q Developer channel configurations for Microsoft Teams.  
Type: Array of [TeamsChannelConfiguration](API_TeamsChannelConfiguration.md) objects

## Errors
<a name="API_ListMicrosoftTeamsChannelConfigurations_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InvalidParameterException **   
Your request input doesn't meet the constraints required by Amazon Q Developer.  
HTTP Status Code: 400

 ** InvalidRequestException **   
Your request input doesn't meet the constraints required by Amazon Q Developer.  
HTTP Status Code: 400

 ** ListTeamsChannelConfigurationsException **   
We can’t process your request right now because of a server issue. Try again later.  
HTTP Status Code: 500

## See Also
<a name="API_ListMicrosoftTeamsChannelConfigurations_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/chatbot-2017-10-11/ListMicrosoftTeamsChannelConfigurations) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/chatbot-2017-10-11/ListMicrosoftTeamsChannelConfigurations) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/chatbot-2017-10-11/ListMicrosoftTeamsChannelConfigurations) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/chatbot-2017-10-11/ListMicrosoftTeamsChannelConfigurations) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/chatbot-2017-10-11/ListMicrosoftTeamsChannelConfigurations) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/chatbot-2017-10-11/ListMicrosoftTeamsChannelConfigurations) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/chatbot-2017-10-11/ListMicrosoftTeamsChannelConfigurations) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/chatbot-2017-10-11/ListMicrosoftTeamsChannelConfigurations) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/chatbot-2017-10-11/ListMicrosoftTeamsChannelConfigurations) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/chatbot-2017-10-11/ListMicrosoftTeamsChannelConfigurations) 

# ListMicrosoftTeamsConfiguredTeams
<a name="API_ListMicrosoftTeamsConfiguredTeams"></a>

Lists all authorized Microsoft Teams for an AWS Account

## Request Syntax
<a name="API_ListMicrosoftTeamsConfiguredTeams_RequestSyntax"></a>

```
POST /list-ms-teams-configured-teams HTTP/1.1
Content-type: application/json

{
   "MaxResults": number,
   "NextToken": "string"
}
```

## URI Request Parameters
<a name="API_ListMicrosoftTeamsConfiguredTeams_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_ListMicrosoftTeamsConfiguredTeams_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [MaxResults](#API_ListMicrosoftTeamsConfiguredTeams_RequestSyntax) **   <a name="qdevinchatapps-ListMicrosoftTeamsConfiguredTeams-request-MaxResults"></a>
The maximum number of results to include in the response. If more results exist than the specified MaxResults value, a token is included in the response so that the remaining results can be retrieved.  
Type: Integer  
Valid Range: Minimum value of 1. Maximum value of 100.  
Required: No

 ** [NextToken](#API_ListMicrosoftTeamsConfiguredTeams_RequestSyntax) **   <a name="qdevinchatapps-ListMicrosoftTeamsConfiguredTeams-request-NextToken"></a>
An optional token returned from a prior request. Use this token for pagination of results from this action. If this parameter is specified, the response includes only results beyond the token, up to the value specified by MaxResults.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 1276.  
Pattern: `[a-zA-Z0-9=\/+_.\-,#:\\"{}]{4,1276}`   
Required: No

## Response Syntax
<a name="API_ListMicrosoftTeamsConfiguredTeams_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "ConfiguredTeams": [ 
      { 
         "State": "string",
         "StateReason": "string",
         "TeamId": "string",
         "TeamName": "string",
         "TenantId": "string"
      }
   ],
   "NextToken": "string"
}
```

## Response Elements
<a name="API_ListMicrosoftTeamsConfiguredTeams_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [ConfiguredTeams](#API_ListMicrosoftTeamsConfiguredTeams_ResponseSyntax) **   <a name="qdevinchatapps-ListMicrosoftTeamsConfiguredTeams-response-ConfiguredTeams"></a>
A list of teams in Microsoft Teams that are configured with Amazon Q Developer.  
Type: Array of [ConfiguredTeam](API_ConfiguredTeam.md) objects

 ** [NextToken](#API_ListMicrosoftTeamsConfiguredTeams_ResponseSyntax) **   <a name="qdevinchatapps-ListMicrosoftTeamsConfiguredTeams-response-NextToken"></a>
An optional token returned from a prior request. Use this token for pagination of results from this action. If this parameter is specified, the response includes only results beyond the token, up to the value specified by MaxResults.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 1276.  
Pattern: `[a-zA-Z0-9=\/+_.\-,#:\\"{}]{4,1276}` 

## Errors
<a name="API_ListMicrosoftTeamsConfiguredTeams_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InvalidParameterException **   
Your request input doesn't meet the constraints required by Amazon Q Developer.  
HTTP Status Code: 400

 ** InvalidRequestException **   
Your request input doesn't meet the constraints required by Amazon Q Developer.  
HTTP Status Code: 400

 ** ListMicrosoftTeamsConfiguredTeamsException **   
We can’t process your request right now because of a server issue. Try again later.  
HTTP Status Code: 500

## See Also
<a name="API_ListMicrosoftTeamsConfiguredTeams_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/chatbot-2017-10-11/ListMicrosoftTeamsConfiguredTeams) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/chatbot-2017-10-11/ListMicrosoftTeamsConfiguredTeams) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/chatbot-2017-10-11/ListMicrosoftTeamsConfiguredTeams) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/chatbot-2017-10-11/ListMicrosoftTeamsConfiguredTeams) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/chatbot-2017-10-11/ListMicrosoftTeamsConfiguredTeams) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/chatbot-2017-10-11/ListMicrosoftTeamsConfiguredTeams) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/chatbot-2017-10-11/ListMicrosoftTeamsConfiguredTeams) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/chatbot-2017-10-11/ListMicrosoftTeamsConfiguredTeams) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/chatbot-2017-10-11/ListMicrosoftTeamsConfiguredTeams) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/chatbot-2017-10-11/ListMicrosoftTeamsConfiguredTeams) 

# ListMicrosoftTeamsUserIdentities
<a name="API_ListMicrosoftTeamsUserIdentities"></a>

A list all Microsoft Teams user identities with a mapped role.

## Request Syntax
<a name="API_ListMicrosoftTeamsUserIdentities_RequestSyntax"></a>

```
POST /list-ms-teams-user-identities HTTP/1.1
Content-type: application/json

{
   "ChatConfigurationArn": "string",
   "MaxResults": number,
   "NextToken": "string"
}
```

## URI Request Parameters
<a name="API_ListMicrosoftTeamsUserIdentities_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_ListMicrosoftTeamsUserIdentities_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [ChatConfigurationArn](#API_ListMicrosoftTeamsUserIdentities_RequestSyntax) **   <a name="qdevinchatapps-ListMicrosoftTeamsUserIdentities-request-ChatConfigurationArn"></a>
The Amazon Resource Name (ARN) of the MicrosoftTeamsChannelConfiguration associated with the user identities to list.  
Type: String  
Length Constraints: Minimum length of 19. Maximum length of 1169.  
Pattern: `arn:aws:(wheatley|chatbot):[A-Za-z0-9_/.-]{0,63}:[A-Za-z0-9_/.-]{0,63}:[A-Za-z0-9][A-Za-z0-9:_/+=,@.-]{0,1023}`   
Required: No

 ** [MaxResults](#API_ListMicrosoftTeamsUserIdentities_RequestSyntax) **   <a name="qdevinchatapps-ListMicrosoftTeamsUserIdentities-request-MaxResults"></a>
The maximum number of results to include in the response. If more results exist than the specified MaxResults value, a token is included in the response so that the remaining results can be retrieved.   
Type: Integer  
Valid Range: Minimum value of 1. Maximum value of 100.  
Required: No

 ** [NextToken](#API_ListMicrosoftTeamsUserIdentities_RequestSyntax) **   <a name="qdevinchatapps-ListMicrosoftTeamsUserIdentities-request-NextToken"></a>
An optional token returned from a prior request. Use this token for pagination of results from this action. If this parameter is specified, the response includes only results beyond the token, up to the value specified by MaxResults.   
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 1276.  
Pattern: `[a-zA-Z0-9=\/+_.\-,#:\\"{}]{4,1276}`   
Required: No

## Response Syntax
<a name="API_ListMicrosoftTeamsUserIdentities_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "NextToken": "string",
   "TeamsUserIdentities": [ 
      { 
         "AwsUserIdentity": "string",
         "ChatConfigurationArn": "string",
         "IamRoleArn": "string",
         "TeamId": "string",
         "TeamsChannelId": "string",
         "TeamsTenantId": "string",
         "UserId": "string"
      }
   ]
}
```

## Response Elements
<a name="API_ListMicrosoftTeamsUserIdentities_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [NextToken](#API_ListMicrosoftTeamsUserIdentities_ResponseSyntax) **   <a name="qdevinchatapps-ListMicrosoftTeamsUserIdentities-response-NextToken"></a>
An optional token returned from a prior request. Use this token for pagination of results from this action. If this parameter is specified, the response includes only results beyond the token, up to the value specified by MaxResults.   
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 1276.  
Pattern: `[a-zA-Z0-9=\/+_.\-,#:\\"{}]{4,1276}` 

 ** [TeamsUserIdentities](#API_ListMicrosoftTeamsUserIdentities_ResponseSyntax) **   <a name="qdevinchatapps-ListMicrosoftTeamsUserIdentities-response-TeamsUserIdentities"></a>
User level permissions associated to a channel configuration.  
Type: Array of [TeamsUserIdentity](API_TeamsUserIdentity.md) objects

## Errors
<a name="API_ListMicrosoftTeamsUserIdentities_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InvalidParameterException **   
Your request input doesn't meet the constraints required by Amazon Q Developer.  
HTTP Status Code: 400

 ** InvalidRequestException **   
Your request input doesn't meet the constraints required by Amazon Q Developer.  
HTTP Status Code: 400

 ** ListMicrosoftTeamsUserIdentitiesException **   
We can’t process your request right now because of a server issue. Try again later.  
HTTP Status Code: 500

## See Also
<a name="API_ListMicrosoftTeamsUserIdentities_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/chatbot-2017-10-11/ListMicrosoftTeamsUserIdentities) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/chatbot-2017-10-11/ListMicrosoftTeamsUserIdentities) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/chatbot-2017-10-11/ListMicrosoftTeamsUserIdentities) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/chatbot-2017-10-11/ListMicrosoftTeamsUserIdentities) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/chatbot-2017-10-11/ListMicrosoftTeamsUserIdentities) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/chatbot-2017-10-11/ListMicrosoftTeamsUserIdentities) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/chatbot-2017-10-11/ListMicrosoftTeamsUserIdentities) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/chatbot-2017-10-11/ListMicrosoftTeamsUserIdentities) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/chatbot-2017-10-11/ListMicrosoftTeamsUserIdentities) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/chatbot-2017-10-11/ListMicrosoftTeamsUserIdentities) 

# ListTagsForResource
<a name="API_ListTagsForResource"></a>

Lists all of the tags associated with the Amazon Resource Name (ARN) that you specify. The resource can be a user, server, or role.

## Request Syntax
<a name="API_ListTagsForResource_RequestSyntax"></a>

```
POST /list-tags-for-resource HTTP/1.1
Content-type: application/json

{
   "ResourceARN": "string"
}
```

## URI Request Parameters
<a name="API_ListTagsForResource_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_ListTagsForResource_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [ResourceARN](#API_ListTagsForResource_RequestSyntax) **   <a name="qdevinchatapps-ListTagsForResource-request-ResourceARN"></a>
The ARN of the resource to list tags for.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 1011.  
Pattern: `arn:aws:(wheatley|chatbot):[A-Za-z0-9_/.-]{0,63}:[A-Za-z0-9_/.-]{0,63}:[A-Za-z0-9][A-Za-z0-9:_/+=,@.-]{0,1023}`   
Required: Yes

## Response Syntax
<a name="API_ListTagsForResource_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "Tags": [ 
      { 
         "TagKey": "string",
         "TagValue": "string"
      }
   ]
}
```

## Response Elements
<a name="API_ListTagsForResource_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [Tags](#API_ListTagsForResource_ResponseSyntax) **   <a name="qdevinchatapps-ListTagsForResource-response-Tags"></a>
Key-value pairs that are assigned to a resource, usually for the purpose of grouping and searching for items. Tags are metadata that you define.  
Type: Array of [Tag](API_Tag.md) objects  
Array Members: Minimum number of 0 items. Maximum number of 200 items.

## Errors
<a name="API_ListTagsForResource_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InternalServiceError **   
Unexpected error during processing of request.  
HTTP Status Code: 500

 ** ResourceNotFoundException **   
We were unable to find the resource for your request  
HTTP Status Code: 404

 ** ServiceUnavailableException **   
We can’t process your request right now because of a server issue. Try again later.  
HTTP Status Code: 429

## See Also
<a name="API_ListTagsForResource_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/chatbot-2017-10-11/ListTagsForResource) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/chatbot-2017-10-11/ListTagsForResource) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/chatbot-2017-10-11/ListTagsForResource) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/chatbot-2017-10-11/ListTagsForResource) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/chatbot-2017-10-11/ListTagsForResource) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/chatbot-2017-10-11/ListTagsForResource) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/chatbot-2017-10-11/ListTagsForResource) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/chatbot-2017-10-11/ListTagsForResource) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/chatbot-2017-10-11/ListTagsForResource) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/chatbot-2017-10-11/ListTagsForResource) 

# TagResource
<a name="API_TagResource"></a>

Attaches a key-value pair to a resource, as identified by its Amazon Resource Name (ARN). Resources are users, servers, roles, and other entities.

## Request Syntax
<a name="API_TagResource_RequestSyntax"></a>

```
POST /tag-resource HTTP/1.1
Content-type: application/json

{
   "ResourceARN": "string",
   "Tags": [ 
      { 
         "TagKey": "string",
         "TagValue": "string"
      }
   ]
}
```

## URI Request Parameters
<a name="API_TagResource_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_TagResource_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [ResourceARN](#API_TagResource_RequestSyntax) **   <a name="qdevinchatapps-TagResource-request-ResourceARN"></a>
The ARN of the configuration.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 1011.  
Pattern: `arn:aws:(wheatley|chatbot):[A-Za-z0-9_/.-]{0,63}:[A-Za-z0-9_/.-]{0,63}:[A-Za-z0-9][A-Za-z0-9:_/+=,@.-]{0,1023}`   
Required: Yes

 ** [Tags](#API_TagResource_RequestSyntax) **   <a name="qdevinchatapps-TagResource-request-Tags"></a>
A list of tags to apply to the configuration.  
Type: Array of [Tag](API_Tag.md) objects  
Array Members: Minimum number of 0 items. Maximum number of 200 items.  
Required: Yes

## Response Syntax
<a name="API_TagResource_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Response Elements
<a name="API_TagResource_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.

## Errors
<a name="API_TagResource_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InternalServiceError **   
Unexpected error during processing of request.  
HTTP Status Code: 500

 ** ResourceNotFoundException **   
We were unable to find the resource for your request  
HTTP Status Code: 404

 ** ServiceUnavailableException **   
We can’t process your request right now because of a server issue. Try again later.  
HTTP Status Code: 429

 ** TooManyTagsException **   
The supplied list of tags contains too many tags.  
HTTP Status Code: 400

## See Also
<a name="API_TagResource_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/chatbot-2017-10-11/TagResource) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/chatbot-2017-10-11/TagResource) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/chatbot-2017-10-11/TagResource) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/chatbot-2017-10-11/TagResource) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/chatbot-2017-10-11/TagResource) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/chatbot-2017-10-11/TagResource) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/chatbot-2017-10-11/TagResource) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/chatbot-2017-10-11/TagResource) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/chatbot-2017-10-11/TagResource) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/chatbot-2017-10-11/TagResource) 

# UntagResource
<a name="API_UntagResource"></a>

Detaches a key-value pair from a resource, as identified by its Amazon Resource Name (ARN). Resources are users, servers, roles, and other entities.

## Request Syntax
<a name="API_UntagResource_RequestSyntax"></a>

```
POST /untag-resource HTTP/1.1
Content-type: application/json

{
   "ResourceARN": "string",
   "TagKeys": [ "string" ]
}
```

## URI Request Parameters
<a name="API_UntagResource_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_UntagResource_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [ResourceARN](#API_UntagResource_RequestSyntax) **   <a name="qdevinchatapps-UntagResource-request-ResourceARN"></a>
The value of the resource that will have the tag removed. An Amazon Resource Name (ARN) is an identifier for a specific AWS resource, such as a server, user, or role.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 1011.  
Pattern: `arn:aws:(wheatley|chatbot):[A-Za-z0-9_/.-]{0,63}:[A-Za-z0-9_/.-]{0,63}:[A-Za-z0-9][A-Za-z0-9:_/+=,@.-]{0,1023}`   
Required: Yes

 ** [TagKeys](#API_UntagResource_RequestSyntax) **   <a name="qdevinchatapps-UntagResource-request-TagKeys"></a>
TagKeys are key-value pairs assigned to ARNs that can be used to group and search for resources by type. This metadata can be attached to resources for any purpose.  
Type: Array of strings  
Array Members: Minimum number of 0 items. Maximum number of 200 items.  
Length Constraints: Minimum length of 1. Maximum length of 128.  
Required: Yes

## Response Syntax
<a name="API_UntagResource_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Response Elements
<a name="API_UntagResource_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.

## Errors
<a name="API_UntagResource_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InternalServiceError **   
Unexpected error during processing of request.  
HTTP Status Code: 500

 ** ResourceNotFoundException **   
We were unable to find the resource for your request  
HTTP Status Code: 404

 ** ServiceUnavailableException **   
We can’t process your request right now because of a server issue. Try again later.  
HTTP Status Code: 429

## See Also
<a name="API_UntagResource_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/chatbot-2017-10-11/UntagResource) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/chatbot-2017-10-11/UntagResource) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/chatbot-2017-10-11/UntagResource) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/chatbot-2017-10-11/UntagResource) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/chatbot-2017-10-11/UntagResource) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/chatbot-2017-10-11/UntagResource) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/chatbot-2017-10-11/UntagResource) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/chatbot-2017-10-11/UntagResource) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/chatbot-2017-10-11/UntagResource) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/chatbot-2017-10-11/UntagResource) 

# UpdateAccountPreferences
<a name="API_UpdateAccountPreferences"></a>

Updates Amazon Q Developer account preferences.

## Request Syntax
<a name="API_UpdateAccountPreferences_RequestSyntax"></a>

```
POST /update-account-preferences HTTP/1.1
Content-type: application/json

{
   "TrainingDataCollectionEnabled": boolean,
   "UserAuthorizationRequired": boolean
}
```

## URI Request Parameters
<a name="API_UpdateAccountPreferences_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_UpdateAccountPreferences_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [TrainingDataCollectionEnabled](#API_UpdateAccountPreferences_RequestSyntax) **   <a name="qdevinchatapps-UpdateAccountPreferences-request-TrainingDataCollectionEnabled"></a>
 This paramater is *deprecated*. For more information about Amazon Q Developer service improvements, see [Amazon Q Developer service improvement](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/service-improvement.html) in the *Amazon Q Developer User Guide*. 
Turns on training data collection.  
This helps improve the Amazon Q Developer experience by allowing Amazon Q Developer to store and use your customer information, such as Amazon Q Developer configurations, notifications, user inputs, Amazon Q Developer generated responses, and interaction data. This data helps us to continuously improve and develop Artificial Intelligence (AI) technologies. Your data is not shared with any third parties and is protected using sophisticated controls to prevent unauthorized access and misuse. Amazon Q Developer does not store or use interactions in chat channels with Amazon Q for training AI technologies for Amazon Q Developer.   
Type: Boolean  
Required: No

 ** [UserAuthorizationRequired](#API_UpdateAccountPreferences_RequestSyntax) **   <a name="qdevinchatapps-UpdateAccountPreferences-request-UserAuthorizationRequired"></a>
Enables use of a user role requirement in your chat configuration.  
Type: Boolean  
Required: No

## Response Syntax
<a name="API_UpdateAccountPreferences_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "AccountPreferences": { 
      "TrainingDataCollectionEnabled": boolean,
      "UserAuthorizationRequired": boolean
   }
}
```

## Response Elements
<a name="API_UpdateAccountPreferences_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [AccountPreferences](#API_UpdateAccountPreferences_ResponseSyntax) **   <a name="qdevinchatapps-UpdateAccountPreferences-response-AccountPreferences"></a>
Preferences related to Amazon Q Developer usage in the calling AWS account.  
Type: [AccountPreferences](API_AccountPreferences.md) object

## Errors
<a name="API_UpdateAccountPreferences_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InvalidParameterException **   
Your request input doesn't meet the constraints required by Amazon Q Developer.  
HTTP Status Code: 400

 ** InvalidRequestException **   
Your request input doesn't meet the constraints required by Amazon Q Developer.  
HTTP Status Code: 400

 ** UpdateAccountPreferencesException **   
We can’t process your request right now because of a server issue. Try again later.  
HTTP Status Code: 500

## See Also
<a name="API_UpdateAccountPreferences_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/chatbot-2017-10-11/UpdateAccountPreferences) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/chatbot-2017-10-11/UpdateAccountPreferences) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/chatbot-2017-10-11/UpdateAccountPreferences) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/chatbot-2017-10-11/UpdateAccountPreferences) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/chatbot-2017-10-11/UpdateAccountPreferences) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/chatbot-2017-10-11/UpdateAccountPreferences) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/chatbot-2017-10-11/UpdateAccountPreferences) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/chatbot-2017-10-11/UpdateAccountPreferences) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/chatbot-2017-10-11/UpdateAccountPreferences) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/chatbot-2017-10-11/UpdateAccountPreferences) 

# UpdateChimeWebhookConfiguration
<a name="API_UpdateChimeWebhookConfiguration"></a>

Updates a Amazon Chime webhook configuration.

## Request Syntax
<a name="API_UpdateChimeWebhookConfiguration_RequestSyntax"></a>

```
POST /update-chime-webhook-configuration HTTP/1.1
Content-type: application/json

{
   "ChatConfigurationArn": "string",
   "IamRoleArn": "string",
   "LoggingLevel": "string",
   "SnsTopicArns": [ "string" ],
   "WebhookDescription": "string",
   "WebhookUrl": "string"
}
```

## URI Request Parameters
<a name="API_UpdateChimeWebhookConfiguration_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_UpdateChimeWebhookConfiguration_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [ChatConfigurationArn](#API_UpdateChimeWebhookConfiguration_RequestSyntax) **   <a name="qdevinchatapps-UpdateChimeWebhookConfiguration-request-ChatConfigurationArn"></a>
The Amazon Resource Name (ARN) of the ChimeWebhookConfiguration to update.  
Type: String  
Length Constraints: Minimum length of 19. Maximum length of 1169.  
Pattern: `arn:aws:(wheatley|chatbot):[A-Za-z0-9_/.-]{0,63}:[A-Za-z0-9_/.-]{0,63}:[A-Za-z0-9][A-Za-z0-9:_/+=,@.-]{0,1023}`   
Required: Yes

 ** [IamRoleArn](#API_UpdateChimeWebhookConfiguration_RequestSyntax) **   <a name="qdevinchatapps-UpdateChimeWebhookConfiguration-request-IamRoleArn"></a>
A user-defined role that Amazon Q Developer assumes. This is not the service-linked role.  
For more information, see [IAM policies for Amazon Q Developer in chat applications](https://docs.aws.amazon.com/chatbot/latest/adminguide/chatbot-iam-policies.html) in the * Amazon Q Developer Administrator Guide*.   
Type: String  
Length Constraints: Minimum length of 12. Maximum length of 1224.  
Pattern: `arn:aws:[A-Za-z0-9][A-Za-z0-9_/.-]{0,62}:[A-Za-z0-9_/.-]{0,63}:[A-Za-z0-9_/.-]{0,63}:[A-Za-z0-9][A-Za-z0-9:_/+=,@.-]{0,1023}`   
Required: No

 ** [LoggingLevel](#API_UpdateChimeWebhookConfiguration_RequestSyntax) **   <a name="qdevinchatapps-UpdateChimeWebhookConfiguration-request-LoggingLevel"></a>
Logging levels include `ERROR`, `INFO`, or `NONE`.  
Type: String  
Length Constraints: Minimum length of 4. Maximum length of 5.  
Pattern: `(ERROR|INFO|NONE)`   
Required: No

 ** [SnsTopicArns](#API_UpdateChimeWebhookConfiguration_RequestSyntax) **   <a name="qdevinchatapps-UpdateChimeWebhookConfiguration-request-SnsTopicArns"></a>
The ARNs of the SNS topics that deliver notifications to Amazon Q Developer.  
Type: Array of strings  
Length Constraints: Minimum length of 12. Maximum length of 1224.  
Pattern: `arn:aws:[A-Za-z0-9][A-Za-z0-9_/.-]{0,62}:[A-Za-z0-9_/.-]{0,63}:[A-Za-z0-9_/.-]{0,63}:[A-Za-z0-9][A-Za-z0-9:_/+=,@.-]{0,1023}`   
Required: No

 ** [WebhookDescription](#API_UpdateChimeWebhookConfiguration_RequestSyntax) **   <a name="qdevinchatapps-UpdateChimeWebhookConfiguration-request-WebhookDescription"></a>
A description of the webhook. We recommend using the convention `RoomName/WebhookName`.  
For more information, see [Tutorial: Get started with Amazon Chime](https://docs.aws.amazon.com/chatbot/latest/adminguide/chime-setup.html) in the * Amazon Q Developer Administrator Guide*.   
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 255.  
Required: No

 ** [WebhookUrl](#API_UpdateChimeWebhookConfiguration_RequestSyntax) **   <a name="qdevinchatapps-UpdateChimeWebhookConfiguration-request-WebhookUrl"></a>
The URL for the Amazon Chime webhook.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 255.  
Pattern: `https://hooks\.chime\.aws/incomingwebhooks/[A-Za-z0-9\-]+?\?token=[A-Za-z0-9\-]+`   
Required: No

## Response Syntax
<a name="API_UpdateChimeWebhookConfiguration_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "WebhookConfiguration": { 
      "ChatConfigurationArn": "string",
      "ConfigurationName": "string",
      "IamRoleArn": "string",
      "LoggingLevel": "string",
      "SnsTopicArns": [ "string" ],
      "State": "string",
      "StateReason": "string",
      "Tags": [ 
         { 
            "TagKey": "string",
            "TagValue": "string"
         }
      ],
      "WebhookDescription": "string"
   }
}
```

## Response Elements
<a name="API_UpdateChimeWebhookConfiguration_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [WebhookConfiguration](#API_UpdateChimeWebhookConfiguration_ResponseSyntax) **   <a name="qdevinchatapps-UpdateChimeWebhookConfiguration-response-WebhookConfiguration"></a>
A Amazon Chime webhook configuration.  
Type: [ChimeWebhookConfiguration](API_ChimeWebhookConfiguration.md) object

## Errors
<a name="API_UpdateChimeWebhookConfiguration_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InvalidParameterException **   
Your request input doesn't meet the constraints required by Amazon Q Developer.  
HTTP Status Code: 400

 ** InvalidRequestException **   
Your request input doesn't meet the constraints required by Amazon Q Developer.  
HTTP Status Code: 400

 ** ResourceNotFoundException **   
We were unable to find the resource for your request  
HTTP Status Code: 404

 ** UpdateChimeWebhookConfigurationException **   
We can’t process your request right now because of a server issue. Try again later.  
HTTP Status Code: 500

## See Also
<a name="API_UpdateChimeWebhookConfiguration_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/chatbot-2017-10-11/UpdateChimeWebhookConfiguration) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/chatbot-2017-10-11/UpdateChimeWebhookConfiguration) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/chatbot-2017-10-11/UpdateChimeWebhookConfiguration) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/chatbot-2017-10-11/UpdateChimeWebhookConfiguration) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/chatbot-2017-10-11/UpdateChimeWebhookConfiguration) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/chatbot-2017-10-11/UpdateChimeWebhookConfiguration) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/chatbot-2017-10-11/UpdateChimeWebhookConfiguration) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/chatbot-2017-10-11/UpdateChimeWebhookConfiguration) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/chatbot-2017-10-11/UpdateChimeWebhookConfiguration) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/chatbot-2017-10-11/UpdateChimeWebhookConfiguration) 

# UpdateCustomAction
<a name="API_UpdateCustomAction"></a>

Updates a custom action.

## Request Syntax
<a name="API_UpdateCustomAction_RequestSyntax"></a>

```
POST /update-custom-action HTTP/1.1
Content-type: application/json

{
   "AliasName": "string",
   "Attachments": [ 
      { 
         "ButtonText": "string",
         "Criteria": [ 
            { 
               "Operator": "string",
               "Value": "string",
               "VariableName": "string"
            }
         ],
         "NotificationType": "string",
         "Variables": { 
            "string" : "string" 
         }
      }
   ],
   "CustomActionArn": "string",
   "Definition": { 
      "CommandText": "string"
   }
}
```

## URI Request Parameters
<a name="API_UpdateCustomAction_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_UpdateCustomAction_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [AliasName](#API_UpdateCustomAction_RequestSyntax) **   <a name="qdevinchatapps-UpdateCustomAction-request-AliasName"></a>
The name used to invoke this action in the chat channel. For example, `@Amazon Q run my-alias`.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 30.  
Pattern: `[A-Za-z0-9-_]+`   
Required: No

 ** [Attachments](#API_UpdateCustomAction_RequestSyntax) **   <a name="qdevinchatapps-UpdateCustomAction-request-Attachments"></a>
Defines when this custom action button should be attached to a notification.  
Type: Array of [CustomActionAttachment](API_CustomActionAttachment.md) objects  
Required: No

 ** [CustomActionArn](#API_UpdateCustomAction_RequestSyntax) **   <a name="qdevinchatapps-UpdateCustomAction-request-CustomActionArn"></a>
The fully defined Amazon Resource Name (ARN) of the custom action.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 1011.  
Pattern: `arn:aws:chatbot::[0-9]{12}:custom-action/[a-zA-Z0-9_-]{1,64}`   
Required: Yes

 ** [Definition](#API_UpdateCustomAction_RequestSyntax) **   <a name="qdevinchatapps-UpdateCustomAction-request-Definition"></a>
The definition of the command to run when invoked as an alias or as an action button.  
Type: [CustomActionDefinition](API_CustomActionDefinition.md) object  
Required: Yes

## Response Syntax
<a name="API_UpdateCustomAction_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "CustomActionArn": "string"
}
```

## Response Elements
<a name="API_UpdateCustomAction_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [CustomActionArn](#API_UpdateCustomAction_ResponseSyntax) **   <a name="qdevinchatapps-UpdateCustomAction-response-CustomActionArn"></a>
The fully defined ARN of the custom action.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 1011.  
Pattern: `arn:aws:chatbot::[0-9]{12}:custom-action/[a-zA-Z0-9_-]{1,64}` 

## Errors
<a name="API_UpdateCustomAction_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InternalServiceError **   
Unexpected error during processing of request.  
HTTP Status Code: 500

 ** InvalidRequestException **   
Your request input doesn't meet the constraints required by Amazon Q Developer.  
HTTP Status Code: 400

 ** ResourceNotFoundException **   
We were unable to find the resource for your request  
HTTP Status Code: 404

 ** UnauthorizedException **   
The request was rejected because it doesn't have valid credentials for the target resource.  
HTTP Status Code: 403

## See Also
<a name="API_UpdateCustomAction_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/chatbot-2017-10-11/UpdateCustomAction) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/chatbot-2017-10-11/UpdateCustomAction) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/chatbot-2017-10-11/UpdateCustomAction) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/chatbot-2017-10-11/UpdateCustomAction) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/chatbot-2017-10-11/UpdateCustomAction) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/chatbot-2017-10-11/UpdateCustomAction) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/chatbot-2017-10-11/UpdateCustomAction) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/chatbot-2017-10-11/UpdateCustomAction) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/chatbot-2017-10-11/UpdateCustomAction) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/chatbot-2017-10-11/UpdateCustomAction) 

# UpdateMicrosoftTeamsChannelConfiguration
<a name="API_UpdateMicrosoftTeamsChannelConfiguration"></a>

Updates an Microsoft Teams channel configuration.

## Request Syntax
<a name="API_UpdateMicrosoftTeamsChannelConfiguration_RequestSyntax"></a>

```
POST /update-ms-teams-channel-configuration HTTP/1.1
Content-type: application/json

{
   "ChannelId": "string",
   "ChannelName": "string",
   "ChatConfigurationArn": "string",
   "GuardrailPolicyArns": [ "string" ],
   "IamRoleArn": "string",
   "LoggingLevel": "string",
   "SnsTopicArns": [ "string" ],
   "UserAuthorizationRequired": boolean
}
```

## URI Request Parameters
<a name="API_UpdateMicrosoftTeamsChannelConfiguration_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_UpdateMicrosoftTeamsChannelConfiguration_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [ChannelId](#API_UpdateMicrosoftTeamsChannelConfiguration_RequestSyntax) **   <a name="qdevinchatapps-UpdateMicrosoftTeamsChannelConfiguration-request-ChannelId"></a>
The ID of the Microsoft Teams channel.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 255.  
Pattern: `([a-zA-Z0-9-_=+\/.,])*%3[aA]([a-zA-Z0-9-_=+\/.,])*%40([a-zA-Z0-9-_=+\/.,])*`   
Required: Yes

 ** [ChannelName](#API_UpdateMicrosoftTeamsChannelConfiguration_RequestSyntax) **   <a name="qdevinchatapps-UpdateMicrosoftTeamsChannelConfiguration-request-ChannelName"></a>
The name of the Microsoft Teams channel.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 1000.  
Pattern: `(.*)`   
Required: No

 ** [ChatConfigurationArn](#API_UpdateMicrosoftTeamsChannelConfiguration_RequestSyntax) **   <a name="qdevinchatapps-UpdateMicrosoftTeamsChannelConfiguration-request-ChatConfigurationArn"></a>
The Amazon Resource Name (ARN) of the TeamsChannelConfiguration to update.  
Type: String  
Length Constraints: Minimum length of 19. Maximum length of 1169.  
Pattern: `arn:aws:(wheatley|chatbot):[A-Za-z0-9_/.-]{0,63}:[A-Za-z0-9_/.-]{0,63}:[A-Za-z0-9][A-Za-z0-9:_/+=,@.-]{0,1023}`   
Required: Yes

 ** [GuardrailPolicyArns](#API_UpdateMicrosoftTeamsChannelConfiguration_RequestSyntax) **   <a name="qdevinchatapps-UpdateMicrosoftTeamsChannelConfiguration-request-GuardrailPolicyArns"></a>
The list of IAM policy ARNs that are applied as channel guardrails. The AWS managed `AdministratorAccess` policy is applied by default if this is not set.   
Type: Array of strings  
Length Constraints: Minimum length of 11. Maximum length of 1163.  
Pattern: `(^$|(?!.*\/aws-service-role\/.*)arn:aws:iam:[A-Za-z0-9_\/.-]{0,63}:[A-Za-z0-9_\/.-]{0,63}:[A-Za-z0-9][A-Za-z0-9:_\/+=,@.-]{0,1023})`   
Required: No

 ** [IamRoleArn](#API_UpdateMicrosoftTeamsChannelConfiguration_RequestSyntax) **   <a name="qdevinchatapps-UpdateMicrosoftTeamsChannelConfiguration-request-IamRoleArn"></a>
A user-defined role that Amazon Q Developer assumes. This is not the service-linked role.  
For more information, see [IAM policies for Amazon Q Developer](https://docs.aws.amazon.com/chatbot/latest/adminguide/chatbot-iam-policies.html) in the * Amazon Q Developer Administrator Guide*.   
Type: String  
Length Constraints: Minimum length of 12. Maximum length of 1224.  
Pattern: `arn:aws:[A-Za-z0-9][A-Za-z0-9_/.-]{0,62}:[A-Za-z0-9_/.-]{0,63}:[A-Za-z0-9_/.-]{0,63}:[A-Za-z0-9][A-Za-z0-9:_/+=,@.-]{0,1023}`   
Required: No

 ** [LoggingLevel](#API_UpdateMicrosoftTeamsChannelConfiguration_RequestSyntax) **   <a name="qdevinchatapps-UpdateMicrosoftTeamsChannelConfiguration-request-LoggingLevel"></a>
Logging levels include `ERROR`, `INFO`, or `NONE`.  
Type: String  
Length Constraints: Minimum length of 4. Maximum length of 5.  
Pattern: `(ERROR|INFO|NONE)`   
Required: No

 ** [SnsTopicArns](#API_UpdateMicrosoftTeamsChannelConfiguration_RequestSyntax) **   <a name="qdevinchatapps-UpdateMicrosoftTeamsChannelConfiguration-request-SnsTopicArns"></a>
The Amazon Resource Names (ARNs) of the SNS topics that deliver notifications to Amazon Q Developer.  
Type: Array of strings  
Length Constraints: Minimum length of 12. Maximum length of 1224.  
Pattern: `arn:aws:[A-Za-z0-9][A-Za-z0-9_/.-]{0,62}:[A-Za-z0-9_/.-]{0,63}:[A-Za-z0-9_/.-]{0,63}:[A-Za-z0-9][A-Za-z0-9:_/+=,@.-]{0,1023}`   
Required: No

 ** [UserAuthorizationRequired](#API_UpdateMicrosoftTeamsChannelConfiguration_RequestSyntax) **   <a name="qdevinchatapps-UpdateMicrosoftTeamsChannelConfiguration-request-UserAuthorizationRequired"></a>
Enables use of a user role requirement in your chat configuration.  
Type: Boolean  
Required: No

## Response Syntax
<a name="API_UpdateMicrosoftTeamsChannelConfiguration_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "ChannelConfiguration": { 
      "ChannelId": "string",
      "ChannelName": "string",
      "ChatConfigurationArn": "string",
      "ConfigurationName": "string",
      "GuardrailPolicyArns": [ "string" ],
      "IamRoleArn": "string",
      "LoggingLevel": "string",
      "SnsTopicArns": [ "string" ],
      "State": "string",
      "StateReason": "string",
      "Tags": [ 
         { 
            "TagKey": "string",
            "TagValue": "string"
         }
      ],
      "TeamId": "string",
      "TeamName": "string",
      "TenantId": "string",
      "UserAuthorizationRequired": boolean
   }
}
```

## Response Elements
<a name="API_UpdateMicrosoftTeamsChannelConfiguration_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [ChannelConfiguration](#API_UpdateMicrosoftTeamsChannelConfiguration_ResponseSyntax) **   <a name="qdevinchatapps-UpdateMicrosoftTeamsChannelConfiguration-response-ChannelConfiguration"></a>
The configuration for a Microsoft Teams channel configured with Amazon Q Developer.  
Type: [TeamsChannelConfiguration](API_TeamsChannelConfiguration.md) object

## Errors
<a name="API_UpdateMicrosoftTeamsChannelConfiguration_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InvalidParameterException **   
Your request input doesn't meet the constraints required by Amazon Q Developer.  
HTTP Status Code: 400

 ** InvalidRequestException **   
Your request input doesn't meet the constraints required by Amazon Q Developer.  
HTTP Status Code: 400

 ** ResourceNotFoundException **   
We were unable to find the resource for your request  
HTTP Status Code: 404

 ** UpdateTeamsChannelConfigurationException **   
We can’t process your request right now because of a server issue. Try again later.  
HTTP Status Code: 500

## See Also
<a name="API_UpdateMicrosoftTeamsChannelConfiguration_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/chatbot-2017-10-11/UpdateMicrosoftTeamsChannelConfiguration) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/chatbot-2017-10-11/UpdateMicrosoftTeamsChannelConfiguration) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/chatbot-2017-10-11/UpdateMicrosoftTeamsChannelConfiguration) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/chatbot-2017-10-11/UpdateMicrosoftTeamsChannelConfiguration) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/chatbot-2017-10-11/UpdateMicrosoftTeamsChannelConfiguration) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/chatbot-2017-10-11/UpdateMicrosoftTeamsChannelConfiguration) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/chatbot-2017-10-11/UpdateMicrosoftTeamsChannelConfiguration) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/chatbot-2017-10-11/UpdateMicrosoftTeamsChannelConfiguration) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/chatbot-2017-10-11/UpdateMicrosoftTeamsChannelConfiguration) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/chatbot-2017-10-11/UpdateMicrosoftTeamsChannelConfiguration) 

# UpdateSlackChannelConfiguration
<a name="API_UpdateSlackChannelConfiguration"></a>

Updates a Slack channel configuration.

## Request Syntax
<a name="API_UpdateSlackChannelConfiguration_RequestSyntax"></a>

```
POST /update-slack-channel-configuration HTTP/1.1
Content-type: application/json

{
   "ChatConfigurationArn": "string",
   "GuardrailPolicyArns": [ "string" ],
   "IamRoleArn": "string",
   "LoggingLevel": "string",
   "SlackChannelId": "string",
   "SlackChannelName": "string",
   "SnsTopicArns": [ "string" ],
   "UserAuthorizationRequired": boolean
}
```

## URI Request Parameters
<a name="API_UpdateSlackChannelConfiguration_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_UpdateSlackChannelConfiguration_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [ChatConfigurationArn](#API_UpdateSlackChannelConfiguration_RequestSyntax) **   <a name="qdevinchatapps-UpdateSlackChannelConfiguration-request-ChatConfigurationArn"></a>
The Amazon Resource Name (ARN) of the SlackChannelConfiguration to update.  
Type: String  
Length Constraints: Minimum length of 19. Maximum length of 1169.  
Pattern: `arn:aws:(wheatley|chatbot):[A-Za-z0-9_/.-]{0,63}:[A-Za-z0-9_/.-]{0,63}:[A-Za-z0-9][A-Za-z0-9:_/+=,@.-]{0,1023}`   
Required: Yes

 ** [GuardrailPolicyArns](#API_UpdateSlackChannelConfiguration_RequestSyntax) **   <a name="qdevinchatapps-UpdateSlackChannelConfiguration-request-GuardrailPolicyArns"></a>
The list of IAM policy ARNs that are applied as channel guardrails. The AWS managed `AdministratorAccess` policy is applied by default if this is not set.   
Type: Array of strings  
Length Constraints: Minimum length of 11. Maximum length of 1163.  
Pattern: `(^$|(?!.*\/aws-service-role\/.*)arn:aws:iam:[A-Za-z0-9_\/.-]{0,63}:[A-Za-z0-9_\/.-]{0,63}:[A-Za-z0-9][A-Za-z0-9:_\/+=,@.-]{0,1023})`   
Required: No

 ** [IamRoleArn](#API_UpdateSlackChannelConfiguration_RequestSyntax) **   <a name="qdevinchatapps-UpdateSlackChannelConfiguration-request-IamRoleArn"></a>
A user-defined role that Amazon Q Developer assumes. This is not the service-linked role.  
For more information, see [IAM policies for Amazon Q Developer](https://docs.aws.amazon.com/chatbot/latest/adminguide/chatbot-iam-policies.html) in the * Amazon Q Developer Administrator Guide*.   
Type: String  
Length Constraints: Minimum length of 12. Maximum length of 1224.  
Pattern: `arn:aws:[A-Za-z0-9][A-Za-z0-9_/.-]{0,62}:[A-Za-z0-9_/.-]{0,63}:[A-Za-z0-9_/.-]{0,63}:[A-Za-z0-9][A-Za-z0-9:_/+=,@.-]{0,1023}`   
Required: No

 ** [LoggingLevel](#API_UpdateSlackChannelConfiguration_RequestSyntax) **   <a name="qdevinchatapps-UpdateSlackChannelConfiguration-request-LoggingLevel"></a>
Logging levels include `ERROR`, `INFO`, or `NONE`.  
Type: String  
Length Constraints: Minimum length of 4. Maximum length of 5.  
Pattern: `(ERROR|INFO|NONE)`   
Required: No

 ** [SlackChannelId](#API_UpdateSlackChannelConfiguration_RequestSyntax) **   <a name="qdevinchatapps-UpdateSlackChannelConfiguration-request-SlackChannelId"></a>
The ID of the Slack channel.  
To get this ID, open Slack, right click on the channel name in the left pane, then choose Copy Link. The channel ID is the 9-character string at the end of the URL. For example, ABCBBLZZZ.   
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 255.  
Pattern: `[A-Za-z0-9]+`   
Required: Yes

 ** [SlackChannelName](#API_UpdateSlackChannelConfiguration_RequestSyntax) **   <a name="qdevinchatapps-UpdateSlackChannelConfiguration-request-SlackChannelName"></a>
The name of the Slack channel.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 255.  
Required: No

 ** [SnsTopicArns](#API_UpdateSlackChannelConfiguration_RequestSyntax) **   <a name="qdevinchatapps-UpdateSlackChannelConfiguration-request-SnsTopicArns"></a>
The Amazon Resource Names (ARNs) of the SNS topics that deliver notifications to Amazon Q Developer.  
Type: Array of strings  
Length Constraints: Minimum length of 12. Maximum length of 1224.  
Pattern: `arn:aws:[A-Za-z0-9][A-Za-z0-9_/.-]{0,62}:[A-Za-z0-9_/.-]{0,63}:[A-Za-z0-9_/.-]{0,63}:[A-Za-z0-9][A-Za-z0-9:_/+=,@.-]{0,1023}`   
Required: No

 ** [UserAuthorizationRequired](#API_UpdateSlackChannelConfiguration_RequestSyntax) **   <a name="qdevinchatapps-UpdateSlackChannelConfiguration-request-UserAuthorizationRequired"></a>
Enables use of a user role requirement in your chat configuration.  
Type: Boolean  
Required: No

## Response Syntax
<a name="API_UpdateSlackChannelConfiguration_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "ChannelConfiguration": { 
      "ChatConfigurationArn": "string",
      "ConfigurationName": "string",
      "GuardrailPolicyArns": [ "string" ],
      "IamRoleArn": "string",
      "LoggingLevel": "string",
      "SlackChannelId": "string",
      "SlackChannelName": "string",
      "SlackTeamId": "string",
      "SlackTeamName": "string",
      "SnsTopicArns": [ "string" ],
      "State": "string",
      "StateReason": "string",
      "Tags": [ 
         { 
            "TagKey": "string",
            "TagValue": "string"
         }
      ],
      "UserAuthorizationRequired": boolean
   }
}
```

## Response Elements
<a name="API_UpdateSlackChannelConfiguration_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [ChannelConfiguration](#API_UpdateSlackChannelConfiguration_ResponseSyntax) **   <a name="qdevinchatapps-UpdateSlackChannelConfiguration-response-ChannelConfiguration"></a>
The configuration for a Slack channel configured with Amazon Q Developer.  
Type: [SlackChannelConfiguration](API_SlackChannelConfiguration.md) object

## Errors
<a name="API_UpdateSlackChannelConfiguration_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** InvalidParameterException **   
Your request input doesn't meet the constraints required by Amazon Q Developer.  
HTTP Status Code: 400

 ** InvalidRequestException **   
Your request input doesn't meet the constraints required by Amazon Q Developer.  
HTTP Status Code: 400

 ** ResourceNotFoundException **   
We were unable to find the resource for your request  
HTTP Status Code: 404

 ** UpdateSlackChannelConfigurationException **   
We can’t process your request right now because of a server issue. Try again later.  
HTTP Status Code: 500

## See Also
<a name="API_UpdateSlackChannelConfiguration_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/chatbot-2017-10-11/UpdateSlackChannelConfiguration) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/chatbot-2017-10-11/UpdateSlackChannelConfiguration) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/chatbot-2017-10-11/UpdateSlackChannelConfiguration) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/chatbot-2017-10-11/UpdateSlackChannelConfiguration) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/chatbot-2017-10-11/UpdateSlackChannelConfiguration) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/chatbot-2017-10-11/UpdateSlackChannelConfiguration) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/chatbot-2017-10-11/UpdateSlackChannelConfiguration) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/chatbot-2017-10-11/UpdateSlackChannelConfiguration) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/chatbot-2017-10-11/UpdateSlackChannelConfiguration) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/chatbot-2017-10-11/UpdateSlackChannelConfiguration)