dev.knotless.putPreferences

lexicons.knotless.dev

Documentation

Changes the asking account's preferences, as the appview keeps them: each one given takes the place of the one of its kind, and the rest stay. Answers them all, as dev.knotless.getPreferences does. Requires authentication: a service token, or the session cookie the pages' login sets, from the pages themselves.

main procedure

Changes the asking account's preferences, as the appview keeps them: each one given takes the place of the one of its kind, and the rest stay. Answers them all, as dev.knotless.getPreferences does. Requires authentication: a service token, or the session cookie the pages' login sets, from the pages themselves.

Input

Encodingapplication/json
preferences array Required

The preferences to set, at most one of each kind.

maxLength: 32 items

Output

Encodingapplication/json
Schemadev.knotless.getPreferences#preferences

Errors

InvalidRequest A kind of preference the appview does not keep, or one not as its kind says: a theme not named as the pages name theirs, or a reason the appview does not give.
AuthenticationRequired No account asks.
NotFound This appview keeps no index, so it keeps no preferences.
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": "Changes the asking account's preferences, as the appview keeps them: each one given takes the place of the one of its kind, and the rest stay. Answers them all, as dev.knotless.getPreferences does. Requires authentication: a service token, or the session cookie the pages' login sets, from the pages themselves.",
  "errors": [
    {
      "description": "A kind of preference the appview does not keep, or one not as its kind says: a theme not named as the pages name theirs, or a reason the appview does not give.",
      "name": "InvalidRequest"
    },
    {
      "description": "No account asks.",
      "name": "AuthenticationRequired"
    },
    {
      "description": "This appview keeps no index, so it keeps no preferences.",
      "name": "NotFound"
    }
  ],
  "input": {
    "encoding": "application/json",
    "schema": {
      "properties": {
        "preferences": {
          "description": "The preferences to set, at most one of each kind.",
          "items": {
            "refs": [
              "dev.knotless.getPreferences#appearancePref",
              "dev.knotless.getPreferences#notificationPref"
            ],
            "type": "union"
          },
          "maxLength": 32,
          "type": "array"
        }
      },
      "required": [
        "preferences"
      ],
      "type": "object"
    }
  },
  "output": {
    "encoding": "application/json",
    "schema": {
      "ref": "dev.knotless.getPreferences#preferences",
      "type": "ref"
    }
  },
  "type": "procedure"
}

Lexicon Garden

@