Amazon Connect Service

2026/04/24 - Amazon Connect Service - 3 new api methods

Changes  Amazon Connect is expanding attachment capabilities to give customers greater flexibility and control. Currently limited to predefined file types, the new feature will allow contact center administrators to customize which file extensions and sizes are supported across chat, email, tasks, and cases.

ListAttachedFilesConfigurations (new) Link ¶

Provides summary information about the attached files configurations for the specified Amazon Connect instance.

This API returns effective configurations (custom overrides or defaults) for each attachment scope. If no custom configuration exists for a scope, the default configuration values are returned.

See also: AWS API Documentation

Request Syntax

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

string

param InstanceId:

[REQUIRED]

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

type MaxResults:

integer

param MaxResults:

The maximum number of results to return per page. The default MaxResult size is 100.

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.

rtype:

dict

returns:

Response Syntax

{
    'AttachedFilesConfigurations': [
        {
            'InstanceId': 'string',
            'AttachmentScope': 'EMAIL'|'CHAT'|'CASE'|'TASK',
            'MaximumSizeLimitInBytes': 123,
            'ExtensionConfiguration': {
                'AllowedExtensions': [
                    {
                        'Extension': 'string'
                    },
                ]
            }
        },
    ],
    'NextToken': 'string'
}

Response Structure

  • (dict) --

    • AttachedFilesConfigurations (list) --

      Information about the attached files configurations.

      • (dict) --

        A summary of the attached files configuration.

        • InstanceId (string) --

          The identifier of the Amazon Connect instance.

        • AttachmentScope (string) --

          The scope of the attachment. Valid values are EMAIL, CHAT, CASE, and TASK.

        • MaximumSizeLimitInBytes (integer) --

          The maximum size limit for attached files in bytes. The minimum value is 1 and the maximum value is 104857600 (100 MB).

        • ExtensionConfiguration (dict) --

          The configuration for allowed file extensions.

          • AllowedExtensions (list) --

            The list of allowed file extensions.

            • (dict) --

              Information about an allowed file extension.

              • Extension (string) --

                The file extension. The extension must be between 1 and 10 characters and can contain only alphanumeric characters, hyphens, and underscores.

    • NextToken (string) --

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

DescribeAttachedFilesConfiguration (new) Link ¶

Describes the attached files configuration for the specified Amazon Connect instance and attachment scope.

If a custom configuration exists for the specified attachment scope, the custom configuration is returned. If no custom configuration exists, the default configuration values for that attachment scope are returned.

See also: AWS API Documentation

Request Syntax

client.describe_attached_files_configuration(
    InstanceId='string',
    AttachmentScope='EMAIL'|'CHAT'|'CASE'|'TASK'
)
type InstanceId:

string

param InstanceId:

[REQUIRED]

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

type AttachmentScope:

string

param AttachmentScope:

[REQUIRED]

The scope of the attachment. Valid values are EMAIL, CHAT, CASE, and TASK.

rtype:

dict

returns:

Response Syntax

{
    'AttachedFilesConfiguration': {
        'InstanceId': 'string',
        'AttachmentScope': 'EMAIL'|'CHAT'|'CASE'|'TASK',
        'MaximumSizeLimitInBytes': 123,
        'ExtensionConfiguration': {
            'AllowedExtensions': [
                {
                    'Extension': 'string'
                },
            ]
        },
        'LastModifiedTime': datetime(2015, 1, 1)
    }
}

Response Structure

  • (dict) --

    • AttachedFilesConfiguration (dict) --

      Information about the attached files configuration.

      • InstanceId (string) --

        The identifier of the Amazon Connect instance.

      • AttachmentScope (string) --

        The scope of the attachment. Valid values are EMAIL, CHAT, CASE, and TASK.

      • MaximumSizeLimitInBytes (integer) --

        The maximum size limit for attached files in bytes.

      • ExtensionConfiguration (dict) --

        The configuration for allowed file extensions.

        • AllowedExtensions (list) --

          The list of allowed file extensions.

          • (dict) --

            Information about an allowed file extension.

            • Extension (string) --

              The file extension. The extension must be between 1 and 10 characters and can contain only alphanumeric characters, hyphens, and underscores.

      • LastModifiedTime (datetime) --

        The timestamp when the configuration was last modified.

UpdateAttachedFilesConfiguration (new) Link ¶

Updates the attached files configuration for the specified Amazon Connect instance and attachment scope.

If no instance-specific configuration exists, this operation creates one. Partial updates are supported—only specified fields are updated, while unspecified fields retain their current values.

See also: AWS API Documentation

Request Syntax

client.update_attached_files_configuration(
    InstanceId='string',
    AttachmentScope='EMAIL'|'CHAT'|'CASE'|'TASK',
    MaximumSizeLimitInBytes=123,
    ExtensionConfiguration={
        'AllowedExtensions': [
            {
                'Extension': 'string'
            },
        ]
    }
)
type InstanceId:

string

param InstanceId:

[REQUIRED]

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

type AttachmentScope:

string

param AttachmentScope:

[REQUIRED]

The scope of the attachment. Valid values are EMAIL, CHAT, CASE, and TASK.

type MaximumSizeLimitInBytes:

integer

param MaximumSizeLimitInBytes:

The maximum size limit for attached files in bytes. The minimum value is 1 and the maximum value is 104857600 (100 MB).

type ExtensionConfiguration:

dict

param ExtensionConfiguration:

The configuration for allowed file extensions.

  • AllowedExtensions (list) -- [REQUIRED]

    The list of allowed file extensions.

    • (dict) --

      Information about an allowed file extension.

      • Extension (string) -- [REQUIRED]

        The file extension. The extension must be between 1 and 10 characters and can contain only alphanumeric characters, hyphens, and underscores.

rtype:

dict

returns:

Response Syntax

{
    'InstanceId': 'string',
    'AttachmentScope': 'EMAIL'|'CHAT'|'CASE'|'TASK',
    'MaximumSizeLimitInBytes': 123,
    'ExtensionConfiguration': {
        'AllowedExtensions': [
            {
                'Extension': 'string'
            },
        ]
    },
    'LastModifiedTime': datetime(2015, 1, 1)
}

Response Structure

  • (dict) --

    • InstanceId (string) --

      The identifier of the Amazon Connect instance.

    • AttachmentScope (string) --

      The scope of the attachment.

    • MaximumSizeLimitInBytes (integer) --

      The maximum size limit for attached files in bytes.

    • ExtensionConfiguration (dict) --

      The configuration for allowed file extensions.

      • AllowedExtensions (list) --

        The list of allowed file extensions.

        • (dict) --

          Information about an allowed file extension.

          • Extension (string) --

            The file extension. The extension must be between 1 and 10 characters and can contain only alphanumeric characters, hyphens, and underscores.

    • LastModifiedTime (datetime) --

      The timestamp when the configuration was last modified.