Siren

Remove Collaborator Group Member

Removes a single collaborator from a collaborator group by collaborator id.

Last updated: June 7, 2026

DELETE /siren/v1/collaborator-groups/{id}/members/{collaboratorId}

Removes one collaborator from the group. The membership row is looked up by the group id and collaborator id from the path, then deleted. There is no soft-delete stage, so the removal is immediate and irreversible. Only the membership row is deleted. The collaborator record itself is untouched and stays available to other groups and programs. Requires authentication and the update capability on the CollaboratorGroup resource.

Path Parameters

ParameterTypeRequiredDescription
idintegerYesThe parent group’s id. Taken from the path.
collaboratorIdintegerYesThe collaborator’s id whose membership row is removed. Taken from the path.

This endpoint takes no request body.

Example Request

DELETE /siren/v1/collaborator-groups/12/members/41

Example Response

204 No Content

Returns 204 No Content on success.

Events: Broadcasts CollaboratorRemovedFromCollaboratorGroup on success.

Error Responses:

  • 404. Either the membership row does not exist for that group and collaborator (message Collaborator group member not found.), or the group itself does not exist (message The specified record does not exist., from the record-exists check that runs before the handler). The two messages let you tell a missing group from a missing membership. Removing a collaborator who is already not a member of an existing group returns the membership 404 rather than a 204, so a repeated or already-applied removal is reported as not-found rather than as a silent success. If the whole group is gone, you get the group 404 instead.
  • 500. Database error while removing the member.