Skip to content
Updawg

`POST /v1/orgs/{org}/proposals/{proposal_id}/snooze`.

POST
/v1/orgs/{org}/proposals/{proposal_id}/snooze
curl --request POST \
  --url https://api.updawg.net/v1/orgs/example/proposals/example/snooze \
  --header 'Content-Type: application/json' \
  --data '{ "until": "2026-04-15T12:00:00Z" }'

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
org
required
string

Organization slug.

proposal_id
required
string

The prp_… id.

Request Bodyrequired

Section titled “Request Bodyrequired”
Media typeapplication/json
object
until
required

RFC 3339, as every other timestamp this API takes or gives.

string format: date-time
Examplegenerated
{
  "until": "2026-04-15T12:00:00Z"
}

Responses

Section titled “Responses”

200

Section titled “200”

Snoozed until the time given.

Media typeapplication/json

The body every one of the three answers with.

Named for what it is rather than for the endpoint, because all three return it and a portal that has just clicked a button wants the same three facts whichever button it was: where the proposal is now, and how the approval count stands.

object
approvals
required

Distinct people who have approved. A rejected proposal keeps the count it had: it is a record of who had agreed before somebody said no.

integer format: int64
id
required
string
outstanding
required

How many more approvals this needs before it can go ahead.

Zero once there are enough, and zero once there is nothing left to go ahead with — see [ok].

integer format: int64
required
required

What the policy asked for, via proposals.required_approvals.

integer format: int64
scheduled_for

When a proposal that is scheduled may start (DAWG-92).

Present only on that status, and omitted rather than null everywhere else: it is not “unknown”, it is “does not apply”, and a portal that renders a date field will render something for a null.

string | null format: date-time
status
required
string
Examplegenerated
{
  "approvals": 1,
  "id": "example",
  "outstanding": 1,
  "required": 1,
  "scheduled_for": "2026-04-15T12:00:00Z",
  "status": "example"
}

400

Section titled “400”

A time in the past.

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

403

Section titled “403”

An operator’s, deliberately: taking a proposal off the dashboard for a month is the same power as rejecting it without the audit trail saying no.

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

409

Section titled “409”

No longer yours to decide.

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