Plantonizei

Painel da empresa › Permissões

Salvar exceção de permissão

PUT/api/v1/permissions/exceptionsPede sessão

Como funciona

Cria ou atualiza uma exceção de permissão para uma pessoa: libera (effect: allow) ou bloqueia (effect: deny) uma ação (action) de um módulo (moduleKey) só para ela, por cima do perfil. O motivo vai em reason.

Há uma exceção por pessoa, módulo e ação: mandar de novo atualiza a existente. A pessoa precisa ser desta empresa. Pede a permissão de criar e editar permissões.

Parâmetros

  • actionCorpo · stringO que foi feito.
  • effectCorpo · stringEfeito da exceção: `allow` libera, `deny` bloqueia.
  • moduleKeyCorpo · stringChave do módulo do painel.
  • reasonCorpo · stringMotivo.
  • userIdCorpo · stringIdentificador da conta da pessoa.

Respostas

200 · exception: a exceção gravada.

  • exceptionobject · A exceção gravada.
  • exception.actionstring · O que foi feito.
  • exception.effectstring · Efeito da exceção: allow libera, deny bloqueia.
  • exception.grantedAtstring · Quando foi concedido.
  • exception.grantedBystring · Quem concedeu.
  • exception.idstring · Identificador do registro.
  • exception.moduleKeystring · Chave do módulo do painel.
  • exception.reasonstring · Motivo.
  • exception.userIdstring · Identificador da conta da pessoa.
  • exception.userNamestring · Nome de quem fez a ação.

Corpo de exemplo

{
  "exception": {
    "action": "texto",
    "effect": "texto",
    "grantedAt": "2026-10-20T09:30:00-03:00",
    "grantedBy": "texto",
    "id": "3f0c2a5e-9b1d-4c7e-8a21-6d0f5b7ca91e",
    "moduleKey": "texto",
    "reason": "texto",
    "userId": "3f0c2a5e-9b1d-4c7e-8a21-6d0f5b7ca91e",
    "userName": "texto"
  }
}