Remove candidates from a list by external ID

Removes one or more candidate profiles from the list with the given external ID, addressed by profile id (candidateIds) and/or external id (candidateProfileExternalIds). Candidates not on the list are ignored. Returns 204 on success, 400 when a candidate external id matches no candidate, and 404 when no list matches.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required
length between 1 and 256
^[\w.-]+$

Caller-supplied external identifier matching ^[\w.-]+$ (1-256 characters).

Query Params
string
length between 1 and 255

Your own identifier for the organization to look in, instead of the one x-organization-id names. Resolved within your organization group and checked against the access of the user the API key belongs to. Unknown or ambiguous values return 400, an organization the user cannot reach 403.

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 strings
length ≤ 100

Candidate Profile IDs.

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

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