Skip to content

Version

A Version is an immutable build of a definition at a fingerprint; an Order keeps the Offer Version it bought.

Properties

PropertyTypeRequiredDescription
fingerprintstringrequiredThe content hash that identifies the build.

Object

JSON
{
  "$id": "https://api.sb/quietcopy.com/versions/version_1",
  "$type": "Version",
  "fingerprint": "sha256:9f2c4e1a7b3d"
}

Relationships

  • A Version is pinned cohorts many Cohorts: every Startup in a Cohort runs the same Version of a shared definition; a control Cohort keeps the prior one. pinnedCohorts, inverse pinnedTo.
  • A Version is a version of one Thing: every published change to a Thing’s definition is an immutable Version, kept forever. versionOf, inverse versionedAs.

Verbs

  1. getReturns one Version by id.
    GET /{namespace}/versions/{id}readNo Event
  2. listReturns Versions, newest first, one page at a time.
    GET /{namespace}/versionsreadNo Event
  3. deployDeploy points a Startup’s live address at a Version, so every Interface serves that build.
    POST /{namespace}/versions/{version}/deploydoVersion.deployed

A Version is kept forever and never edited: it has no update or delete.

Permissions

Which Access level may call each Verb. One-way Verbs wait their delay window.

Operationowneradminmemberviewer
Version.getYesYesYesYes
Version.listYesYesYesYes
Version.deployYesYesYesNo

Call it

Text
Deploy the latest version.

Example

A dental group's Order points to Version 3 of the $99 Offer. Version 4 raises the Price to $119, and the Order keeps Version 3.