releases
create a release
- Github
- Blog
- Community
- Youtube
- GETget all apps for the current org
- POSTcreate an app
- GETget an app
- DELdelete an app
- PATCHupdate an app
- POSTCreate app input configs
- GETget app input configs
- GETget latest app input config
- POSTcreate an app sandbox config
- GETget app sandbox configs
- GETget latest app sandbox config
- GETget all components for an app
- GETget all components for an org
- GETget a component
- PATCHupdate a component
- GETGet all builds for a component
- POSTcreate component build
- GETget latest build for a component
- GETget a build for a component
- GETget component build plan
- GETget all configs for a component
- POSTcreate a docker build component config
- POSTcreate an external image component config
- POSTcreate a helm component config
- POSTcreate a job component config
- GETget latest config for a component
- POSTcreate a terraform component config
- POSTcreate an app installer
- GETrender an installer
- GETget an installer
- DELdelete an installer
- GETget all installs for an app
- POSTcreate an app install
- GETget an install
- POSTcreate an app install from an installer
- GETget all installs for an org
- DELdelete an install
- PATCHupdate an install
- GETget an install component
- GETget an installs components
- GETget an install components deploys
- GETget the latest deploy for an install component
- POSTdeploy a build to an install
- GETget an install deploy
- GETget install deploy logs
- GETget install deploy plan
- GETget an installs inputs
- POSTcreate install inputs
- GETget an installs current inputs
- GETget an installs sandbox runs
- GETget all releases for an app
- GETget all releases for a component
- POSTcreate a release
- POSTCreate a release 1
- GETget a release
- GETget a release
- GETGet config for cli
- GETGet current user
- POSTPublish a metric from different Nuon clients for telemetry purposes.
apps
components
installers
installs
releases
general
releases
create a release
POST
/
v1
/
components
/
{component_id}
/
releases
Authorization
string
*
Authorization
Required
string
Type "Bearer" followed by a space and token.
component_id
string
*
component_id
Required
string
component ID
object
*
auto_build
boolean
auto_build
boolean
build_id
string
build_id
string
strategy
object
strategy
object
delay
string
delay
string
installs_per_step
integer
installs_per_step
integer
curl --request POST \
--url https://ctl.prod.nuon.co/v1/components/{component_id}/releases \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
"auto_build": true,
"build_id": "<string>",
"strategy": {
"delay": "<string>",
"installs_per_step": 123
}
}'
{
"build_id": "<string>",
"created_at": "<string>",
"created_by": {
"created_at": "<string>",
"created_by_id": "<string>",
"email": "<string>",
"expires_at": "<string>",
"id": "<string>",
"issued_at": "<string>",
"issuer": "<string>",
"subject": "<string>",
"token_type": "auth0",
"updated_at": "<string>"
},
"created_by_id": "<string>",
"id": "<string>",
"release_steps": [
{
"component_release_id": "<string>",
"created_at": "<string>",
"created_by": {
"created_at": "<string>",
"created_by_id": "<string>",
"email": "<string>",
"expires_at": "<string>",
"id": "<string>",
"issued_at": "<string>",
"issuer": "<string>",
"subject": "<string>",
"token_type": "auth0",
"updated_at": "<string>"
},
"created_by_id": "<string>",
"delay": "<string>",
"id": "<string>",
"install_deploys": [
{
"build_id": "<string>",
"component_id": "<string>",
"component_name": "<string>",
"created_at": "<string>",
"created_by": {
"created_at": "<string>",
"created_by_id": "<string>",
"email": "<string>",
"expires_at": "<string>",
"id": "<string>",
"issued_at": "<string>",
"issuer": "<string>",
"subject": "<string>",
"token_type": "auth0",
"updated_at": "<string>"
},
"created_by_id": "<string>",
"id": "<string>",
"install_component_id": "<string>",
"install_deploy_type": "release",
"install_id": "<string>",
"release_id": "<string>",
"status": "<string>",
"status_description": "<string>",
"updated_at": "<string>"
}
],
"requested_install_ids": [
"<string>"
],
"status": "<string>",
"status_description": "<string>",
"updated_at": "<string>"
}
],
"status": "<string>",
"status_description": "<string>",
"total_release_steps": 123,
"updated_at": "<string>"
}
Authorizations
Authorization
string
headerrequiredType "Bearer" followed by a space and token.
Path Parameters
component_id
string
requiredcomponent ID
Body
application/json
auto_build
boolean
build_id
string
strategy
object
strategy.delay
string
strategy.installs_per_step
integer
Response
201 - application/json
build_id
string
created_at
string
created_by
object
created_by.created_at
string
created_by.created_by_id
string
created_by.email
string
created_by.expires_at
string
created_by.id
string
created_by.issued_at
string
created_by.issuer
string
created_by.subject
string
claim data
created_by.token_type
enum<string>
Available options:
auth0
, admin
, static
, integration
, canary
created_by.updated_at
string
created_by_id
string
id
string
release_steps
object[]
release_steps.component_release_id
string
parent release ID
release_steps.created_at
string
release_steps.created_by
object
release_steps.created_by.created_at
string
release_steps.created_by.created_by_id
string
release_steps.created_by.email
string
release_steps.created_by.expires_at
string
release_steps.created_by.id
string
release_steps.created_by.issued_at
string
release_steps.created_by.issuer
string
release_steps.created_by.subject
string
claim data
release_steps.created_by.token_type
enum<string>
Available options:
auth0
, admin
, static
, integration
, canary
release_steps.created_by.updated_at
string
release_steps.created_by_id
string
release_steps.delay
string
fields to control the delay of the individual step, as this is set based on the parent strategy
release_steps.id
string
release_steps.install_deploys
object[]
release_steps.install_deploys.build_id
string
release_steps.install_deploys.component_id
string
release_steps.install_deploys.component_name
string
release_steps.install_deploys.created_at
string
release_steps.install_deploys.created_by
object
release_steps.install_deploys.created_by.created_at
string
release_steps.install_deploys.created_by.created_by_id
string
release_steps.install_deploys.created_by.email
string
release_steps.install_deploys.created_by.expires_at
string
release_steps.install_deploys.created_by.id
string
release_steps.install_deploys.created_by.issued_at
string
release_steps.install_deploys.created_by.issuer
string
release_steps.install_deploys.created_by.subject
string
claim data
release_steps.install_deploys.created_by.token_type
enum<string>
Available options:
auth0
, admin
, static
, integration
, canary
release_steps.install_deploys.created_by.updated_at
string
release_steps.install_deploys.created_by_id
string
release_steps.install_deploys.id
string
release_steps.install_deploys.install_component_id
string
release_steps.install_deploys.install_deploy_type
enum<string>
Available options:
release
, install
, teardown
release_steps.install_deploys.install_id
string
Fields that are de-nested at read time using AfterQuery
release_steps.install_deploys.release_id
string
release_steps.install_deploys.status
string
release_steps.install_deploys.status_description
string
release_steps.install_deploys.updated_at
string
release_steps.requested_install_ids
string[]
When a step is created, a set of installs are targeted. However, by the time the release step goes out, the install might have been setup in any order of ways.
release_steps.status
string
release_steps.status_description
string
release_steps.updated_at
string
status
string
status_description
string
total_release_steps
integer
updated_at
string
curl --request POST \
--url https://ctl.prod.nuon.co/v1/components/{component_id}/releases \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
"auto_build": true,
"build_id": "<string>",
"strategy": {
"delay": "<string>",
"installs_per_step": 123
}
}'
{
"build_id": "<string>",
"created_at": "<string>",
"created_by": {
"created_at": "<string>",
"created_by_id": "<string>",
"email": "<string>",
"expires_at": "<string>",
"id": "<string>",
"issued_at": "<string>",
"issuer": "<string>",
"subject": "<string>",
"token_type": "auth0",
"updated_at": "<string>"
},
"created_by_id": "<string>",
"id": "<string>",
"release_steps": [
{
"component_release_id": "<string>",
"created_at": "<string>",
"created_by": {
"created_at": "<string>",
"created_by_id": "<string>",
"email": "<string>",
"expires_at": "<string>",
"id": "<string>",
"issued_at": "<string>",
"issuer": "<string>",
"subject": "<string>",
"token_type": "auth0",
"updated_at": "<string>"
},
"created_by_id": "<string>",
"delay": "<string>",
"id": "<string>",
"install_deploys": [
{
"build_id": "<string>",
"component_id": "<string>",
"component_name": "<string>",
"created_at": "<string>",
"created_by": {
"created_at": "<string>",
"created_by_id": "<string>",
"email": "<string>",
"expires_at": "<string>",
"id": "<string>",
"issued_at": "<string>",
"issuer": "<string>",
"subject": "<string>",
"token_type": "auth0",
"updated_at": "<string>"
},
"created_by_id": "<string>",
"id": "<string>",
"install_component_id": "<string>",
"install_deploy_type": "release",
"install_id": "<string>",
"release_id": "<string>",
"status": "<string>",
"status_description": "<string>",
"updated_at": "<string>"
}
],
"requested_install_ids": [
"<string>"
],
"status": "<string>",
"status_description": "<string>",
"updated_at": "<string>"
}
],
"status": "<string>",
"status_description": "<string>",
"total_release_steps": 123,
"updated_at": "<string>"
}