Create profile

POST /api/perfil Creates a new profile record. If bitAdministrador is true, full permissions (bitAgregar, bitEditar, bitConsulta, bitEliminar, bitDetalle) are automatically created in the permisos_perfil table for every existing module.

Request body

string

required

Name of the new profile. Cannot be empty or whitespace-only.

boolean

default:"false"

Whether this profile has administrator-level access. When true, full permissions are automatically granted for all existing modules.

Response

boolean

required

true when the profile is created successfully.

object

required

The newly created profile record as returned by the database.

Show properties

number

Auto-generated primary key.

string

Profile name.

boolean

Administrator flag.

Error responses

Status	Message	Cause
`400`	`El nombre del perfil es obligatorio`	`strNombrePerfil` is missing or is an empty/whitespace string.
`500`	`No se pudo obtener el perfil recién creado`	The `INSERT` statement succeeded but the `RETURNING` clause returned no rows.
`500`	`Ocurrió un error interno al crear el perfil`	Any other unhandled database error.

Examples

curl --request POST \
  --url https://your-domain.com/api/perfil \
  --header 'Content-Type: application/json' \
  --cookie 'auth_token=<your-jwt>' \
  --data '{
    "strNombrePerfil": "Supervisor",
    "bitAdministrador": false
  }'

const response = await fetch('/api/perfil', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  credentials: 'include',
  body: JSON.stringify({
    strNombrePerfil: 'Supervisor',
    bitAdministrador: false,
  }),
});

const { success, data } = await response.json();

Success response

200

{
  "success": true,
  "data": {
    "id": 4,
    "strNombrePerfil": "Supervisor",
    "bitAdministrador": false
  }
}

Error response (400)

400

{
  "statusCode": 400,
  "message": "El nombre del perfil es obligatorio"
}

Authentication

Users

Profiles

Modules

Permissions

Request body

Response

Error responses

Examples

Success response

Error response (400)

​Request body

​Response

​Error responses

​Examples

​Success response

​Error response (400)

Request body

Response

Error responses

Examples

Success response

Error response (400)