curl --request POST \
--url 'https://management.scanova.io/multi-users/' \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"email": "teammate@example.com",
"name": "Jordan Lee",
"access_level": 5
}'
{
"id": 118,
"shared_user": {
"id": 88213,
"first_name": "Jordan",
"last_name": "Lee",
"full_name": "Jordan Lee",
"email": "teammate@example.com",
"is_active": false,
"is_locked": false
},
"access_level": {
"id": 5,
"name": "Manager",
"slug": "manager",
"permissions": [],
"is_custom": false
},
"invitation_sent_on": null,
"invitation_accepted_on": null,
"is_invitation_sent": false,
"is_invitation_accepted": false,
"status": "Invitation Sent",
"is_active": false,
"created": "2026-08-16T20:41:09.442000+05:30",
"modified": "2026-08-16T20:41:09.442000+05:30",
"include_untagged": true,
"enable_tag_permission": false,
"tags": []
}
API de gestión — Usuarios compartidos y roles
Invitar a un usuario compartido
POST /multi-users/
POST
/
multi-users
/
curl --request POST \
--url 'https://management.scanova.io/multi-users/' \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"email": "teammate@example.com",
"name": "Jordan Lee",
"access_level": 5
}'
{
"id": 118,
"shared_user": {
"id": 88213,
"first_name": "Jordan",
"last_name": "Lee",
"full_name": "Jordan Lee",
"email": "teammate@example.com",
"is_active": false,
"is_locked": false
},
"access_level": {
"id": 5,
"name": "Manager",
"slug": "manager",
"permissions": [],
"is_custom": false
},
"invitation_sent_on": null,
"invitation_accepted_on": null,
"is_invitation_sent": false,
"is_invitation_accepted": false,
"status": "Invitation Sent",
"is_active": false,
"created": "2026-08-16T20:41:09.442000+05:30",
"modified": "2026-08-16T20:41:09.442000+05:30",
"include_untagged": true,
"enable_tag_permission": false,
"tags": []
}
Los usuarios compartidos son los compañeros de equipo que invitas a tu cuenta de Scanova — la misma lista que se muestra en la tabla Users del panel. Este endpoint te permite listarlos, invitarlos, actualizarlos o eliminarlos de forma programática.
Este endpoint no estaba documentado anteriormente. Requiere una clave de la API de gestión con cuota
MANAGEMENT_API (o MANAGEMENT_API_SANDBOX), enviada como el valor sin procesar del encabezado Authorization — consulta el resumen de la API de gestión — además de la propia cuota de Team de la cuenta para usuarios compartidos. Para saber qué otorga realmente cada rol, consulta Roles y permisos; para el formato de transmisión de los propios roles, consulta Roles (niveles de acceso).curl --request POST \
--url 'https://management.scanova.io/multi-users/' \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"email": "teammate@example.com",
"name": "Jordan Lee",
"access_level": 5
}'
{
"id": 118,
"shared_user": {
"id": 88213,
"first_name": "Jordan",
"last_name": "Lee",
"full_name": "Jordan Lee",
"email": "teammate@example.com",
"is_active": false,
"is_locked": false
},
"access_level": {
"id": 5,
"name": "Manager",
"slug": "manager",
"permissions": [],
"is_custom": false
},
"invitation_sent_on": null,
"invitation_accepted_on": null,
"is_invitation_sent": false,
"is_invitation_accepted": false,
"status": "Invitation Sent",
"is_active": false,
"created": "2026-08-16T20:41:09.442000+05:30",
"modified": "2026-08-16T20:41:09.442000+05:30",
"include_untagged": true,
"enable_tag_permission": false,
"tags": []
}
string
requerido
Dirección de correo electrónico del nuevo compañero de equipo. No debe pertenecer ya a otro usuario de Scanova — un duplicado devuelve un 400 con
{"email": ["Email address is already used."]}.string
requerido
Nombre para mostrar, hasta 20 caracteres.
integer
requerido
ID de un rol de
GET /multi-users/access-levels/ — ya sea un rol de sistema predeterminado o uno personalizado que esta cuenta haya creado.array
IDs de etiquetas a las que limitar el acceso de este usuario. Requiere la cuota
CUSTOM_TAG/permiso de etiquetas de la cuenta — de lo contrario se rechaza con un 403.boolean
predeterminado:"false"
Restringe los códigos QR visibles para este usuario a
tags.boolean
predeterminado:"true"
Cuando
enable_tag_permission es verdadero, si los códigos QR sin etiquetar siguen siendo visibles.Invitar a un compañero de equipo siempre le envía un correo de invitación — crear el registro aquí tiene el mismo efecto que hacer clic en Invite Users en la tabla Users del panel. No hay forma de omitir el correo mediante este endpoint.
Relacionado
- Listar usuarios compartidos — la otra operación de este mismo endpoint.
- Obtener un usuario compartido — opera sobre el registro del usuario compartido después de invitarlo.
- Actualizar un usuario compartido — opera sobre el registro del usuario compartido después de invitarlo.
- Eliminar un usuario compartido — opera sobre el registro del usuario compartido después de invitarlo.
- Listar roles — busca o crea el ID de
access_levelque requieren las llamadas de invitar/actualizar de este endpoint. - Crear un rol personalizado — busca o crea el ID de
access_levelque requieren las llamadas de invitar/actualizar de este endpoint. - Usuarios compartidos — la propia tabla Users del panel, que muestra las mismas acciones de invitar/desactivar/eliminar.
- Roles y permisos — qué otorga realmente cada rol a un compañero de equipo.
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
Invitation created — sends an invitation email to the shared user.
¿Esta página le ayudó?
⌘I