pub.chive.review.listForEprint

lexicons.governance.chive.pub

Documentation

List reviews for a specific eprint with optional filtering

main query

List reviews for a specific eprint with optional filtering

Parameters

cursor string Optional

Pagination cursor for next page

eprintUri string at-uri Required

AT-URI of the eprint

inlineOnly boolean Optional

Only include inline annotations with text span targets

limit integer Optional

Maximum number of results to return

motivation string Optional

Filter by W3C Web Annotation motivation

Output

Encodingapplication/json
cursor string Optional

Cursor for next page

hasMore boolean Required

Whether more results are available

reviews array Required

List of reviews for the eprint

total integer Optional

Total number of reviews for this eprint

Try It

Requests are sent directly from your browser. Some servers may block requests due to CORS.

Base URL for XRPC calls (e.g., https://api.bsky.social)
Parameters
Pagination cursor for next page
AT-URI of the eprint
Only include inline annotations with text span targets
Maximum number of results to return
Filter by W3C Web Annotation motivation
View raw schema 
{
  "description": "List reviews for a specific eprint with optional filtering",
  "errors": [],
  "output": {
    "encoding": "application/json",
    "schema": {
      "properties": {
        "cursor": {
          "description": "Cursor for next page",
          "type": "string"
        },
        "hasMore": {
          "description": "Whether more results are available",
          "type": "boolean"
        },
        "reviews": {
          "description": "List of reviews for the eprint",
          "items": {
            "ref": "#reviewView",
            "type": "ref"
          },
          "type": "array"
        },
        "total": {
          "description": "Total number of reviews for this eprint",
          "type": "integer"
        }
      },
      "required": [
        "reviews",
        "hasMore"
      ],
      "type": "object"
    }
  },
  "parameters": {
    "properties": {
      "cursor": {
        "description": "Pagination cursor for next page",
        "type": "string"
      },
      "eprintUri": {
        "description": "AT-URI of the eprint",
        "format": "at-uri",
        "type": "string"
      },
      "inlineOnly": {
        "default": false,
        "description": "Only include inline annotations with text span targets",
        "type": "boolean"
      },
      "limit": {
        "default": 50,
        "description": "Maximum number of results to return",
        "maximum": 100,
        "minimum": 1,
        "type": "integer"
      },
      "motivation": {
        "description": "Filter by W3C Web Annotation motivation",
        "knownValues": [
          "commenting",
          "highlighting",
          "questioning",
          "replying",
          "assessing",
          "bookmarking",
          "classifying",
          "describing",
          "editing",
          "linking",
          "moderating",
          "tagging"
        ],
        "type": "string"
      }
    },
    "required": [
      "eprintUri"
    ],
    "type": "params"
  },
  "type": "query"
}
authorRef object

No description available.

Properties

avatar string uri Optional

A valid URI.

did string did Required

A decentralized identifier (DID).

displayName string Optional

No description available.

handle string Optional

No description available.

View raw schema 
{
  "properties": {
    "avatar": {
      "format": "uri",
      "type": "string"
    },
    "did": {
      "format": "did",
      "type": "string"
    },
    "displayName": {
      "type": "string"
    },
    "handle": {
      "type": "string"
    }
  },
  "required": [
    "did"
  ],
  "type": "object"
}
reviewView object

View of a review/comment

Properties

author ref #authorRef Required

No description available.

body array of union Optional

Rich text body items

maxLength: 500 items
Known types:
bodyPlainText string Optional

Plain text body for search/preview

cid string Required

Content identifier

content string Required

Plain text content of the review

createdAt string datetime Required

When the review was created

deleted boolean Optional

Whether this review has been deleted (tombstone for thread preservation)

eprintUri string at-uri Required

AT-URI of the eprint being reviewed

indexedAt string datetime Required

When the review was indexed

motivation string Required

W3C Web Annotation motivation

Known values: commenting, highlighting, questioning, replying, assessing, bookmarking, classifying, describing, editing, linking, moderating, tagging
parentReviewUri string at-uri Optional

Parent review URI for threaded replies

replyCount integer Required

Number of direct replies

minimum: 0
target ref #textSpanTarget Optional

Target text span for inline annotations

uri string at-uri Required

Review AT-URI

View raw schema 
{
  "description": "View of a review/comment",
  "properties": {
    "author": {
      "ref": "#authorRef",
      "type": "ref"
    },
    "body": {
      "description": "Rich text body items",
      "items": {
        "refs": [
          "pub.chive.richtext.defs#textItem",
          "pub.chive.richtext.defs#nodeRefItem",
          "pub.chive.richtext.defs#wikidataRefItem",
          "pub.chive.richtext.defs#fieldRefItem",
          "pub.chive.richtext.defs#facetRefItem",
          "pub.chive.richtext.defs#eprintRefItem",
          "pub.chive.richtext.defs#annotationRefItem",
          "pub.chive.richtext.defs#authorRefItem",
          "pub.chive.richtext.defs#mentionItem",
          "pub.chive.richtext.defs#linkItem",
          "pub.chive.richtext.defs#tagItem",
          "pub.chive.richtext.defs#latexItem",
          "pub.chive.richtext.defs#codeBlockItem",
          "pub.chive.richtext.defs#headingItem",
          "pub.chive.richtext.defs#listItem",
          "pub.chive.richtext.defs#blockquoteItem"
        ],
        "type": "union"
      },
      "maxLength": 500,
      "type": "array"
    },
    "bodyPlainText": {
      "description": "Plain text body for search/preview",
      "type": "string"
    },
    "cid": {
      "description": "Content identifier",
      "type": "string"
    },
    "content": {
      "description": "Plain text content of the review",
      "type": "string"
    },
    "createdAt": {
      "description": "When the review was created",
      "format": "datetime",
      "type": "string"
    },
    "deleted": {
      "default": false,
      "description": "Whether this review has been deleted (tombstone for thread preservation)",
      "type": "boolean"
    },
    "eprintUri": {
      "description": "AT-URI of the eprint being reviewed",
      "format": "at-uri",
      "type": "string"
    },
    "indexedAt": {
      "description": "When the review was indexed",
      "format": "datetime",
      "type": "string"
    },
    "motivation": {
      "description": "W3C Web Annotation motivation",
      "knownValues": [
        "commenting",
        "highlighting",
        "questioning",
        "replying",
        "assessing",
        "bookmarking",
        "classifying",
        "describing",
        "editing",
        "linking",
        "moderating",
        "tagging"
      ],
      "type": "string"
    },
    "parentReviewUri": {
      "description": "Parent review URI for threaded replies",
      "format": "at-uri",
      "type": "string"
    },
    "replyCount": {
      "description": "Number of direct replies",
      "minimum": 0,
      "type": "integer"
    },
    "target": {
      "description": "Target text span for inline annotations",
      "ref": "#textSpanTarget",
      "type": "ref"
    },
    "uri": {
      "description": "Review AT-URI",
      "format": "at-uri",
      "type": "string"
    }
  },
  "required": [
    "uri",
    "cid",
    "author",
    "eprintUri",
    "content",
    "motivation",
    "replyCount",
    "createdAt",
    "indexedAt"
  ],
  "type": "object"
}
textPositionSelector object

W3C Text Position Selector with optional page info

Properties

end integer Required

No description available.

minimum: 0
pageNumber integer Optional

Page number in PDF

minimum: 1
start integer Required

No description available.

minimum: 0
type string Required

No description available.

View raw schema 
{
  "description": "W3C Text Position Selector with optional page info",
  "properties": {
    "end": {
      "minimum": 0,
      "type": "integer"
    },
    "pageNumber": {
      "description": "Page number in PDF",
      "minimum": 1,
      "type": "integer"
    },
    "start": {
      "minimum": 0,
      "type": "integer"
    },
    "type": {
      "const": "TextPositionSelector",
      "type": "string"
    }
  },
  "required": [
    "type",
    "start",
    "end"
  ],
  "type": "object"
}
textQuoteSelector object

W3C Text Quote Selector

Properties

exact string Required

No description available.

maxLength: 1000 bytes
prefix string Optional

No description available.

maxLength: 100 bytes
suffix string Optional

No description available.

maxLength: 100 bytes
type string Required

No description available.

View raw schema 
{
  "description": "W3C Text Quote Selector",
  "properties": {
    "exact": {
      "maxLength": 1000,
      "type": "string"
    },
    "prefix": {
      "maxLength": 100,
      "type": "string"
    },
    "suffix": {
      "maxLength": 100,
      "type": "string"
    },
    "type": {
      "const": "TextQuoteSelector",
      "type": "string"
    }
  },
  "required": [
    "type",
    "exact"
  ],
  "type": "object"
}
textSpanTarget object

Target text span for inline annotations (W3C Web Annotation compatible)

Properties

page integer Optional

Page number (deprecated, use refinedBy.pageNumber)

minimum: 1
source string at-uri Required

Eprint AT-URI

View raw schema 
{
  "description": "Target text span for inline annotations (W3C Web Annotation compatible)",
  "properties": {
    "page": {
      "description": "Page number (deprecated, use refinedBy.pageNumber)",
      "minimum": 1,
      "type": "integer"
    },
    "refinedBy": {
      "description": "Position refinement with page info",
      "ref": "#textPositionSelector",
      "type": "ref"
    },
    "selector": {
      "description": "Text quote selector",
      "ref": "#textQuoteSelector",
      "type": "ref"
    },
    "source": {
      "description": "Eprint AT-URI",
      "format": "at-uri",
      "type": "string"
    }
  },
  "required": [
    "source"
  ],
  "type": "object"
}

Lexicon Garden

@