Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/exon-reyes/integra-backend/llms.txt

Use this file to discover all available pages before exploring further.

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