Skip to main content

Aragora API Documentation

This document describes the HTTP API endpoints provided by the Aragora server.

Table of Contents​

A2A​

A2A Protocol HTTP Handler.

GET /api/a2a/agents​

List all available agents

GET /api/a2a/agents/:name​

Get agent card by name

POST /api/a2a/tasks​

Submit a task

GET /api/a2a/tasks/:id​

Get task status

DELETE /api/a2a/tasks/:id​

Cancel task

POST /api/a2a/tasks/:id/stream​

Stream task (WebSocket upgrade)

GET /api/a2a/.well-known/agent.json​

Discovery endpoint

Accounting​

Accounting handlers for QuickBooks Online and Gusto payroll integration.

GET /api/accounting/status​

QuickBooks status + dashboard data

GET /api/accounting/connect​

Start QuickBooks OAuth

GET /api/accounting/callback​

QuickBooks OAuth callback

POST /api/accounting/disconnect​

Disconnect QuickBooks

GET /api/accounting/customers​

List QuickBooks customers

GET /api/accounting/transactions​

List QuickBooks transactions

POST /api/accounting/report​

Generate accounting report

GET /api/accounting/gusto/status​

Gusto connection status

GET /api/accounting/gusto/connect​

Start Gusto OAuth

GET /api/accounting/gusto/callback​

Gusto OAuth callback

POST /api/accounting/gusto/disconnect​

Disconnect Gusto

GET /api/accounting/gusto/employees​

List employees

GET /api/accounting/gusto/payrolls​

List payroll runs

GET /api/accounting/gusto/payrolls/\{payroll_id\}​

Payroll run details

POST /api/accounting/gusto/payrolls/\{payroll_id\}/journal-entry​

Generate journal entry

AnalyticsMetrics​

Handler for analytics metrics dashboard endpoints.

GET /api/analytics/debates/overview 🔒​

Get debate overview statistics

GET /api/analytics/debates/trends 🔒​

Get agent performance trends over time

GET /api/analytics/debates/topics 🔒​

Get topic distribution for debates

GET /api/analytics/debates/outcomes 🔒​

Get debate outcome distribution (win/loss/draw)

GET /api/analytics/agents/leaderboard 🔒​

Get agent leaderboard with ELO rankings and win rates

GET /api/analytics/agents/comparison 🔒​

Compare multiple agents

GET /api/analytics/agents/trends 🔒​

Get agent performance trends over time

GET /api/analytics/usage/tokens 🔒​

Get token consumption trends

GET /api/analytics/usage/costs 🔒​

Get cost breakdown by provider and model

GET /api/analytics/usage/active_users 🔒​

Get active user counts

AnalyticsPerformance​

Handler for analytics performance endpoints.

GET /api/analytics/agents/performance 🔒​

Get aggregate agent performance metrics

GET /api/analytics/debates/summary 🔒​

Get debate summary statistics

GET /api/analytics/trends​

Calculate trend analysis from data points

Parameters:

NameTypeDescription
data_pointsstringList of period data points

Ap Automation​

HTTP API Handlers for Accounts Payable Automation.

POST /api/v1/accounting/ap/invoices​

Add payable invoice

GET /api/v1/accounting/ap/invoices​

List payable invoices

GET /api/v1/accounting/ap/invoices/\{id\}​

Get invoice by ID

POST /api/v1/accounting/ap/invoices/\{id\}/payment​

Record payment

POST /api/v1/accounting/ap/optimize​

Optimize payment timing

POST /api/v1/accounting/ap/batch​

Create batch payment

GET /api/v1/accounting/ap/forecast​

Get cash flow forecast

GET /api/v1/accounting/ap/discounts​

Get discount opportunities

Ar Automation​

HTTP API Handlers for Accounts Receivable Automation.

POST /api/v1/accounting/ar/invoices​

Create invoice

GET /api/v1/accounting/ar/invoices​

List invoices

GET /api/v1/accounting/ar/invoices/\{id\}​

Get invoice by ID

POST /api/v1/accounting/ar/invoices/\{id\}/send​

Send invoice to customer

POST /api/v1/accounting/ar/invoices/\{id\}/reminder​

Send payment reminder

POST /api/v1/accounting/ar/invoices/\{id\}/payment​

Record payment

GET /api/v1/accounting/ar/aging​

Get AR aging report

GET /api/v1/accounting/ar/collections​

Get collection suggestions

POST /api/v1/accounting/ar/customers​

Add customer

GET /api/v1/accounting/ar/customers/\{id\}/balance​

Get customer balance

Audit Export​

Audit Export API Handler.

GET /api/audit/events​

Query audit events

GET /api/audit/stats​

Audit log statistics

POST /api/audit/export​

Export audit log (JSON, CSV, SOC2)

POST /api/audit/verify​

Verify audit log integrity

Audit Trail​

Audit Trail HTTP Handlers for Aragora.

GET /api/v1/audit-trails​

List recent audit trails

GET /api/v1/audit-trails/:trail_id​

Get specific audit trail

GET /api/v1/audit-trails/:trail_id/export​

Export (format=json|csv|md)

POST /api/v1/audit-trails/:trail_id/verify​

Verify integrity checksum

GET /api/v1/receipts​

List recent decision receipts

GET /api/v1/receipts/:receipt_id​

Get specific receipt

POST /api/v1/receipts/:receipt_id/verify​

Verify receipt integrity

Auditing​

Auditing and security analysis endpoint handlers.

POST /api/debates/capability-probe​

Run capability probes on an agent

POST /api/debates/deep-audit​

Run deep audit on a task

POST /api/debates/:id/red-team​

Run red team analysis on a debate

Autonomous Learning​

Autonomous Learning Handler for Aragora.

GET /api/v2/learning/sessions​

List training sessions

POST /api/v2/learning/sessions​

Start new training session

GET /api/v2/learning/sessions/:session_id​

Get session details

POST /api/v2/learning/sessions/:session_id/stop​

Stop training session

GET /api/v2/learning/metrics​

Get learning metrics

GET /api/v2/learning/metrics/:metric_type​

Get specific metric

POST /api/v2/learning/feedback​

Submit learning feedback

GET /api/v2/learning/patterns​

List detected patterns

POST /api/v2/learning/patterns/:pattern_id/validate​

Validate a pattern

GET /api/v2/learning/knowledge​

Get extracted knowledge

POST /api/v2/learning/knowledge/extract​

Trigger knowledge extraction

GET /api/v2/learning/recommendations​

Get learning recommendations

GET /api/v2/learning/performance​

Get model performance stats

POST /api/v2/learning/calibrate​

Trigger calibration

Backup Handler​

Backup HTTP Handlers for Aragora.

GET /api/v2/backups​

List backups with filters

POST /api/v2/backups​

Create new backup

GET /api/v2/backups/:backup_id​

Get specific backup metadata

POST /api/v2/backups/:backup_id/verify​

Verify backup integrity

POST /api/v2/backups/:backup_id/verify-comprehensive​

Comprehensive verification

POST /api/v2/backups/:backup_id/restore-test​

Dry-run restore test

DELETE /api/v2/backups/:backup_id​

Delete a backup

POST /api/v2/backups/cleanup​

Run retention policy cleanup

GET /api/v2/backups/stats​

Backup statistics

Belief​

Belief Network and Reasoning endpoint handlers.

GET /api/belief-network/:debate_id/cruxes​

Get key claims that impact debate outcome

GET /api/belief-network/:debate_id/load-bearing-claims​

Get high-centrality claims

GET /api/provenance/:debate_id/claims/:claim_id/support​

Get claim verification status

GET /api/laboratory/emergent-traits​

Get emergent traits from agent performance

GET /api/debate/:debate_id/graph-stats​

Get argument graph statistics

Bindings​

Bindings endpoint handlers.

GET /api/bindings​

List all message bindings

GET /api/bindings/:provider​

List bindings for a provider

POST /api/bindings​

Create a new binding

PUT /api/bindings/:id​

Update a binding

DELETE /api/bindings/:id​

Remove a binding

POST /api/bindings/resolve​

Resolve binding for a message

GET /api/bindings/stats​

Get router statistics

Breakpoints​

Breakpoints endpoint handlers for human-in-the-loop intervention.

GET /api/breakpoints/pending​

List pending breakpoints awaiting resolution

POST /api/breakpoints/\{id\}/resolve​

Resolve a pending breakpoint

GET /api/breakpoints/\{id\}/status​

Get status of a specific breakpoint

Budgets​

Budget Management API Handler.

GET /api/v1/budgets​

List budgets for org

POST /api/v1/budgets​

Create a budget

GET /api/v1/budgets/:id​

Get budget details

PATCH /api/v1/budgets/:id​

Update a budget

DELETE /api/v1/budgets/:id​

Delete (close) a budget

GET /api/v1/budgets/:id/alerts​

Get alerts for a budget

POST /api/v1/budgets/:id/alerts/:alert_id/acknowledge​

Acknowledge alert

POST /api/v1/budgets/:id/override​

Add override for user

DELETE /api/v1/budgets/:id/override/:user_id​

Remove override

POST /api/v1/budgets/:id/reset​

Reset budget period

GET /api/v1/budgets/:id/transactions​

Get transaction history

GET /api/v1/budgets/:id/trends​

Get spending trends for budget

GET /api/v1/budgets/summary​

Get org budget summary

GET /api/v1/budgets/trends​

Get org-wide spending trends

POST /api/v1/budgets/check​

Pre-flight cost check

Checkpoints​

Checkpoint management endpoint handlers.

GET /api/checkpoints​

List all checkpoints

GET /api/checkpoints/\{id\}​

Get checkpoint details

POST /api/checkpoints/\{id\}/resume​

Resume debate from checkpoint

DELETE /api/checkpoints/\{id\}​

Delete checkpoint

GET /api/debates/\{id\}/checkpoints​

List checkpoints for a debate

POST /api/debates/\{id\}/checkpoint​

Create checkpoint for running debate

POST /api/debates/\{id\}/pause​

Pause debate and create checkpoint

Cloud Storage​

Cloud Storage Handler for Aragora.

GET /api/v2/storage/files​

List files with filtering

POST /api/v2/storage/files​

Upload a file

GET /api/v2/storage/files/:file_id​

Get file metadata

GET /api/v2/storage/files/:file_id/download​

Download file

DELETE /api/v2/storage/files/:file_id​

Delete a file

POST /api/v2/storage/files/:file_id/presign​

Generate presigned URL

GET /api/v2/storage/quota​

Get storage quota usage

GET /api/v2/storage/buckets​

List available buckets

POST /api/v2/storage/buckets​

Create a bucket

DELETE /api/v2/storage/buckets/:bucket_id​

Delete a bucket

Code Review​

HTTP API Handlers for Code Review.

POST /api/v1/code-review/review​

Review code snippet

POST /api/v1/code-review/diff​

Review diff/patch

POST /api/v1/code-review/pr​

Review GitHub PR

GET /api/v1/code-review/results/\{id\}​

Get review results

GET /api/v1/code-review/history​

Get review history

Compliance​

HTTP handler for compliance and audit operations.

GET /api/v2/compliance​

GET /api/v2/compliance

GET /api/v2/compliance/*​

GET /api/v2/compliance/*

Composite​

Composite API handlers that aggregate data from multiple subsystems.

GET /api/v1/debates/\{id\}/full-context​

Memory + Knowledge + Belief context

GET /api/v1/agents/\{id\}/reliability​

Circuit breaker + Airlock metrics

GET /api/v1/debates/\{id\}/compression-analysis​

RLM compression metrics

ComputerUse​

HTTP request handler for computer use API endpoints.

GET /api/v1/computer-use/tasks 🔒​

Handle POST /api/v1/computer-use/tasks/{id}/cancel

GET /api/v1/computer-use/tasks/*​

GET /api/v1/computer-use/tasks/*

GET /api/v1/computer-use/actions 🔒​

Handle GET /api/v1/computer-use/actions/stats

GET /api/v1/computer-use/actions/*​

GET /api/v1/computer-use/actions/*

GET /api/v1/computer-use/policies 🔒​

Handle POST /api/v1/computer-use/policies

GET /api/v1/computer-use/policies/*​

GET /api/v1/computer-use/policies/*

GET /api/v1/computer-use/approvals 🔒​

Handle POST /api/v1/computer-use/approvals/{id}/approve

GET /api/v1/computer-use/approvals/*​

GET /api/v1/computer-use/approvals/*

Memory​

Memory management, retrieval, and analytics endpoints.

GET /api/v1/memory/continuum/retrieve​

Retrieve memories from ContinuumMemory

POST /api/v1/memory/continuum/consolidate​

Trigger memory consolidation

POST /api/v1/memory/continuum/cleanup​

Cleanup expired memories

DELETE /api/v1/memory/continuum/\{id\}​

Delete a memory entry by ID

GET /api/v1/memory/tier-stats​

Get tier statistics

GET /api/v1/memory/archive-stats​

Get archive statistics

GET /api/v1/memory/pressure​

Get memory pressure and utilization

GET /api/v1/memory/tiers​

List all memory tiers

GET /api/v1/memory/search​

Search memories across tiers

GET /api/v1/memory/search-index​

Progressive search index (stage 1)

GET /api/v1/memory/search-timeline​

Progressive timeline context (stage 2)

GET /api/v1/memory/entries​

Progressive full entry retrieval (stage 3)

GET /api/v1/memory/viewer​

Memory Viewer UI

GET /api/v1/memory/critiques​

Browse critique store entries

GET /api/v1/memory/analytics​

Memory analytics overview

GET /api/v1/memory/analytics/tier/\{tier\}​

Memory analytics per tier

POST /api/v1/memory/analytics/snapshot​

Capture memory analytics snapshot

Consensus​

Consensus Memory endpoint handlers.

GET /api/consensus/similar​

Find debates similar to a topic

GET /api/consensus/settled​

Get high-confidence settled topics

GET /api/consensus/stats​

Get consensus memory statistics

GET /api/consensus/dissents​

Get recent dissenting views

GET /api/consensus/contrarian-views​

Get contrarian perspectives

GET /api/consensus/risk-warnings​

Get risk warnings and edge cases

GET /api/consensus/domain/:domain​

Get domain-specific history

Critique​

Critique pattern and reputation endpoint handlers.

GET /api/critiques/patterns​

Get high-impact critique patterns

GET /api/critiques/archive​

Get archive statistics

GET /api/reputation/all​

Get all agent reputations

GET /api/agent/:name/reputation​

Get specific agent reputation

Cross Pollination​

Cross-Pollination observability endpoint handlers.

GET /api/cross-pollination/stats​

Get cross-subscriber statistics

GET /api/cross-pollination/subscribers​

List all subscribers

GET /api/cross-pollination/bridge​

Arena event bridge status

POST /api/cross-pollination/reset​

Reset subscriber statistics

Dashboard​

HTTP API Handlers for Dashboard.

GET /api/v1/dashboard​

Get dashboard overview

GET /api/v1/dashboard/stats​

Get detailed stats

GET /api/v1/dashboard/activity​

Get recent activity

GET /api/v1/dashboard/inbox-summary​

Get inbox summary

GET /api/v1/dashboard/quick-actions​

Get available quick actions

POST /api/v1/dashboard/quick-actions/\{action\}​

Execute quick action

Decision​

Handler for unified decision-making API endpoints.

GET /api/v1/decisions​

List recent decisions

GET /api/v1/decisions/*​

GET /api/v1/decisions/*

Deliberations​

Handler for vetted decisionmaking dashboard endpoints.

GET /api/v1/deliberations/active​

Fetch active vetted decisionmaking sessions from the debate store

GET /api/v1/deliberations/stats​

Get deliberation statistics

GET /api/v1/deliberations/stream​

Handle WebSocket stream for real-time updates

GET /api/v1/deliberations/\{deliberation_id\}​

GET /api/v1/deliberations/{deliberation_id}

Dependency Analysis​

HTTP API Handlers for Dependency Analysis.

POST /api/v1/codebase/analyze-dependencies​

Analyze project dependencies

GET /api/v1/codebase/sbom​

Generate SBOM

POST /api/v1/codebase/scan-vulnerabilities​

Scan for CVEs

POST /api/v1/codebase/check-licenses​

Check license compatibility

Devices​

Device Registration and Notification API Handlers.

POST /api/devices/register​

Register a device for push notifications

DELETE /api/devices/\{device_id\}​

Unregister a device

POST /api/devices/\{device_id\}/notify​

Send notification to a device

POST /api/devices/user/\{user_id\}/notify​

Send to all user devices

GET /api/devices/user/\{user_id\}​

List user's devices

GET /api/devices/health​

Get device connector health

POST /api/devices/alexa/webhook​

Alexa skill webhook

POST /api/devices/google/webhook​

Google Actions webhook

Docs​

API documentation endpoint handlers.

GET /api/openapi​

OpenAPI 3.0 JSON specification

GET /api/openapi.json​

OpenAPI 3.0 JSON specification

GET /api/openapi.yaml​

OpenAPI 3.0 YAML specification

GET /api/postman.json​

Postman collection export

GET /api/docs​

Swagger UI interactive documentation

GET /api/redoc​

ReDoc API documentation viewer

Dr Handler​

Disaster Recovery HTTP Handlers for Aragora.

GET /api/v2/dr/status​

Get DR readiness status

POST /api/v2/dr/drill​

Run DR drill (simulated recovery)

GET /api/v2/dr/objectives​

Get RPO/RTO objectives and current status

POST /api/v2/dr/validate​

Validate DR configuration

EmailDebate​

Handler for email vetted decisionmaking API endpoints.

GET /api/v1/email/prioritize​

Prioritize multiple emails

GET /api/v1/email/prioritize/batch​

Prioritize multiple emails

GET /api/v1/email/triage​

Full inbox triage with categorization and sorting

Email Services​

HTTP API Handlers for Email Services.

POST /api/v1/email/followups/mark​

Mark email as awaiting reply

GET /api/v1/email/followups/pending​

List pending follow-ups

POST /api/v1/email/followups/\{id\}/resolve​

Resolve a follow-up

POST /api/v1/email/followups/check-replies​

Check for replies

GET /api/v1/email/\{id\}/snooze-suggestions​

Get snooze recommendations

POST /api/v1/email/\{id\}/snooze​

Apply snooze to email

DELETE /api/v1/email/\{id\}/snooze​

Cancel snooze

GET /api/v1/email/snoozed​

List snoozed emails

GET /api/v1/email/categories​

List available categories

POST /api/v1/email/categories/learn​

Submit category feedback

EndpointAnalytics​

Handler for API endpoint performance analytics.

GET /api/analytics/endpoints​

GET /api/analytics/endpoints - List all endpoints with metrics

GET /api/analytics/endpoints/slowest​

GET /api/analytics/endpoints/slowest - Top N slowest endpoints

GET /api/analytics/endpoints/errors​

GET /api/analytics/endpoints/errors - Top N endpoints by error rate

GET /api/analytics/endpoints/health​

GET /api/analytics/endpoints/health - Overall API health summary

ERC8004​

Handler for ERC-8004 blockchain API endpoints.

GET /api/v1/blockchain/config​

GET /api/v1/blockchain/config

GET /api/v1/blockchain/health​

GET /api/v1/blockchain/health

GET /api/v1/blockchain/sync​

GET /api/v1/blockchain/sync

GET /api/v1/blockchain/agents​

GET /api/v1/blockchain/agents

GET /api/v1/blockchain/agents/*​

GET /api/v1/blockchain/agents/*

Evaluation​

Handler for LLM-as-Judge evaluation endpoints.

GET /api/v1/evaluate 🔒​

Evaluate a response using LLM-as-Judge

GET /api/v1/evaluate/compare 🔒​

Compare two responses using pairwise evaluation

GET /api/v1/evaluate/dimensions 🔒​

List available evaluation dimensions

GET /api/v1/evaluate/profiles 🔒​

List available evaluation weight profiles

Expenses​

HTTP API Handlers for Expense Tracking.

POST /api/v1/accounting/expenses/upload​

Upload and process receipt

POST /api/v1/accounting/expenses​

Create expense manually

GET /api/v1/accounting/expenses​

List expenses with filters

GET /api/v1/accounting/expenses/\{id\}​

Get expense by ID

PUT /api/v1/accounting/expenses/\{id\}​

Update expense

DELETE /api/v1/accounting/expenses/\{id\}​

Delete expense

POST /api/v1/accounting/expenses/\{id\}/approve​

Approve expense

POST /api/v1/accounting/expenses/\{id\}/reject​

Reject expense

POST /api/v1/accounting/expenses/categorize​

Auto-categorize expenses

POST /api/v1/accounting/expenses/sync​

Sync expenses to QBO

GET /api/v1/accounting/expenses/stats​

Get expense statistics

GET /api/v1/accounting/expenses/pending​

Get pending approvals

GET /api/v1/accounting/expenses/export​

Export expenses

Explainability​

Handler for debate explainability endpoints.

GET /api/v1/debates/*/explanation​

Build explanation dictionary based on options

GET /api/v1/debates/*/evidence​

Handle evidence chain request

GET /api/v1/debates/*/votes/pivots​

Handle vote pivot analysis request

GET /api/v1/debates/*/counterfactuals​

Handle counterfactual analysis request

GET /api/v1/debates/*/summary​

Handle human-readable summary request

GET /api/v1/explain/*​

GET /api/v1/explain/*

GET /api/v1/explainability/batch 🔒​

Create a new batch explainability job

GET /api/v1/explainability/batch/*/status​

Get status of a batch job

GET /api/v1/explainability/batch/*/results​

Get results of a completed batch job

GET /api/v1/explainability/compare 🔒​

Compare explanations between multiple debates

GET /api/v1/debates/*/explanation​

Build explanation dictionary based on options

GET /api/v1/explain/*​

GET /api/v1/explain/*

External Agents​

External Agent Gateway endpoint handlers.

POST /api/external-agents/tasks​

Submit task to external agent

GET /api/external-agents/tasks/\{id\}​

Get task status/result

DELETE /api/external-agents/tasks/\{id\}​

Cancel task

GET /api/external-agents/adapters​

List registered adapters

GET /api/external-agents/health​

Health check all adapters

External Integrations​

External Integrations API Handler.

POST /api/integrations/zapier/apps​

Create Zapier app

GET /api/integrations/zapier/apps​

List Zapier apps

DELETE /api/integrations/zapier/apps/:id​

Delete Zapier app

POST /api/integrations/zapier/triggers​

Subscribe to trigger

DELETE /api/integrations/zapier/triggers/:id​

Unsubscribe trigger

GET /api/integrations/zapier/triggers​

List trigger types

POST /api/integrations/make/connections​

Create Make connection

GET /api/integrations/make/connections​

List Make connections

DELETE /api/integrations/make/connections/:id​

Delete Make connection

POST /api/integrations/make/webhooks​

Register webhook

DELETE /api/integrations/make/webhooks/:id​

Unregister webhook

GET /api/integrations/make/modules​

List available modules

POST /api/integrations/n8n/credentials​

Create n8n credential

GET /api/integrations/n8n/credentials​

List n8n credentials

DELETE /api/integrations/n8n/credentials/:id​

Delete n8n credential

POST /api/integrations/n8n/webhooks​

Register webhook

DELETE /api/integrations/n8n/webhooks/:id​

Unregister webhook

GET /api/integrations/n8n/nodes​

Get node definitions

Feedback​

User Feedback Collection Handler.

POST /api/v1/feedback/nps​

Submit NPS score (requires feedback.write)

POST /api/v1/feedback/general​

Submit general feedback (requires feedback.write)

GET /api/v1/feedback/nps/summary​

Get NPS summary (requires feedback.update - admin)

GET /api/v1/feedback/prompts​

Get active feedback prompts (requires feedback.read)

Public Gallery endpoint handlers.

GET /api/gallery​

List public debates

GET /api/gallery/:debate_id​

Get specific debate with full history

GET /api/gallery/:debate_id/embed​

Get embeddable debate summary

Gastown Dashboard​

Gas Town Dashboard API Handlers.

GET /api/v1/dashboard/gastown/overview​

Get Gas Town overview

GET /api/v1/dashboard/gastown/convoys​

Get convoy list with progress

GET /api/v1/dashboard/gastown/agents​

Get agent workload distribution

GET /api/v1/dashboard/gastown/beads​

Get bead queue stats

GET /api/v1/dashboard/gastown/metrics​

Get throughput metrics

GatewayAgents​

HTTP request handler for external agent registration endpoints.

GET /api/v1/gateway/agents​

Extract agent name from path like /api/v1/gateway/agents/{name}

GET /api/v1/gateway/agents/*​

GET /api/v1/gateway/agents/*

GatewayConfig​

HTTP handler for gateway configuration endpoints.

GET /api/v1/gateway/config 🔒​

Handle GET /api/v1/gateway/config

GET /api/v1/gateway/config/defaults 🔒​

Handle GET /api/v1/gateway/config/defaults

GatewayCredentials​

HTTP request handler for gateway credential management endpoints.

GET /api/v1/gateway/credentials​

Extract credential ID from path like /api/v1/gateway/credentials/{id}

GET /api/v1/gateway/credentials/*​

GET /api/v1/gateway/credentials/*

Gateway​

HTTP request handler for gateway API endpoints.

GET /api/v1/gateway/devices 🔒​

Handle GET /api/v1/gateway/devices/{id}

GET /api/v1/gateway/devices/*​

GET /api/v1/gateway/devices/*

GET /api/v1/gateway/channels 🔒​

Handle GET /api/v1/gateway/channels

GET /api/v1/gateway/routing 🔒​

Handle GET /api/v1/gateway/routing/rules

GET /api/v1/gateway/routing/*​

GET /api/v1/gateway/routing/*

GET /api/v1/gateway/messages 🔒​

Handle POST /api/v1/gateway/messages/route

GET /api/v1/gateway/messages/*​

GET /api/v1/gateway/messages/*

GatewayHealth​

HTTP handler for gateway health endpoints.

GET /api/v1/gateway/health 🔒​

Handle GET /api/v1/gateway/agents/{name}/health

GET /api/v1/gateway/agents/*/health 🔒​

Handle GET /api/v1/gateway/agents/{name}/health

Genesis​

Genesis (evolution visibility) endpoint handlers.

GET /api/genesis/stats​

Get overall genesis statistics

GET /api/genesis/events​

Get recent genesis events

GET /api/genesis/lineage/:genome_id​

Get genome ancestry

GET /api/genesis/tree/:debate_id​

Get debate tree structure

GET /api/genesis/genomes​

List all genomes

GET /api/genesis/genomes/top​

Get top genomes by fitness

GET /api/genesis/genomes/:genome_id​

Get single genome details

HybridDebate​

HTTP request handler for hybrid debate API endpoints.

GET /api/v1/debates/hybrid 🔒​

Handle POST /api/v1/debates/hybrid

GET /api/v1/debates/hybrid/*​

GET /api/v1/debates/hybrid/*

Inbox Command​

Inbox Command Center API Handler.

GET /api/inbox/command​

Fetch prioritized inbox

POST /api/inbox/actions​

Execute quick action

POST /api/inbox/bulk-actions​

Execute bulk action

GET /api/inbox/sender-profile​

Get sender profile

GET /api/inbox/daily-digest​

Get daily digest

POST /api/inbox/reprioritize​

Trigger AI re-prioritization

Integration Management​

Integration Management HTTP Handlers for Aragora.

GET /api/v2/integrations​

List all integrations

GET /api/v2/integrations/:type​

Get specific integration status

DELETE /api/v2/integrations/:type​

Disconnect integration

POST /api/v2/integrations/:type/test​

Test integration connectivity

GET /api/v2/integrations/stats​

Integration statistics

Introspection​

Introspection endpoint handlers.

GET /api/introspection/all​

Get introspection for all agents

GET /api/introspection/leaderboard​

Get agents ranked by reputation

GET /api/introspection/agents​

List available agents

GET /api/introspection/agents/\{name\}​

Get introspection for specific agent

Invoices​

HTTP API Handlers for Invoice Processing.

POST /api/v1/accounting/invoices/upload​

Upload and extract invoice

POST /api/v1/accounting/invoices​

Create invoice manually

GET /api/v1/accounting/invoices​

List invoices with filters

GET /api/v1/accounting/invoices/\{id\}​

Get invoice by ID

PUT /api/v1/accounting/invoices/\{id\}​

Update invoice

POST /api/v1/accounting/invoices/\{id\}/approve​

Approve invoice

POST /api/v1/accounting/invoices/\{id\}/reject​

Reject invoice

POST /api/v1/accounting/invoices/\{id\}/match​

Match to PO

POST /api/v1/accounting/invoices/\{id\}/schedule​

Schedule payment

GET /api/v1/accounting/invoices/\{id\}/anomalies​

Get anomalies

GET /api/v1/accounting/invoices/pending​

Get pending approvals

GET /api/v1/accounting/invoices/overdue​

Get overdue invoices

GET /api/v1/accounting/invoices/stats​

Get statistics

POST /api/v1/accounting/purchase-orders​

Add purchase order

GET /api/v1/accounting/payments/scheduled​

Get scheduled payments

KnowledgeChat​

HTTP handler for Knowledge + Chat bridge endpoints.

GET /api/v1/chat/knowledge/search​

GET /api/v1/chat/knowledge/search

GET /api/v1/chat/knowledge/inject​

GET /api/v1/chat/knowledge/inject

GET /api/v1/chat/knowledge/store​

GET /api/v1/chat/knowledge/store

Laboratory​

Persona laboratory endpoint handlers.

GET /api/laboratory/emergent-traits​

Get emergent traits from agent performance

POST /api/laboratory/cross-pollinations/suggest​

Suggest beneficial trait transfers

Marketplace​

Marketplace API Handlers.

GET /api/v1/marketplace/templates​

List all templates

GET /api/v1/marketplace/templates/\{id\}​

Get template details

POST /api/v1/marketplace/templates​

Create a template

DELETE /api/v1/marketplace/templates/\{id\}​

Delete a template

POST /api/v1/marketplace/templates/\{id\}/ratings​

Rate a template

GET /api/v1/marketplace/templates/\{id\}/ratings​

Get template ratings

POST /api/v1/marketplace/templates/\{id\}/star​

Star a template

GET /api/v1/marketplace/categories​

List categories

GET /api/v1/marketplace/templates/\{id\}/export​

Export template

POST /api/v1/marketplace/templates/import​

Import a template

GET /api/v1/marketplace/status​

Health and circuit breaker status

Metrics​

Handler for operational metrics endpoints.

GET /api/metrics​

Get comprehensive operational metrics

GET /api/metrics/health​

Get detailed health check status

GET /api/metrics/cache​

Get cache statistics

GET /api/metrics/verification​

Get formal verification statistics

GET /api/metrics/system​

Get system information

GET /api/metrics/background​

Get background task statistics

GET /api/metrics/debate​

Get debate performance statistics

Parameters:

NameTypeDescription
debate_idstringOptional specific debate to get insights for

GET /metrics​

Get comprehensive operational metrics

Metrics Endpoint​

Unified Prometheus metrics endpoint.

GET /metrics​

Full Prometheus-format metrics export

GET /api/v1/metrics/prometheus​

Same as /metrics with API versioning

GET /api/v1/metrics/prometheus/summary​

Aggregated metrics summary

Ml​

ML (Machine Learning) endpoint handlers.

POST /api/ml/route​

Get ML-based agent routing for a task

POST /api/ml/score​

Score response quality

POST /api/ml/score-batch​

Score multiple responses

POST /api/ml/consensus​

Predict consensus likelihood

POST /api/ml/export-training​

Export debate data for training

GET /api/ml/models​

List available ML models/capabilities

GET /api/ml/stats​

Get ML module statistics

Moments​

Moments endpoint handlers.

GET /api/moments/summary​

Global moments overview

GET /api/moments/timeline​

Chronological moments (limit, offset)

GET /api/moments/by-type/\{type\}​

Filter moments by type

GET /api/moments/trending​

Most significant recent moments

Nomic​

Nomic loop state and monitoring endpoint handlers.

GET /api/nomic/state​

Get nomic loop state

GET /api/nomic/health​

Get nomic loop health with stall detection

GET /api/nomic/metrics​

Get nomic loop Prometheus metrics summary

GET /api/nomic/log​

Get nomic loop logs

GET /api/nomic/risk-register​

Get risk register entries

GET /api/nomic/witness/status​

Get Gas Town witness patrol status

GET /api/nomic/mayor/current​

Get current Gas Town mayor information

GET /api/modes​

Get available operational modes

WS /api/nomic/stream​

Real-time WebSocket event stream

Oauth Wizard​

Unified OAuth Wizard Handler for SME Onboarding.

GET /api/v2/integrations/wizard​

Get wizard configuration

GET /api/v2/integrations/wizard/providers​

List all available providers

GET /api/v2/integrations/wizard/status​

Get status of all integrations

POST /api/v2/integrations/wizard/validate​

Validate configuration before connecting

Onboarding​

Onboarding Orchestration Handler.

GET /api/v1/onboarding/flow​

Get current onboarding state

POST /api/v1/onboarding/flow​

Initialize onboarding

PUT /api/v1/onboarding/flow/step​

Update current step

GET /api/v1/onboarding/templates​

Get recommended starter templates

POST /api/v1/onboarding/first-debate​

Start guided first debate

POST /api/v1/onboarding/quick-start​

Apply quick-start configuration

GET /api/v1/onboarding/analytics​

Get onboarding funnel analytics

Organizations​

Organization Management Handlers.

GET /api/org/\{org_id\}​

Get organization details

PUT /api/org/\{org_id\}​

Update organization settings

GET /api/org/\{org_id\}/members​

List organization members

POST /api/org/\{org_id\}/invite​

Invite user to organization

GET /api/org/\{org_id\}/invitations​

List pending invitations

DELETE /api/org/\{org_id\}/invitations/\{invitation_id\}​

Revoke invitation

DELETE /api/org/\{org_id\}/members/\{user_id\}​

Remove member

PUT /api/org/\{org_id\}/members/\{user_id\}/role​

Update member role

GET /api/invitations/pending​

List pending invitations for current user

POST /api/invitations/\{token\}/accept​

Accept an invitation

GET /api/user/organizations​

List organizations for current user

POST /api/user/organizations/switch​

Switch active organization

POST /api/user/organizations/default​

Set default organization

DELETE /api/user/organizations/\{org_id\}​

Leave organization

Partner​

Partner API HTTP handlers.

POST /api/partners/register​

Register as a partner

GET /api/partners/me​

Get current partner profile

POST /api/partners/keys​

Create API key

GET /api/partners/keys​

List API keys

POST /api/partners/keys/\{key_id\}/rotate​

Rotate API key

DELETE /api/partners/keys/\{key_id\}​

Revoke API key

GET /api/partners/usage​

Get usage statistics

POST /api/partners/webhooks​

Configure webhook

GET /api/partners/limits​

Get rate limits

Persona​

Persona-related endpoint handlers.

GET /api/personas​

Get all agent personas

GET /api/agent/\{name\}/persona​

Get agent persona

GET /api/agent/\{name\}/grounded-persona​

Get truth-grounded persona

GET /api/agent/\{name\}/identity-prompt​

Get identity prompt

GET /api/agent/\{name\}/performance​

Get agent performance summary

GET /api/agent/\{name\}/domains​

Get agent expertise domains

GET /api/agent/\{name\}/accuracy​

Get position accuracy stats

Policy​

Policy and Compliance endpoint handlers.

GET /api/policies​

List policies

GET /api/policies/:id​

Get policy details

POST /api/policies​

Create policy

PATCH /api/policies/:id​

Update policy

DELETE /api/policies/:id​

Delete policy

POST /api/policies/:id/toggle​

Toggle policy enabled status

GET /api/policies/:id/violations​

Get violations for a policy

GET /api/compliance/violations​

List all violations

GET /api/compliance/violations/:id​

Get violation details

PATCH /api/compliance/violations/:id​

Update violation status

POST /api/compliance/check​

Run compliance check on content

GET /api/compliance/stats​

Get compliance statistics

Privacy​

Privacy Handler - GDPR/CCPA Compliant Data Export and Account Deletion.

GET /api/privacy/export​

Export all user data (GDPR Article 15, CCPA Right to Know)

GET /api/privacy/data-inventory​

Get summary of data categories collected

DELETE /api/privacy/account​

Delete user account (GDPR Article 17, CCPA Right to Delete)

POST /api/privacy/preferences​

Update privacy preferences (CCPA Do Not Sell)

Queue​

Queue management endpoint handlers.

POST /api/queue/jobs​

Submit new job

GET /api/queue/jobs​

List jobs with filters

GET /api/queue/jobs/:id​

Get job status

POST /api/queue/jobs/:id/retry​

Retry failed job

DELETE /api/queue/jobs/:id​

Cancel job

GET /api/queue/stats​

Queue statistics

GET /api/queue/workers​

Worker status

RBAC​

HTTP handler for RBAC management endpoints.

GET /api/v1/rbac/permissions 🔒​

List all system permissions with optional filtering

GET /api/v1/rbac/permissions/*​

GET /api/v1/rbac/permissions/*

GET /api/v1/rbac/roles 🔒​

List all roles (system and custom)

GET /api/v1/rbac/roles/*​

GET /api/v1/rbac/roles/*

GET /api/v1/rbac/assignments 🔒​

List role assignments with optional filtering

GET /api/v1/rbac/assignments/*​

GET /api/v1/rbac/assignments/*

GET /api/v1/rbac/check 🔒​

Check if a user has a specific permission

Receipts​

Decision Receipt HTTP Handlers for Aragora.

GET /api/v2/receipts​

List receipts with filters

GET /api/v2/receipts/search​

Full-text search receipts

GET /api/v2/receipts/:receipt_id​

Get specific receipt

GET /api/v2/receipts/:receipt_id/export​

Export (format=json|html|md|pdf)

POST /api/v2/receipts/:receipt_id/verify​

Verify integrity checksum

POST /api/v2/receipts/:receipt_id/verify-signature​

Verify cryptographic signature

POST /api/v2/receipts/verify-batch​

Batch signature verification

POST /api/v2/receipts/sign-batch​

Batch signing

POST /api/v2/receipts/batch-export​

Batch export to ZIP

GET /api/v2/receipts/stats​

Receipt statistics

POST /api/v2/receipts/:receipt_id/share​

Create shareable link

GET /api/v2/receipts/share/:token​

Access receipt via share token

Replays​

Replays and learning evolution endpoint handlers.

GET /api/replays​

List available replays

GET /api/replays/:replay_id​

Get specific replay with events

GET /api/learning/evolution​

Get meta-learning patterns

GET /api/meta-learning/stats​

Get meta-learning hyperparameters and efficiency stats

Repository​

Repository indexing endpoint handlers.

POST /api/repository/index​

Start full repository index

POST /api/repository/incremental​

Incremental update

GET /api/repository/:id/status​

Get indexing status

GET /api/repository/:id/entities​

List entities with filters

GET /api/repository/:id/graph​

Get relationship graph

DELETE /api/repository/:id​

Remove indexed repository

Reviews​

Reviews Handler - Serve shareable code reviews.

GET /api/reviews/\{id\}​

Get a specific review by ID

GET /api/reviews​

List recent reviews

RLMContext​

Handler for RLM context compression and query endpoints.

GET /api/v1/rlm/stats​

GET /api/v1/rlm/stats

GET /api/v1/rlm/strategies​

GET /api/v1/rlm/strategies

GET /api/v1/rlm/compress​

Get or create the hierarchical compressor using factory

GET /api/v1/rlm/query​

Simple fallback query when full RLM is not available

GET /api/v1/rlm/contexts​

GET /api/v1/rlm/contexts

GET /api/v1/rlm/stream​

GET /api/v1/rlm/stream

GET /api/v1/rlm/stream/modes​

GET /api/v1/rlm/stream/modes

GET /api/v1/rlm/codebase/health​

GET /api/v1/rlm/codebase/health

SCIM​

HTTP request handler for SCIM 2.0 provisioning endpoints.

GET /scim/v2/Users​

Extract resource ID from path like /scim/v2/Users/{id}

GET /scim/v2/Users/*​

GET /scim/v2/Users/*

GET /scim/v2/Groups​

GET /scim/v2/Groups

GET /scim/v2/Groups/*​

GET /scim/v2/Groups/*

Selection​

Handler for selection plugin endpoints.

GET /api/v1/selection/plugins 🔒​

List all available selection plugins

GET /api/v1/selection/defaults 🔒​

Get default plugin configuration

GET /api/v1/selection/score 🔒​

Get information about a specific scorer

GET /api/v1/selection/team 🔒​

Get information about a specific team selector

GET /api/v1/team-selection​

GET /api/v1/team-selection

Skill Marketplace​

Skill Marketplace API Handlers.

GET /api/v1/skills/marketplace/search​

Search skills

GET /api/v1/skills/marketplace/\{skill_id\}​

Get skill details

GET /api/v1/skills/marketplace/\{skill_id\}/versions​

Get skill versions

GET /api/v1/skills/marketplace/\{skill_id\}/ratings​

Get skill ratings

POST /api/v1/skills/marketplace/publish​

Publish a skill

POST /api/v1/skills/marketplace/\{skill_id\}/install​

Install a skill

DELETE /api/v1/skills/marketplace/\{skill_id\}/install​

Uninstall a skill

POST /api/v1/skills/marketplace/\{skill_id\}/rate​

Rate a skill

GET /api/v1/skills/marketplace/installed​

List installed skills

GET /api/v1/skills/marketplace/stats​

Get marketplace statistics

Skills​

Skills endpoint handlers.

GET /api/skills​

List all registered skills

GET /api/skills/:name​

Get skill details

POST /api/skills/invoke​

Invoke a skill by name

GET /api/skills/:name/metrics​

Get skill execution metrics

Slack​

Handler for Slack bot integration endpoints.

GET /api/v1/bots/slack/status​

Build the status response JSON

Parameters:

NameTypeDescription
extra_statusstringAdditional fields to include.

GET /api/v1/bots/slack/events​

GET /api/v1/bots/slack/events

GET /api/v1/bots/slack/interactions​

GET /api/v1/bots/slack/interactions

GET /api/v1/bots/slack/commands​

GET /api/v1/bots/slack/commands

Slo​

SLO (Service Level Objective) endpoint handlers.

GET /api/slos/status​

Overall SLO compliance status

GET /api/slos/\{slo_name\}​

Individual SLO details

GET /api/slos/error-budget​

Error budget timeline

GET /api/slos/violations​

Recent SLO violations

GET /api/slos/targets​

Configured SLO targets

GET /api/v1/slos/status​

Versioned endpoint

SMESuccessDashboard​

Handler for SME success dashboard endpoints.

GET /api/v1/sme/success​

Calculate core success metrics for an organization

GET /api/v1/sme/success/cfo 🔒​

Get CFO-focused success view

GET /api/v1/sme/success/pm 🔒​

Get PM-focused success view

GET /api/v1/sme/success/hr 🔒​

Get HR-focused success view

GET /api/v1/sme/success/milestones 🔒​

Get achievement milestones and gamification status

GET /api/v1/sme/success/insights 🔒​

Get actionable insights and recommendations

SMEUsageDashboard​

Handler for SME usage dashboard endpoints.

GET /api/v1/usage/summary 🔒​

Get unified usage summary for the SME dashboard

GET /api/v1/usage/breakdown 🔒​

Get detailed usage breakdown by dimension

GET /api/v1/usage/roi 🔒​

Get ROI analysis for the organization

GET /api/v1/usage/export 🔒​

Export usage data in various formats

GET /api/v1/usage/budget-status​

GET /api/v1/usage/budget-status

GET /api/v1/usage/forecast 🔒​

Get usage forecast based on current patterns

GET /api/v1/usage/benchmarks 🔒​

Get industry benchmark comparison data

Template Marketplace​

Template Marketplace API Handler.

GET /api/marketplace/templates​

Browse marketplace templates

GET /api/marketplace/templates/:id​

Get marketplace template details

POST /api/marketplace/templates​

Publish template to marketplace

POST /api/marketplace/templates/:id/rate​

Rate a template

GET /api/marketplace/templates/:id/reviews​

Get template reviews

POST /api/marketplace/templates/:id/reviews​

Submit a review

POST /api/marketplace/templates/:id/import​

Import to workspace

GET /api/marketplace/featured​

Get featured templates

GET /api/marketplace/trending​

Get trending templates

GET /api/marketplace/categories​

Get marketplace categories

Threat Intel​

Threat Intelligence API Handlers.

POST /api/v1/threat/url​

Check URL for threats

POST /api/v1/threat/urls​

Batch check URLs

GET /api/v1/threat/ip/\{ip_address\}​

Check IP reputation

POST /api/v1/threat/ips​

Batch check IPs

GET /api/v1/threat/hash/\{hash_value\}​

Check file hash reputation

POST /api/v1/threat/hashes​

Batch check hashes

POST /api/v1/threat/email​

Scan email content

GET /api/v1/threat/status​

Get service status

Tournaments​

Tournament-related endpoint handlers.

GET /api/tournaments​

List all tournaments

POST /api/tournaments​

Create new tournament

GET /api/tournaments/\{id\}​

Get tournament details

GET /api/tournaments/\{id\}/standings​

Get tournament standings

GET /api/tournaments/\{id\}/bracket​

Get bracket structure

GET /api/tournaments/\{id\}/matches​

Get match history

POST /api/tournaments/\{id\}/advance​

Advance to next round

POST /api/tournaments/\{id\}/matches/\{match_id\}/result​

Record match result

Training​

Handler for training data export endpoints.

GET /api/v1/training/export/sft​

Get or create SFT exporter

GET /api/v1/training/export/dpo​

Get or create DPO exporter

GET /api/v1/training/export/gauntlet​

Get or create Gauntlet exporter

GET /api/v1/training/stats​

GET /api/v1/training/stats

GET /api/v1/training/formats​

GET /api/v1/training/formats

GET /api/v1/training/jobs​

GET /api/v1/training/jobs

Transcription​

Transcription endpoint handlers for speech-to-text and media processing.

POST /api/transcription/audio​

Transcribe audio file

POST /api/transcription/video​

Extract and transcribe audio from video

POST /api/transcription/youtube​

Transcribe YouTube video

GET /api/transcription/status/:id​

Get transcription job status

GET /api/transcription/config​

Get supported formats and limits

Uncertainty​

Uncertainty estimation endpoint handlers.

POST /api/uncertainty/estimate​

Estimate uncertainty for a debate/response

GET /api/uncertainty/debate/:id​

Get debate uncertainty metrics

GET /api/uncertainty/agent/:id​

Get agent calibration profile

POST /api/uncertainty/followups​

Generate follow-up suggestions from cruxes

UsageMetering​

Handler for usage metering endpoints.

GET /api/v1/billing/usage 🔒​

Export usage data as CSV

GET /api/v1/billing/usage/breakdown 🔒​

Get detailed usage breakdown for billing

GET /api/v1/billing/limits 🔒​

Get current usage limits and utilization percentages

GET /api/v1/billing/usage/summary​

GET /api/v1/billing/usage/summary

GET /api/v1/billing/usage/export 🔒​

Export usage data as CSV

GET /api/v1/quotas​

GET /api/v1/quotas

Verticals​

Vertical specialist endpoint handlers.

GET /api/verticals​

List available verticals

GET /api/verticals/:id​

Get vertical config

PUT /api/verticals/:id/config​

Update vertical configuration

GET /api/verticals/:id/tools​

Get vertical tools

GET /api/verticals/:id/compliance​

Get compliance frameworks

POST /api/verticals/:id/debate​

Create vertical-specific debate

POST /api/verticals/:id/agent​

Create specialist agent instance

GET /api/verticals/suggest​

Suggest vertical for a task

Webhook​

Handler for webhook management API endpoints.

GET /api/v1/webhooks​

Handle GET /api/webhooks - list all webhooks

GET /api/v1/webhooks/events​

Handle GET /api/webhooks/events - list available event types

GET /api/v1/webhooks/slo/status​

Handle GET /api/webhooks/slo/status - get SLO webhook status

GET /api/v1/webhooks/dead-letter​

GET /api/v1/webhooks/dead-letter

GET /api/v1/webhooks/queue/stats​

Handle GET /api/webhooks/queue/stats - get queue statistics

Workflow Templates​

Workflow Templates API Handler.

GET /api/workflow/templates​

List available templates

GET /api/workflow/templates/:id​

Get template details

GET /api/workflow/templates/:id/package​

Get full package

POST /api/workflow/templates/run​

Execute a template

Workspace Module​

Workspace Handler - Enterprise Privacy and Data Isolation APIs.

POST /api/workspaces​

Create a new workspace

GET /api/workspaces​

List workspaces

GET /api/workspaces/\{id\}​

Get workspace details

DELETE /api/workspaces/\{id\}​

Delete workspace

POST /api/workspaces/\{id\}/members​

Add member to workspace

DELETE /api/workspaces/\{id\}/members/\{user_id\}​

Remove member

GET /api/retention/policies​

List retention policies

POST /api/retention/policies​

Create retention policy

PUT /api/retention/policies/\{id\}​

Update retention policy

DELETE /api/retention/policies/\{id\}​

Delete retention policy

POST /api/retention/policies/\{id\}/execute​

Execute retention policy

GET /api/retention/expiring​

Get items expiring soon

POST /api/classify​

Classify content sensitivity

GET /api/classify/policy/\{level\}​

Get policy for sensitivity level

GET /api/audit/entries​

Query audit entries

GET /api/audit/report​

Generate compliance report

GET /api/audit/verify​

Verify audit log integrity

Intelligence​

HTTP API Handlers for Code Intelligence Analysis.

POST /api/v1/codebase/\{repo\}/analyze​

Analyze codebase structure

GET /api/v1/codebase/\{repo\}/symbols​

List symbols (classes, functions)

GET /api/v1/codebase/\{repo\}/callgraph​

Get call graph

GET /api/v1/codebase/\{repo\}/deadcode​

Find dead/unreachable code

POST /api/v1/codebase/\{repo\}/impact​

Analyze impact of changes

POST /api/v1/codebase/\{repo\}/understand​

Answer questions about code

POST /api/v1/codebase/\{repo\}/audit​

Run comprehensive audit

Metrics​

HTTP API Handlers for Codebase Metrics Analysis.

POST /api/v1/codebase/\{repo\}/metrics/analyze​

Run metrics analysis

GET /api/v1/codebase/\{repo\}/metrics​

Get latest metrics

GET /api/v1/codebase/\{repo\}/metrics/\{analysis_id\}​

Get specific analysis

GET /api/v1/codebase/\{repo\}/hotspots​

Get complexity hotspots

GET /api/v1/codebase/\{repo\}/duplicates​

Get code duplicates

Quick Scan​

Quick Security Scan API Handler.

POST /api/codebase/quick-scan​

Run quick security scan

GET /api/codebase/quick-scan/\{scan_id\}​

Get scan result

Audit Bridge​

Audit-to-GitHub Bridge Handler.

POST /api/v1/github/audit/issues​

Create issues from findings

POST /api/v1/github/audit/issues/bulk​

Bulk create issues

POST /api/v1/github/audit/pr​

Create PR with fixes

GET /api/v1/github/audit/sync/\{session_id\}​

Get sync status

POST /api/v1/github/audit/sync/\{session_id\}​

Sync session to GitHub

Pr Review​

HTTP API Handlers for GitHub Pull Request Review.

POST /api/v1/github/pr/review​

Trigger PR review

GET /api/v1/github/pr/\{pr_number\}​

Get PR details

POST /api/v1/github/pr/\{pr_number\}/review​

Submit review

GET /api/v1/github/pr/\{pr_number\}/reviews​

List reviews

Authentication​

Endpoints marked with 🔒 require authentication.

Include an Authorization header with your API token:

Authorization: Bearer <your-api-token>

Set ARAGORA_API_TOKEN environment variable to configure the token.

Generated automatically by scripts/generate_api_docs.py