Skip to content

`POST /v1/orgs/{org}/proposals/{proposal_id}/rollout/promote` (DAWG-353).

POST
/v1/orgs/{org}/proposals/{proposal_id}/rollout/promote
curl --request POST \
--url https://api.updawg.net/v1/orgs/example/proposals/example/rollout/promote

Start the stage that waits for a person, or — while a stage soaks — end the soak now and go on to the next stage, through a gate on it too: the person promoting is that approval. The same move the rollout would make on its own, a person’s, and in the audit log as theirs.

org
required
string

Organization slug.

proposal_id
required
string

The prp_… id.

Promoted.

Media typeapplication/json

What promoting did.

object
outcome
required

started: the waiting stage started. soak_ended: the soak ended and the next stage started. completed: the soak ended and it was the last stage.

string
stage

The stage that started, for started.

string | null

Example generated

{
"outcome": "example",
"stage": "example"
}

No session.

Media typeapplication/json
object
detail
string | null
status
required
integer format: int32
title
required
string
type
required
string

Example generated

{
"detail": "example",
"status": 1,
"title": "example",
"type": "example"
}

Not permitted for this role.

Media typeapplication/json
object
detail
string | null
status
required
integer format: int32
title
required
string
type
required
string

Example generated

{
"detail": "example",
"status": 1,
"title": "example",
"type": "example"
}

No such proposal here.

Media typeapplication/json
object
detail
string | null
status
required
integer format: int32
title
required
string
type
required
string

Example generated

{
"detail": "example",
"status": 1,
"title": "example",
"type": "example"
}

Nothing to promote (wrong-status): no staged rollout, the proposal is not rolling out, or the rollout is neither waiting for a person nor soaking.

Media typeapplication/json
object
detail
string | null
status
required
integer format: int32
title
required
string
type
required
string

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.

Media typeapplication/json
object
detail
string | null
status
required
integer format: int32
title
required
string
type
required
string

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.

Media typeapplication/json
object
detail
string | null
status
required
integer format: int32
title
required
string
type
required
string

Example generated

{
"detail": "example",
"status": 1,
"title": "example",
"type": "example"
}