Skip to main content

Page: docs api

API Documentation

Source-first RESTful API reference generated via Utoipa route contracts.

Source-First API Contract & Exploration

The OmniGCloud API contract is derived directly from Rust handler source code via Utoipa. All 68 micro-workers declare typed schemas, path parameters, and RBAC tier entitlement constraints.

Authentication & Headers

Authorization: Bearer omni_sec_live_...
Content-Type: application/json
X-Tenant-Id: tenant_primary_...

Pass your API token as an HTTP Bearer header. Use Register or Sign in in the documentation portal; disposable test credentials remain environment-controlled and are never assumed.

Request state semantics

Loading

The UI is checking session, tenant, or contract state.

401 / 403

Re-authenticate or upgrade; never treat denial as success.

409 / 429

Preserve idempotency and retry only when the contract permits it.

5xx / unavailable

Show degraded or retryable state; provider evidence is still required.

Need help?

OpenAPI documents describe the contract, not a grant of access. For tenant, billing, connector, or enterprise administration issues, use the authenticated shell or contact support.