dev.knotless.listNotifications

{
  "$type": "com.atproto.lexicon.schema",
  "defs": {
    "main": {
      "description": "What others did that concerns the account asking, as the appview has indexed it, the latest first: stars of its repositories, follows of it, pulls and issues opened on its repositories, and comments and reviews on its pulls and issues, and on those it commented on, after it did. Leaves out its own doings, and accounts it blocked or that are taken down. Those of a private repository come from the appview's own index of its space, where its owner lets it keep one, while the account can read it. Requires authentication: a service token, or the session cookie the pages' login sets.",
      "errors": [
        {
          "description": "No account asks.",
          "name": "AuthenticationRequired"
        }
      ],
      "output": {
        "encoding": "application/json",
        "schema": {
          "properties": {
            "cursor": {
              "description": "Absent on the last page.",
              "type": "string"
            },
            "notifications": {
              "items": {
                "ref": "#notification",
                "type": "ref"
              },
              "type": "array"
            },
            "seenAt": {
              "description": "When the account last said it had seen its notifications, if ever.",
              "format": "datetime",
              "type": "string"
            }
          },
          "required": [
            "notifications"
          ],
          "type": "object"
        }
      },
      "parameters": {
        "properties": {
          "cursor": {
            "description": "Where the page before ended.",
            "maxLength": 512,
            "type": "string"
          },
          "limit": {
            "default": 50,
            "maximum": 100,
            "minimum": 1,
            "type": "integer"
          }
        },
        "type": "params"
      },
      "type": "query"
    },
    "notification": {
      "description": "One thing another account did that concerns the asker.",
      "properties": {
        "author": {
          "ref": "dev.knotless.defs#actorView",
          "type": "ref"
        },
        "createdAt": {
          "format": "datetime",
          "type": "string"
        },
        "isRead": {
          "description": "Whether it is from before the asker last saw its notifications.",
          "type": "boolean"
        },
        "reason": {
          "description": "What it did: starred the asker's repository, followed the asker, opened a pull or an issue on its repository, or commented on its pull or issue, or on one it commented on.",
          "knownValues": [
            "star",
            "follow",
            "pull",
            "issue",
            "comment"
          ],
          "type": "string"
        },
        "reasonSubject": {
          "description": "For a comment, the pull or issue it is on.",
          "format": "at-uri",
          "type": "string"
        },
        "repo": {
          "description": "The repository it is about, under the name it has now, if any.",
          "ref": "dev.knotless.defs#repoViewBasic",
          "type": "ref"
        },
        "title": {
          "description": "The title of the pull or issue it is, or is on.",
          "type": "string"
        },
        "uri": {
          "description": "The record it wrote: a star, a follow, a pull, an issue or a comment.",
          "format": "at-uri",
          "type": "string"
        },
        "verdict": {
          "description": "For a comment that reviews a pull, what it found: `approve`, or `changes` to ask for changes.",
          "knownValues": [
            "approve",
            "changes"
          ],
          "type": "string"
        }
      },
      "required": [
        "uri",
        "author",
        "reason",
        "isRead",
        "createdAt"
      ],
      "type": "object"
    }
  },
  "description": "What others did that concerns the account asking.",
  "id": "dev.knotless.listNotifications",
  "lexicon": 1
}