pub.chive.review.getThread

chive.pub View official

Documentation

Get a review thread including the root review and all replies

main query

Get a review thread including the root review and all replies

Parameters

uri string at-uri Required

AT-URI of the root review

Output

Encodingapplication/json
parent ref#reviewView Required

Root review of the thread

replies array Required

Direct replies to the root review

totalReplies integer Required

Total number of replies in the thread

Errors

NotFound Review not found
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
AT-URI of the root review
View raw schema 
{
  "description": "Get a review thread including the root review and all replies",
  "errors": [
    {
      "description": "Review not found",
      "name": "NotFound"
    }
  ],
  "output": {
    "encoding": "application/json",
    "schema": {
      "properties": {
        "parent": {
          "description": "Root review of the thread",
          "ref": "#reviewView",
          "type": "ref"
        },
        "replies": {
          "description": "Direct replies to the root review",
          "items": {
            "ref": "#reviewView",
            "type": "ref"
          },
          "type": "array"
        },
        "totalReplies": {
          "description": "Total number of replies in the thread",
          "minimum": 0,
          "type": "integer"
        }
      },
      "required": [
        "parent",
        "replies",
        "totalReplies"
      ],
      "type": "object"
    }
  },
  "parameters": {
    "properties": {
      "uri": {
        "description": "AT-URI of the root review",
        "format": "at-uri",
        "type": "string"
      }
    },
    "required": [
      "uri"
    ],
    "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

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

@