Remove members lists
DELETE /api/v1/lists/{listId}/members: request fields and declared response contract.
DELETE/api/v1/lists/{listId}/members
| Permission | list.manage |
|---|---|
| Workspace scope | required |
| Scope target | resource-set |
Parameters
| Field | Type | Required | Nullable | Default |
|---|---|---|---|---|
| listId | string | required | non-null | — |
| Field | Type | Required | Nullable | Default |
|---|---|---|---|---|
| memberRefs | array | required | non-null | — |
Response
200
| Field | Type | Required | Nullable | Default |
|---|---|---|---|---|
| data | object | required | non-null | — |
| data.removed | number | required | non-null | — |
Declared failures
| LIST_MEMBER_REFS_MIXED | 400 — not retryable |
|---|---|
| LIST_NOT_FOUND | 404 — not retryable |
Readback
Read the result back with:
- lists.get
Request example
Schematic only. Replace placeholders with real values and include all required nested fields.
DELETE /api/v1/lists/{listId}/members?memberRefs= HTTP/1.1
Authorization: Bearer <token>
x-merulan-workspace-id: <workspace-id>