Platform · ConceptPreview

Environments and contract maturity

Separate sandbox and production behavior, understand documentation maturity labels and plan controlled promotion.

Audience
Developer, Solution architect, Administrator, Operator
Owner
Platform operations
Last reviewed
Jul 19, 2026
Reading time
7 min
On this page

Promotion path

  1. 01SandboxValidate contracts and workflows with non-production credentials and data.
  2. 02IntegrationTest service boundaries, retries, events and failure recovery.
  3. 03Pre-productionExercise production-like controls, monitoring and operational runbooks.
  4. 04ProductionPromote approved configuration and use separately issued credentials.

Maturity labels

Previewstatus
A testable contract that can change before production publication.
Betastatus
A supported pre-GA capability with documented limitations.
GAstatus
A production contract governed by published compatibility expectations.
Plannedstatus
A verified product direction or domain concept without a public runtime contract.

Before production promotion

  • Replace sandbox credentials and URLs with values issued for production.
  • Confirm least-privilege scopes and separation of duties.
  • Verify retry, idempotency and event replay behavior under failure.
  • Create monitoring, reconciliation and incident-response ownership.
  • Record the exact API and SDK versions approved for release.

Continue learning

Related documentation