Journal des modifications

Mis à jour 29 septembre 2026

Daté, du plus récent au plus ancien. Chaque changement de l’API publique ou de cette documentation est une ligne ici.

2026-09-25

Publier est gratuit. POST /v1/jobs/{jobId}/publish ne facture plus rien : creditsCharged ne figure plus dans sa réponse, et 402 insufficient_credits a disparu. Publier ne lance pas non plus l’appariement des candidats — classer les candidats et comparer le vivier relèvent d’une offre gérée, qu’un recruteur active dans Orbit.
category. Le type d’emploi d’un poste, dans une liste fixe. Acceptée sur POST /v1/jobs et PATCH /v1/jobs/{jobId}, renvoyée sur chaque poste qui en a une, et obligatoire à la première publication d’un poste : sans elle, publish répond 422 avec category dans missing.
Les offres gérées gardent leur intitulé et leur catégorie. Un PATCH qui changerait l’un ou l’autre sur une offre gérée, directement ou via publishEdits, reçoit un 409 avec managed_ad_locked et une liste fields, et ne change rien.
La présélection via l’API. POST /v1/jobs/{jobId}/candidates/{candidateId}/screening invite l’un des candidats d’un poste à une présélection par IA avec l’un de vos modèles. Seule une offre gérée peut présélectionner (409 ad_not_managed). Au-delà des présélections incluses dans l’offre, une présélection est supplémentaire, au prix du modèle figé à l’envoi, et n’est facturée que si elle est terminée, sans confirmation à chaque appel. Une présélection qui ferait dépasser au compte sa limite mensuelle reçoit 402 overage_cap_reached.
La portée screening. Affichée dans Orbit sous le nom Présélection, c’est celle dont la route de présélection a besoin. Émettre une clé qui la porte vaut consentement du compte aux présélections supplémentaires, jusqu’à la limite mensuelle.

2026-09-08

Écriture des offres. POST /v1/jobs crée un brouillon, POST /v1/jobs/{jobId}/publish le met en ligne et facture les frais de publication, PATCH /v1/jobs/{jobId} modifie et POST /v1/jobs/{jobId}/close clôture. Les modifications d’un poste publié restent en attente, sauf si vous envoyez publishEdits: true.
Une nouvelle portée, jobs:write. Affichée dans Orbit comme lecture et gestion des offres. Elle n’est pas impliquée par la lecture : publier consomme des crédits, elle se choisit donc délibérément à la création de la clé.
Idempotency-Key sur les endpoints POST. Une nouvelle tentative renvoie la première réponse au lieu d’une seconde annonce ou d’un second débit.
URL de base. L’hôte de développement n’est plus listé ici. Il refuse les appels externes et n’a jamais été utilisable de l’extérieur.

2026-09-06

API publique des offres v1. GET /v1/jobs et GET /v1/jobs/{jobId} : les postes publiés, clos et expirés d’un compte via clé d’API, avec pagination par curseur, filtres status et updatedSince, et un applyLink sur chaque offre.
Portées des clés d’API. Les clés portent une portée choisie à la création — lecture des offres ou screening — affichée sur chaque clé dans Orbit → Paramètres → Clés d’API.
Cette documentation. Démarrage, le guide page carrières et la référence des endpoints générée.