Buk

Buk Job Titles API

The Job Titles API from Buk — 3 operation(s) for job titles.

Documentation GitHub OpenAPI

Business capability

Human Capital Management BC-300

Operations 4

GET /roles List job titles #

POST /roles Create a job title #

GET /roles/{id} Get a specific role by ID #

PATCH /roles/{identifier} Update a position #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/buk-job-titles-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  description: '# Buk Data Access API.


    To use the API, you need to obtain an **API Key**.

    You can manage access within the platform, in **Settings => API Access.**


    Once an API Key is created, you must send the value as a header in the HTTP request, in the `auth_token` field.


    ## For more details, you can review the article "How to integrate with Buk through an API"


    # Endpoints'
  title: Buk Job Titles API
servers:
- url: https://demo.buk.cl/api/v1/brasil
tags:
- name: Job Titles
paths:
  /roles:
    get:
      summary: List job titles
      description: 'Displays all job titles registered in the system''.


        Este endpoint no requiere permisos especiales.


        Descripción de atributos:

        - `id`: [string] Id del Cargo.

        - `code`: [string] Codigo.

        - `name`: [string] Nombre.

        - `description`: [string] Description.

        - `requirements`: [string] Requisitos.

        - `role_family`: [object] Familia de cargo.

        - `area_ids`: [array] Área al que pertenece el cargo.

        - `custom_attributes`: [object] Atributos personalizados del cargo.'
      tags:
      - Job Titles
      parameters:
      - name: search
        in: query
        description: Filter job titles by name
        schema:
          type: string
      - name: code
        in: query
        description: Filter job titles by code
        schema:
          type: string
      - name: page_size
        in: query
        description: (OPTIONAL) Number of answers per page. By default it has a value of 25 and must be within a range of [25 - 100].
        schema:
          type: integer
      responses:
        '200':
          description: As a response, we receive an array (data) with job titles
          name: data
          content:
            application/json:
              schema:
                properties:
                  pagination:
                    $ref: '#/components/schemas/Pagination'
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/Role'
            application/pdf:
              schema:
                properties:
                  pagination:
                    $ref: '#/components/schemas/Pagination'
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/Role'
      operationId: getRoles
      x-operation-id-source: derived
    post:
      summary: Create a job title
      description: 'Creates a new role in the system. The parameters are:

        - name: Name of the role

        - code: Role code

        - description: Role description (OPTIONAL)

        - requirements: Role requirements (OPTIONAL)

        - area_ids: Role area IDs (OPTIONAL)

        - custom_attributes: Custom attributes of the role (OPTIONAL)

        - role_family_id: Role family ID (OPTIONAL)

        Este endpoint no requiere permisos especiales.'
      tags:
      - Job Titles
      responses:
        '201':
          description: ''
          content:
            application/json:
              schema:
                title: ResponseBody
                description: Job title created.
                properties:
                  data:
                    $ref: '#/components/schemas/Role__Response'
            application/pdf:
              schema:
                title: ResponseBody
                description: Job title created.
                properties:
                  data:
                    $ref: '#/components/schemas/Role__Response'
        '400':
          description: There is an error with the data submitted
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/bad_request'
            application/pdf:
              schema:
                $ref: '#/components/schemas/bad_request'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Role__Create'
        description: Role type object
        required: true
      operationId: postRoles
      x-operation-id-source: derived
  /roles/{id}:
    get:
      summary: Get a specific role by ID
      description: 'Returns the specific information of the role associated with the provided ID


        Descripción de atributos:

        - `id`: [string] Id del Cargo.

        - `code`: [string] Codigo.

        - `name`: [string] Nombre.

        - `description`: [string] Description.

        - `requirements`: [string] Requisitos.

        - `role_family`: [object] Familia de cargo.

        - `area_ids`: [array] Área al que pertenece el cargo.

        - `custom_attributes`: [object] Atributos personalizados del cargo.

        Este endpoint no requiere permisos especiales.'
      tags:
      - Job Titles
      parameters:
      - name: id
        in: path
        description: Job title ID
        required: true
        schema:
          type: integer
      responses:
        '200':
          description: As a response you will receive a Role
          content:
            application/json:
              schema:
                title: ResponseBody
                description: As a response you will receive the attributes corresponding to the requested role
                properties:
                  data:
                    $ref: '#/components/schemas/Role__Response'
            application/pdf:
              schema:
                title: ResponseBody
                description: As a response you will receive the attributes corresponding to the requested role
                properties:
                  data:
                    $ref: '#/components/schemas/Role__Response'
        '404':
          description: Job title not found
      operationId: getRolesById
      x-operation-id-source: derived
  /roles/{identifier}:
    patch:
      summary: Update a position
      description: 'Updates an existing role in the system. The parameters are:

        - identifier: Existing role identifier. Can be either the numeric ID or the Role code

        - name: New name of the role (OPTIONAL)

        - description: New description of the role (OPTIONAL)

        - requirements: New requirements of the role (OPTIONAL)

        - active: Role status (OPTIONAL)

        - area_ids: IDs of the new role areas (OPTIONAL)

        - custom_attributes: Custom attributes of the role (OPTIONAL)

        - role_family_id: Role family ID (OPTIONAL)


        The entered values will overwrite the data of the role being edited


        If area_ids does not contain the current ones, they will be removed, leaving only the ones entered.


        You cannot remove the association of an area with a job title that has active jobs.


        Este endpoint no requiere permisos especiales.'
      tags:
      - Job Titles
      parameters:
      - name: identifier
        in: path
        description: '- identifier: Existing role identifier. Can be either the numeric ID or the Role code'
        required: true
        schema:
          type: string
      responses:
        '201':
          description: ''
          content:
            application/json:
              schema:
                title: ResponseBody
                description: Job title updated.
                properties:
                  data:
                    $ref: '#/components/schemas/Role__Response'
            application/pdf:
              schema:
                title: ResponseBody
                description: Job title updated.
                properties:
                  data:
                    $ref: '#/components/schemas/Role__Response'
        '400':
          description: There is an error with the data submitted
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/bad_request'
            application/pdf:
              schema:
                $ref: '#/components/schemas/bad_request'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Role__Update'
        description: Role type object
        required: true
      operationId: patchRolesByIdentifier
      x-operation-id-source: derived
components:
  schemas:
    RoleFamily:
      properties:
        id:
          type: integer
        name:
          type: string
        quantity_of_roles:
          type: integer
    Pagination:
      properties:
        next:
          type: string
        previous:
          type: string
        count:
          type: integer
        total_pages:
          type: integer
    bad_request:
      properties:
        errors:
          type: array
          items:
            type: string
    Role__Create:
      properties:
        name:
          type: string
          description: Nombre del cargo
          example: Analista
        code:
          type: string
          description: Código del cargo
          example: ROL-001
        description:
          type: string
          description: Descripción del cargo
          example: Gestion
        requirements:
          type: string
          description: Requisitos del cargo
          example: Universitario
        role_family_id:
          type: integer
          description: Identificador de la familia de cargos
          example: 1
        area_ids:
          type: array
          description: Identificadores de las áreas asociadas al cargo
          items:
            type: integer
            example: 1
        custom_attributes:
          type: object
          description: Atributos personalizados del cargo
          example: {}
    Role__Response:
      properties:
        id:
          type: integer
          description: Identificador único del cargo
          example: 1
        name:
          type: string
          description: Nombre del cargo
          example: Analista
        description:
          type: string
          description: Descripción del cargo
          example: Gestion
        code:
          type: string
          description: Código del cargo
          example: ROL-001
        requirements:
          type: string
          description: Requisitos del cargo
          example: Universitario
        active:
          type: boolean
          description: Indica si el cargo está activo
          example: true
        area_ids:
          type: array
          description: Identificadores de las áreas asociadas al cargo
          items:
            type: integer
            example: 1
        role_family_id:
          type: integer
          description: Identificador de la familia de cargos
          example: 1
        custom_attributes:
          type: object
          description: Atributos personalizados del cargo
          example: {}
    Role:
      properties:
        id:
          type: integer
          description: Identificador único del cargo
          example: 1
        code:
          type: string
          description: Código del cargo
          example: ROL-001
        name:
          type: string
          description: Nombre del cargo
          example: Analista
        description:
          type: string
          description: Descripción del cargo
          example: Gestion
        requirements:
          type: string
          description: Requisitos del cargo
          example: Universitario
        role_family:
          type: object
          $ref: '#/components/schemas/RoleFamily'
          description: Familia de cargos a la que pertenece el cargo
        area_ids:
          type: array
          description: Identificadores de las áreas asociadas al cargo
          items:
            type: integer
            example: 1
        custom_attributes:
          type: object
          description: Atributos personalizados del cargo
          example: {}
    Role__Update:
      properties:
        name:
          type: string
          description: Nombre del cargo
          example: Analista
        description:
          type: string
          description: Descripción del cargo
          example: Gestion
        requirements:
          type: string
          description: Requisitos del cargo
          example: Universitario
        active:
          type: boolean
          description: Indica si el cargo está activo
          example: true
        role_family_id:
          type: integer
          description: Identificador de la familia de cargos
          example: 1
        area_ids:
          type: array
          description: Identificadores de las áreas asociadas al cargo
          items:
            type: integer
            example: 1
        custom_attributes:
          type: object
          description: Atributos personalizados del cargo
          example: {}
  securitySchemes:
    auth_token:
      type: apiKey
      name: auth_token
      in: header