pub.chive.annotation.listByAuthor Documentation (EN)

main query

List annotations created by a specific author

Parameters

annotatorDid string did Required

DID of the annotator

cursor string Optional

Pagination cursor for next page

limit integer Optional

Maximum number of results to return

motivation string Optional

Filter by annotation motivation

Output

Encodingapplication/json

annotations array Required

List of annotations by the author

cursor string Optional

Cursor for next page

hasMore boolean Required

Whether more results are available

total integer Optional

Total number of annotations by this author

Try It

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

Service Endpoint Base URL for XRPC calls (e.g., https://api.bsky.social)

Parameters

annotatorDid * DID of the annotator

cursor Pagination cursor for next page

limit Maximum number of results to return

motivation Filter by annotation motivation

View raw schema

{
  "type": "query",
  "errors": [],
  "output": {
    "schema": {
      "type": "object",
      "required": [
        "annotations",
        "hasMore"
      ],
      "properties": {
        "total": {
          "type": "integer",
          "description": "Total number of annotations by this author"
        },
        "cursor": {
          "type": "string",
          "description": "Cursor for next page"
        },
        "hasMore": {
          "type": "boolean",
          "description": "Whether more results are available"
        },
        "annotations": {
          "type": "array",
          "items": {
            "ref": "pub.chive.annotation.listForEprint#annotationView",
            "type": "ref"
          },
          "description": "List of annotations by the author"
        }
      }
    },
    "encoding": "application/json"
  },
  "parameters": {
    "type": "params",
    "required": [
      "annotatorDid"
    ],
    "properties": {
      "limit": {
        "type": "integer",
        "default": 50,
        "maximum": 100,
        "minimum": 1,
        "description": "Maximum number of results to return"
      },
      "cursor": {
        "type": "string",
        "description": "Pagination cursor for next page"
      },
      "motivation": {
        "type": "string",
        "description": "Filter by annotation motivation",
        "knownValues": [
          "commenting",
          "questioning",
          "highlighting",
          "replying"
        ]
      },
      "annotatorDid": {
        "type": "string",
        "format": "did",
        "description": "DID of the annotator"
      }
    }
  },
  "description": "List annotations created by a specific author"
}