Skip to content
Updawg

`GET /v1/orgs/{org}/proposals/{proposal_id}/comments`.

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

Oldest first. The most recent [db::comments::PAGE] of them, with total saying how many there are — see that constant for why it is the recent end rather than the first page.

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 thread, oldest first — the most recent page of it, with total saying how many there are.

Media typeapplication/json
object
comments
required
Array<object>
object
author
required
object
email
required
string
id
required
string
name
string | null
body
required
string
id
required
string
mentions
required

Who this comment addressed, as resolved when it was written.

Always present, empty when there were none, because a portal that has to tell null from [] will get it wrong once.

Array<object>
object
email
required
string
id
required
string
name
string | null
written_at
required
string format: date-time
total
required

Every comment on the proposal, including any outside this page.

integer format: int64
Examplegenerated
{
  "comments": [
    {
      "author": {
        "email": "example",
        "id": "example",
        "name": "example"
      },
      "body": "example",
      "id": "example",
      "mentions": [
        {
          "email": "example",
          "id": "example",
          "name": "example"
        }
      ],
      "written_at": "2026-04-15T12:00:00Z"
    }
  ],
  "total": 1
}

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

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