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.Request
Method:GET
Endpoint: /puestos
Headers:
Authorization: Bearer token (required)
Response
Status Code:200 OK
Response Example
Entity Structure
Position Entity
| Field | Type | Description |
|---|---|---|
id | Integer | Unique identifier for the position |
nombre | String | Name of the position |
activo | Boolean | Indicates if the position is active/available |
Status Values
activo: true- The position is active and can be assigned to employeesactivo: 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
Related Endpoints
- Departments API - Manage organizational departments
- Units API - Manage organizational units
- Employees API - Manage employee information and assignments