Skip to content

`GET /v1/orgs/{org}/releases`.

GET
/v1/orgs/{org}/releases
curl --request GET \
--url https://api.updawg.net/v1/orgs/example/releases
org
required
string

Organization slug.

Every release the fleet runs, what it can move to, and the plans to.

Media typeapplication/json

Every release the fleet runs.

object
releases
required

By distribution, oldest release first.

Array
object
codename
string | null
distro
required

As distro on a host: debian, ubuntu.

string
eol_active

End of ordinary vendor support, where a community or paid tier follows it.

string | null format: date
eol_extended

End of extended (often paid) support.

string | null format: date
eol_standard

End of security support.

string | null format: date
is_lts
required
boolean
released_on
string | null format: date
version
required

13, 24.04.

string
hosts
required

Hosts in the fleet running it.

integer format: int64
plans
required

Release upgrades from it that have not finished, newest first.

Array<object>

An unfinished release upgrade, and where its hosts stand.

object
group
One of:

The group it was planned for. Absent for every host on the release.

object
id
required
string
name
required
string
hosts
required

Hosts it targets that are still in the fleet.

integer format: int64
number
required
integer format: int32
preflight
required

How many hosts stand where after their current preflight.

object
blocked
required

A check failed.

integer format: int64
no_answer
required

Finished without checks: refused by the agent, failed or expired.

integer format: int64
not_run
required

No preflight signed for it yet.

integer format: int64
ready
required

Every check passed.

integer format: int64
running
required

Signed and not answered.

integer format: int64
warnings
required

Nothing failed, something warned.

integer format: int64
proposal_id
required

The prp_… id of its proposal.

string
status
required
string
stuck
required

Each host a check failed on, or that finished without answering, and why.

Array<object>
object
failing
required

The checks that failed.

Array<object>
object
items
required

The specifics: a package, a file, a module.

Array<string>
name
required

Stable, for code: disk_space, held_packages, modified_conffiles, dkms_modules, snapshot, reboot, for a package change approved_only, and for a release upgrade release_upgrade and third_party_repos. A newer agent may add more.

string
status
required

pass, warn or fail.

string
summary
required

One sentence for a person, saying what to do when it is not a pass.

string
host_id
required
string
hostname
required
string
problem

Why there was no answer.

string | null
standing
required

blocked or no_answer.

string
to_version
required

The target, by version.

string
targets
required

Releases it can be upgraded to, oldest first.

Array<object>
object
codename
string | null
distro
required

As distro on a host: debian, ubuntu.

string
eol_active

End of ordinary vendor support, where a community or paid tier follows it.

string | null format: date
eol_extended

End of extended (often paid) support.

string | null format: date
eol_standard

End of security support.

string | null format: date
is_lts
required
boolean
released_on
string | null format: date
version
required

13, 24.04.

string
unresolved_hosts
required

Hosts not resolved to a known release yet. No plan can name them.

integer format: int64
Examplegenerated
{
"releases": [
{
"codename": "example",
"distro": "example",
"eol_active": "2026-04-15",
"eol_extended": "2026-04-15",
"eol_standard": "2026-04-15",
"is_lts": true,
"released_on": "2026-04-15",
"version": "example",
"hosts": 1,
"plans": [
{
"group": {
"id": "example",
"name": "example"
},
"hosts": 1,
"number": 1,
"preflight": {
"blocked": 1,
"no_answer": 1,
"not_run": 1,
"ready": 1,
"running": 1,
"warnings": 1
},
"proposal_id": "example",
"status": "example",
"stuck": [
{
"failing": [
{
"items": [
"example"
],
"name": "example",
"status": "example",
"summary": "example"
}
],
"host_id": "example",
"hostname": "example",
"problem": "example",
"standing": "example"
}
],
"to_version": "example"
}
],
"targets": [
{
"codename": "example",
"distro": "example",
"eol_active": "2026-04-15",
"eol_extended": "2026-04-15",
"eol_standard": "2026-04-15",
"is_lts": true,
"released_on": "2026-04-15",
"version": "example"
}
]
}
],
"unresolved_hosts": 1
}

No session.

Media typeapplication/json
object
detail
string | null
status
required
integer format: int32
title
required
string
type
required
string
Examplegenerated
{
"detail": "example",
"status": 1,
"title": "example",
"type": "example"
}

Not permitted.

Media typeapplication/json
object
detail
string | null
status
required
integer format: int32
title
required
string
type
required
string
Examplegenerated
{
"detail": "example",
"status": 1,
"title": "example",
"type": "example"
}

No such organization, or not yours.

Media typeapplication/json
object
detail
string | null
status
required
integer format: int32
title
required
string
type
required
string
Examplegenerated
{
"detail": "example",
"status": 1,
"title": "example",
"type": "example"
}

Over the organization’s request limit. Retry-After says when to try again; RateLimit-Limit is the burst.

Media typeapplication/json
object
detail
string | null
status
required
integer format: int32
title
required
string
type
required
string
Examplegenerated
{
"detail": "example",
"status": 1,
"title": "example",
"type": "example"
}