API Reference
Complete HTTP API documentation for the Elydora platform. All endpoints use JSON request and response bodies.
Base URL
https://api.elydora.comAuthentication
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