---
title: "PUT /allow-lists/{id}"
method: PUT
path: "/allow-lists/{id}"
---

# PUT /allow-lists/{id}

`PUT /allow-lists/{id}`

Updates the settings for an allow list.

## Path parameters

- `id` string, required

## Request body

- object
  - `criteria` object, required — Specifies the criteria for an allow list. The criteria must specify a regular expression (regex) or an S3 object (s3WordsList). It can't specify both.
    - `regex` string — The regular expression (<i>regex</i>) that defines the text pattern to ignore. The expression can contain as many as 512 characters.
    - `s3WordsList` object — The location and name of the S3 object that lists specific text to ignore.
      - `bucketName` string, required — The full name of the S3 bucket that contains the object.
      - `objectKey` string, required — The full name (key) of the object.
  - `description` string — A custom description of the allow list. The description can contain as many as 512 characters.
  - `name` string, required — A custom name for the allow list. The name can contain as many as 128 characters.

## Response `200`

Success

- UpdateAllowListResponse
  - `arn` string — The Amazon Resource Name (ARN) of the allow list.
  - `id` string — The unique identifier for the allow list.

## Other responses

- `480` — ResourceNotFoundException
- `481` — ThrottlingException
- `482` — ValidationException
- `483` — InternalServerException
- `484` — AccessDeniedException

---

[API](https://skmtc.net/aws/apis/macie2.md) · [All operations](https://skmtc.net/aws/apis/macie2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/macie2/versions/6252cf55d8ef/schema)