Amazon Connect Service

2026/09/25 - Amazon Connect Service - 3 updated api methods

Changes  Agent Privacy During Hold is a new privacy capability for Amazon Connect Voice that prevents agent audio from being captured in call recordings or Contact Lens conversational analytics during hold. When enabled, agents are automatically muted on entering hold and unmuted on resuming the contact

DescribeInstanceAttribute (updated) Link ¶
Changes (request, response)
Request
{'AttributeType': {'AUTO_MUTE_AGENT_ON_HOLD'}}
Response
{'Attribute': {'AttributeType': {'AUTO_MUTE_AGENT_ON_HOLD'}}}

This API is in preview release for Connect Customer and is subject to change.

Describes the specified instance attribute.

See also: AWS API Documentation

Request Syntax

client.describe_instance_attribute(
    InstanceId='string',
    AttributeType='INBOUND_CALLS'|'OUTBOUND_CALLS'|'CONTACTFLOW_LOGS'|'CONTACT_LENS'|'AUTO_RESOLVE_BEST_VOICES'|'USE_CUSTOM_TTS_VOICES'|'EARLY_MEDIA'|'MULTI_PARTY_CONFERENCE'|'AUTO_MUTE_AGENT_ON_HOLD'|'HIGH_VOLUME_OUTBOUND'|'ENHANCED_CONTACT_MONITORING'|'ENHANCED_CHAT_MONITORING'|'MULTI_PARTY_CHAT_CONFERENCE'|'MESSAGE_STREAMING'
)
type InstanceId:

string

param InstanceId:

[REQUIRED]

The identifier of the Connect Customer instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.

type AttributeType:

string

param AttributeType:

[REQUIRED]

The type of attribute.

rtype:

dict

returns:

Response Syntax

{
    'Attribute': {
        'AttributeType': 'INBOUND_CALLS'|'OUTBOUND_CALLS'|'CONTACTFLOW_LOGS'|'CONTACT_LENS'|'AUTO_RESOLVE_BEST_VOICES'|'USE_CUSTOM_TTS_VOICES'|'EARLY_MEDIA'|'MULTI_PARTY_CONFERENCE'|'AUTO_MUTE_AGENT_ON_HOLD'|'HIGH_VOLUME_OUTBOUND'|'ENHANCED_CONTACT_MONITORING'|'ENHANCED_CHAT_MONITORING'|'MULTI_PARTY_CHAT_CONFERENCE'|'MESSAGE_STREAMING',
        'Value': 'string'
    }
}

Response Structure

  • (dict) --

    • Attribute (dict) --

      The type of attribute.

      • AttributeType (string) --

        The type of attribute.

      • Value (string) --

        The value of the attribute.

ListInstanceAttributes (updated) Link ¶
Changes (response)
{'Attributes': {'AttributeType': {'AUTO_MUTE_AGENT_ON_HOLD'}}}

This API is in preview release for Connect Customer and is subject to change.

Returns a paginated list of all attribute types for the given instance.

See also: AWS API Documentation

Request Syntax

client.list_instance_attributes(
    InstanceId='string',
    NextToken='string',
    MaxResults=123
)
type InstanceId:

string

param InstanceId:

[REQUIRED]

The identifier of the Connect Customer instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.

type NextToken:

string

param NextToken:

The token for the next set of results. Use the value returned in the previous response in the next request to retrieve the next set of results.

type MaxResults:

integer

param MaxResults:

The maximum number of results to return per page.

rtype:

dict

returns:

Response Syntax

{
    'Attributes': [
        {
            'AttributeType': 'INBOUND_CALLS'|'OUTBOUND_CALLS'|'CONTACTFLOW_LOGS'|'CONTACT_LENS'|'AUTO_RESOLVE_BEST_VOICES'|'USE_CUSTOM_TTS_VOICES'|'EARLY_MEDIA'|'MULTI_PARTY_CONFERENCE'|'AUTO_MUTE_AGENT_ON_HOLD'|'HIGH_VOLUME_OUTBOUND'|'ENHANCED_CONTACT_MONITORING'|'ENHANCED_CHAT_MONITORING'|'MULTI_PARTY_CHAT_CONFERENCE'|'MESSAGE_STREAMING',
            'Value': 'string'
        },
    ],
    'NextToken': 'string'
}

Response Structure

  • (dict) --

    • Attributes (list) --

      The attribute types.

      • (dict) --

        A toggle for an individual feature at the instance level.

        • AttributeType (string) --

          The type of attribute.

        • Value (string) --

          The value of the attribute.

    • NextToken (string) --

      If there are additional results, this is the token for the next set of results.

UpdateInstanceAttribute (updated) Link ¶
Changes (request)
{'AttributeType': {'AUTO_MUTE_AGENT_ON_HOLD'}}

This API is in preview release for Connect Customer and is subject to change.

Updates the value for the specified attribute type.

See also: AWS API Documentation

Request Syntax

client.update_instance_attribute(
    InstanceId='string',
    AttributeType='INBOUND_CALLS'|'OUTBOUND_CALLS'|'CONTACTFLOW_LOGS'|'CONTACT_LENS'|'AUTO_RESOLVE_BEST_VOICES'|'USE_CUSTOM_TTS_VOICES'|'EARLY_MEDIA'|'MULTI_PARTY_CONFERENCE'|'AUTO_MUTE_AGENT_ON_HOLD'|'HIGH_VOLUME_OUTBOUND'|'ENHANCED_CONTACT_MONITORING'|'ENHANCED_CHAT_MONITORING'|'MULTI_PARTY_CHAT_CONFERENCE'|'MESSAGE_STREAMING',
    Value='string',
    ClientToken='string'
)
type InstanceId:

string

param InstanceId:

[REQUIRED]

The identifier of the Connect Customer instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.

type AttributeType:

string

param AttributeType:

[REQUIRED]

The type of attribute.

type Value:

string

param Value:

[REQUIRED]

The value for the attribute. Maximum character limit is 100.

type ClientToken:

string

param ClientToken:

A unique, case-sensitive identifier that you provide to ensure the idempotency of the request. If not provided, the Amazon Web Services SDK populates this field. For more information about idempotency, see Making retries safe with idempotent APIs.

This field is autopopulated if not provided.

returns:

None