Versions

Nav Versions. Lifecycle: Draft → Mark ready → Publish / Deprecate / Revoke. Lines: Yank, Disable. Promote channel moves to a more stable channel.

Create and publish

1. Click Create version. Fill Build and/or SemVer, Channel. stable cannot use a prerelease suffix (CHANNEL_SUFFIX_MISMATCHPrerelease suffix vs channel; stable cannot use a prerelease suffix). Duplicate identity: VERSION_ALREADY_EXISTSDuplicate version in project. Engine mismatch: ENGINE_MISMATCHEngine vs identity mismatch.
2. Optional LTS, Critical (mandatory for everyone), Minimum source version. Critical versions cannot use gray (GRAY_NOT_ALLOWED_ON_CRITICALGray on critical version).
3. Open Manage artifacts. Click Upload artifact. Channel Direct PUT or TUS chunked (resumable). direct_s3 is always false: never PUT unknown S3 keys. Hash mismatch: CHECKSUM_MISMATCHDeclared SHA-256 mismatch. Unregistered hw: HW_REV_UNKNOWNUnregistered hw_rev. Published artifacts cannot be overwritten (ARTIFACT_IMMUTABLEPublished artifact immutable (yank the line first); Yank first).
4. Mark ready on that platform line. Incomplete upload → UPLOAD_INCOMPLETEUpload incomplete for this operation.
5. Publish. No ready line → ARTIFACT_REQUIREDPublish rejected: no ready version line. Incomplete auto_publish_when → AUTO_PUBLISH_PENDINGauto_publish_when is not fully ready yet. Copy: “Changelog is immutable after publish”.
6. Generate delta, Reuse existing artifact, and multi-file archives are async jobs (header Task Center). Failure: JOB_FAILEDAsync job failed.

List latest=true

Admin GET versions?latest=true&os=&arch= returns { versions, latest }. latest is published + ready via CompareVersions, not client SelectTarget. Without latest the response omits that key.

Concepts: Releases. CI: CI releases.