Registrar un empleo

POSThttps://api.curriculo.me/public/jobs/

On this page

Solicitud
Ejemplo
Respuesta
Errores

Opcional y gratuito. Almacena una descripción de trabajo y devuelve un job_id con el alcance de tus credenciales, por lo que un registro de CVs evita volver a enviar el mismo texto.

Este es un ayudante de evaluación, no una junta de empleo. No hay lista, no paginación, no organización y no tubería. Solo se almacena la descripción que envías, nunca un candidato, un CV o un resultado.

Solicitud

application/json

Campo	Tipo	Notas
`job_details` (obligatorio)	cadena	Texto plano pegado desde tu página de carreras, o un objeto JSON de requisitos estructurados.
`language`	cadena	Código 639-1 predeterminado ISO para la prosa orientada al candidato.
`label`	cadena	Su propio nombre para el trabajo. Devuelto.

Ejemplo

curl -X POST https://api.curriculo.me/public/jobs/ \
  -H 'Authorization: Bearer key_abc123_yoursecret' \
  -H 'Content-Type: application/json' \
  -d '{"job_details": "Senior backend engineer, Python and FastAPI, Seoul", "label": "BE-Seoul"}'

Respuesta

{"job_id": "job_abc123", "label": "BE-Seoul"}

Envíe ese job_id el POST /evaluate/ o POST /evaluate/async en lugar de job_details.

Errores

Estado	Causa típica
`400`	Incorrecto `job_details`.
`422`	`job_details` está faltando.

/evaluate/ devuelve 404 para un job_iddesconocido, o uno registrado por una cuenta diferente. Los ids están limitados al credencial que los creó.

Updated 12 October 2026