AgentShield
API v1.0

API Reference

Catálogo completo de los 23 micro-routers de AgentShield.
Authentication: Bearer Token (JWT) or X-API-Key

AI Core & Proxy

POST/v1/chat/completionsproxy.py

Endpoint principal. Proxy universal compatible con OpenAI. Ejecuta DecisionPipeline (6 gates), Hive Mind cache, LLM streaming y Safety Engine.

POST/v1/images/generationsimages.py

Proxy Generativo para DALL-E 3. Intercepta, gobierna y cobra la creatividad mediante el Estimador Multimodal.

POST/v1/embeddingsembeddings.py

Endpoint crítico para RAG. Intercepta la vectorización de documentos para cobrar y auditar la inyección de conocimiento.

Financial & FinOps

POST/v1/receiptreceipt.py

Registra transacción completada y genera firma SHA256. Fundamental para el WAL financiero.

GET/budget/quotas/{user_id}budget_management.py

Obtiene límites de cuota (diario/mensual) y gasto actual del usuario.

POST/v1/evidence/packagereceipt.py

Legal Discovery. Genera ZIP forense con receipt.json, transcript.pdf y firmas. Admisible en juicio.

POST/budget/wallets/{wallet_id}/top-upbudget_management.py

Crypto/Fiat Top-Up. Recarga de saldo en tiempo real con conversión automática de divisa.

GET/budget/anomaliesbudget_management.py

Fraud Detection. Lista anomalías de gasto detectadas por ML (e.g. 'Spike de 500% en 10min').

POST/budget/anomalies/{anomaly_id}/acknowledgebudget_management.py

Fraud Ops. Marca una anomalía como investigada (False Positive / Confirmed) para reentrenar el modelo.

GET/v1/invoices/download/{cost_center_id}invoices.py

Descarga la factura mensual de chargeback interno en PDF. Requiere privilegios de Admin/Manager.

Legal & Compliance

POST/ai-act/classifyai_act_compliance.py

Clasifica request según EU AI Act (PROHIBITED / HIGH / LIMITED). Retorna artículo de ley aplicable.

POST/ai-act/fria/generateai_act_compliance.py

Article 27 Generator. Crea draft legal de 'Fundamental Rights Impact Assessment' basado en contexto industrial.

POST/ai-act/report-incidentai_act_compliance.py

Article 62 Reporting. Loguea incidentes serios y genera recibo firmado criptográficamente (Digital Witness).

GET/ai-act/conformity-assessmentai_act_compliance.py

Annex VII Declaration. Auto-evaluación de conformidad firmada + Datos de consumo energético (Art. 40).

GET/ai-act/transparency/artifactai_act_compliance.py

Article 52 Disclaimer. Retorna el texto legal EXACTO requerido para watermarks de AI.

GET/ai-act/approvalsai_act_compliance.py

Human Oversight Queue. Lista solicitudes de Alto Riesgo pendientes de aprobación humana (Article 14).

POST/ai-act/approvals/{id}/approveai_act_compliance.py

Autorizar Riesgo. Desbloquea el request detenido firmando la decisión con la identidad del humano.

POST/ai-act/approvals/{id}/rejectai_act_compliance.py

Rechazar Riesgo. Bloquea permanentemente el request y notifica al usuario.

GET/ai-act/auditai_act_compliance.py

Forensic Ledger. Descarga el historial completo de clasificaciones y decisiones humanas para auditoría externa.

GET/ai-act/compliance-summaryai_act_compliance.py

Executive Status. Semáforo de cumplimiento general (Compliant / Warning / Violation).

POST/v1/compliance/forget-usercompliance.py

GDPR Right to be Forgotten. Anonimiza PII pero preserva integridad contable. Solo DPO.

GET/v1/quarantine/pendingcompliance.py

Request Jail. Lista peticiones bloqueadas temporalmente por sospecha de inyección de prompt o fuga de datos.

POST/v1/quarantine/{quarantine_id}/resolvecompliance.py

Jailbreak Judge. Libera o banea definitivamente un request en cuarentena tras revisión humana.

POST/v1/trust/acknowledge-trainingtrust.py

Válvula de Amnistía. Restaura el Trust Score al umbral mínimo (70) tras el reconocimiento formal de políticas.

POST/pii/patterns/generatepii_config.py

Pattern AI Architect. Genera una expresión regular compleja a partir de una descripción en lenguaje natural.

POST/pii/patternspii_config.py

Custom Privacy DSL. Registra un nuevo patrón de PII con su estrategia de redacción (Full/Partial/Hint).

Admin & Governance

GET/v1/admin/rolesadmin_roles.py

Lista todos los roles definidos en el tenant con sus políticas y ranking jerárquico.

POST/v1/admin/roles/provisionadmin_roles.py

AI Role Architect. Crea roles complejos desde lenguaje natural. Incluye 'King Slayer Protection' (integridad jerárquica).

POST/v1/admin/roles/simulate-accessadmin_roles.py

Digital Twin. Simula 'Qué pasaría si' un rol intenta una acción. No persiste cambios, solo prueba políticas.

DELETE/v1/admin/roles/{role_id}admin_roles.py

Safe Deletion. Elimina un rol solo si no tiene usuarios activos asignados (previene huérfanos).

POST/v1/admin/copilot/policyadmin_chat.py

Semantic Policy Copilot. Genera borradores JSON de políticas a partir de intención ('Bloquear marketing en GPT-4').

POST/v1/admin/policiesadmin_chat.py

Policy Commit. Guarda y activa una política generada por el Copilot tras validación de conflictos.

GET/v1/admin/approvals/pendingtools.py

Human Oversight Queue. Lista solicitudes de acceso a herramientas o modelos de alto riesgo pendientes.

POST/v1/admin/approvals/{id}/decidetools.py

Intervención Humana. Aprueba o rechaza una acción suspendida inyectando notas de revisión.

Analytics & Intelligence

GET/analytics/strategy/briefinganalytics.py

AI CEO Consultant. Genera un PDF ejecutivo con recomendaciones estratégicas basadas en todos los dashboards.

GET/analytics/insightsanalytics.py

Prescriptive Engine. Lista sugerencias accionables (e.g. 'Migrar a Batch API ahorra $400').

GET/analytics/operationalanalytics.py

Ops Monitor. P95 Latency, Cache Hit Rates y distribución de modelos.

GET/analytics/roianalytics.py

Calculadora de Valor. Muestra Productivity Multiplier y Ahorro Neto vs Costo Humano.

GET/analytics/securityanalytics.py

Compliance Score. Métricas de ataques bloqueados, PII redactado y violaciones AI Act.

GET/analytics/financialanalytics.py

Financial Command Center. Burn Rate en tiempo real y predicción de agotamiento de presupuesto.

GET/analytics/transparency/reportanalytics.py

Data Residency Proof. Valida criptográficamente que los datos no salieron de la región (GDPR).

POST/v1/feedbackfeedback.py

Active Learning Loop. Registra señales de refuerzo (+1/-1) y correcciones para optimizar la Hive Memory.

Forensics & Operations

GET/v1/audit/replay/{trace_id}forensics.py

Black Box Replay. Reconstrucción paso a paso de una interacción pasada para auditoría forense.

POST/v1/dashboard/emergency/stopdashboard.py

KILL SWITCH. Bloquea inmediatamente todo el gasto y tráfico de un tenant ante ataque detectado.

POST/v1/filesembeddings.py

Vault Ingestion. Sube y procesa archivos PDF/TXT. Ejecuta FileGuardian para bloquear contenido sensible.

POST/v1/webhooks/auth/user-createdwebhooks.py

Supabase Auth Sync. Recibe eventos INSERT de la base de datos para automatizar el onboarding.

Identity & Lifecycle

POST/v1/signuponboarding.py

Zero-Touch Signup. Registro atómico de Tenant, Perfil de Usuario, Centro de Coste y Política inicial.

GET/v1/onboarding/organizationsonboarding.py

Tenant Discovery. Lista todas las organizaciones donde el usuario tiene acceso o propiedad.

POST/v1/onboarding/inviteonboarding.py

Viral Expansion. Invita a nuevos miembros vinculados a roles RBAC heredados.

GET/v1/public/tenant-configpublic_config.py

White-Label Engine. Endpoint público que retorna configuración de marca (logo, colores) según dominio.