Candidats

Gérez votre vivier de candidats — créez, consultez et suivez les profils.

Scope requis : candidates:read pour la lecture, candidates:write pour la création et la mise à jour.

Lister les candidats

GET/api/v1/candidates

Retourne la liste paginée des candidats de l'organisation.

Query Parameters

Paramètre	Type	Requis	Description
`page`	integer	Non	Numéro de page (défaut : 1).
`pageSize`	integer	Non	Résultats par page — max 100 (défaut : 20).
`search`	string	Non	Recherche par nom ou email.
`jobId`	string	Non	Filtrer par offre d'emploi.
`tags`	string	Non	Filtrer par tag (valeurs séparées par virgule).

Requête

Réponse 200

GET/api/v1/candidates/:id

Retourne le profil complet d'un candidat.

Path Parameters

Paramètre	Type	Requis	Description
`id`	string	Oui	Identifiant unique du candidat.

Requête

Réponse 200

POST/api/v1/candidates

Crée un nouveau candidat dans votre organisation.

Body Parameters

Paramètre	Type	Requis	Description
`email`	string	Oui	Email unique (utilisé pour les invitations).
`firstName`	string	Non	Prénom du candidat.
`lastName`	string	Non	Nom de famille.
`phone`	string	Non	Numéro de téléphone.
`locale`	string	Non	Langue préférée du candidat (défaut : fr).
`cvUrl`	string	Non	URL du CV du candidat.
`tags`	string[]	Non	Tags associés au profil dans votre organisation.
`source`	string	Non	Source d'acquisition (ex. : LinkedIn, Indeed, Referral).

Requête

Réponse 201