Roll back to an earlier revision: a new run of its release and configuration. The app stays on it until automatic deploys resume.

POST

/api/v1/projects/{project}/environments/{environment}/apps/{app}/rollback

curl --request POST \
  --url https://example.com/api/v1/projects/example/environments/example/apps/example/rollback \
  --header 'Content-Type: application/json' \
  --data '{ "revision": 1 }'

Parameters

Path Parameters

project

required

string

Project name

environment

required

string

Environment short name

app

required

string

App name

Request Body^required

Media typeapplication/json

object

revision

required

Revision to restore.

integer format: int64

Example^generated

{
  "revision": 1
}

Responses

200

Media typeapplication/json

object

name

required

string

project

required

string

environment

required

Environment short name.

string

namespace

required

string

image

string | null

git_repo

string | null

url

string | null

ready

required

boolean

reason

Available, Progressing, RolloutFailed, Scheduled, AwaitingBuild, …

string | null

message

string | null

processes

required

Array<object>

object

name

required

string

command

required

Array<string>

port

integer | null format: int32

size

required

string

min_replicas

required

integer format: int32

max_replicas

required

integer format: int32

schedule

Cron expression of scheduled processes.

string | null

protocol

required

http or tcp.

string

env

required

Values are only included in the app detail, for callers allowed to read secrets.

Array<object>

Environment variable: a plain value or a secret reference.

object

name

required

string

value

string | null

secret

One of:

null

null

object

object

name

required

string

key

required

string

domains

required

Array<string>

volumes

required

Array<object>

Persistent volume (kept when the app is deleted, unless requested).

object

name

required

string

mount_path

required

string

size

Capacity such as 5Gi. Can grow, never shrink.

string

created_at

string | null

exposure

One of:

null

null

object

Whether the app can be reached through the gateway, apart from whether it runs (null while it has no route).

object

routed

The gateway accepted the route and resolved its references; null until a gateway controller answered.

boolean | null

message

string | null

hosts

required

Array<object>

One hostname of an app.

object

host

required

string

tls

required

auto (certificate from the cluster issuer), secret (the app’s own certificate) or none (plain HTTP).

string

certificate_ready

For auto hosts with a certificate of their own: whether it is issued.

boolean | null

certificate_message

string | null

paused

Why delivery is paused, while it is: new runs wait.

string | null

Example

{
  "env": [
    {
      "name": "LOG_LEVEL"
    }
  ],
  "volumes": [
    {
      "name": "data",
      "mount_path": "/data",
      "size": "5Gi"
    }
  ]
}

403

Media typeapplication/json

Problem Details body.

object

code

required

Stable machine-readable code, e.g. forbidden.

string

title

required

Short human readable title.

string

status

required

HTTP status.

integer format: int32

detail

Details, if safe to expose.

string | null

Example

{
  "code": "forbidden"
}

404

Media typeapplication/json

Problem Details body.

object

code

required

Stable machine-readable code, e.g. forbidden.

string

title

required

Short human readable title.

string

status

required

HTTP status.

integer format: int32

detail

Details, if safe to expose.

string | null

Example

{
  "code": "forbidden"
}

409

Media typeapplication/json

Problem Details body.

object

code

required

Stable machine-readable code, e.g. forbidden.

string

title

required

Short human readable title.

string

status

required

HTTP status.

integer format: int32

detail

Details, if safe to expose.

string | null

Example

{
  "code": "forbidden"
}

422

Media typeapplication/json

Problem Details body.

object

code

required

Stable machine-readable code, e.g. forbidden.

string

title

required

Short human readable title.

string

status

required

HTTP status.

integer format: int32

detail

Details, if safe to expose.

string | null

Example

{
  "code": "forbidden"
}