Registro de cambios

Actualizado 29 de septiembre de 2026

Con fecha, del más reciente al más antiguo. Todo cambio de la API pública o de esta documentación es una línea aquí.

2026-09-25

Publicar es gratis. POST /v1/jobs/{jobId}/publish no cobra nada: creditsCharged ya no está en su respuesta, y 402 insufficient_credits ha desaparecido. Publicar tampoco arranca el emparejamiento de candidatos: ordenar candidatos y buscar en el pool corresponden a un aviso gestionado, que alguien de selección activa en Orbit.
category. Qué tipo de empleo es un puesto, a partir de una lista fija. Se acepta en POST /v1/jobs y PATCH /v1/jobs/{jobId}, se devuelve en todo puesto que la tenga y es obligatoria en la primera publicación de un puesto: sin ella, publish responde 422 con category en missing.
Los avisos gestionados conservan su título y su categoría. Un PATCH que cambiaría cualquiera de los dos en un aviso gestionado, directamente o mediante publishEdits, responde 409 con managed_ad_locked y una lista fields, y no cambia nada.
Evaluaciones por la API. POST /v1/jobs/{jobId}/candidates/{candidateId}/screening invita a una de las personas candidatas de un puesto a una evaluación con IA con una de tus plantillas. Solo un aviso gestionado puede evaluar (409 ad_not_managed). Pasadas las evaluaciones incluidas en el aviso, una evaluación es adicional, al precio de la plantilla fijado al enviarla, y solo se factura si se completa, sin confirmación en cada llamada. Una que llevaría a la cuenta por encima de su límite mensual responde 402 overage_cap_reached.
El permiso screening. Se muestra en Orbit como Screening y es el que necesita la ruta de evaluación. Emitir una clave con él es el consentimiento de la cuenta a las evaluaciones adicionales, hasta el límite mensual.

2026-09-08

Escritura de vacantes. POST /v1/jobs crea un borrador, POST /v1/jobs/{jobId}/publish lo pone en marcha y cobra la tarifa de publicación, PATCH /v1/jobs/{jobId} edita y POST /v1/jobs/{jobId}/close cierra. Las ediciones de un puesto publicado quedan en espera salvo que envíes publishEdits: true.
Un permiso nuevo, jobs:write. En Orbit aparece como leer y gestionar empleos. No va implícito en la lectura: publicar gasta créditos, así que se elige a propósito al crear la clave.
Idempotency-Key en los endpoints POST. Un reintento devuelve la primera respuesta en lugar de un segundo anuncio o un segundo cobro.
URLs base. El host de desarrollo ya no aparece aquí. Rechaza llamadas externas y nunca fue utilizable desde fuera.

2026-09-06

API pública de vacantes v1. GET /v1/jobs y GET /v1/jobs/{jobId}: los puestos publicados, cerrados y caducados de una cuenta mediante clave de API, con paginación por cursor, filtros status y updatedSince, y un applyLink en cada vacante.
Permisos de las claves de API. Las claves llevan un permiso elegido al crearlas — lectura de vacantes o screening — visible en cada clave en Orbit → Configuración → Claves de API.
Esta documentación. Primeros pasos, la guía de página de empleo y la referencia de endpoints generada.