Retry an app environment API Reference

POST

/tenants/{tenant}/apps/{app}/environments/{env}/retry

curl --request POST \
  --url https://api.kupe.cloud/api/v1/tenants/example/apps/example/environments/example/retry \
  --header 'Authorization: <Authorization>'

Deploy the environment’s current configuration again. Accepts no body or an empty JSON object. Send If-Match with the environment’s ETag so the retry is refused if the environment changed since you read it. A retry while deploying supersedes that request; the latest request wins. Answers 404 while the platform has apps switched off. Poll GET .../environments/{env} until status.requestedRelease names a release whose deploymentRevision matches the returned value; GET .../environments/{env}/releases provides that release’s revision. Then wait until status.deployment names that release and its phase is Succeeded or Failed. Recovery does not turn the failed requested release into a success.

Authorizations

• BearerAuth

Parameters

Path Parameters

tenant

required

string

Tenant name

app

required

string

App name

env

required

string

Environment name

Header Parameters

If-Match

string

ETag from the environment read

Responses

202

Accepted

Media type application/json

object

app

string

deploymentRevision

integer

environment

string

generation

integer

Example ^generated

{
  "app": "example",
  "deploymentRevision": 1,
  "environment": "example",
  "generation": 1
}

Headers

ETag

string

UID and spec generation

400

Bad Request

Media type application/json

object

code

string

error

string

field

string

message

string

severity

string

Example ^generated

{
  "code": "example",
  "error": "example",
  "field": "example",
  "message": "example",
  "severity": "example"
}

401

Unauthorized

Media type application/json

object

code

string

error

string

field

string

message

string

severity

string

Example ^generated

{
  "code": "example",
  "error": "example",
  "field": "example",
  "message": "example",
  "severity": "example"
}

403

Forbidden

Media type application/json

object

code

string

error

string

field

string

message

string

severity

string

Example ^generated

{
  "code": "example",
  "error": "example",
  "field": "example",
  "message": "example",
  "severity": "example"
}

404

Not Found

Media type application/json

object

code

string

error

string

field

string

message

string

severity

string

Example ^generated

{
  "code": "example",
  "error": "example",
  "field": "example",
  "message": "example",
  "severity": "example"
}

409

Conflict

Media type application/json

object

code

string

error

string

field

string

message

string

severity

string

Example ^generated

{
  "code": "example",
  "error": "example",
  "field": "example",
  "message": "example",
  "severity": "example"
}

412

Precondition Failed

Media type application/json

object

code

string

error

string

field

string

message

string

severity

string

Example ^generated

{
  "code": "example",
  "error": "example",
  "field": "example",
  "message": "example",
  "severity": "example"
}

413

Request Entity Too Large

Media type application/json

object

code

string

error

string

field

string

message

string

severity

string

Example ^generated

{
  "code": "example",
  "error": "example",
  "field": "example",
  "message": "example",
  "severity": "example"
}

429

Too Many Requests

Media type application/json

object

code

string

error

string

field

string

message

string

severity

string

Example ^generated

{
  "code": "example",
  "error": "example",
  "field": "example",
  "message": "example",
  "severity": "example"
}

500

Media type application/json

object

code

string

error

string

field

string

message

string

severity

string

Example ^generated

{
  "code": "example",
  "error": "example",
  "field": "example",
  "message": "example",
  "severity": "example"
}