`GET /v1/orgs/{org}/proposals/{proposal_id}/rollout`.
const url = 'https://api.updawg.net/v1/orgs/example/proposals/example/rollout';const options = {method: 'GET'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url https://api.updawg.net/v1/orgs/example/proposals/example/rolloutParameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”Organization slug.
The prp_… id.
Responses
Section titled “Responses”The stages and their hosts. strategy is null, with no stages, when the rule named no rollout and every host goes at once.
object
Why it halted, in words, when it did.
In order. A stage may have no hosts: a canary stage with no canaries.
object
The policy says approval: required: this stage waits for a person to promote it once the stage before it is done (DAWG-353).
object
Its current job’s status, or null before it has one.
How long to wait after this stage before the next. Null for none.
When its soak ends, while it soaks.
Null until the rollout starts; then pending, awaiting_promotion (waiting for a person to promote it), running, soaking, completed, halted or cancelled.
Null until it starts; then running, soaking, halted, completed or cancelled.
The rollout’s name in the policy, or null for every host at once.
Example generated
{ "halt_on": { "failed_health_checks": 1, "failed_jobs": 1 }, "halt_reason": "example", "stages": [ { "approval": true, "finished_at": "2026-04-15T12:00:00Z", "hosts": [ { "display_name": "example", "hostname": "example", "id": "example", "job": "example" } ], "name": "example", "soak_seconds": 1, "soak_until": "2026-04-15T12:00:00Z", "started_at": "2026-04-15T12:00:00Z", "status": "example" } ], "status": "example", "strategy": "example"}No session.
object
Example generated
{ "detail": "example", "status": 1, "title": "example", "type": "example"}No such proposal here.
object
Example generated
{ "detail": "example", "status": 1, "title": "example", "type": "example"}The organization’s data is in another region (wrong-region, DAWG-159). detail names that region’s API; send the request there.
object
Example generated
{ "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.
object
Example generated
{ "detail": "example", "status": 1, "title": "example", "type": "example"}