API Reference

Complete HTTP API documentation for the Elydora platform. All endpoints use JSON request and response bodies.

Base URL

https://api.elydora.com

Authentication

Most endpoints require a Bearer token in the Authorization header. Obtain a token via the Authentication endpoints.

http
Authorization: Bearer <your-jwt-token>

Error Format

All errors return a consistent JSON structure with an error code and human-readable message. See the full list of error codes.

json
{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Missing or invalid authorization token."
  }
}

Pagination

List endpoints support cursor-based pagination using cursor and limit query parameters. The response includes a nextCursor field when more results are available.

json
{
  "data": [...],
  "nextCursor": "eyJpZCI6MTAwfQ==",
  "hasMore": true
}

Endpoint Overview

POST
/v1/auth/register
Register a new organization
POST
/v1/auth/login
Authenticate and receive JWT
GET
/v1/auth/me
Get current user profile
Auth: Any authenticated user
POST
/v1/auth/refresh
Refresh JWT token
Auth: Any authenticated user
POST
/v1/agents/register
Register a new agent
Auth: integration_engineer
GET
/v1/agents/:agent_id
Get agent details
Auth: readonly_investigator
POST
/v1/agents/:agent_id/freeze
Freeze an agent
Auth: security_admin
POST
/v1/agents/:agent_id/revoke
Revoke an agent
Auth: security_admin
POST
/v1/operations
Submit a signed operation
Auth: integration_engineer
GET
/v1/operations/:operation_id
Retrieve an operation record
Auth: readonly_investigator
POST
/v1/operations/:operation_id/verify
Verify operation integrity
Auth: readonly_investigator
POST
/v1/audit/query
Query audit records
Auth: compliance_auditor
GET
/v1/epochs
List epochs
Auth: readonly_investigator
GET
/v1/epochs/:epoch_id
Get epoch details
Auth: readonly_investigator
POST
/v1/exports
Create an export job
Auth: compliance_auditor
GET
/v1/exports
List export jobs
Auth: compliance_auditor
GET
/v1/exports/:export_id
Get export status
Auth: compliance_auditor
GET
/v1/exports/:export_id/download
Download export data
Auth: compliance_auditor
GET
/.well-known/elydora/jwks.json
Public JWKS endpoint