social.colibri.beta.notification.clear

colibri.social

Documentation

Clears the requesting user's inbox up to a point in time. Every notification raised at or before it is marked seen and left out of listNotifications, getUnreadCount and getUnseen from then on.

main procedure

Clears the requesting user's inbox up to a point in time. Every notification raised at or before it is marked seen and left out of listNotifications, getUnreadCount and getUnseen from then on.

Input

Encodingapplication/json
clearedAt stringdatetime Required

Notifications raised at or before this time are cleared. A time in the future is treated as now, and a time before an earlier clear leaves that clear in place.

Output

Encodingapplication/json
clearedAt stringdatetime Required

The point the inbox is now cleared up to.

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.

Base URL for XRPC calls (e.g., https://bsky.social)
Enter valid JSON for the request body
View raw schema
{
  "description": "Clears the requesting user's inbox up to a point in time. Every notification raised at or before it is marked seen and left out of listNotifications, getUnreadCount and getUnseen from then on.",
  "errors": [
    {
      "description": "The request has no valid service auth.",
      "name": "AuthRequired"
    }
  ],
  "input": {
    "encoding": "application/json",
    "schema": {
      "properties": {
        "clearedAt": {
          "description": "Notifications raised at or before this time are cleared. A time in the future is treated as now, and a time before an earlier clear leaves that clear in place.",
          "format": "datetime",
          "type": "string"
        }
      },
      "required": [
        "clearedAt"
      ],
      "type": "object"
    }
  },
  "output": {
    "encoding": "application/json",
    "schema": {
      "properties": {
        "clearedAt": {
          "description": "The point the inbox is now cleared up to.",
          "format": "datetime",
          "type": "string"
        },
        "unread": {
          "description": "Number of unread notifications remaining.",
          "type": "integer"
        }
      },
      "required": [
        "clearedAt",
        "unread"
      ],
      "type": "object"
    }
  },
  "type": "procedure"
}

Lexicon Garden

@