API Documentation

API reference for the MeghiQ research prototype, including the newest evidence, privacy, GDPR, AI agent, and resource-mutation governance surfaces.

Evidence systems under study

New evidence, privacy, and agent-control features now implemented.

The latest backend work strengthens enterprise-grade governance: tamper-evident audit records, cryptographic key rotation, encrypted sensitive fields, GDPR rights workflows, resource mutation evidence, and an AI Agent Registry.

codeimplemented surfacereview basisenterprise relevancestudy lens
A01
Tamper-Evident Audit Chainaudit_events
Hash chain + HMAC signatures

Gives enterprise reviewers a verifiable sequence of actions instead of a loose activity log that can be rewritten after the fact.

integrity
A02
HMAC Key Rotationsigning_keys
Versioned signing keys

Lets the audit chain keep cryptographic continuity while keys evolve, which matters for long-lived regulated environments.

continuity
P01
Encrypted PII With Lookup Hashessensitive_fields
Fernet fields + companion hashes

Protects sensitive identity fields while preserving operational search and ownership lookup without exposing plaintext.

privacy
G01
GDPR Data-Subject Rightsprivacy_requests
Export + erasure router

Supports export and erasure workflows so privacy review is part of the platform architecture, not a manual afterthought.

rights workflow
R01
Resource Mutation Evidenceresource_mutations
Shared audit hooks across routers

Turns creates, updates, deletes, executions, toggles, acknowledgements, and remediations into reviewable tenant-scoped evidence.

change lineage
AG1
AI Agent Registryagent_registry
Agent registry API + UI

Creates a controlled inventory for autonomous agents so organizations can study ownership, access, lifecycle, and operational state.

ownership

Interactive API Explorer

Explore and test our API endpoints directly in your browser with our interactive documentation.

View OpenAPI Specification

Authentication

Secure your API requests with JWT tokens. All endpoints require authentication.

Authorization: Bearer <your_jwt_token>

API Endpoints Overview

Authentication

User authentication, token management, and session handling.

POST/auth/login
GET/auth/me

Automation Discovery

Discover and catalog automations across your enterprise platforms.

GET/automations
POST/discovery/scan

Compliance

Monitor compliance across GDPR, HIPAA, SOX and custom rules.

GET/compliance/checks
GET/compliance/violations

AI Insights

AI-powered automation analysis, DNA profiling, and predictions.

GET/ai/dna-profile
GET/ai/health-score

Analytics

Comprehensive analytics, metrics, and reporting for automations.

GET/analytics/overview
GET/analytics/metrics

Alerts & Notifications

Real-time alerts, notifications, and monitoring configuration.

GET/alerts
POST/notifications/send

Newly Implemented API Surfaces

/api/v1/gdpr/export

GDPR subject export

/api/v1/gdpr/erase

GDPR erasure workflow

/api/v1/ai-agents

AI Agent Registry

/api/v1/audit/verify

Tamper-evident audit verification

/api/v1/automations/{id}/disable

Automation state mutation evidence

/api/v1/workflows/workflows/{id}/execute

Workflow execution evidence

/api/v1/scheduled-reports/{id}/run

Scheduled-report execution evidence

/api/v1/compliance/violations/{id}/remediate

Compliance remediation evidence

Getting Started

Base URL

https://api.meghiq.com/v2

Quick Example

curl -H "Authorization: Bearer YOUR_TOKEN" \
     -H "Content-Type: application/json" \
     https://api.meghiq.com/v2/automations

Response Format

{
  "success": true,
  "data": {...},
  "pagination": {...},
  "meta": {...}
}

Need Help?