Atualizar Vaga Representada

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-pt/mcp

Standard setup for AI tools providing an mcp.json file

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

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

O auth2

Endpoint para atualização parcial de uma vaga publicada no contexto VaaS em nome de uma empresa representada.

Somente os campos permitidos para atualização podem ser enviados na requisição. Caso seja enviado um campo cuja alteração não seja permitida, a API retornará uma mensagem informando que o campo não é editável.

Path parameters

id integer Required

Identificador da vaga que será atualizada.
representado_hash_id string Required

Hash identificador da empresa representada.

application/json

Body Required

url_externa string
cargo string
cargo_exclusivo_pcd boolean
tipo_de_contratacao_id integer
idiomas array[object]
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]

Um mesmo benefício não pode ser adicionado mais de uma vez à vaga. Caso este campo seja enviado, o campo beneficios_txt não deve ser enviado na requisição.
Hide beneficios attributes Show beneficios attributes object
- id integer Required
- valor number
beneficios_txt string

Texto livre contendo os benefícios da vaga. Caso este campo seja enviado, o campo beneficios não deve ser enviado na requisição.
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
- faixa_salario_min number
- faixa_salario_max number
- exibir_salario_no_anuncio boolean
pre_requisitos object
Hide pre_requisitos attributes Show pre_requisitos attributes object
- escolaridade_minima_id integer
- nivel_hierarquico_id integer
- aceitar_candidaturas_outras_areas boolean
- areas_de_atuacao_ids array[integer]
atuacao object
Hide atuacao attributes Show atuacao attributes object
- modelo_de_trabalho integer
- local_aceita_candidaturas string
  
  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
  
  estado_id integer Required
  
  cidade_id integer Required
sobre_a_empresa object
Hide sobre_a_empresa attributes Show sobre_a_empresa attributes object
- anuncio_confidencial boolean
- apresentacao_da_empresa integer
canais_de_divulgacao object
Hide canais_de_divulgacao attributes Show canais_de_divulgacao attributes object
- divisao_id integer
- parceiros_ids array[integer]

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": "https://empresa.com.br/vaga/123",
  "cargo": "Desenvolvedor Ruby",
  "cargo_exclusivo_pcd": false,
  "tipo_de_contratacao_id": 1,
  "idiomas": [
    {
      "id": 534,
      "nivel_id": 5
    }
  ],
  "beneficios": [
    {
      "id": 2,
      "valor": 80
    }
  ],
  "beneficios_txt": "Vale-refeição, plano de saúde e vale-transporte",
  "anuncio": {
    "descricao": "Descrição atualizada da vaga",
    "outros_requisitos": "Outros requisitos da vaga"
  },
  "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": [
      1,
      2
    ]
  },
  "atuacao": {
    "modelo_de_trabalho": 1,
    "local_aceita_candidaturas": "cidades_proximas",
    "local_de_trabalho": {
      "pais_id": 31,
      "estado_id": 35,
      "cidade_id": 3550308
    }
  },
  "sobre_a_empresa": {
    "anuncio_confidencial": false,
    "apresentacao_da_empresa": 999
  },
  "canais_de_divulgacao": {
    "divisao_id": 999,
    "parceiros_ids": [
      1,
      2
    ]
  }
}'

Request examples

{
  "url_externa": "https://empresa.com.br/vaga/123",
  "cargo": "Desenvolvedor Ruby",
  "cargo_exclusivo_pcd": false,
  "tipo_de_contratacao_id": 1,
  "idiomas": [
    {
      "id": 534,
      "nivel_id": 5
    }
  ],
  "beneficios": [
    {
      "id": 2,
      "valor": 80
    }
  ],
  "beneficios_txt": "Vale-refeição, plano de saúde e vale-transporte",
  "anuncio": {
    "descricao": "Descrição atualizada da vaga",
    "outros_requisitos": "Outros requisitos da vaga"
  },
  "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": [
      1,
      2
    ]
  },
  "atuacao": {
    "modelo_de_trabalho": 1,
    "local_aceita_candidaturas": "cidades_proximas",
    "local_de_trabalho": {
      "pais_id": 31,
      "estado_id": 35,
      "cidade_id": 3550308
    }
  },
  "sobre_a_empresa": {
    "anuncio_confidencial": false,
    "apresentacao_da_empresa": 999
  },
  "canais_de_divulgacao": {
    "divisao_id": 999,
    "parceiros_ids": [
      1,
      2
    ]
  }
}