Reports & Deployer Manual¶

Geodesia G-1 can generate legally-formatted compliance reports as PDF or DOCX files, suitable for submission to regulatory authorities, internal auditors, or enterprise compliance teams. It also generates a Deployer Transparency Manual — an EU AI Act Article 13-compliant instructions-for-use document.

Compliance Report¶

POST /v1/glad/report¶

Generate a comprehensive compliance audit report covering a specified time window.

curl -X POST http://localhost:8199/v1/glad/report \
  -H "Content-Type: application/json" \
  -d '{
    "deployer_id": "acme-corp",
    "regulatory_framework": ["EU_AI_ACT", "GDPR"],
    "period_start": "2026-01-01T00:00:00Z",
    "period_end": "2026-06-30T23:59:59Z",
    "fmt": "pdf",
    "client_info": {
      "company_name": "ACME Corporation",
      "system_name": "Customer Support AI",
      "responsible_person": "Maria Rossi, Chief AI Officer",
      "contact_email": "ai-compliance@acme.com"
    }
  }' \
  --output compliance_report_h1_2026.pdf

Request Fields¶

client_info Fields¶

Report Structure¶

A generated compliance report includes the following sections:

Deployer Transparency Manual¶

POST /v1/glad/deployer-manual¶

Generate a Deployer Transparency Manual — a plain-language document explaining how the AI system works, what it can and cannot do, and how to monitor it. This satisfies EU AI Act Article 13 (transparency obligations) and Article 26(1) (instructions for use).

curl -X POST http://localhost:8199/v1/glad/deployer-manual \
  -H "Content-Type: application/json" \
  -d '{
    "deployer_id": "acme-corp",
    "fmt": "pdf",
    "client_info": {
      "company_name": "ACME Corporation",
      "system_name": "Customer Support AI"
    }
  }' \
  --output deployer_manual.pdf

Request Fields¶

Same as the compliance report, minus the period_start/period_end fields. The manual describes the current system state rather than a historical period.

Manual Contents¶

Provider Identity¶

GET /v1/glad/provider-identity¶

Returns machine-readable provider identity information — the system's "identity card" for regulatory systems.

curl http://localhost:8199/v1/glad/provider-identity

{
  "provider": "Geodesia AI",
  "system_name": "Geodesia G-1",
  "system_version": "1.0.0",
  "model_family": "Geodesia G-1 Companion",
  "eu_ai_act_risk_class": "high",
  "eu_conformity_basis": ["Art. 9", "Art. 10", "Art. 11", "Art. 12", "Art. 13", "Art. 14"],
  "supported_frameworks": ["EU_AI_ACT", "GDPR", "ISO_42001", ...],
  "contact": "compliance@geodesia.ai"
}

Threshold Preferences¶

GET /v1/glad/threshold-prefs¶

Retrieve the currently stored detection threshold preferences.

curl "http://localhost:8199/v1/glad/threshold-prefs?deployer_id=acme-corp"

POST /v1/glad/threshold-prefs¶

Update threshold preferences. Changes are logged to the audit chain.

curl -X POST http://localhost:8199/v1/glad/threshold-prefs \
  -H "Content-Type: application/json" \
  -d '{
    "deployer_id": "acme-corp",
    "prompt_safety": 0.35,
    "answer_safety": 0.50,
    "halluc": 0.617,
    "combined_halluc": 0.617,
    "changed_by": "maria.rossi@acme.com",
    "reason": "Reducing false positives on corporate knowledge base queries"
  }'

Data Retention¶

GET /v1/glad/retention¶

Returns the current data retention policy and statistics.

curl http://localhost:8199/v1/glad/retention

{
  "policy": {
    "call_log_days": 365,
    "oversight_days": 730,
    "fria_days": 3650,
    "chain_days": 3650
  },
  "statistics": {
    "oldest_call": "2026-01-01T00:00:00Z",
    "total_calls": 48291,
    "calls_eligible_for_deletion": 0,
    "storage_used_mb": 142.8
  }
}

Configure retention periods in config.yaml.

License Tokens¶

POST /v1/glad/license-tokens/source-bundle¶

Used internally by the deployment toolchain to obtain a signed download URL for the encrypted source bundle. Requires a valid GLAD_LICENSE_TOKEN in the request headers.

This endpoint is intended for automated deployment scripts, not end-user applications.