Vagas

Atualizar vaga

Atualizar vaga

patch/jobs/{id}

Request

  • Base URL: https://api.inhire.app
  • URL: https://api.inhire.app/jobs/{id}
  • Auth: HTTP bearer

Path parameters

idstring required

Headers

X-Tenantstring required

Multi-tenant identifier. Required on every request. This determines which tenant's data the request operates on. Maps to the DynamoDB partition key (tenantId).

Request body

status'canceled' | 'closed' | 'open' | 'paused' | 'pending'

Status atual do recurso (enum específico do domínio).

acceptedSenioritystring[]

Lista de senioridades aceitas pela vaga (filtro de candidaturas).

area'data' | 'design' | 'engineering' | 'product' | 'other' | 'sales' | 'customerSuccess' | 'marketing' | 'operations'

Macro-área da vaga (engineering, product, design, etc.).

areaATSstring nullable

Área customizada do ATS para a vaga, definida pelo cliente.

competenciesstring

Competências/habilidades exigidas pela vaga (texto livre).

contractTypestring[]

Tipos de contrato aceitos pela vaga (CLT, PJ, etc.).

descriptionstring

Descrição em texto livre do recurso.

emailSequenceIdstring

Identificador da sequência de emails automatizada vinculada.

evaluatorIdsstring[]

IDs dos usuários avaliadores designados.

frameworksstring[]

Frameworks/tecnologias associadas à vaga (texto livre ou tags).

isConfidentialboolean

Quando true, a vaga é confidencial (visibilidade restrita).

languagesstring[]

Idiomas exigidos pela vaga.

locationAddressstring

Endereço (logradouro) completo do local de trabalho da vaga. Preenchido em vagas presenciais e híbridas; ignorado em vagas remotas.

locationCepstring

CEP do local de trabalho da vaga. Usado para geolocalização e exibição na divulgação; relevante apenas para vagas presenciais e híbridas.

locationCitystring

Cidade declarada na localização da vaga ou do talento.

locationComplementstring

Complemento do endereço (sala, andar, etc.).

locationCountrystring

País declarado na localização (código ISO 3166-1 alpha-2).

locationLatitudenumber

Latitude (coordenada GPS) do local de trabalho da vaga. Usada para busca por raio e exibição no mapa da divulgação.

locationLongitudenumber

Longitude (coordenada GPS) do local de trabalho da vaga. Usada para busca por raio e exibição no mapa da divulgação.

locationRequiredboolean

Define se o candidato precisa informar a própria localização durante a inscrição. true = pedir localização ao candidato; false = não pedir.

locationStatestring

Estado/UF declarado na localização (sigla).

managerIdstring

Identificador(es) de manager.

namestring

Nome legível do recurso.

offLimitsstring[]

Lista de empresas marcadas como off-limits para esta vaga — talentos vinculados a essas empresas não devem ser abordados/buscados como candidatos.

originIdstring

Identificador(es) de origin.

recruiterIdstring

Identificador(es) de recruiter.

salaryCurrencystring

Moeda usada nos campos de salário da vaga (salaryMin, salaryMax, salaryTarget). Padrão BRL; aceita também USD, EUR.

salaryMaxnumber

Faixa salarial máxima oferecida pela vaga (na moeda do currency).

salaryMinnumber

Faixa salarial mínima oferecida pela vaga (na moeda do currency).

salaryTargetnumber

Salário-alvo para a vaga (referência interna).

seniority'junior' | 'mid-level' | 'senior' | 'specialist' | 'leadership'

Senioridade principal da vaga.

specializationobject

Especialização técnica (ex.: front-end, back-end).

talentSuggestionsboolean

Habilita o motor de sugestões automáticas de talentos para esta vaga (recomendações geradas a partir da base de talentos do tenant). Pode ser desligado sem efeitos colaterais.

tenantClientIdstring

Identificador externo do cliente do tenant (ID do cliente B2B configurado pelo tenant).

Response

OK

unknown required

Changes

No recorded changes to this operation across all 1 revision of this API.