Skip to main content

​
Positions API

The Positions API provides endpoints to retrieve and manage job positions (puestos) within the organization.

​
Endpoints

​
Get All Positions

Retrieves a list of all job positions in the organization. 
curl -X GET "https://api.integra.com/puestos" \
  -H "Authorization: Bearer YOUR_TOKEN"

​
Request

Method: GET Endpoint: /puestos Headers:
  • Authorization: Bearer token (required)

​
Response

Status Code: 200 OK
Response Example
{
  "data": [
    {
      "id": 1,
      "nombre": "Gerente General",
      "activo": true
    },
    {
      "id": 2,
      "nombre": "Supervisor de Operaciones",
      "activo": true
    },
    {
      "id": 3,
      "nombre": "Operador de Caja",
      "activo": false
    }
  ],
  "message": "Puestos"
}

​
Entity Structure

​
Position Entity

FieldTypeDescription
idIntegerUnique identifier for the position
nombreStringName of the position
activoBooleanIndicates if the position is active/available

​
Status Values

  • activo: true - The position is active and can be assigned to employees
  • activo: false - The position is inactive and not available for assignment

​
Relationships

Positions are job roles that:
  • Can be assigned to employees
  • May be associated with specific departments
  • Define the role and responsibilities within the organization
  • Can be active or inactive based on organizational needs

Build docs developers (and LLMs) love

Get started for freeTalk to us