Update Represented Job Posting

Add MCP server to your AI tool

Allow AI tools and LLMs to interact with the API documentation portal through MCP.

MCP server URL


        
          
            https://vaas.vag.as/doc/publicacao-vagas-vaas-en/mcp

Standard setup for AI tools providing an mcp.json file

{
  "publicacao-vagas-vaas-en MCP server": {
    "url": "https://vaas.vag.as/doc/publicacao-vagas-vaas-en/mcp"
  }
}

PATCH /job-posting/vaas/{id}/{representado_hash_id}

O auth2

Endpoint for partially updating a job posting published through VaaS on behalf of a represented company.

Only fields allowed for update can be included in the request. If a field that is not editable is sent, the API will return a message informing the client that the field cannot be edited.

Path parameters

id integer Required

Identifier of the job posting to be updated.
representado_hash_id string Required

Hash identifier of the represented company.

application/json

Body Required

url_externa string

URL where the candidate will be redirected to complete the application process.
cargo string

Job title.
cargo_exclusivo_pcd boolean

Flag to mark if the job is exclusively for people with disabilities.
tipo_de_contratacao_id integer

Contract type ID. It can be obtained from the endpoint /v1/dominios/modelos-contratuais.
idiomas array[object]

Required languages for the job.
Hide idiomas attributes Show idiomas attributes object
- id integer Required
- nivel_id integer Required
  1 - não tem
  
  2 - Básico
  
  3 - Intermediário
  
  4 - Avançado
  
  5 - Fluente
  Values are 1, 2, 3, 4, or 5.
beneficios array[object]

Job benefits.

The same benefit must not be added more than once to the same job posting. If this field is sent, the beneficios_txt field must not be included in the request.
Hide beneficios attributes Show beneficios attributes object
- id integer Required
- valor number
beneficios_txt string

Free-text description of the job benefits.

If this field is sent, the beneficios field must not be included in the request.
anuncio object
Hide anuncio attributes Show anuncio attributes object
- descricao string
- outros_requisitos string
salario object
Hide salario attributes Show salario attributes object
- tipo_moeda string
  
  Salary currency.
  
  Values are BRL or USD.
- faixa_salario_min number
  
  Minimum value of the salary range.
- faixa_salario_max number
  
  Maximum value of the salary range.
- exibir_salario_no_anuncio boolean
  
  Indicates whether the salary should be displayed in the job posting.
pre_requisitos object
Hide pre_requisitos attributes Show pre_requisitos attributes object
- escolaridade_minima_id integer
  
  Minimum education level.
- nivel_hierarquico_id integer
  
  Hierarchical level.
- aceitar_candidaturas_outras_areas boolean
  
  Indicates whether applications from other fields of activity are accepted.
- areas_de_atuacao_ids array[integer]
  
  Fields of activity IDs.
atuacao object
Hide atuacao attributes Show atuacao attributes object
- modelo_de_trabalho integer
  
  Work model.
- local_aceita_candidaturas string
  
  Defines the location criteria for accepting applications.
  
  Values are somente_cidade, cidades_proximas, or qualquer_cidade.
- local_de_trabalho object
  Hide local_de_trabalho attributes Show local_de_trabalho attributes object
  
  pais_id integer Required
  
  Country ID.
  
  estado_id integer Required
  
  State ID.
  
  cidade_id integer Required
  
  City ID.
sobre_a_empresa object
Hide sobre_a_empresa attributes Show sobre_a_empresa attributes object
- apresentacao_da_empresa integer
  
  Company presentation ID.
- anuncio_confidencial boolean
  
  Indicates whether the job posting is confidential.
canais_de_divulgacao object
Hide canais_de_divulgacao attributes Show canais_de_divulgacao attributes object
- divisao_id integer
  
  Job division ID.
- parceiros_ids array[integer]
  
  Partner channel IDs.

Responses

200

OK

PATCH /job-posting/vaas/{id}/{representado_hash_id}

curl \
 --request PATCH 'https://apigateway.vagas.com.br/v1/job-posting/vaas/123456/abc123xyz' \
 --header "Authorization: Bearer $ACCESS_TOKEN" \
 --header "Content-Type: application/json" \
 --data '{
  "url_externa": "http://jobexternalurl.com/",
  "cargo": "Software Engineer",
  "cargo_exclusivo_pcd": false,
  "tipo_de_contratacao_id": 999,
  "idiomas": [
    {
      "id": 534,
      "nivel_id": 5
    }
  ],
  "beneficios": [
    {
      "id": 2,
      "valor": 80
    }
  ],
  "beneficios_txt": "Meal voucher, health insurance and transportation allowance",
  "anuncio": {
    "descricao": "Updated job description",
    "outros_requisitos": "Additional requirements"
  },
  "salario": {
    "tipo_moeda": "BRL",
    "faixa_salario_min": 5000,
    "faixa_salario_max": 8000,
    "exibir_salario_no_anuncio": true
  },
  "pre_requisitos": {
    "escolaridade_minima_id": 1,
    "nivel_hierarquico_id": 40,
    "aceitar_candidaturas_outras_areas": false,
    "areas_de_atuacao_ids": [
      4,
      6,
      10
    ]
  },
  "atuacao": {
    "modelo_de_trabalho": 4,
    "local_aceita_candidaturas": "cidades_proximas",
    "local_de_trabalho": {
      "pais_id": 31,
      "estado_id": 35,
      "cidade_id": 3550308
    }
  },
  "sobre_a_empresa": {
    "apresentacao_da_empresa": 999,
    "anuncio_confidencial": false
  },
  "canais_de_divulgacao": {
    "divisao_id": 999,
    "parceiros_ids": [
      999,
      888
    ]
  }
}'

Request examples

{
  "url_externa": "http://jobexternalurl.com/",
  "cargo": "Software Engineer",
  "cargo_exclusivo_pcd": false,
  "tipo_de_contratacao_id": 999,
  "idiomas": [
    {
      "id": 534,
      "nivel_id": 5
    }
  ],
  "beneficios": [
    {
      "id": 2,
      "valor": 80
    }
  ],
  "beneficios_txt": "Meal voucher, health insurance and transportation allowance",
  "anuncio": {
    "descricao": "Updated job description",
    "outros_requisitos": "Additional requirements"
  },
  "salario": {
    "tipo_moeda": "BRL",
    "faixa_salario_min": 5000,
    "faixa_salario_max": 8000,
    "exibir_salario_no_anuncio": true
  },
  "pre_requisitos": {
    "escolaridade_minima_id": 1,
    "nivel_hierarquico_id": 40,
    "aceitar_candidaturas_outras_areas": false,
    "areas_de_atuacao_ids": [
      4,
      6,
      10
    ]
  },
  "atuacao": {
    "modelo_de_trabalho": 4,
    "local_aceita_candidaturas": "cidades_proximas",
    "local_de_trabalho": {
      "pais_id": 31,
      "estado_id": 35,
      "cidade_id": 3550308
    }
  },
  "sobre_a_empresa": {
    "apresentacao_da_empresa": 999,
    "anuncio_confidencial": false
  },
  "canais_de_divulgacao": {
    "divisao_id": 999,
    "parceiros_ids": [
      999,
      888
    ]
  }
}