Registrar um emprego

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

On this page

Solicitação
Exemplo
Resposta
Erros

Opcional e gratuito. Armazena uma descrição de emprego e retorna um job_id com escopo para sua credencial, para que um backlog de currículos pare de reenviar o mesmo texto.

Este é um auxiliar de avaliação, não um quadro de empregos. Não há listagem, não há paginação, não há organização e não há pipeline. Apenas a descrição que você envia é armazenada, nunca um candidato, um CV ou um resultado.

Solicitação

application/json

Campo	Tipo	Notas
`job_details` (obrigatório)	cadeia de caracteres	Texto simples copiado da página de carreiras ou um objeto JSON de requisitos estruturados.
`language`	cadeia de caracteres	Código 639-1 padrão para prosa voltada para o candidato.
`label`	cadeia de caracteres	Seu próprio nome para o cargo. Retornado.

Exemplo

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

Resposta

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

Envie o job_id em POST /evaluate/ ou POST /evaluate/async no lugar de job_details.

Erros

Status	Causa típica
`400`	Formato inválido `job_details`.
`422`	`job_details` está ausente.

/evaluate/ retorna 404 para um job_iddesconhecido ou registrado por outra conta. Os IDs são limitados à credencial que os criou.

Updated 12 October 2026