CreateAssistantAssociation - Amazon Connect Wisdom


Creates an association between an Amazon Connect Wisdom assistant and another resource. Currently, the only supported association is with a knowledge base. An assistant can have only a single association.

Request Syntax

POST /assistants/assistantId/associations HTTP/1.1 Content-type: application/json { "association": { "knowledgeBaseId": "string" }, "associationType": "string", "clientToken": "string", "tags": { "string" : "string" } }

URI Request Parameters

The request uses the following URI parameters.


The identifier of the Wisdom assistant. Can be either the ID or the ARN. URLs cannot contain the ARN.

Pattern: ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$|^arn:[a-z-]*?:wisdom:[a-z0-9-]*?:[0-9]{12}:[a-z-]*?/[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}(?:/[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12})?$

Required: Yes

Request Body

The request accepts the following data in JSON format.


The identifier of the associated resource.

Type: AssistantAssociationInputData object

Required: Yes


The type of association.

Type: String


Required: Yes


A unique, case-sensitive identifier that you provide to ensure the idempotency of the request.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 4096.

Required: No


The tags used to organize, track, or control access for this resource.

Type: String to string map

Key Length Constraints: Minimum length of 1. Maximum length of 128.

Key Pattern: ^(?!aws:)[a-zA-Z+-=._:/]+$

Value Length Constraints: Minimum length of 1. Maximum length of 256.

Required: No

Response Syntax

HTTP/1.1 200 Content-type: application/json { "assistantAssociation": { "assistantArn": "string", "assistantAssociationArn": "string", "assistantAssociationId": "string", "assistantId": "string", "associationData": { "knowledgeBaseAssociation": { "knowledgeBaseArn": "string", "knowledgeBaseId": "string" } }, "associationType": "string", "tags": { "string" : "string" } } }

Response Elements

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

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


The assistant association.

Type: AssistantAssociationData object


For information about the errors that are common to all actions, see Common Errors.


You do not have sufficient access to perform this action.

HTTP Status Code: 403


The request could not be processed because of conflict in the current state of the resource. For example, if you're using a Create API (such as CreateAssistant) that accepts name, a conflicting resource (usually with the same name) is being created or mutated.

HTTP Status Code: 409


The specified resource does not exist.

HTTP Status Code: 404


You've exceeded your service quota. To perform the requested action, remove some of the relevant resources, or use service quotas to request a service quota increase.

HTTP Status Code: 402


The input fails to satisfy the constraints specified by a service.

HTTP Status Code: 400

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following: