Eden REST API

API Overview

ProtocolREST / JSON

Base path/api/v1

AuthenticationBearer token

Eden exposes organization-scoped REST APIs for shared identity, Gateway endpoint operations, AI governance, live migrations, and operations. The base API path is:

text

http://{host}:8000/api/v1

Authenticate requests with an Eden bearer token unless a route documents a different requirement. See Authentication APIs for login and token refresh.

Find An API Family

Need	Start here
Authenticate or grant access	Shared Identity And Organizations
Configure endpoints or execute approved operations	Gateway APIs
Govern model traffic, tools, or AI agents	AI Orchestration APIs
Plan, validate, replay, or cut over a migration	Live Migrations APIs
Review evidence or operate supporting resources	Operations And Observability
Audit every documented public route	Complete API Index
Interpret an API failure	Error Responses

Request Conventions

Send JSON bodies unless a route documents another format. API responses are typed JSON; message-style endpoints may use an ok or error envelope. Do not assume a single response envelope across all resource families.

bash

curl "$EDEN/api/v1/endpoints" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json"