RErecruitwithatlas
Lists

Remove people from a list

Changed on

Removes people from a list. Person IDs that are not on the list are ignored, so the call still returns 200. Removal is a POST with a JSON body (not a DELETE) so the ID list travels in the body.

post/api/v1/lists/{id}/members/remove

Request

Path parameters

idstring uuid required

List ID

Example:3f1c9d2e-8a45-4c7b-9f01-2d6e5b4a7c31

Request body

personIdsstring[] required

Person IDs to add or remove (max 100 per request)

Example request

{
  "personIds": [
    "3f1c9d2e-8a45-4c7b-9f01-2d6e5b4a7c31"
  ]
}

Response

Members removed

status'ok' required

Changes

  • cd4bc8bbd95eRevision changes
    • breaking

      removed the required property / from the response with the status

    • warning

      added the new candidate enum value to the / response property for the response status

    • warning

      added the new contact enum value to the / response property for the response status

    • warning

      added the new private enum value to the / response property for the response status

    • warning

      added the new public enum value to the / response property for the response status

    • warning

      added the new team enum value to the / response property for the response status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the optional property to the response with the status

    • info

      added the required property / to the response with the status

  • d7ef7f970d5bRevision changes
    • info

      endpoint added