# PutChannelExpirationSettings


Sets the number of days before the channel is automatically deleted.

**Note**  
A background process deletes expired channels within 6 hours of expiration. Actual deletion times may vary.
Expired channels that have not yet been deleted appear as active, and you can update their expiration settings. The system honors the new settings.
The `x-amz-chime-bearer` request header is mandatory. Use the ARN of the `AppInstanceUser` or `AppInstanceBot` that makes the API call as the value in the header.

## Request Syntax


```
PUT /channels/channelArn/expiration-settings HTTP/1.1
x-amz-chime-bearer: ChimeBearer
Content-type: application/json

{
   "ExpirationSettings": { 
      "ExpirationCriterion": "string",
      "ExpirationDays": number
   }
}
```

## URI Request Parameters


The request uses the following URI parameters.

 ** [channelArn](#API_messaging-chime_PutChannelExpirationSettings_RequestSyntax) **   <a name="chimesdk-messaging-chime_PutChannelExpirationSettings-request-uri-ChannelArn"></a>
The ARN of the channel.  
Length Constraints: Minimum length of 5. Maximum length of 1600.  
Pattern: `arn:[a-z0-9-\.]{1,63}:[a-z0-9-\.]{0,63}:[a-z0-9-\.]{0,63}:[a-z0-9-\.]{0,63}:[^/].{0,1023}`   
Required: Yes

 ** [ChimeBearer](#API_messaging-chime_PutChannelExpirationSettings_RequestSyntax) **   <a name="chimesdk-messaging-chime_PutChannelExpirationSettings-request-ChimeBearer"></a>
The ARN of the `AppInstanceUser` or `AppInstanceBot` that makes the API call.  
Length Constraints: Minimum length of 5. Maximum length of 1600.  
Pattern: `arn:[a-z0-9-\.]{1,63}:[a-z0-9-\.]{0,63}:[a-z0-9-\.]{0,63}:[a-z0-9-\.]{0,63}:[^/].{0,1023}` 

## Request Body


The request accepts the following data in JSON format.

 ** [ExpirationSettings](#API_messaging-chime_PutChannelExpirationSettings_RequestSyntax) **   <a name="chimesdk-messaging-chime_PutChannelExpirationSettings-request-ExpirationSettings"></a>
Settings that control the interval after which a channel is deleted.  
Type: [ExpirationSettings](API_messaging-chime_ExpirationSettings.md) object  
Required: No

## Response Syntax


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

{
   "ChannelArn": "string",
   "ExpirationSettings": { 
      "ExpirationCriterion": "string",
      "ExpirationDays": number
   }
}
```

## 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.

 ** [ChannelArn](#API_messaging-chime_PutChannelExpirationSettings_ResponseSyntax) **   <a name="chimesdk-messaging-chime_PutChannelExpirationSettings-response-ChannelArn"></a>
The channel ARN.  
Type: String  
Length Constraints: Minimum length of 5. Maximum length of 1600.  
Pattern: `arn:[a-z0-9-\.]{1,63}:[a-z0-9-\.]{0,63}:[a-z0-9-\.]{0,63}:[a-z0-9-\.]{0,63}:[^/].{0,1023}` 

 ** [ExpirationSettings](#API_messaging-chime_PutChannelExpirationSettings_ResponseSyntax) **   <a name="chimesdk-messaging-chime_PutChannelExpirationSettings-response-ExpirationSettings"></a>
Settings that control the interval after which a channel is deleted.  
Type: [ExpirationSettings](API_messaging-chime_ExpirationSettings.md) object

## Errors


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

 ** BadRequestException **   
The input parameters don't match the service's restrictions.  
HTTP Status Code: 400

 ** ConflictException **   
The request could not be processed because of conflict in the current state of the resource.  
HTTP Status Code: 409

 ** ForbiddenException **   
The client is permanently forbidden from making the request.  
HTTP Status Code: 403

 ** ServiceFailureException **   
The service encountered an unexpected error.  
HTTP Status Code: 500

 ** ServiceUnavailableException **   
The service is currently unavailable.  
HTTP Status Code: 503

 ** ThrottledClientException **   
The client exceeded its request rate limit.  
HTTP Status Code: 429

 ** UnauthorizedClientException **   
The client is not currently authorized to make the request.  
HTTP Status Code: 401

## See Also


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/chime-sdk-messaging-2021-05-15/PutChannelExpirationSettings) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/chime-sdk-messaging-2021-05-15/PutChannelExpirationSettings) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/chime-sdk-messaging-2021-05-15/PutChannelExpirationSettings) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/chime-sdk-messaging-2021-05-15/PutChannelExpirationSettings) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/chime-sdk-messaging-2021-05-15/PutChannelExpirationSettings) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/chime-sdk-messaging-2021-05-15/PutChannelExpirationSettings) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/chime-sdk-messaging-2021-05-15/PutChannelExpirationSettings) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/chime-sdk-messaging-2021-05-15/PutChannelExpirationSettings) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/chime-sdk-messaging-2021-05-15/PutChannelExpirationSettings) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/chime-sdk-messaging-2021-05-15/PutChannelExpirationSettings)