v1

latestOpenAPI 3.0.02026-07-24161168406.5 KB
Jobs

Updating a vacancy code

Updates vacancy code, status and errorMessage.

Valores legados de status (waiting, error, etc.) continuam aceitos no contrato, mas o código é sempre persistido como valid e errorMessage como null.

put/jobs/{jobId}/vacancies/{vacancyId}

Path parameters

jobIdinteger required

Job ID

vacancyIdinteger required

Vacancy ID

Request body

codestring required

Vacancy code (eg. COD123)

status'valid' | 'invalid' | 'error' | 'waiting' required

Vacancy status. Valores legados (waiting, error, etc.) continuam aceitos no contrato, mas o código é sempre persistido como valid.

errorMessagestring

Error message when status=error (ex.: Gestor inválido). Aceito no contrato, porém ignorado na persistência — errorMessage é sempre gravado como null.

Response

A confirmation of successful update of the vacancy

idinteger required

Vacancy ID

codestring required

Vacancy code (eg. COD123)

status'valid' | 'invalid' | 'error' | 'waiting'

Vacancy status

errorMessagestring

Error message when status=error (eg. Gestor inválido)

createdAtstring date-time required

Vacancy creation date

updatedAtstring date-time required

Vacancy update date