social.colibri.beta.notification.updateSeen Documentation (EN)

main procedure

Marks every notification raised at or before a point in time seen.

Input

Encodingapplication/json

seenAt stringdatetime Required

Notifications raised at or before this time are marked seen.

Output

Encodingapplication/json

unread integer Required

Number of unread notifications remaining.

Errors

AuthRequired The request has no valid service auth.

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://bsky.social)

Request Body (JSON) Enter valid JSON for the request body

View raw schema

{
  "type": "procedure",
  "input": {
    "schema": {
      "type": "object",
      "required": [
        "seenAt"
      ],
      "properties": {
        "seenAt": {
          "type": "string",
          "format": "datetime",
          "description": "Notifications raised at or before this time are marked seen."
        }
      }
    },
    "encoding": "application/json"
  },
  "errors": [
    {
      "name": "AuthRequired",
      "description": "The request has no valid service auth."
    }
  ],
  "output": {
    "schema": {
      "type": "object",
      "required": [
        "unread"
      ],
      "properties": {
        "unread": {
          "type": "integer",
          "description": "Number of unread notifications remaining."
        }
      }
    },
    "encoding": "application/json"
  },
  "description": "Marks every notification raised at or before a point in time seen."
}