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 |
|---|
success | boolean | Whether the operation succeeded |
message | string | Operation result message |
removedCount | integer | Number of items removed |
namedList | object | Updated named list (see fields below) |
namedList Object
| 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 |
organizationId | UUID | Owning organization ID |
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