API Reference

Complete REST API documentation for the Cognigate governance engine.

Interactive API Explorer

The full interactive API documentation is available via Swagger UI and ReDoc:

• Swagger UI — interactive endpoint testing with live schemas
• ReDoc — clean, readable API reference
• OpenAPI Spec — raw JSON schema for code generation

Base URL

https://cognigate.dev/v1

Core Endpoints

Intent Analysis

Method	Endpoint	Description
POST	/v1/intents	Submit a governance intent for analysis
GET	/v1/intents/:id	Retrieve intent analysis result

Enforcement

Method	Endpoint	Description
POST	/v1/enforce	Enforce policy on an intent
POST	/v1/enforce/batch	Batch enforcement for multiple intents

Proof Chain

Method	Endpoint	Description
GET	/v1/proofs/:id	Retrieve a specific proof receipt
GET	/v1/proofs/latest	Get most recent proof for an agent
GET	/v1/proofs/chain/:agentId	Retrieve full proof chain
POST	/v1/proofs/verify	Verify proof chain integrity

Trust

Method	Endpoint	Description
GET	/v1/trust/:agentId	Get current trust score and tier
GET	/v1/trust/:agentId/history	Trust score history over time
POST	/v1/trust/signals	Submit a trust signal

Agents

Method	Endpoint	Description
POST	/v1/agents	Register a new agent
GET	/v1/agents/:id	Get agent details
GET	/v1/agents	List all registered agents

Health

Method	Endpoint	Description
GET	/health	Service health check
GET	/status	Detailed status with version info

Authentication

All endpoints require an API key. See Authentication for details.

Response Format

All responses are JSON. Successful responses include a data field. Errors include error with a standardized code:

// Success
{
  "data": { ... },
  "meta": { "requestId": "req_abc123", "timestamp": "2026-03-28T..." }
}

// Error
{
  "error": {
    "code": "E1001",
    "message": "API key is missing.",
    "docsUrl": "https://cognigate.dev/docs/authentication"
  }
}