List Agreement Comments

GET /agreements/{agreement_ref}/comments

Returns a paginated canonical comment collection scoped to an agreement.

Conventions

Authentication

All endpoints require a Bearer token. Pass it in the Authorization header as Bearer <token>. Tokens are issued from the API settings page in your workspace.

Base URL

All paths are relative to https://api.allsign.app. The spec includes full paths; strip the base when constructing requests.

Versioning

The current version is 0.1.0. Breaking changes are documented in the Changelog and announced before taking effect.

Specification

The API follows OpenAPI Specification 3.x. All documentation on this page is generated directly from the spec.

Example

Bash

curl "https://api.allsign.app/agreements/{agreement_ref}/comments" \
  -H "Authorization: Bearer {token}"

Request

Request Path

agreement_ref

Public agreement reference.

stringrequired

Parameters

Query

page

One-based page number.

integer = 1optional

page_size

Maximum number of records returned per page.

integer = 20optional

Responses

200 OK

Paginated agreement comment list.

{
  "data": {
    "comments": [
      {
        "actor": {
          "avatar_url": "",
          "name": "",
          "ref": "00000000-0000-4000-8000-000000000000"
        },
        "content": "",
        "created_at": "2026-01-01T00:00:00Z",
        "on_revision": true,
        "ref": "00000000-0000-4000-8000-000000000000",
        "revision": {},
        "section": {},
        "term": {}
      }
    ]
  }
}

data

Standard paginated collection metadata.

objectrequired

data.comments

object[]required

data.comments[].actor

Actor identity attached to a comment.

objectrequired

data.comments[].actor.avatar_url

stringnullrequired

data.comments[].actor.name

stringrequired

data.comments[].actor.ref

string,null (uuid)required

data.comments[].content

stringrequired

data.comments[].created_at

string (date-time)required

data.comments[].on_revision

booleanrequired

data.comments[].ref

Public stable resource reference.

string (uuid)required

data.comments[].revision

objectrequired

data.comments[].section

objectrequired

data.comments[].term

objectrequired

401 Unauthorized

{
  "error": {
    "code": "",
    "message": "",
    "request_id": "",
    "status": 1
  }
}

error

objectrequired

error.code

stringrequired

error.message

stringrequired

error.request_id

stringrequired

error.status

integerrequired

error.fields

object[]optional

404 Not Found

{
  "error": {
    "code": "",
    "message": "",
    "request_id": "",
    "status": 1
  }
}

error

objectrequired

error.code

stringrequired

error.message

stringrequired

error.request_id

stringrequired

error.status

integerrequired

error.fields

object[]optional