Skip to main content
PATCH
Actualiza 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.
Se admiten tanto PUT (para un reemplazo completo) como PATCH (para una actualización parcial), y ambos aceptan los mismos campos name/permissions documentados para Crear un rol personalizado.

Los roles de sistema no se pueden editar aquí

Solo los roles personalizados propios de la cuenta (is_custom: true) son editables mediante este endpoint — un pk perteneciente a un rol de sistema (o al rol personalizado de otra cuenta) devuelve 404, igual que uno que no existe en absoluto.

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

Cuerpo

application/json
name
string
permissions
integer[]

Respuesta

Role updated.