Skip to content
Updawg

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

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

Newest first, at most 200. Query pairs rather than a struct, and an unknown parameter or status refused, for the reasons proposals::list gives: a list quietly not filtered as asked is the failure worth refusing.

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
org
required
string

Organization slug.

Query Parameters

Section titled “Query Parameters”
status
Array<string>

Repeatable. Omitted means every status.

Responses

Section titled “Responses”

200

Section titled “200”

Newest first, at most 200.

Media typeapplication/json
object
rollouts
required
Array<object>

One rollout, for the Rollouts page.

object
current_stage

The stage it is in, or stopped in.

string | null
failed
required

Hosts whose current job failed, was refused or expired.

integer format: int64
finished_at
string | null format: date-time
halt_reason
string | null
hosts
required
integer format: int64
number
required
integer format: int32
proposal_id
required

The prp_… id of the proposal it carries out.

string
proposal_status
required
string
staged
required

In stages, by a strategy the rule named. false: every host at once, one stage with no name.

boolean
stages
required
integer format: int64
started_at
required
string format: date-time
status
required

Running, soaking, halted, completed or cancelled.

string
strategy
required

The rollout’s name in the policy; empty for one that is not staged.

string
succeeded
required

Hosts whose current job succeeded.

integer format: int64
title
required
string
Examplegenerated
{
  "rollouts": [
    {
      "current_stage": "example",
      "failed": 1,
      "finished_at": "2026-04-15T12:00:00Z",
      "halt_reason": "example",
      "hosts": 1,
      "number": 1,
      "proposal_id": "example",
      "proposal_status": "example",
      "staged": true,
      "stages": 1,
      "started_at": "2026-04-15T12:00:00Z",
      "status": "example",
      "strategy": "example",
      "succeeded": 1,
      "title": "example"
    }
  ]
}

400

Section titled “400”

An unknown status or parameter.

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

401

Section titled “401”

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

404

Section titled “404”

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

429

Section titled “429”

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