curl --request POST \
--url 'https://management.scanova.io/multi-users/access-levels/' \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"name": "Regional Support",
"permissions": [23, 24, 31]
}'
{
"id": 42,
"name": "Regional Support",
"slug": null,
"permissions": [
{ "id": 23, "code": "QR_CODE_CAN_VIEW", "name": "Can view QR Code", "description": "Allows viewing QR code details.", "is_boolean": true },
{ "id": 24, "code": "ANALYTICS_CAN_VIEW", "name": "Can view Analytics", "description": "Allows viewing analytics.", "is_boolean": true },
{ "id": 31, "code": "LEAD_GENERATION_CAN_VIEW", "name": "Can view Lead Lists", "description": "Allows viewing lead lists.", "is_boolean": true }
],
"is_custom": true
}
API de gestión — Usuarios compartidos y roles
Crear un rol personalizado
POST /multi-users/access-levels/
POST
/
multi-users
/
access-levels
/
curl --request POST \
--url 'https://management.scanova.io/multi-users/access-levels/' \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"name": "Regional Support",
"permissions": [23, 24, 31]
}'
{
"id": 42,
"name": "Regional Support",
"slug": null,
"permissions": [
{ "id": 23, "code": "QR_CODE_CAN_VIEW", "name": "Can view QR Code", "description": "Allows viewing QR code details.", "is_boolean": true },
{ "id": 24, "code": "ANALYTICS_CAN_VIEW", "name": "Can view Analytics", "description": "Allows viewing analytics.", "is_boolean": true },
{ "id": 31, "code": "LEAD_GENERATION_CAN_VIEW", "name": "Can view Lead Lists", "description": "Allows viewing lead lists.", "is_boolean": true }
],
"is_custom": true
}
A cada usuario compartido se le asigna un rol — el panel de Scanova los llama internamente “access levels” (niveles de acceso), y el mismo término aparece a lo largo de este endpoint. Usa este endpoint para consultar los roles disponibles antes de invitar a un compañero de equipo mediante
POST /multi-users/, o para crear un rol personalizado desde tus propios sistemas.
Este endpoint no estaba documentado anteriormente. Requiere una clave de la API de gestión con cuota
MANAGEMENT_API (o MANAGEMENT_API_SANDBOX) — consulta el resumen de la API de gestión. Para saber qué otorga realmente cada rol a un compañero de equipo, consulta la guía orientada a personas Roles y permisos — esta página solo documenta el formato de transmisión.Crear roles personalizados requiere una cuota dedicada en el plan de la cuenta (la misma restricción que oculta la pestaña Roles del panel en planes no compatibles — consulta Los roles personalizados están limitados por plan). Un 403 aquí significa que el plan no lo incluye.
curl --request POST \
--url 'https://management.scanova.io/multi-users/access-levels/' \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"name": "Regional Support",
"permissions": [23, 24, 31]
}'
{
"id": 42,
"name": "Regional Support",
"slug": null,
"permissions": [
{ "id": 23, "code": "QR_CODE_CAN_VIEW", "name": "Can view QR Code", "description": "Allows viewing QR code details.", "is_boolean": true },
{ "id": 24, "code": "ANALYTICS_CAN_VIEW", "name": "Can view Analytics", "description": "Allows viewing analytics.", "is_boolean": true },
{ "id": 31, "code": "LEAD_GENERATION_CAN_VIEW", "name": "Can view Lead Lists", "description": "Allows viewing lead lists.", "is_boolean": true }
],
"is_custom": true
}
string
requerido
Nombre del rol. Debe ser único entre los roles de esta cuenta — un duplicado devuelve un 400 con
{"name": ["Can not create another user role with the same name."]}.array
requerido
IDs de permisos a otorgar, de los valores
permissions[].id en la respuesta de listado anterior.No existe un endpoint masivo para “listar todos los permisos disponibles independientemente de un rol” en la API de gestión — para descubrir los IDs de permisos, léelos del array
permissions de un rol existente (toda cuenta tiene al menos los 6 roles de sistema para inspeccionar).Relacionado
- Listar roles — la otra operación de este mismo endpoint.
- Invitar a un usuario compartido — asigna un ID de rol de esta lista al invitar o actualizar un compañero de equipo.
- Actualizar un usuario compartido — asigna un ID de rol de esta lista al invitar o actualizar un compañero de equipo.
- Roles y permisos — la explicación orientada a personas de lo que otorga cada rol, incluyendo la restricción por plan de los roles personalizados.
- Usuarios compartidos — la tabla Users del panel donde estos roles se asignan mediante la interfaz.
Autorizaciones
Send your Management API key as the raw value of the Authorization header — no "Bearer " or "Token " prefix, and no other characters. Example: Authorization: 401f7ac837da42b97f613d789819ff93537bee6a. A header containing more than one space-separated part is rejected outright. Requests also require the request's Host header to be the management API host (e.g. management.scanova.io) — the same key sent to the regular API host will not authenticate.
Cuerpo
application/json
Respuesta
201 - application/json
Custom role created. Requires the account's custom-roles plan quota.
¿Esta página le ayudó?
⌘I