Administração — API

Usuários

Endpoint	Papel	Descrição
POST /api/v1/users	super admin	Cria um usuário (nome, e-mail, senha, papel).
GET /api/v1/users	admin	Lista os usuários.
PUT /api/v1/users/{id}	super admin	Atualiza papel, nome ou status.
DELETE /api/v1/users/{id}	super admin	Desativa (soft delete).

Papéis: super_admin · admin · reviewer · viewer.

Provedores de identidade (SSO)

Endpoint	Papel	Descrição
POST /api/v1/idp	super admin	Registra um provedor OIDC.
GET /api/v1/idp	admin	Lista os provedores.
PUT /api/v1/idp/{id}	super admin	Atualiza.
DELETE /api/v1/idp/{id}	super admin	Desativa (contas já federadas são mantidas).

Exemplo de registro

{
  "name": "Entra ID",
  "type": "oidc",
  "discovery_url": "https://login.microsoftonline.com/{tenant}/v2.0/.well-known/openid-configuration",
  "client_id": "…",
  "client_secret": "…",
  "role_mapping": { "AgentHub-Admins": "admin", "AgentHub-Reviewers": "reviewer" }
}

Veja SSO (login federado).

Grupos

Endpoint	Papel	Descrição
POST /api/v1/groups	admin	Cria um grupo.
GET /api/v1/groups	leitor	Lista os grupos.
PUT /api/v1/groups/{id}	admin	Atualiza.
DELETE /api/v1/groups/{id}	admin	Remove.

Configurações da plataforma

Endpoint	Papel	Descrição
GET /api/v1/platform-settings	admin	Lê as configurações.
PATCH /api/v1/platform-settings	admin	Atualiza (campos parciais).

Exemplo

{ "access_token_expire_minutes": 30, "shield_mode": "block" }

shield_mode: off · flag · block (veja Escudo anti-injeção).

Assistente

POST /api/v1/assistant leitor

Assistente conversacional sobre a plataforma. Recebe automaticamente contexto sobre os agentes e as solicitações do usuário autenticado; é somente leitura.

Requisição

{ "message": "Quantos dos meus agentes estão ativos?", "history": [] }

Cobrança (Billing)

Endpoint	Papel	Descrição
GET /api/v1/billing/plan	admin	Plano atual + consumo.
POST /api/v1/billing/upgrade	admin	Inicia o fluxo de pagamento para upgrade.
POST /api/v1/billing/portal	admin	Abre o portal de cobrança.

Veja Planos e uso.