Candidaturas

Atualizar candidatura

Este endpoint permite atualizar uma candidatura.

patch/job-talents/talents/{id}

Request

  • Base URL: https://api.inhire.app
  • URL: https://api.inhire.app/job-talents/talents/{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

originIdstring
descriptionstring
stageChangeCommentstring
stageIdstring
emailstring email
hiredAtstring
resumestring
source'direct-referral' | 'employee' | 'jobPage' | 'jobPage-internal' | 'manual' | 'referral' | 'public-api' | 'whatsapp'

Response

OK

timeInCurrentStagenumber required

Tempo decorrido (em milissegundos ou segundos, conforme o contexto) que o recurso está no estágio atual.

idstring required

Identificador único do recurso (ULID).

userIdstring nullable required

Identificador do usuário associado ao recurso.

userNamestring required

Nome de exibição do usuário associado ao registro.

createdAtstring required

Timestamp ISO-8601 de criação do recurso.

talentIdstring required

Identificador do talento (candidato).

updatedAtstring required

Timestamp ISO-8601 da última atualização do recurso.

userGroupsstring[] nullable

Lista de IDs dos grupos (teams) aos quais o usuário pertence.

descriptionstring

Descrição em texto livre do recurso.

hiredAtstring

Timestamp ISO-8601 da contratação do candidato.

importedAtstring

Timestamp ISO-8601.

mediumstring

Meio/canal de origem (ex.: organic, paid, referral).

originIdstring

Identificador(es) de origin.

originSource'whatsapp' | 'talent' | 'direct-referral' | 'employee' | 'gupy' | 'import' | 'inhire' | 'jobPage' | 'jobPage-internal' | 'linkedin_boost' | 'manual' | 'referral' | 'public-api' | 'indeed' | 'indeedATSIntegration' | 'jobBoardPool' | 'linkedin' | 'netVagas' | 'trampos' | 'google-jobs' | 'bebee' | 'ondeTrabalhar' | 'vemDeVaga' | 'catho' | 'careerjet' | 'empregos-aqui' | 'jobrapido' | 'jobs-brasil' | 'jobsora' | 'jooble' | 'joobta' | 'joonow' | 'empregos' | 'engenha' | 'estagiarios.com' | 'havagas' | 'jobzi' | 'rio-vagas' | 'vaga-net' | 'vagassc' | 'walljobs'

Canal/origem de aquisição original do recurso (ex.: linkedin, indeed, referral, manual).

reactionsJobtalentsPubReactions

Mapa de reações por emoji → quantidade de usuários que reagiram.

reasonstring

Motivo descritivo da ação (ex.: motivo de rejeição, motivo de fechamento de posição).

source'whatsapp' | 'talent' | 'direct-referral' | 'employee' | 'gupy' | 'import' | 'inhire' | 'jobPage' | 'jobPage-internal' | 'linkedin_boost' | 'manual' | 'referral' | 'public-api' | 'indeed' | 'indeedATSIntegration' | 'jobBoardPool' | 'linkedin' | 'netVagas' | 'trampos' | 'google-jobs' | 'bebee' | 'ondeTrabalhar' | 'vemDeVaga' | 'catho' | 'careerjet' | 'empregos-aqui' | 'jobrapido' | 'jobs-brasil' | 'jobsora' | 'jooble' | 'joobta' | 'joonow' | 'empregos' | 'engenha' | 'estagiarios.com' | 'havagas' | 'jobzi' | 'rio-vagas' | 'vaga-net' | 'vagassc' | 'walljobs' required

Fonte de origem do talento (ex.: site de carreiras, indicação, importação).

status'active' | 'rejected' | 'declined' required

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

Changes

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