Registo de alterações

Atualizado 29 de setembro de 2026

Datadas, da mais recente para a mais antiga. Cada alteração à API pública ou a esta documentação é uma linha aqui.

2026-09-25

Publicar é grátis. POST /v1/jobs/{jobId}/publish não cobra nada: creditsCharged já não está na resposta, e 402 insufficient_credits desapareceu. Publicar também não arranca a correspondência de candidatos — ordenar candidatos e comparar o pool pertencem a um anúncio gerido, que um recrutador ativa na Orbit.
category. Que tipo de emprego é uma vaga, a partir de uma lista fixa. Aceite em POST /v1/jobs e PATCH /v1/jobs/{jobId}, devolvida em todas as vagas que a tenham, e obrigatória na primeira publicação de uma vaga: sem ela, publish responde 422 com category em missing.
Os anúncios geridos mantêm o título e a categoria. Um PATCH que mudaria qualquer um dos dois num anúncio gerido, diretamente ou através de publishEdits, responde 409 com managed_ad_locked e uma lista fields, e não muda nada.
Triagem pela API. POST /v1/jobs/{jobId}/candidates/{candidateId}/screening convida um dos candidatos de uma vaga para uma triagem com IA com um dos seus modelos. Só um anúncio gerido pode fazer triagens (409 ad_not_managed). Depois das triagens incluídas no anúncio, uma triagem é adicional, ao preço do modelo fixado no envio, e só é faturada se for concluída, sem confirmação em cada chamada. Uma que levaria a conta além do seu limite mensal responde 402 overage_cap_reached.
O âmbito screening. Mostrado na Orbit como Triagem, é aquele de que a rota de triagem precisa. Emitir uma chave com ele é o consentimento da conta às triagens adicionais, até ao limite mensal.

2026-09-08

Escrita de vagas. POST /v1/jobs cria um rascunho, POST /v1/jobs/{jobId}/publish põe-no no ar e cobra a taxa de publicação, PATCH /v1/jobs/{jobId} edita e POST /v1/jobs/{jobId}/close fecha. As edições a uma vaga publicada ficam em espera, a não ser que envie publishEdits: true.
Um novo âmbito, jobs:write. Aparece na Orbit como ler e gerir vagas. Não está implícito na leitura: publicar gasta créditos, por isso escolhe-se de propósito ao criar a chave.
Idempotency-Key nos endpoints POST. Uma repetição devolve a primeira resposta em vez de um segundo anúncio ou de uma segunda cobrança.
URLs base. O host de desenvolvimento já não aparece aqui. Recusa chamadas externas e nunca foi utilizável de fora.

2026-09-06

API pública de vagas v1. GET /v1/jobs e GET /v1/jobs/{jobId}: as vagas publicadas, fechadas e expiradas de uma conta por chave de API, com paginação por cursor, filtros status e updatedSince, e um applyLink em cada vaga.
Âmbitos das chaves de API. As chaves trazem um âmbito escolhido na criação — leitura de vagas ou screening — visível em cada chave em Orbit → Definições → Chaves de API.
Esta documentação. Primeiros passos, o guia da página de carreiras e a referência de endpoints gerada.