headless.biddevelopers
v1Sandbox console
Sandbox available · Production unavailable

Engine and Platform APIs

The Engine document is generated from its Hono/Zod contracts. The separate Platform document is generated from the OAuth API contract used by CLI and MCP. Repository checks fail when either committed document drifts.

Authentication schemes

SchemePurpose
tenantServiceCredentialBearer credential for tenant-scoped server calls. Verified credential supplies tenant identity.
operatorCapabilityTenant-signed, command-specific capability for interventions; sent in Ledgero-Operator-Capability.
platformOAuthAuthorization code + S256 for the exact consented Workspace and Environment. CLI/MCP access never becomes Ledgero authority.

Using the typed package surfaces? Review the SDK compatibility matrix before choosing a runtime.

Version and deprecation

The document declares OpenAPI 3.1.0 and API version 1.0.0. Compatible additions remain in v1. A breaking change requires a new major API/documentation version and the published deprecation policy; removal is never inferred from a UI change.