Grupos de Permissões

GET /api/auth/permission-groups

Retorna todas as permissões disponíveis, agrupadas por área funcional. Útil para construir interfaces de atribuição de permissões.

Auth: Necessária — qualquer usuário autenticado, com o header x-tenant-id de um de seus tenants

Headers

Header	Obrigatório	Valor
`Authorization`	Sim	`Bearer <access_token>`
`x-tenant-id`	Sim	UUID do tenant

Exemplo

curl https://api.reten.ai/api/auth/permission-groups \
  -H "Authorization: Bearer <token>" \
  -H "x-tenant-id: <tenant-id>"

const response = await fetch("https://api.reten.ai/api/auth/permission-groups", {
  headers: {
    "Authorization": "Bearer <token>",
    "x-tenant-id": "<tenant-id>",
  },
});
const data = await response.json();

import requests

response = requests.get(
    "https://api.reten.ai/api/auth/permission-groups",
    headers={
        "Authorization": "Bearer <token>",
        "x-tenant-id": "<tenant-id>",
    },
)
data = response.json()

Resposta `200 OK`

Trecho — a resposta tem 16 grupos, e cada permissão aparece em exatamente um deles:

{
  "groups": [
    {
      "name": "User Management",
      "permissions": [
        { "key": "user:create", "description": "Create new users" },
        { "key": "user:view", "description": "View user list and details" },
        { "key": "user:update", "description": "Update user information" },
        { "key": "user:delete", "description": "Delete users" },
        { "key": "user:reset-password", "description": "Reset other users passwords" }
      ]
    },
    {
      "name": "Projects",
      "permissions": [
        { "key": "project:create", "description": "Create new projects within the tenant" },
        { "key": "project:view", "description": "View the project list of the tenant" },
        { "key": "project:update", "description": "Rename projects and edit their root audience" }
      ]
    },
    {
      "name": "Activities",
      "permissions": [
        { "key": "activity:view", "description": "View activity list and details" },
        { "key": "activity:create", "description": "Create new activities" },
        { "key": "activity:cancel", "description": "Cancel activities in READY status" },
        { "key": "activity-config:manage", "description": "Manage activity configuration (target resolution)" },
        { "key": "activity:dispatch", "description": "Manually dispatch activities to external providers" },
        { "key": "activity:force-retry-dispatch", "description": "Force retry dispatch for failed activities" }
      ]
    }
  ]
}

Formato da Resposta

Campo	Tipo	Descrição
`groups`	array	Lista de grupos de permissões, sempre na mesma ordem
`groups[].name`	string	Nome de exibição do grupo, em inglês
`groups[].permissions`	array	Permissões neste grupo
`groups[].permissions[].key`	string	Valor da permissão — a mesma string enviada em `permissions` de `POST /api/api-keys`
`groups[].permissions[].description`	string	Descrição legível, em inglês

Respostas de Erro

Status	Descrição
`400`	Header `x-tenant-id` ausente — `Missing required header: x-tenant-id`
`401`	Token de acesso ausente ou inválido
`403`	O usuário não pertence ao tenant — `User does not have access to the requested tenant`