Aevah Public API Preview Specification. Publication describes the intended contract; it does not grant tenant access or imply that every operation is enabled in production. Confirm availability, scopes, hostnames, and limits with Aevah.
Resources and operations
| Method | Path | Operation |
|---|---|---|
| GET | /entities | List entities |
| GET | /entities/{id} | Get an entity |
| GET | /entities/{id}/relationships | List an entity's relationships |
| GET | /definitions | List semantic definitions |
| GET | /sources | List governed sources |
| GET | /workflows | List workflows |
| GET | /workflows/{id} | Get a workflow |
| POST | /workflows/{id} | Start a workflow |
| GET | /agents | List agents |
| GET | /agents/{id} | Get an agent |
| POST | /agents/{id} | Invoke an agent |
| GET | /decisions | List decisions |
| GET | /evidence | List evidence |
Authentication and mutations
The preview describes customer-specific OAuth 2.x/OIDC and bearer-token patterns. Production identity endpoints are intentionally not public. Workflow and agent POST operations require authorization, an execution scope, policy approval, and an Idempotency-Key header.
Machine-readable contract
The JSON document is the canonical preview contract for schemas, request bodies, responses, security schemes, and reusable errors.
Open /openapi.json