# Candidate API

The Candidate API provides endpoints for managing candidates within job vacancies. It allows you to create new candidates, update existing candidate information, and upload candidate data in bulk through file uploads. All endpoints require authentication via Bearer token or API Key and include vacancy ownership validation.

Version: 1.0

## Servers

Development server
```
https://k8s-exp-api-dev.hunty.cloud
```

Production server
```
https://k8s-exp-api-stg.hunty.cloud
```

## Security

### bearer

Type: http
Scheme: bearer
Bearer Format: JWT

### x-auth-api-key

Type: apiKey
In: header
Name: x-auth-api-key

## Download OpenAPI description

 - [Candidate API](https://docs.hunty.cloud/_bundle/apis/candidate/index.yaml)

## Candidate

 - [GET /candidates/company/{company_id}/vacancy/{vacancy_id}/candidate/{candidate_id}](https://docs.hunty.cloud/apis/candidate/candidate/candidatecontroller_getcandidatebyid.md): Retrieves the candidate details for the specified company, vacancy, and candidate ID.
 - [PATCH /candidates/company/{company_id}/vacancy/{vacancy_id}/candidate/{candidate_id}](https://docs.hunty.cloud/apis/candidate/candidate/candidatecontroller_updatecandidate.md): Updates the information of an existing candidate associated with the specified company, vacancy, and candidate IDs.
 - [POST /candidates/company/{company_id}/vacancy/{vacancy_id}](https://docs.hunty.cloud/apis/candidate/candidate/candidatecontroller_createcandidate.md): Creates a new candidate associated with the specified company and vacancy IDs.
 - [POST /candidates/company/{company_id}/vacancy/{vacancy_id}/upload](https://docs.hunty.cloud/apis/candidate/candidate/candidatecontroller_uploadcandidatesfile.md): Uploads a file containing candidate information and associates the candidates with the specified company and vacancy. Required columns: `cellphone_number`, `first_name`, `last_name`. Optional: `email`