API Reference
Catálogo completo de los 23 micro-routers de AgentShield.
Authentication: Bearer Token (JWT) or X-API-Key
AI Core & Proxy
/v1/chat/completionsproxy.pyEndpoint principal. Proxy universal compatible con OpenAI. Ejecuta DecisionPipeline (6 gates), Hive Mind cache, LLM streaming y Safety Engine.
/v1/images/generationsimages.pyProxy Generativo para DALL-E 3. Intercepta, gobierna y cobra la creatividad mediante el Estimador Multimodal.
/v1/embeddingsembeddings.pyEndpoint crítico para RAG. Intercepta la vectorización de documentos para cobrar y auditar la inyección de conocimiento.
Financial & FinOps
/v1/receiptreceipt.pyRegistra transacción completada y genera firma SHA256. Fundamental para el WAL financiero.
/budget/quotas/{user_id}budget_management.pyObtiene límites de cuota (diario/mensual) y gasto actual del usuario.
/v1/evidence/packagereceipt.pyLegal Discovery. Genera ZIP forense con receipt.json, transcript.pdf y firmas. Admisible en juicio.
/budget/wallets/{wallet_id}/top-upbudget_management.pyCrypto/Fiat Top-Up. Recarga de saldo en tiempo real con conversión automática de divisa.
/budget/anomaliesbudget_management.pyFraud Detection. Lista anomalías de gasto detectadas por ML (e.g. 'Spike de 500% en 10min').
/budget/anomalies/{anomaly_id}/acknowledgebudget_management.pyFraud Ops. Marca una anomalía como investigada (False Positive / Confirmed) para reentrenar el modelo.
/v1/invoices/download/{cost_center_id}invoices.pyDescarga la factura mensual de chargeback interno en PDF. Requiere privilegios de Admin/Manager.
Legal & Compliance
/ai-act/classifyai_act_compliance.pyClasifica request según EU AI Act (PROHIBITED / HIGH / LIMITED). Retorna artículo de ley aplicable.
/ai-act/fria/generateai_act_compliance.pyArticle 27 Generator. Crea draft legal de 'Fundamental Rights Impact Assessment' basado en contexto industrial.
/ai-act/report-incidentai_act_compliance.pyArticle 62 Reporting. Loguea incidentes serios y genera recibo firmado criptográficamente (Digital Witness).
/ai-act/conformity-assessmentai_act_compliance.pyAnnex VII Declaration. Auto-evaluación de conformidad firmada + Datos de consumo energético (Art. 40).
/ai-act/transparency/artifactai_act_compliance.pyArticle 52 Disclaimer. Retorna el texto legal EXACTO requerido para watermarks de AI.
/ai-act/approvalsai_act_compliance.pyHuman Oversight Queue. Lista solicitudes de Alto Riesgo pendientes de aprobación humana (Article 14).
/ai-act/approvals/{id}/approveai_act_compliance.pyAutorizar Riesgo. Desbloquea el request detenido firmando la decisión con la identidad del humano.
/ai-act/approvals/{id}/rejectai_act_compliance.pyRechazar Riesgo. Bloquea permanentemente el request y notifica al usuario.
/ai-act/auditai_act_compliance.pyForensic Ledger. Descarga el historial completo de clasificaciones y decisiones humanas para auditoría externa.
/ai-act/compliance-summaryai_act_compliance.pyExecutive Status. Semáforo de cumplimiento general (Compliant / Warning / Violation).
/v1/compliance/forget-usercompliance.pyGDPR Right to be Forgotten. Anonimiza PII pero preserva integridad contable. Solo DPO.
/v1/quarantine/pendingcompliance.pyRequest Jail. Lista peticiones bloqueadas temporalmente por sospecha de inyección de prompt o fuga de datos.
/v1/quarantine/{quarantine_id}/resolvecompliance.pyJailbreak Judge. Libera o banea definitivamente un request en cuarentena tras revisión humana.
/v1/trust/acknowledge-trainingtrust.pyVálvula de Amnistía. Restaura el Trust Score al umbral mínimo (70) tras el reconocimiento formal de políticas.
/pii/patterns/generatepii_config.pyPattern AI Architect. Genera una expresión regular compleja a partir de una descripción en lenguaje natural.
/pii/patternspii_config.pyCustom Privacy DSL. Registra un nuevo patrón de PII con su estrategia de redacción (Full/Partial/Hint).
Admin & Governance
/v1/admin/rolesadmin_roles.pyLista todos los roles definidos en el tenant con sus políticas y ranking jerárquico.
/v1/admin/roles/provisionadmin_roles.pyAI Role Architect. Crea roles complejos desde lenguaje natural. Incluye 'King Slayer Protection' (integridad jerárquica).
/v1/admin/roles/simulate-accessadmin_roles.pyDigital Twin. Simula 'Qué pasaría si' un rol intenta una acción. No persiste cambios, solo prueba políticas.
/v1/admin/roles/{role_id}admin_roles.pySafe Deletion. Elimina un rol solo si no tiene usuarios activos asignados (previene huérfanos).
/v1/admin/copilot/policyadmin_chat.pySemantic Policy Copilot. Genera borradores JSON de políticas a partir de intención ('Bloquear marketing en GPT-4').
/v1/admin/policiesadmin_chat.pyPolicy Commit. Guarda y activa una política generada por el Copilot tras validación de conflictos.
/v1/admin/approvals/pendingtools.pyHuman Oversight Queue. Lista solicitudes de acceso a herramientas o modelos de alto riesgo pendientes.
/v1/admin/approvals/{id}/decidetools.pyIntervención Humana. Aprueba o rechaza una acción suspendida inyectando notas de revisión.
Analytics & Intelligence
/analytics/strategy/briefinganalytics.pyAI CEO Consultant. Genera un PDF ejecutivo con recomendaciones estratégicas basadas en todos los dashboards.
/analytics/insightsanalytics.pyPrescriptive Engine. Lista sugerencias accionables (e.g. 'Migrar a Batch API ahorra $400').
/analytics/operationalanalytics.pyOps Monitor. P95 Latency, Cache Hit Rates y distribución de modelos.
/analytics/roianalytics.pyCalculadora de Valor. Muestra Productivity Multiplier y Ahorro Neto vs Costo Humano.
/analytics/securityanalytics.pyCompliance Score. Métricas de ataques bloqueados, PII redactado y violaciones AI Act.
/analytics/financialanalytics.pyFinancial Command Center. Burn Rate en tiempo real y predicción de agotamiento de presupuesto.
/analytics/transparency/reportanalytics.pyData Residency Proof. Valida criptográficamente que los datos no salieron de la región (GDPR).
/v1/feedbackfeedback.pyActive Learning Loop. Registra señales de refuerzo (+1/-1) y correcciones para optimizar la Hive Memory.
Forensics & Operations
/v1/audit/replay/{trace_id}forensics.pyBlack Box Replay. Reconstrucción paso a paso de una interacción pasada para auditoría forense.
/v1/dashboard/emergency/stopdashboard.pyKILL SWITCH. Bloquea inmediatamente todo el gasto y tráfico de un tenant ante ataque detectado.
/v1/filesembeddings.pyVault Ingestion. Sube y procesa archivos PDF/TXT. Ejecuta FileGuardian para bloquear contenido sensible.
/v1/webhooks/auth/user-createdwebhooks.pySupabase Auth Sync. Recibe eventos INSERT de la base de datos para automatizar el onboarding.
Identity & Lifecycle
/v1/signuponboarding.pyZero-Touch Signup. Registro atómico de Tenant, Perfil de Usuario, Centro de Coste y Política inicial.
/v1/onboarding/organizationsonboarding.pyTenant Discovery. Lista todas las organizaciones donde el usuario tiene acceso o propiedad.
/v1/onboarding/inviteonboarding.pyViral Expansion. Invita a nuevos miembros vinculados a roles RBAC heredados.
/v1/public/tenant-configpublic_config.pyWhite-Label Engine. Endpoint público que retorna configuración de marca (logo, colores) según dominio.