Skip to main content

Environments and releases

Environments and releases provide delivery context for quality, issues, and agents.

Environments

An environment is a named target such as:

  • staging
  • production
  • preview-pr-128

Environment fields:

FieldPurpose
NameHuman-readable name
SlugStable identifier used by API and CLI
HostTarget URL or hostname
Typestatic or dynamic
Originmanual or auto

Releases

A release is a product version record. Releases are usually created by CI/CD, the CLI, or the REST API.

tiden release create \
--product-id <product-id> \
--version my-app@1.2.3 \
--environment production \
--url https://github.com/acme/app/releases/tag/v1.2.3

Release creation is idempotent for a product, version, and environment. Sending the same release again updates the existing record.

Auto-created environments

If release creation references an unknown environment slug, Tiden can create an auto-origin environment for that slug. You can later enrich it with a name, host, and description.

Release detail

The release detail page connects version context to issues and quality gate state. Use the same release string in your telemetry SDK so runtime errors can be attributed to the release.