Remove members from an endpoint group
/{namespace}/{principalType}/{principalId}/endpoint-groups/{groupId}/remove-membersRemoves one or more endpoint members from an existing endpoint group.
Required scope
group:manageHeader parameters
- If-Match
stringRequired The quoted strong entity tag of the resource the client last read (its `etag` field or `ETag` response header). The mutation is applied only when it still matches: a stale value returns 412 PRECONDITION_FAILED and a missing header returns 428 PRECONDITION_REQUIRED. `*` matches any current version of an existing group (RFC 9110), for a deliberate last-writer-wins change.
minLength: 1
Returns
202
Members removal accepted
No response body.
Response headers
- ETag
string Opaque strong entity tag of the returned resource version. Send it back in `If-Match` on the next mutation of the same resource.
Errors
400 BAD_REQUESTInvalid request payload
Check the request fields and any validation details, then correct the payload.
401 UNAUTHORIZEDUnauthorized - invalid or missing authentication token
Obtain a valid access token, then retry.
403 FORBIDDENForbidden - insufficient permissions
Check the linked account and its permissions for the device or resource.
404 NOT_FOUNDEndpoint group not found
Verify the target identifier and that its endpoint or plugin route still exists.
412 PRECONDITION_FAILEDThe If-Match etag does not match the current group version; re-read the group and retry
Inspect the returned code and family and follow the error handling guide.
428 PRECONDITION_REQUIREDThe If-Match header is missing
Inspect the returned code and family and follow the error handling guide.
500 INTERNALInternal server error
Retry with backoff only when the operation is safe to repeat. Include the error code when reporting persistent failures.