POST /v1/api/vivier HTTP/1.1
Authorization: Bearer <RECRUTEUR_TOKEN>
Content-Type: application/json

{
  "nom": "Senior Java — pipeline 2026",
  "description": "Profils backend Java pour futures ouvertures",
  "tags": ["Java", "Senior", "Backend"],
  "partageEntreprise": true
}

{ "id": 55, "nom": "Senior Java — pipeline 2026", "totalCandidats": 0 }

POST /v1/api/vivier/55/candidats HTTP/1.1
Content-Type: application/json

{ "candidatId": 42, "note": "Contacté lors du JobDay Douala" }

POST /v1/api/vivier/55/candidats/external HTTP/1.1
Content-Type: application/json

{
  "firstName": "Alain",
  "lastName": "Mvondo",
  "email": "alain.mvondo@example.com",
  "phone": "+237690111222",
  "competences": ["Java", "Spring Boot"],
  "source": "LINKEDIN",
  "note": "Rencontré à la conf Yaoundé"
}

firstName,lastName,email,phone,competences,source,note
Alain,Mvondo,alain@ex.com,+237690111222,"Java,Spring",LINKEDIN,Conf Yaoundé
Célestine,Kamga,c.kamga@ex.com,,"React,TS",RECOMMANDATION,Recommandée par Paul

POST /v1/api/vivier/55/candidats/import-csv HTTP/1.1
Content-Type: multipart/form-data

file=@pipeline.csv

PATCH /v1/api/vivier/candidats/702 HTTP/1.1

{ "statut": "CONTACTE", "note": "Premier appel fait, revient vers nous" }

GET /v1/api/vivier/55?statut=CONTACTE&page=0&size=20 HTTP/1.1

POST /v1/api/vivier/candidats/701/invite-to-offre HTTP/1.1

{ "offreId": 123 }