Version

A Version represents a specific instance of the configuration for a service. A Version can be cloned, locked, activated, or deactivated.

Data model

activebooleanWhether this is the active version or not. [Default false]
commentstringA freeform descriptive note.
deployedbooleanUnused at this time.
lockedbooleanWhether this version is locked or not. Objects can not be added or edited on locked versions. [Default false]
numberintegerThe number of this version. Read-only.
stagingbooleanUnused at this time. [Default false]
testingbooleanUnused at this time. [Default false]
service_idstringAlphanumeric string identifying the service. Read-only.
created_atstringDate and time in ISO 8601 format. Read-only.
deleted_atstringDate and time in ISO 8601 format. Read-only.
environmentsarrayA list of environments where the service has been deployed.
updated_atstringDate and time in ISO 8601 format. Read-only.

Endpoints

List versions of a service

GET/service/service_id/version

Create a service version

POST/service/service_id/version

Get a version of a service

GET/service/service_id/version/version_id

Update a service version

PUT/service/service_id/version/version_id

Validate a service version

GET/service/service_id/version/version_id/validate

Activate a service version

PUT/service/service_id/version/version_id/activate

Activate a service version on the specified environment

PUT/service/service_id/version/version_id/activate/environment_name

Deactivate a service version

PUT/service/service_id/version/version_id/deactivate

Deactivate a service version on an environment

PUT/service/service_id/version/version_id/deactivate/environment_name

Clone a service version

PUT/service/service_id/version/version_id/clone

Lock a service version

PUT/service/service_id/version/version_id/lock