{
  "opencollection": "1.0.0",
  "info": {
    "name": "Buk Job Titles API",
    "version": "1.0"
  },
  "items": [
    {
      "info": {
        "name": "Job Titles",
        "type": "folder"
      },
      "items": [
        {
          "info": {
            "name": "List job titles",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "{{baseUrl}}/roles",
            "params": [
              {
                "name": "search",
                "value": "",
                "type": "query",
                "description": "Filter job titles by name"
              },
              {
                "name": "code",
                "value": "",
                "type": "query",
                "description": "Filter job titles by code"
              },
              {
                "name": "page_size",
                "value": "",
                "type": "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]."
              }
            ]
          },
          "docs": "Displays all job titles registered in the system'.\n\nEste endpoint no requiere permisos especiales.\n\n\nDescripción de atributos:\n- `id`: [string] Id del Cargo.\n- `code`: [string] Codigo.\n- `name`: [string] Nombre.\n- `description`: [string] Description.\n- `requirements`: [string] Requisitos.\n- `role_family`: [object] Familia de cargo.\n- `area_ids`: [array] Área al que pertenece el cargo.\n- `custom_attributes`: [object] Atributos personalizados del cargo.\n\n"
        },
        {
          "info": {
            "name": "Create a job title",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "{{baseUrl}}/roles"
          },
          "docs": "Creates a new role in the system. The parameters are:\n- name: Name of the role\n- code: Role code\n- description: Role description (OPTIONAL)\n- requirements: Role requirements (OPTIONAL)\n- area_ids: Role area IDs (OPTIONAL)\n- custom_attributes: Custom attributes of the role (OPTIONAL)\n- role_family_id: Role family ID (OPTIONAL)\nEste endpoint no requiere permisos especiales.\n"
        },
        {
          "info": {
            "name": "Get a specific role by ID",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "{{baseUrl}}/roles/:id",
            "params": [
              {
                "name": "id",
                "value": "",
                "type": "path",
                "description": "Job title ID"
              }
            ]
          },
          "docs": "Returns the specific information of the role associated with the provided ID\n\nDescripción de atributos:\n- `id`: [string] Id del Cargo.\n- `code`: [string] Codigo.\n- `name`: [string] Nombre.\n- `description`: [string] Description.\n- `requirements`: [string] Requisitos.\n- `role_family`: [object] Familia de cargo.\n- `area_ids`: [array] Área al que pertenece el cargo.\n- `custom_attributes`: [object] Atributos personalizados del cargo.\nEste endpoint no requiere permisos especiales.\n"
        },
        {
          "info": {
            "name": "Update a position",
            "type": "http"
          },
          "http": {
            "method": "PATCH",
            "url": "{{baseUrl}}/roles/:identifier",
            "params": [
              {
                "name": "identifier",
                "value": "",
                "type": "path",
                "description": "- identifier: Existing role identifier. Can be either the numeric ID or the Role code"
              }
            ]
          },
          "docs": "Updates an existing role in the system. The parameters are:\n- identifier: Existing role identifier. Can be either the numeric ID or the Role code\n- name: New name of the role (OPTIONAL)\n- description: New description of the role (OPTIONAL)\n- requirements: New requirements of the role (OPTIONAL)\n- active: Role status (OPTIONAL)\n- area_ids: IDs of the new role areas (OPTIONAL)\n- custom_attributes: Custom attributes of the role (OPTIONAL)\n- role_family_id: Role family ID (OPTIONAL)\n\nThe entered val"
        }
      ]
    }
  ],
  "bundled": true
}