Remove items from named list
Remove one or more items from an existing named list. Items not found in the list are silently ignored.
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
id | UUID | Yes | Named list identifier |
Request Body
| Field | Type | Required | Description |
|---|---|---|---|
items | string[] | Yes | Array of items to remove (at least one required) |
Behavior
- Specified items are removed from the list
- Items not in the list are silently ignored
- Changes affect policies immediately for ACTIVE lists
- Case-sensitive matching
Response Fields
| Field | Type | Description |
|---|---|---|
id | UUID | Unique list identifier |
name | string | List name |
type | string | List type |
description | string | List description |
status | string | ACTIVE or INACTIVE |
items | string[] | Array of remaining items after removal |
metadata | object | Additional metadata |
organizationId | UUID | Owning organization ID |
createdBy | string | User ID who created the list |
updatedBy | string | User ID who last updated the list |
itemCount | number | Number of items remaining in the list |
createdAt | string | Creation timestamp (ISO 8601) |
updatedAt | string | Last update timestamp (ISO 8601) |
Use Cases
- Remove addresses from whitelists
- Revoke previously approved addresses
- Clean up outdated list entries
- Update address-based policy restrictions
Required Permission
lists:update
Remove items from named list
Remove one or more items from an existing named list. Items not found in the list are silently ignored.
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
id | UUID | Yes | Named list identifier |
Request Body
| Field | Type | Required | Description |
|---|---|---|---|
items | string[] | Yes | Array of items to remove (at least one required) |
Behavior
- Specified items are removed from the list
- Items not in the list are silently ignored
- Changes affect policies immediately for ACTIVE lists
- Case-sensitive matching
Response Fields
| Field | Type | Description |
|---|---|---|
id | UUID | Unique list identifier |
name | string | List name |
type | string | List type |
description | string | List description |
status | string | ACTIVE or INACTIVE |
items | string[] | Array of remaining items after removal |
metadata | object | Additional metadata |
organizationId | UUID | Owning organization ID |
createdBy | string | User ID who created the list |
updatedBy | string | User ID who last updated the list |
itemCount | number | Number of items remaining in the list |
createdAt | string | Creation timestamp (ISO 8601) |
updatedAt | string | Last update timestamp (ISO 8601) |
Use Cases
- Remove addresses from whitelists
- Revoke previously approved addresses
- Clean up outdated list entries
- Update address-based policy restrictions
Required Permission
lists:update