GET/api/permission-groups

Listar grupos

Os grupos da clínica e o catálogo das permissões que existem, por área.

Headers

NomeTipoObrig.Descrição
Authorization
stringSimBearer {access_token}, com o token que o login devolve.

Parâmetros

Esta rota não tem parâmetros.

Campos da resposta

NomeTipoDescrição
groups
arrayOs grupos.
catalog
arrayAs permissões, por área.

Request URL

https://api-endosystem.imagemais.com.br/api/permission-groups
curl -X GET "https://api-endosystem.imagemais.com.br/api/permission-groups" \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Respostas

{
  "groups": [
    {
  ...
{
  "groups": [
    {
      "id": "1f3b5d7a-9c2e-4b4d-a6f8-0b2d4f6a8c0e",
      "name": "Integração",
      "description": "Usuário do Sistema X",
      "permissions": [
        "patients.create",
        "patients.edit"
      ],
      "is_system": false,
      "users_count": 1,
      "members": [
        {
          "id": "6a8c0e2b-4d6f-4a8b-9c1e-3f5a7b9d1c3e",
          "name": "Integração Sistema X"
        }
      ],
      "created_at": "2026-10-14T07:55:00-03:00"
    }
  ],
  "catalog": [
    {
      "area": "Pacientes",
      "where": "Menu → Pacientes",
      "permissions": [
        {
          "key": "patients.create",
          "action": "create",
          "subject": "patients",
          "label": "Cadastrar paciente"
        },
        {
          "key": "patients.edit",
          "action": "edit",
          "subject": "patients",
          "label": "Editar paciente"
        },
        {
          "key": "patients.delete",
          "action": "delete",
          "subject": "patients",
          "label": "Excluir paciente"
        }
      ]
    }
  ]
}
{
  "error": "Token ausente",
  "message": "Token de autenticação necessário.",
  ...
{
  "error": "Token ausente",
  "message": "Token de autenticação necessário.",
  "code": "TOKEN_MISSING"
}
{
  "error": "Token expirado",
  "message": "Sua sessão expirou. Faça login novamente.",
  ...
{
  "error": "Token expirado",
  "message": "Sua sessão expirou. Faça login novamente.",
  "code": "TOKEN_EXPIRED"
}
{
  "error": "Token inválido",
  "message": "Token de autenticação inválido. Faça login novamente.",
  ...
{
  "error": "Token inválido",
  "message": "Token de autenticação inválido. Faça login novamente.",
  "code": "TOKEN_INVALID"
}
{
  "error": "Acesso revogado",
  "message": "Seu acesso foi desativado. Procure o administrador da clínica.",
  ...
{
  "error": "Acesso revogado",
  "message": "Seu acesso foi desativado. Procure o administrador da clínica.",
  "code": "ACCESS_REVOKED"
}