Skip to main content

Close a job

Available

This request closes a specific job.

HTTP Request [DELETE]
https://parceiros.empregos.com.br/api/job/{externalJobPostingId}

curl -X 'DELETE' \
'https://parceiros.empregos.com.br/api/job/{externalJobPostingId}' \
-H 'accept: */*' \
-H 'Authorization: bearer any'

Parameters [Request]

FieldDescriptionTypeRequired
externalJobPostingIdRepresents unique job id within the partner system. Do not send an empty or null string for this field. The maximum allowed length is 200 charactersStringYes

Responses

  • 200 OK: job closed.

    {
    "success": true,
    "message": "Removido com sucesso!"
    }
  • 400 Bad Request: the job was not found for your partner account, could not be closed, or an unexpected error occurred. The text of message is in Portuguese.

    {
    "success": false,
    "errorMessages": [
    {
    "propertyName": "",
    "message": "Não foi possivel localizar a vaga vaga-teste-01."
    }
    ]
    }
  • 401 Unauthorized: missing or invalid bearer token. See Security.

Response fieldDescriptionType
successtrue when the job was closed.Boolean
messageResult message (text in Portuguese). Only on success.String
errorMessagesList of errors. Only on failure.Array
errorMessages.propertyNameName of the field that failed. Empty for general errors.String
errorMessages.messageDescription of the error (text in Portuguese).String