Skip to content

List app releases API Reference

GET
/tenants/{tenant}/apps/{app}/environments/{env}/releases
curl --request GET \
--url https://api.kupe.cloud/api/v1/tenants/example/apps/example/environments/example/releases \
--header 'Authorization: <Authorization>'

List all retained releases for this environment, newest first, with no pagination. Records from an earlier environment with the same name are excluded. The runtime contains configuration and referenced secret names and keys, never fetched secret values. A failed release stays failed after recovery; recovery is reported separately. Available while apps are switched off.

tenant
required
string

Tenant name

app
required
string

App name

env
required
string

Environment name

OK

Media type application/json
object
items
Array<object>
object
chart
object
revision
string
deploymentRevision
integer
name
string
number
integer
runtime
object
args
Array<string>
command
Array<string>
env
Array<object>
object
name
string
value
string
valueFrom
object
secretKeyRef
object
key
string
secret
string
healthChecks
object
liveness
object
http
object
path
string
tcp
object
readiness
object
http
object
path
string
tcp
object
image
string
port
integer
replicas
integer
resources
object
limits
object
cpu
string
memory
string
requests
object
cpu
string
memory
string
secrets
Array<object>
object
keys
Array<string>
name
string
path
string
status
object
completedAt
string
deadlineAt
string
imageDigest
string
message
string
phase
string
reason
string
recovery
object
completedAt
string
deadlineAt
string
phase
string
reason
string
release
object
name
string
startedAt
string
startedAt
string
trigger
string
Example generated
{
"items": [
{
"chart": {
"revision": "example"
},
"deploymentRevision": 1,
"name": "example",
"number": 1,
"runtime": {
"args": [
"example"
],
"command": [
"example"
],
"env": [
{
"name": "example",
"value": "example",
"valueFrom": {
"secretKeyRef": {
"key": "example",
"secret": "example"
}
}
}
],
"healthChecks": {
"liveness": {
"http": {
"path": "example"
},
"tcp": {}
},
"readiness": {
"http": {
"path": "example"
},
"tcp": {}
}
},
"image": "example",
"port": 1,
"replicas": 1,
"resources": {
"limits": {
"cpu": "example",
"memory": "example"
},
"requests": {
"cpu": "example",
"memory": "example"
}
},
"secrets": [
{
"keys": [
"example"
],
"name": "example",
"path": "example"
}
]
},
"status": {
"completedAt": "example",
"deadlineAt": "example",
"imageDigest": "example",
"message": "example",
"phase": "example",
"reason": "example",
"recovery": {
"completedAt": "example",
"deadlineAt": "example",
"phase": "example",
"reason": "example",
"release": {
"name": "example"
},
"startedAt": "example"
},
"startedAt": "example"
},
"trigger": "example"
}
]
}

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"
}

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"
}

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"
}

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"
}

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"
}
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"
}