Eliminar una asignación de rol de un directorio
DELETE /v1/directories/{directory_id}/role-mappings/{mapping_id} · permiso directories:write
Elimina la asignación. Una asignación de un directorio que se haya eliminado entretanto también puede eliminarse. Los roles concedidos por la asignación se recalculan. La eliminación se audita como role_mapping.deleted.
Solicitud
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
directory_id |
path | sí | ID del directorio SCIM (dir_…). |
mapping_id |
path | sí | ID de la asignación (rmp_…). |
No hay cuerpo de solicitud.
Respuesta
204 No Content sin cuerpo.
Errores
| HTTP | code | Cuándo |
|---|---|---|
| 404 | not_found |
La asignación no existe, o pertenece a otro directorio o entorno. |
| 401 | unauthenticated |
La credencial falta, no es válida o ha sido revocada. |
| 403 | insufficient_permissions |
La credencial no tiene el permiso requerido. |
| 429 | rate_limited |
Se superó el límite de frecuencia; reintenta después del periodo indicado por Retry-After. |
| 503 | service_unavailable |
Una dependencia no está disponible temporalmente; reintenta después del periodo indicado por Retry-After. |
Ejemplo
curl -i -X DELETE "https://api.eu.keenauth.com/v1/directories/dir_01j9xm2n4p6q8r0s2t4v6w8y0z/role-mappings/rmp_01j9xw0x4y5z9a1b3c5d7e9f1h" \
-H "Authorization: Bearer $KEENAUTH_SECRET_KEY"