Eden REST API

API Overview

ProtocolREST / JSON

Base path/api/v1

AuthenticationBearer token

Eden exposes organization-scoped REST APIs for shared identity, Eden 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.

For the complete machine-readable contract, fetch GET /api-docs/openapi.json on the service origin, outside /api/v1. OpenAPI discovery and queries covers full and partitioned specifications, Swagger UI, jq examples, authentication, and image/profile coverage limits. Use the running build's document when generating a client.

Find An API Family

Need	Start here
Authenticate or grant access	Shared Identity And Organizations
Configure endpoints or execute approved operations	Eden 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"