Skip to content
FRSign inBook a walkthrough

Developers | REST API, MCP server and webhooks

Build on eAviora.

A versioned REST API, an MCP server for AI assistants, signed webhooks and enterprise sign-in, on the same permissions as the app.

GET /api/v1/records200
curl https://app.eaviora.com/api/v1/records?type=occurrence&limit=1 \
  -H "Authorization: Bearer $EAVIORA_API_KEY"

{
  "data": [{
    "reference": "SMS-OCC-2026-0412",
    "type": "occurrence",
    "title": "Hard landing on runway 24R, 2.1 g at touchdown",
    "stage": "investigation",
    "riskLevel": "UNDESIRE"
  ...
01Your records02REST API03MCP server04Webhooks05Sign-in
Sample data | Northwind Air, a fictional airline
Start here

Developer resources. Docs, contract, events and SDK.

DOCS | FOR CUSTOMERS

Developer documentation

Path
docs.eaviora.com, for customers
CONTRACT | VERSION 1

OpenAPI 3.1 spec

Path
/api/v1/openapi.json
EVENTS | SIGNED

Webhook events

Path
/api/webhooks/events
SDK | ZERO DEPENDENCIES

Webhooks SDK

Path
npm @eaviora/webhooks
REST API, version 1

Read and write your records.

58 endpoints across records, links, actions, documents, evidence, imports, exports, webhooks and the audit log. The contract is generated from the running code, so the spec and the API cannot drift.

curl https://app.eaviora.com/api/v1/records?type=occurrence&limit=1 \
  -H "Authorization: Bearer $EAVIORA_API_KEY"

{
  "data": [{
    "reference": "SMS-OCC-2026-0412",
    "type": "occurrence",
    "title": "Hard landing on runway 24R, 2.1 g at touchdown",
    "stage": "investigation",
    "riskLevel": "UNDESIRE"
  }],
  "pagination": { "limit": 1, "offset": 0, "total": 1 }
}
GET /api/v1/recordsSMS-OCC-2026-0412the same reference as on screen | sample data
One contract
58endpoints
Generated from the running code, so the spec and the API cannot drift.
  • KeysCreated by an administrator in settings, scoped to one organization.
  • ReferencesA record has the same reference in the API as on screen.
  • LimitsEvery response states your remaining calls in X-RateLimit headers.
  • WorkflowA record’s workflow stage moves in the app, by a person: the API cannot set it. A key with write scope can update an action’s status, so give write scope only to systems you trust.
  • AuditEvery write is logged under the key that made it, in the same transaction.
MCP server

Connect an AI assistant to your records.

Add eAviora as a connector in an assistant that supports MCP. The person consents in the app, and the assistant acts with their role, never more.

The connector
Endpoint/api/mcp/mcp
Sign-inOAuth 2.1 with PKCE and dynamic registration. Access tokens last an hour; refresh tokens rotate over 30 days.
ConsentThe person grants read, or read and write, and sees what they hand over.
Limits on writesWrites go straight to the record within the person’s role, and are audited. An assistant cannot move a record’s workflow stage or a governance decision: a person does.
The limit on writesAn assistant writes, with the person’s consent
  • The person’s role: read, or read and write. Writes, audited., passes
  • Workflow stage and governance decisions: a person moves it., held
A write passes the role and is held at the workflow stage.
12 tools in all
Read tools6
list_modulessearch_recordsget_recordget_record_linksget_import_joblist_export_jobs
Write tools6
create_recordupdate_recordlink_recordsstart_csv_importrequest_exportask_eavy
Webhooks

Signed events, with a delivery feed.

Subscribe to record events and verify each one with the zero-dependency SDK, on Node, Deno, Bun, Cloudflare Workers or the browser.

01SignatureHMAC-SHA256 over the timestamp and the body, checked in constant time.
02AddressesChecked against private and internal ranges when saved, and again before each send.
03SecretsShown once when created, and rotated whenever you choose.
04FailuresThe delivery feed in settings replays one event, or every failed one. An endpoint that fails ten times in a row is paused.
Enterprise sign-in and data

What your security review will ask.

  • Single sign-onSAML 2.0 with Okta, Microsoft Entra or Google, just-in-time accounts, and sign-on enforced for your domain.Asked by | your security teamIn place
  • ProvisioningSCIM 2.0 creates and removes accounts, so a leaver loses access without a manual step.Asked by | your security teamIn place
  • Multi-factorMulti-factor sign-in for every user. Passkeys are available as an experimental option.Asked by | your security teamIn place
  • IsolationRow-level security in the database, under a role that cannot bypass it.Asked by | your security teamIn place
  • ExportEvery record and the audit log, as JSON or CSV, at any time.Asked by | your security teamIn place

Talk to an engineer.

On the same permissions as the app, with the real limits stated.