Candidate Tags
An association between a candidate and a corresponding tag for which the candidate has
Create a candidate tag
POST
https://endorsed.ai/api/v1/candidate_tags
Creates a new candidate tag and returns the candidate tag's UUID id. Tags are also unique by the following fields (candidate_id
, tag_id
, and creation_method
) as these fields serve as a composite key in addition to the unique id
field.
Headers
Authorization*
string
Authorization header containing the Bearer Access Token from the /auth/tokens
endpoint. Example: Bearer <ACCESS_TOKEN>
Content-Type
string
Must be application/json
. If not set, defaults to application/json
Request Body
candidate_id*
string
The Candidate UUID from the /candidates entity resource.
tag_id*
string
The Tag UUID from the /tags entity resource.
creation_method*
string
The type of the method the candidate tag was created by:
custom_input_by_candidate
,
selected_by_organization
, or
auto_generated_by_endorsed
Examples:
Get an existing candidate tag
GET
https://endorsed.ai/api/v1/candidate_tags/{id}
Get an existing candidate tag by it's UUID id.
Path Parameters
id*
string
UUID id of the candidate tag
Headers
Authorization*
string
Authorization header containing the Bearer Access Token from the /auth/tokens
endpoint. Example: Bearer <ACCESS_TOKEN>
Examples:
Delete an existing candidate tag
DELETE
https://endorsed.ai/api/v1/candidate_tags/{id}
Deletes an existing candidate tag by it's UUID id.
Path Parameters
id*
string
UUID id of the candidate tag
Headers
Authorization*
string
Authorization header containing the Bearer Access Token from the /auth/tokens
endpoint. Example: Bearer <ACCESS_TOKEN>
Examples:
Last updated