# Job Posting API

> This is version `1.0.0` of this API documentation. Last update on Sep 22, 2026.
> The Job Posting API allows Vagas for Business customers to post jobs via an HTTP call in JSON format.
> 
> ## Authentication
> 
> The authentication for using this API can be done in two ways:
> 
> - Client Credencials
> - The job will be created with user identification of _admin_ as responsible
> - Autorization Code (3-legged)
> - The job will be created with the given user in the authorization steps as responsible
> 
> ### Client Credencials
> 
> This process consists of a direct POST call to the gateway indicating the credentials to obtain the access token.
> 
> Considering that the credentials were created in the gateway, just make a call according to the example:
> 
> ```
> curl -X POST -k -H 'Content-Type: application/x-www-form-urlencoded' -i 'https://apigateway.vagas.com.br/oauth/token' --data 'grant_type=client_credentials' -u 'client_id:client_secret'
> ```
> 
> The return will be:
> 
> ```json
> {
> "access_token": "asd23sde12e123sd",
> "expires_in": 2591999,
> "token_type": "Bearer"
> }
> ```
> 
> For all other requests below, the __access\_token__ must be
> included in the request as a Authorization HEADER attribute in BEARER token format
> 
> Remembering that __access\_token__ has a time limit for use, the information returned in the key
> __expires\_in__ indicates the number of seconds that the token will expire from its generation date.
> 
> __Exemple request using the __access\_token__:__
> 
> ```shell
> # Example token the must be added in the Authorization HEADER:
> # Authorization: Bearer asd23sde12e123sd
> CURL example:
> curl -XGET <URL TBD>
> --header “Authorization: Bearer asd23sde12e123sd”
> ```
> 
> ### Autorization Code (3-legged)
> 
> This process implements the OAuth 2.0 specification for authentication and authorization.
> 
> This authentication follows the "three leg" approach:
> 
> - The __remote service__ requests __user__ (Jobs For Business employee)
> to authenticate to a __VAGAS API__ server
> 
> #### How to get the token
> 
> The remote service starts the process by calling the PATH /oauth/authorize
> from the VAGAS API server, sending as parameters:
> 
> - __client_id__: Application ID (Provided by VAGAS team)
> - __login_type__: Type of login ID (must send the value "empresa")
> - __response_type__: Type of response ID (must send "code")
> - __redirect_uri__: URI that will be redirected when login action succeeds or fails
> 
> __Exemple:__
> ```
> https://apigateway.vagas.com.br/oauth/authorize?response_type=code&client_id=some_application_id&login_type=empresa&redirect_uri=http%3A%2F%2Flocalhost%2Foauth%2Fcode_callback
> ```
> 
> The user will authenticate with their credentials and authorize the use of their information
> by the remote service.
> 
> When the user accepts the authorization, the VAGAS API server will redirect back
> to the remote service using the address indicated by the redirect_uri parameter
> with an authorization code.
> 
> __Exemple:__
> ```
> http://localhost/oauth/code_callback?code=AixUbVTop239876
> ```
> 
> In case of unauthorized request, the call will be to the same URI
> informed in the redirect_uri parameter with the error parameter.
> 
> __Exemple:__
> ```
> http://localhost/oauth/code_callback?error=unauthorized-request
> ```
> 
> Using the code returned above, the remote service must request
> an access token that will be used for all other requests.
> 
> Making a new request via an HTTP POST to the route
> /oauth/token using the "application/x-www-form-urlencoded" format with the following parameters:
> 
> - __code__: The authorization code (received in the previous request)
> - __grant_type__: Should have the value: "authorization_code"
> 
> It must also be included in the request HEADER an attribute with the client\_id and client\_secret information concatenated
> by a colon (:) and encoded in Base64
> 
> __Example:__
> 
> - Having the client\_id equal to __"example"__ and a client\_secret equal to __"emi40QrBjUiPaVC2eGK5"__
> - Must be concatenated: __example:emi40QrBjUiPaVC2eGK5__
> - Applied Base64 on above value: __ZXhhbXBsZTplbWk0MFFyQmpVaVBhVkMyZUdLNQ==__
> - Included in the HEADER of the request: __Authorization: Basic ZXhhbXBsZTplbWk0MFFyQmpVaVBhVkMyZUdLNQ==__
> 
> __Exemple Curl:__
> 
> ```shell
> curl -XPOST https://apigateway.vagas.com.br/oauth/token \
> --header “Authorization: Basic ZXhhbXBsZTplbWk0MFFyQmpVaVBhVkMyZUdLNQ==” \
> --data “code=AixUbVTop239876&grant_type=authorization_code”
> ```
> 
> __The return of the request, if successful will be:__
> ```json
> {
> "access_token": "asd23sde12e123sd",
> "expired_in": 2591999
> }
> ```
> 
> For all other requests below, the __access\_token__ must be
> included in the request as a HEADER attribute in BEARER format
> 
> Remembering that __access\_token__ has a time limit for use, the information returned
> in the key __expires\_in__ indicates the number of seconds that the token will expire from its generation date.
> 
> __Example call using __access\_token__:__
> 
> ```shell
> # Example value that must be included in the request HEADER:
> # Authorization: Bearer asd23sde12e123sd
> CURL example:
> curl -XGET <URL TBD>
> --header “Authorization: Bearer asd23sde12e123sd”
> ```

[Documentation](https://vaas.vag.as/doc/publicacao-vagas-en.md)

OpenAPI file: https://vaas.vag.as/doc/publicacao-vagas-en.yaml

## MCP server

Connect AI agents to this documentation with the publicacao-vagas-en MCP server (Model Context Protocol, no authentication, Streamable HTTP transport):

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

## [Servers](https://vaas.vag.as/doc/publicacao-vagas-en/servers.md)
- https://apigateway.vagas.com.br/v1: https://apigateway.vagas.com.br/v1


## Topics

### [Authentication](https://vaas.vag.as/doc/publicacao-vagas-en/authentication.md)


## Endpoints

### [Lists](https://vaas.vag.as/doc/publicacao-vagas-en/group/endpoint-lists.md)

- [List Benefits](https://vaas.vag.as/doc/publicacao-vagas-en/operation/operation-listbenefits.md)

- [List Cities](https://vaas.vag.as/doc/publicacao-vagas-en/operation/operation-listcities.md)

- [List Company Divisions](https://vaas.vag.as/doc/publicacao-vagas-en/operation/operation-listcompanydivisions.md)

- [List Contract Type](https://vaas.vag.as/doc/publicacao-vagas-en/operation/operation-listcontracttype.md)

- [List Countries](https://vaas.vag.as/doc/publicacao-vagas-en/operation/operation-listcountries.md)

- [List Education Levels](https://vaas.vag.as/doc/publicacao-vagas-en/operation/operation-listeducationlevels.md)

- [List Fields of Activity](https://vaas.vag.as/doc/publicacao-vagas-en/operation/operation-listfieldsofactivity.md)

- [List Forms](https://vaas.vag.as/doc/publicacao-vagas-en/operation/operation-listforms.md)

- [List Hierarchical Levels](https://vaas.vag.as/doc/publicacao-vagas-en/operation/operation-listhierarchicallevels.md)

- [List Job Models](https://vaas.vag.as/doc/publicacao-vagas-en/operation/operation-listjobmodels.md)

- [List Languages](https://vaas.vag.as/doc/publicacao-vagas-en/operation/operation-listlanguages.md)

- [List Partner channels](https://vaas.vag.as/doc/publicacao-vagas-en/operation/operation-listpartnerchannels.md)

- [List Phases](https://vaas.vag.as/doc/publicacao-vagas-en/operation/operation-listphases.md)

- [List Presentations](https://vaas.vag.as/doc/publicacao-vagas-en/operation/operation-listpresentations.md)

- [List States](https://vaas.vag.as/doc/publicacao-vagas-en/operation/operation-liststates.md)

- [List Work model](https://vaas.vag.as/doc/publicacao-vagas-en/operation/operation-listworkmodel.md)


### [Jobs](https://vaas.vag.as/doc/publicacao-vagas-en/group/endpoint-jobs.md)

- [Post Job](https://vaas.vag.as/doc/publicacao-vagas-en/operation/operation-postjob.md)

- [Edit Job](https://vaas.vag.as/doc/publicacao-vagas-en/operation/operation-editjob.md)




## Changelog

- [Changelog](https://vaas.vag.as/doc/publicacao-vagas-en/changes.md)
- [Changelog index (llms.txt)](https://vaas.vag.as/doc/publicacao-vagas-en/changes/llms.txt)

[Powered by Bump.sh](https://bump.sh)
