Skip to main content

Vivier

Un vivier est une liste de candidats constituée par un recruteur. Le vivier peut contenir des candidats inscrits sur la plateforme ou des candidats externes (importés depuis LinkedIn, CV reçus hors plateforme, etc.).

Schéma

Exemple JSON

{
  "id": 55,
  "nom": "Senior Java — pipeline 2026",
  "description": "Candidats identifiés pour futures ouvertures backend",
  "tags": ["Java", "Senior", "Backend"],
  "partageEntreprise": true,
  "totalCandidats": 24,
  "repartition": { "inscrits": 15, "externes": 9 },
  "candidats": [
    {
      "id": 701,
      "type": "INSCRIT",
      "candidat": { "id": 42, "firstName": "Jean", "niveauExperience": "SENIOR" },
      "statut": "CONTACTE",
      "note": "Contacté le 10/04, en cours d'échange"
    },
    {
      "id": 702,
      "type": "EXTERNE",
      "external": { "firstName": "Alain", "source": "LINKEDIN" },
      "statut": "INVITE",
      "note": "Invité à s'inscrire 05/04"
    }
  ]
}

Flow d’ajout

Cycle d’un candidat dans le vivier

Invitation à s’inscrire (external → inscrit)

Partage intra-entreprise

Endpoints principaux

MéthodePathDescription
POST/v1/api/vivierCréer vivier
GET/v1/api/vivierMes viviers
GET/v1/api/vivier/{id}Détail + candidats
POST/v1/api/vivier/{id}/candidatsAjouter inscrit
POST/v1/api/vivier/{id}/candidats/externalAjouter externe
POST/v1/api/vivier/{id}/candidats/import-csvImport CSV
PATCH/v1/api/vivier/candidats/{id}Changer statut / note
POST/v1/api/vivier/candidats/{id}/inviteInvitation plateforme
DELETE/v1/api/vivier/candidats/{id}Retirer

Quota

PlanViviers maxCandidats par vivier
Gratuit150
Essentiel5500
Pro205000
Entreprise