Fill a candidate tag
You can fill a candidate tag using the API.
Request
This method allows you to fill a candidate tag:
POST /company/{companyID}/applicant/{applicantID}/trait
Parameters
| Parameter | In | Type | Required | Description | Example |
|---|---|---|---|---|---|
| companyID | path | string | Company identifier | 0GjqBwprWAdArDl4 | |
| applicantID | path | string | Candidate id | ADYjo9mGxZdkR0ry | |
| tag | payload | string | Tag id | 5gQayv9L1Qp6LXE4 | |
| value | payload | string | Tag value | Bachelor |
Request example
cURL request
curl -X POST 'https://api.flatchr.io/company/0GjqBwprWAdArDl4/applicant/ADYjo9mGxZdkR0ry/trait'
-H "Authorization: Bearer {token}"
-H 'Content-Type: application/json'
-d '{"tag":"5gQayv9L1Qp6LXE4","value":"Bachelor"}'
Response
| Name | Type | Description |
|---|---|---|
| id | string | Identifier |
| tag_id | string | Tag identifier |
| value | string | Tag value |
Response example
{
"id":"w67MknKVOldJ1203",
"tag_id":"5gQayv9L1Qp6LXE4",
"value":"Bachelor"
}