# API de gestão > Referência da API de gestão da Atlasberg Platform: scan de arquivos, aprovações, auditoria, orçamentos suaves, economômetro, agentes, conformidade, painel executivo, Copilot, licença, SSO, identidade, login por dispositivo e tokens pessoais. As rotas /api/atlasberg/*. Todas montadas na mesma cadeia de middleware de gestão do console: o que autentica o console autentica estas rotas. ## Arquivos e DLP - Método: POST | Rota: /api/atlasberg/files/scan | Uso: O portal envia um arquivo multipart e recebe o veredito DLP (upload_id, status, motivo, codigos). Bloqueio vem com HTTP 200 e o veredito no corpo; 400, 413 e 503 são falhas do gateway, não veredito. - Método: GET | Rota: /api/atlasberg/policies | Uso: A política DLP em vigor. - Método: POST | Rota: /api/atlasberg/policies/test | Uso: Teste de política. ## Aprovações - Método: GET | Rota: /api/atlasberg/approvals | Uso: Fila de aprovações pendentes: códigos de motivo mais o hash do payload, nunca o texto. - Método: POST | Rota: /api/atlasberg/approvals/{id}/approve e /deny | Uso: Decidir uma aprovação. A identidade do aprovador é obrigatória: sessão verificada, ou o header x-atlasberg-approver ou o campo aprovador do corpo. ## Auditoria - Método: GET | Rota: /api/atlasberg/audit | Uso: Status da trilha. - Método: GET | Rota: /api/atlasberg/audit/events | Uso: Leitura de eventos. - Método: POST | Rota: /api/atlasberg/audit/verify | Uso: Verificação da trilha pelo próprio gateway. - Método: GET | Rota: /api/atlasberg/audit/export | Uso: Export assinado. - Método: POST | Rota: /api/atlasberg/audit/anchor | Uso: Força uma âncora. ## Custo e inteligência - Método: GET/POST, PUT/DELETE em {id} | Rota: /api/atlasberg/orcamentos | Uso: Orçamentos suaves (corte suave). - Método: GET | Rota: /api/atlasberg/economometro e /economometro/alerta | Uso: Medidor passivo de desperdício. - Método: GET | Rota: /api/atlasberg/agentes | Uso: Inventário de agentes observados. - Método: GET | Rota: /api/atlasberg/cambio | Uso: Cotação USD para exibição em BRL no console. - Método: GET | Rota: /api/atlasberg/finops/chargeback | Uso: Rateio FinOps. - Método: GET | Rota: /api/atlasberg/executivo e /executivo/export | Uso: Painel executivo e export (PDF). - Método: GET/POST, PUT/DELETE em {id}, POST/DELETE em {id}/times/{team_id} | Rota: /api/atlasberg/executivo/unidades | Uso: Árvore de unidades organizacionais e mapeamento de times. ## Conformidade - Método: GET | Rota: /api/atlasberg/compliance e /compliance/export | Uso: Relatório de conformidade. ## Copilot - Método: GET | Rota: /api/atlasberg/copilot | Uso: Painel de licenças Copilot importadas. Responde sempre com dado e carrega modulo_licenciado (booleano) e, quando falso, modulo_aviso. As listas superficies e por_time podem ser vazias, nunca null. - Método: POST/DELETE | Rota: /api/atlasberg/copilot/{superficie} | Uso: Importar ou remover inventário. POST responde 403 sem o módulo copilot; DELETE nunca depende da licença. - Método: GET, PUT/DELETE em /conexoes/{superficie} | Rota: /api/atlasberg/copilot/conexoes | Uso: Configuração de acesso por superfície. GET devolve sempre a configuração completa mais modulo_licenciado e modulo_aviso; o segredo nunca é devolvido. PUT responde 403 sem o módulo. ## Licença - Método: GET | Rota: /api/atlasberg/license | Uso: Estado vivo da licença: plano, expiração, graça, módulos, high water mark, chave pública do deployment. - Método: POST | Rota: /api/atlasberg/license/import | Uso: Importa a licença assinada (corpo cru ou multipart file, máximo 64 KiB). - Método: GET | Rota: /api/atlasberg/license/activation | Uso: Pedido de ativação assinado, para copiar ao back-office. - Método: GET | Rota: /api/atlasberg/license/usage | Uso: Relatório de uso assinado (?period=YYYY-MM; vazio agrega a trilha inteira). ## SSO - Método: GET | Rota: /api/atlasberg/sso/login e /sso/callback | Uso: Login OIDC. - Método: POST | Rota: /api/atlasberg/sso/local-login e /sso/logout | Uso: Login local air-gapped e logout. - Método: GET | Rota: /api/atlasberg/sso/session | Uso: Sessão. - Método: GET | Rota: /api/atlasberg/sso/downloads e /sso/downloads/{arquivo} | Uso: Listar e baixar os binários da CLI atlasberg servidos pelo appliance (lista fechada de cinco arquivos, a partir de ATLASBERG_DOWNLOADS_DIR). ## Login por dispositivo e tokens pessoais Device flow da RFC 8628. Estas rotas são montadas fora da cadeia de gestão, junto das demais rotas /sso/: o terminal chama as duas primeiras sem credencial nenhuma, o portal chama as três seguintes com o cookie de sessão, e as duas últimas são os tokens da própria pessoa. Tokens pessoais carregam o prefixo atu- (43 caracteres base64url); o código de usuário tem 8 letras do alfabeto BCDFGHJKLMNPQRSTVWXZ, exibido como XXXX-XXXX. - Método: POST | Rota: /api/atlasberg/sso/device/code | Uso: Terminal pede um código (client_name opcional). Devolve device_code, user_code, verification_uri, verification_uri_complete, expires_in, interval. - Método: POST | Rota: /api/atlasberg/sso/device/token | Uso: Terminal consulta com device_code. Devolve access_token e token_type Bearer. Erros da RFC com 400: authorization_pending, slow_down, expired_token, access_denied, invalid_grant; codigo_desconhecido com 404; limite_de_origem com 429. - Método: GET | Rota: /api/atlasberg/sso/device/pendente?codigo= | Uso: Portal (cookie): o pedido pendente por trás de um código, para a tela de aprovação em /portal/dispositivo. - Método: POST | Rota: /api/atlasberg/sso/device/aprovar e /negar | Uso: Portal (cookie): a pessoa aprova ou nega o código. - Método: GET | Rota: /api/atlasberg/sso/tokens | Uso: Os tokens da própria pessoa. - Método: DELETE | Rota: /api/atlasberg/sso/tokens/{id} | Uso: Revoga um token da pessoa; atual significa o token desta própria requisição. - Política padrão: código válido por 10 minutos (piso 1, teto 30), intervalo de consulta de 5 segundos (mínimo 1), token válido por 7 dias (de 1 hora a 90 dias), 5 tokens por pessoa (mínimo 1), 1000 concessões pendentes, 10 pedidos de código e 30 consultas por origem por minuto. Configurado no bloco device_flow do sso.json. - A roster de tokens guarda só digests SHA-256, em /atlasberg-tokens-pessoais.json com modo 0600. - Na inferência o token é aceito nos mesmos headers de uma chave virtual e trocado pela chave viva do time; veja a página API do plano de dados. ## Identidade As rotas por trás de Configurações, Identidade e SSO. Montadas na cadeia de gestão como o resto desta página. Cada gravação da configuração gera um evento config.change com recurso sso e a seção no detalhe; cada ciclo de sincronização com o diretório gera config.change com recurso diretorio e ator sincronizacao_diretorio. - Método: GET/PUT | Rota: /api/atlasberg/identidade/config | Uso: Ler a tela inteira numa chamada, ou gravar uma seção do sso.json; validado antes de salvar, salvo atomicamente, aplicado ao vivo. - Método: POST | Rota: /api/atlasberg/identidade/config/testar | Uso: Rodar a descoberta OIDC contra o issuer configurado. - Método: POST | Rota: /api/atlasberg/identidade/contas-locais | Uso: Criar conta local. - Método: PUT/DELETE | Rota: /api/atlasberg/identidade/contas-locais/{usuario} | Uso: Atualizar ou remover conta local. - Método: PUT | Rota: /api/atlasberg/identidade/contas-locais/{usuario}/senha | Uso: Trocar a senha de uma conta local. - Método: GET | Rota: /api/atlasberg/identidade/tokens | Uso: Todos os tokens pessoais emitidos neste gateway. - Método: DELETE | Rota: /api/atlasberg/identidade/tokens/{id} | Uso: Revogar um token (administrador). - Método: POST | Rota: /api/atlasberg/identidade/tokens/revogar-pessoa | Uso: Revogar todos os tokens de uma pessoa. - Método: GET | Rota: /api/atlasberg/identidade/diretorio | Uso: Estado da sincronização com o diretório. - Método: POST | Rota: /api/atlasberg/identidade/diretorio/previa | Uso: Prévia do plano de sincronização, sem aplicar. - Método: POST | Rota: /api/atlasberg/identidade/diretorio/sincronizar | Uso: Rodar um ciclo de sincronização agora. ## Rotas de gestão herdadas O motor base também expõe as rotas de gestão herdadas: /api/governance/* para chaves virtuais e times, /api/config, /api/providers, /api/plugins e /api/session/login, logout e ws-ticket. POST /api/session/login aceita, além do par de admin, as contas da roster local_login que carregam o grupo de console; a sessão fica vinculada à pessoa e a trilha a nomeia. O logout desfaz o vínculo. Congelamento por licença: Com o plano de controle congelado (expirada pós-graça, ou setup), mutações sob /api são recusadas com 403 por allowlist. Leituras GET sempre passam. Ficam abertas só as rotas de licença, login e sessão, as rotas /api/atlasberg/sso/, /api/atlasberg/files/scan e as revogações sob /api/atlasberg/identidade/tokens. Editar a configuração de identidade e as contas locais congela com o resto. Detalhes na página Licenciamento. ## Sobre a Atlasberg Platform A Atlasberg Platform é a camada de controle entre uma empresa e todos os modelos de IA: cada requisição é autenticada com uma chave virtual, filtrada por política e DLP, roteada para o provedor certo e gravada numa trilha de auditoria encadeada por hash. Expõe uma API compatível com a OpenAI, então as aplicações só trocam a URL base. O mesmo artefato roda na Atlasberg Cloud, na sua VPC, on-premises ou totalmente air-gapped, e é cobrado por capacidade e módulos, nunca por assento. Esta página faz parte da documentação oficial. Para falar com o time de engenharia, escreva para contact@atlasberg.com ou use https://atlasberg.com/pt-br/contato. A resposta vem em até um dia útil. ## Mais da Atlasberg - [Índice da documentação](https://atlasberg.com/pt-br/docs) - [Visão geral da plataforma](https://atlasberg.com/pt-br) - [Fale com a engenharia](https://atlasberg.com/pt-br/contato) --- Fonte: https://atlasberg.com/pt-br/docs/api/gestao Empresa: Sobimann Tecnologia da Informacao LTDA (Atlasberg), Porto Alegre, RS, Brasil. Contato: contact@atlasberg.com - resposta em até um dia útil. Índice para agentes: https://atlasberg.com/llms.txt