Skip to content
Updawg

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

POST
/v1/orgs/{org}/proposals/{proposal_id}/reject
curl --request POST \
  --url https://api.updawg.net/v1/orgs/example/proposals/example/reject \
  --header 'Content-Type: application/json' \
  --data '{ "reason": "example" }'

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
reason

Option so that a missing field reaches Reason::parse rather than axum’s body rejection — see the note in [reject]. It is still required; what is optional is which of the three ways of not sending it the caller chose.

string | null
Examplegenerated
{
  "reason": "example"
}

Responses

Section titled “Responses”

200

Section titled “200”

Rejected.

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 reason is required and must not be blank.

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”

Not permitted for this role.

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