Skip to main content
DELETE
Elimina uno de los roles personalizados propios de la cuenta en el host de la API de gestión (api.scanova.io), autenticado con tu clave sin procesar de la API de gestión.
integer
requerido
El id del rol.
Una llamada exitosa devuelve 204 No Content.

Reasigna a los compañeros primero

Si el rol sigue asignado a algún usuario compartido, esto devuelve un 400 amigable (no un error de integridad de base de datos en bruto) pidiendo reasignar a esos compañeros a otro rol antes de eliminarlo. Igual que en la actualización, un pk perteneciente a un rol de sistema o al rol personalizado de otra cuenta devuelve 404.

Relacionado

Autorizaciones

Authorization
string
header
requerido

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. api.scanova.io) — the same key sent to the regular API host will not authenticate.

Parámetros de ruta

pk
integer
requerido

Respuesta

Role deleted.