---
title: "PUT /app-instance-users/{appInstanceUserArn}/expiration-settings"
method: PUT
path: "/app-instance-users/{appInstanceUserArn}/expiration-settings"
---

# PUT /app-instance-users/{appInstanceUserArn}/expiration-settings

`PUT /app-instance-users/{appInstanceUserArn}/expiration-settings`

Sets the number of days before the `AppInstanceUser` is automatically deleted.

A background process deletes expired `AppInstanceUsers` within 6 hours of expiration. Actual deletion times may vary.

Expired `AppInstanceUsers` that have not yet been deleted appear as active, and you can update their expiration settings. The system honors the new settings.

## Path parameters

- `appInstanceUserArn` string, required

## Request body

- object
  - `ExpirationSettings` object — Determines the interval after which an <code>AppInstanceUser</code> is automatically deleted.
    - `ExpirationDays` integer — The period in days after which an <code>AppInstanceUser</code> will be automatically deleted.
    - `ExpirationCriterion` 'CREATED_TIMESTAMP' — Specifies the conditions under which an <code>AppInstanceUser</code> will expire.

## Response `200`

Success

- PutAppInstanceUserExpirationSettingsResponse
  - `AppInstanceUserArn` string — The ARN of the <code>AppInstanceUser</code>.
  - `ExpirationSettings` object — Settings that control the interval after which an <code>AppInstanceUser</code> is automatically deleted.
    - `ExpirationDays` integer, required — The period in days after which an <code>AppInstanceUser</code> will be automatically deleted.
    - `ExpirationCriterion` 'CREATED_TIMESTAMP', required — Specifies the conditions under which an <code>AppInstanceUser</code> will expire.

## Other responses

- `480` — BadRequestException
- `481` — ConflictException
- `482` — ForbiddenException
- `483` — ThrottledClientException
- `484` — UnauthorizedClientException
- `485` — ServiceUnavailableException
- `486` — ServiceFailureException

---

[API](https://skmtc.net/aws/apis/chime-sdk-identity.md) · [All operations](https://skmtc.net/aws/apis/chime-sdk-identity/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/chime-sdk-identity/versions/5ac0320cd9af/schema)