API Reference

Remove candidates from a list

delete
https://api.joinpopp.com/v1/candidates/lists//candidates

Removes one or more candidate profiles from a list, addressed by profile id (candidateIds) and/or external id (candidateProfileExternalIds). Candidates not on the list are ignored. Returns 204 on success, 400 when an external id matches no candidate, and 404 when the list is not found in the caller's organization.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
uuid
required

Candidate list id (UUID).

Body Params

Candidates to remove, by profile id and/or external id

Candidates to add to or remove from a list, addressable by Popp candidate profile id and/or by caller-supplied external id. Provide at least one id across the two fields; the combined total cannot exceed 100.

candidateIds
array of uuids
length ≤ 100

Candidate profile ids (UUIDs).

candidateIds
candidateProfileExternalIds
array of strings
length ≤ 100

Candidate profile external ids, resolved to profile ids within the caller's organization. An external id that matches no candidate returns 400.

candidateProfileExternalIds
Responses
204

Updated 2 days ago

Did this page help you?
Language
Credentials
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 2 days ago

Did this page help you?