Skip to content
Updawg

A proposal's rollback: whether one can be asked for, and exactly what it does to each host (DAWG-120). What the portal's confirmation says.

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

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
org
required
string

Organization slug.

proposal_id
required
string

The prp_… id.

Responses

Section titled “Responses”

200

Section titled “200”

The rollback, asked for or not.

Media typeapplication/json

A proposal’s rollback.

object
blocked

Why one cannot be asked for now. Absent when it can, or when it has been.

string | null
hosts
required

The hosts it restores, each to the snapshot it took before this proposal changed it.

Array<object>
object
host_id
required
string
hostname
required
string
job_status

The rollback job’s status once it is signed: queued, delivered, running, succeeded, failed, rejected_by_host, expired.

string | null
snapshot_id
required
string
requested
One of:

Who asked, and when. Absent until somebody does.

object
at
required
string format: date-time
by
required

The usr_… id.

string
email
required
string
name
string | null
skipped
required

Hosts the proposal changed that it cannot restore, and why.

Array<object>
object
host_id
required
string
hostname
required
string
reason
required
string
Examplegenerated
{
  "blocked": "example",
  "hosts": [
    {
      "host_id": "example",
      "hostname": "example",
      "job_status": "example",
      "snapshot_id": "example"
    }
  ],
  "requested": {
    "at": "2026-04-15T12:00:00Z",
    "by": "example",
    "email": "example",
    "name": "example"
  },
  "skipped": [
    {
      "host_id": "example",
      "hostname": "example",
      "reason": "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 proposal here.

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