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	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

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

---

Réponse

La réponse est au format JSON.

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
}

Détail des champs

Le corps renvoyé correspond au schéma d'une candidature. Voir le détail des champs items dans Récupération des candidatures.

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"
}'