Mise à jour du statut d'une candidature

Description

Met à jour le statut d'une candidature. Les statuts possibles sont : open, reopen, reject et hire.

---

Endpoint

POST https://api.mytalentplug.com/jam/v1/jobapplications/status

Authentification

• Requise : Oui
• Type : Bearer Authentication
• Exemple d'en-tête :

Authorization: Bearer <token>

---

Requête

Corps de la requête (JSON)

Nom du paramètre	Type	Requis	Format	Valeurs possibles	Exemple	Description
jobApplicationId	string	Oui	UUID	—	5c357095-eb76-41d9-a896-b7fa5193e3ad	Identifiant unique de la candidature à mettre à jour
status	string	Oui	—	open, reopen, reject, hire	open	Nouveau statut à attribuer à la candidature

Exemple de corps de requête

{
    "jobApplicationId": "5c357095-eb76-41d9-a896-b7fa5193e3ad",
    "status": "hire"
}

---

Réponse

Réponse 200 (succès)

Retourné lorsque le statut est défini sur open ou reopen et que l'opération réussit.

Exemple

{
  "id": "5c357095-eb76-41d9-a896-b7fa5193e3ad",
  "ownerId": 42,
  "companyId": 99,
  "date": "2025-04-13T10:30:00Z",
  "applicant": {
    "firstName": "Alice",
    "lastName": "Durand",
    "fullname": "Alice Durand",
    "email": "alice@example.com",
    "phoneNumber": "0123456789"
  },
  "jobOffer": {
    "id": "123456",
    "reference": "REF-ABC-123",
    "atsExternalId": null,
    "jobTitle": "Développeur .NET",
    "jobLocation": "Paris - 75000"
  },
  "source": "Site carrière",
  "sourceId": 3,
  "rating": 5,
  "attachments": [],
  "tags": ["urgent", "prioritaire"],
  "recruitmentStepId": "ddee6677-8899-aabb-ccdd-1234567890ab",
  "status": 2,
  "duplicatesCount": 0,
  "isMultiApplicationDuplicate": false
}

Réponse 204 (No Content)

Retourné lorsque le statut est défini sur hire ou reject et que l'opération réussit. Aucun corps de réponse n'est renvoyé.

---

Réponses d'erreur

Code HTTP	Message	Description
400	Bad Request	Échec de validation ou échec de l'opération pour le statut spécifié
401	Unauthorized	Jeton d'accès manquant ou invalide
403	Forbidden	Accès refusé
404	Not Found	Candidature non trouvée
500	Internal Server Error	Le serveur a rencontré un problème inattendu

Exemple

{
    "type": "https://tools.ietf.org/html/rfc9110#section-15.5.1",
    "title": "Bad Request",
    "status": 400,
    "detail": "Validation failed: \n -- Status: must be one of: open, reopen, reject, hire Severity: Error",
    "traceId": "0HNB7RMJ268SM:00000003",
    "requestId": "00-19aae3969015288f7162ad681f003a16-af9a7edd53036350-00"
}

---

Exemple de requête avec curl

curl -X POST 'https://api.mytalentplug.com/jam/v1/jobapplications/status' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <token>' \
-d '{
    "jobApplicationId": "5c357095-eb76-41d9-a896-b7fa5193e3ad",
    "status": "hire"
}'