{
  "components": {
    "schemas": {
      "AbuseAction": {
        "enum": [
          "dismiss",
          "hide",
          "warn",
          "ban"
        ],
        "type": "string"
      },
      "AbuseTargetType": {
        "enum": [
          "public_list",
          "profile",
          "comment"
        ],
        "type": "string"
      },
      "AcceptTerms": {
        "description": "Body of `POST /users/me/terms`.",
        "properties": {
          "terms_version": {
            "description": "Must equal `legal::TERMS_VERSION`.",
            "type": "string"
          }
        },
        "required": [
          "terms_version"
        ],
        "type": "object"
      },
      "ApiKeyView": {
        "description": "Public key metadata (never includes the secret).",
        "properties": {
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "last_used_at": {
            "format": "date-time",
            "type": [
              "string",
              "null"
            ]
          },
          "name": {
            "type": "string"
          },
          "prefix": {
            "type": "string"
          },
          "revoked_at": {
            "format": "date-time",
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "id",
          "name",
          "prefix",
          "created_at"
        ],
        "type": "object"
      },
      "AuthorizeRequest": {
        "properties": {
          "code_challenge": {
            "type": "string"
          },
          "code_challenge_method": {
            "type": [
              "string",
              "null"
            ]
          },
          "extension_origin": {
            "description": "The extension's base address, `chrome-extension://<id>/` or `moz-extension://<uuid>/`.",
            "type": "string"
          },
          "state": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "extension_origin",
          "code_challenge"
        ],
        "type": "object"
      },
      "BookmarkIdsResponse": {
        "properties": {
          "ids": {
            "items": {
              "format": "uuid",
              "type": "string"
            },
            "type": "array"
          }
        },
        "required": [
          "ids"
        ],
        "type": "object"
      },
      "BookmarkListResponse": {
        "properties": {
          "items": {
            "items": {
              "$ref": "#/components/schemas/BookmarkView"
            },
            "type": "array"
          },
          "next_cursor": {
            "type": [
              "string",
              "null"
            ]
          },
          "total": {
            "format": "int64",
            "type": "integer"
          }
        },
        "required": [
          "items",
          "total"
        ],
        "type": "object"
      },
      "BookmarkView": {
        "properties": {
          "can_write": {
            "description": "Whether the requesting user may mutate this bookmark.",
            "type": "boolean"
          },
          "categories": {
            "items": {
              "$ref": "#/components/schemas/CategoryRef"
            },
            "type": "array"
          },
          "category_id": {
            "description": "Primary / first category (legacy + export). Prefer `categories`.",
            "format": "uuid",
            "type": [
              "string",
              "null"
            ]
          },
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "deleted_at": {
            "format": "date-time",
            "type": [
              "string",
              "null"
            ]
          },
          "description": {
            "type": [
              "string",
              "null"
            ]
          },
          "favicon_url": {
            "type": [
              "string",
              "null"
            ]
          },
          "has_preview": {
            "type": "boolean"
          },
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "is_favorite": {
            "description": "Per-viewer flags (reading list / favorites / pin).",
            "type": "boolean"
          },
          "is_pinned": {
            "type": "boolean"
          },
          "is_private": {
            "type": "boolean"
          },
          "is_unread": {
            "type": "boolean"
          },
          "is_vault": {
            "type": "boolean"
          },
          "link_check_error": {
            "type": [
              "string",
              "null"
            ]
          },
          "link_check_status": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/LinkCheckStatus",
                "description": "`ok` / `broken` / `unreachable` / `unverifiable` — absent until first check."
              },
              {
                "type": "null"
              }
            ]
          },
          "link_check_status_code": {
            "format": "int32",
            "type": [
              "integer",
              "null"
            ]
          },
          "link_checked_at": {
            "format": "date-time",
            "type": [
              "string",
              "null"
            ]
          },
          "notes": {
            "type": [
              "string",
              "null"
            ]
          },
          "owner_display_name": {
            "description": "Present for invitees — owner's display name (or email local-part).",
            "type": [
              "string",
              "null"
            ]
          },
          "owner_user_id": {
            "format": "uuid",
            "type": "string"
          },
          "preview_image_url": {
            "type": [
              "string",
              "null"
            ]
          },
          "shared_out": {
            "description": "Owner has shared a folder this bookmark lives in (invitees see invitee badges instead).",
            "type": "boolean"
          },
          "shared_with": {
            "description": "Owner-only: invitee display labels for the outgoing share pill tooltip.",
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "tags": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "title": {
            "type": "string"
          },
          "updated_at": {
            "format": "date-time",
            "type": "string"
          },
          "url": {
            "type": "string"
          },
          "vault_id": {
            "format": "uuid",
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "id",
          "owner_user_id",
          "categories",
          "url",
          "title",
          "has_preview",
          "is_private",
          "is_vault",
          "tags",
          "can_write",
          "created_at",
          "updated_at"
        ],
        "type": "object"
      },
      "CategoryAccess": {
        "description": "Effective access for the current user on a category.",
        "enum": [
          "owner",
          "read",
          "write"
        ],
        "type": "string"
      },
      "CategoryPublicLinkView": {
        "description": "Owner-facing public-link state for a category (list).",
        "properties": {
          "enabled": {
            "type": "boolean"
          },
          "path": {
            "description": "SPA path, e.g. `/l/ldl_…`.",
            "type": [
              "string",
              "null"
            ]
          },
          "slug": {
            "description": "Present when enabled. High-entropy unlisted slug.",
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "enabled"
        ],
        "type": "object"
      },
      "CategoryRef": {
        "properties": {
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "path": {
            "description": "Nested path, e.g. `Work / Side projects`.",
            "type": "string"
          }
        },
        "required": [
          "id",
          "name",
          "path"
        ],
        "type": "object"
      },
      "CategoryShareView": {
        "properties": {
          "access": {
            "$ref": "#/components/schemas/ShareAccess"
          },
          "category_id": {
            "format": "uuid",
            "type": "string"
          },
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "invited_by_user_id": {
            "format": "uuid",
            "type": "string"
          },
          "invitee_display_name": {
            "type": [
              "string",
              "null"
            ]
          },
          "invitee_email": {
            "type": "string"
          },
          "invitee_user_id": {
            "format": "uuid",
            "type": "string"
          },
          "updated_at": {
            "format": "date-time",
            "type": "string"
          }
        },
        "required": [
          "id",
          "category_id",
          "invitee_user_id",
          "invitee_email",
          "access",
          "invited_by_user_id",
          "created_at",
          "updated_at"
        ],
        "type": "object"
      },
      "CategorySharesEnvelope": {
        "properties": {
          "pending": {
            "items": {
              "$ref": "#/components/schemas/PendingShareInviteView"
            },
            "type": "array"
          },
          "shares": {
            "items": {
              "$ref": "#/components/schemas/CategoryShareView"
            },
            "type": "array"
          }
        },
        "required": [
          "shares",
          "pending"
        ],
        "type": "object"
      },
      "CategoryView": {
        "properties": {
          "access": {
            "$ref": "#/components/schemas/CategoryAccess"
          },
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "deleted_at": {
            "format": "date-time",
            "type": [
              "string",
              "null"
            ]
          },
          "icon": {
            "type": [
              "string",
              "null"
            ]
          },
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "is_hidden": {
            "type": "boolean"
          },
          "is_vault": {
            "type": "boolean"
          },
          "last_bookmark_at": {
            "description": "When a live bookmark directly in this folder was last added or changed. Set by\n`list_categories` only; the sidebar orders its recent folders by it.",
            "format": "date-time",
            "type": [
              "string",
              "null"
            ]
          },
          "name": {
            "type": "string"
          },
          "owner_display_name": {
            "description": "Present for invitees — owner's display name (or email local-part).",
            "type": [
              "string",
              "null"
            ]
          },
          "owner_user_id": {
            "format": "uuid",
            "type": "string"
          },
          "parent_id": {
            "format": "uuid",
            "type": [
              "string",
              "null"
            ]
          },
          "position": {
            "format": "int32",
            "type": "integer"
          },
          "shared_out": {
            "description": "True when the owner has shared this folder (or an ancestor) with someone.",
            "type": "boolean"
          },
          "shared_with": {
            "description": "Owner-only: invitee display labels for the outgoing share pill tooltip.",
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "updated_at": {
            "format": "date-time",
            "type": "string"
          },
          "vault_id": {
            "format": "uuid",
            "type": [
              "string",
              "null"
            ]
          },
          "visibility": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "owner_user_id",
          "name",
          "is_hidden",
          "is_vault",
          "visibility",
          "position",
          "created_at",
          "updated_at",
          "access"
        ],
        "type": "object"
      },
      "CategoryVisibility": {
        "description": "Who can see a category's bookmarks on the owner's profile. \"Public\" is reserved for\nthe no-login Public link, so the widest tier here is `Members`.",
        "enum": [
          "private",
          "followers",
          "members"
        ],
        "type": "string"
      },
      "ChangeBans": {
        "description": "Changes every listed ban. Fields left out keep their value.",
        "properties": {
          "days": {
            "format": "int64",
            "type": [
              "integer",
              "null"
            ]
          },
          "ends_at": {
            "format": "date-time",
            "type": [
              "string",
              "null"
            ]
          },
          "permanent": {
            "type": "boolean"
          },
          "reason": {
            "type": [
              "string",
              "null"
            ]
          },
          "user_ids": {
            "items": {
              "format": "uuid",
              "type": "string"
            },
            "type": "array"
          }
        },
        "required": [
          "user_ids"
        ],
        "type": "object"
      },
      "ChangeEmail": {
        "properties": {
          "email": {
            "type": "string"
          }
        },
        "required": [
          "email"
        ],
        "type": "object"
      },
      "ChangeGlobalPassphraseRequest": {
        "properties": {
          "current_passphrase": {
            "type": "string"
          },
          "new_passphrase": {
            "type": "string"
          }
        },
        "required": [
          "current_passphrase",
          "new_passphrase"
        ],
        "type": "object"
      },
      "ChangePassword": {
        "properties": {
          "current_password": {
            "type": "string"
          },
          "new_password": {
            "type": "string"
          },
          "revoke_api_keys": {
            "description": "Also revoke every API key. Other login sessions always end.",
            "type": "boolean"
          }
        },
        "required": [
          "current_password",
          "new_password"
        ],
        "type": "object"
      },
      "ChangeRequest": {
        "properties": {
          "new_email": {
            "type": "string"
          },
          "password": {
            "type": "string"
          }
        },
        "required": [
          "password",
          "new_email"
        ],
        "type": "object"
      },
      "ClaimRequest": {
        "properties": {
          "token": {
            "type": "string"
          }
        },
        "required": [
          "token"
        ],
        "type": "object"
      },
      "CreateAbuseReport": {
        "description": "`target_id` is a public list's slug or category id, a user id, or a comment id.",
        "properties": {
          "details": {
            "type": [
              "string",
              "null"
            ]
          },
          "reason": {
            "type": "string"
          },
          "target_id": {
            "type": "string"
          },
          "target_type": {
            "$ref": "#/components/schemas/AbuseTargetType"
          }
        },
        "required": [
          "target_type",
          "target_id",
          "reason"
        ],
        "type": "object"
      },
      "CreateApiKey": {
        "properties": {
          "name": {
            "type": "string"
          }
        },
        "required": [
          "name"
        ],
        "type": "object"
      },
      "CreateApiKeyResponse": {
        "description": "One-shot create response: view + plaintext token (shown once).",
        "properties": {
          "key": {
            "$ref": "#/components/schemas/ApiKeyView"
          },
          "token": {
            "type": "string"
          }
        },
        "required": [
          "key",
          "token"
        ],
        "type": "object"
      },
      "CreateBan": {
        "description": "`ends_at` or `days` sets the end. Neither means permanent.",
        "properties": {
          "days": {
            "format": "int64",
            "type": [
              "integer",
              "null"
            ]
          },
          "ends_at": {
            "format": "date-time",
            "type": [
              "string",
              "null"
            ]
          },
          "reason": {
            "type": "string"
          }
        },
        "required": [
          "reason"
        ],
        "type": "object"
      },
      "CreateBookmark": {
        "properties": {
          "category_id": {
            "format": "uuid",
            "type": [
              "string",
              "null"
            ]
          },
          "category_ids": {
            "items": {
              "format": "uuid",
              "type": "string"
            },
            "type": "array"
          },
          "description": {
            "type": [
              "string",
              "null"
            ]
          },
          "is_favorite": {
            "type": "boolean"
          },
          "is_pinned": {
            "type": "boolean"
          },
          "is_unread": {
            "type": "boolean"
          },
          "notes": {
            "type": [
              "string",
              "null"
            ]
          },
          "tags": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "title": {
            "type": [
              "string",
              "null"
            ]
          },
          "url": {
            "type": "string"
          },
          "vault_id": {
            "description": "For a loose vault bookmark. Categories inside a vault imply their vault.",
            "format": "uuid",
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "url"
        ],
        "type": "object"
      },
      "CreateCategory": {
        "properties": {
          "icon": {
            "type": [
              "string",
              "null"
            ]
          },
          "is_hidden": {
            "type": "boolean"
          },
          "name": {
            "type": "string"
          },
          "parent_id": {
            "format": "uuid",
            "type": [
              "string",
              "null"
            ]
          },
          "vault_id": {
            "format": "uuid",
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "name",
          "is_hidden"
        ],
        "type": "object"
      },
      "CreateCategoryShare": {
        "properties": {
          "access": {
            "$ref": "#/components/schemas/ShareAccess"
          },
          "email": {
            "type": "string"
          }
        },
        "required": [
          "email",
          "access"
        ],
        "type": "object"
      },
      "CreateDashboard": {
        "properties": {
          "title": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "type": "object"
      },
      "CreateDashboardShare": {
        "properties": {
          "access": {
            "$ref": "#/components/schemas/ShareAccess"
          },
          "email": {
            "type": "string"
          }
        },
        "required": [
          "email",
          "access"
        ],
        "type": "object"
      },
      "CreateRegistrationInvite": {
        "properties": {
          "email": {
            "description": "Optional: bind invite to this email (case-insensitive match on register).",
            "type": [
              "string",
              "null"
            ]
          },
          "expires_in_days": {
            "description": "Days until expiry (default 7, clamp 1..=90).",
            "format": "int32",
            "type": [
              "integer",
              "null"
            ]
          }
        },
        "type": "object"
      },
      "CreateSocialComment": {
        "properties": {
          "body": {
            "type": "string"
          }
        },
        "required": [
          "body"
        ],
        "type": "object"
      },
      "CreateVaultRequest": {
        "properties": {
          "name": {
            "type": "string"
          },
          "passphrase": {
            "type": "string"
          }
        },
        "required": [
          "name",
          "passphrase"
        ],
        "type": "object"
      },
      "DashboardItemView": {
        "properties": {
          "bookmark": {
            "$ref": "#/components/schemas/BookmarkView"
          },
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "last_opened_at": {
            "description": "When the viewer last opened it.",
            "format": "date-time",
            "type": [
              "string",
              "null"
            ]
          },
          "open_count": {
            "description": "How often the viewer opened it: in the last 30 days for a section counting that\nwindow, otherwise of all time. Absent when never opened.",
            "format": "int64",
            "type": [
              "integer",
              "null"
            ]
          },
          "position": {
            "format": "int32",
            "type": "integer"
          }
        },
        "required": [
          "id",
          "position",
          "bookmark"
        ],
        "type": "object"
      },
      "DashboardOpenWindow": {
        "description": "The period \"Most opened\" counts opens over.",
        "enum": [
          "last_30_days",
          "all_time"
        ],
        "type": "string"
      },
      "DashboardSectionDisplay": {
        "description": "How a section shows its bookmarks.",
        "enum": [
          "small",
          "medium",
          "large",
          "icons"
        ],
        "type": "string"
      },
      "DashboardSectionKind": {
        "description": "What fills a dashboard section.",
        "enum": [
          "pinned",
          "latest",
          "most_opened",
          "recently_visited"
        ],
        "type": "string"
      },
      "DashboardSectionLayout": {
        "description": "A section's place and size on the dashboard's 12-column grid, in grid units. The web app\npacks sections upward, so `y` orders them more than it places them.",
        "properties": {
          "h": {
            "format": "int32",
            "type": "integer"
          },
          "w": {
            "format": "int32",
            "type": "integer"
          },
          "x": {
            "format": "int32",
            "type": "integer"
          },
          "y": {
            "format": "int32",
            "type": "integer"
          }
        },
        "required": [
          "x",
          "y",
          "w",
          "h"
        ],
        "type": "object"
      },
      "DashboardSectionSettings": {
        "description": "A section's type, display mode and source. Every field has a default, so older layouts\nand exports (title and pins only) still read as pinned, medium sections.",
        "properties": {
          "display": {
            "$ref": "#/components/schemas/DashboardSectionDisplay"
          },
          "item_limit": {
            "format": "int32",
            "type": "integer"
          },
          "kind": {
            "$ref": "#/components/schemas/DashboardSectionKind"
          },
          "layout": {
            "$ref": "#/components/schemas/DashboardSectionLayout"
          },
          "open_window": {
            "$ref": "#/components/schemas/DashboardOpenWindow"
          },
          "source": {
            "$ref": "#/components/schemas/DashboardSectionSource"
          }
        },
        "type": "object"
      },
      "DashboardSectionSource": {
        "description": "Filters for a section that fills itself. A bookmark must match every one that is set.",
        "properties": {
          "category_id": {
            "description": "A folder of the owner's, with its subfolders.",
            "format": "uuid",
            "type": [
              "string",
              "null"
            ]
          },
          "favorites": {
            "type": "boolean"
          },
          "site": {
            "description": "A website, such as `github.com`; its subdomains match too.",
            "type": [
              "string",
              "null"
            ]
          },
          "tag": {
            "type": [
              "string",
              "null"
            ]
          },
          "unread": {
            "type": "boolean"
          }
        },
        "type": "object"
      },
      "DashboardSectionView": {
        "allOf": [
          {
            "$ref": "#/components/schemas/DashboardSectionSettings"
          },
          {
            "properties": {
              "id": {
                "format": "uuid",
                "type": "string"
              },
              "items": {
                "items": {
                  "$ref": "#/components/schemas/DashboardItemView"
                },
                "type": "array"
              },
              "position": {
                "format": "int32",
                "type": "integer"
              },
              "title": {
                "type": "string"
              }
            },
            "required": [
              "id",
              "title",
              "position",
              "items"
            ],
            "type": "object"
          }
        ]
      },
      "DashboardShareView": {
        "properties": {
          "access": {
            "$ref": "#/components/schemas/ShareAccess"
          },
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "dashboard_id": {
            "format": "uuid",
            "type": "string"
          },
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "invited_by_user_id": {
            "format": "uuid",
            "type": "string"
          },
          "invitee_display_name": {
            "type": [
              "string",
              "null"
            ]
          },
          "invitee_email": {
            "type": "string"
          },
          "invitee_user_id": {
            "format": "uuid",
            "type": "string"
          },
          "updated_at": {
            "format": "date-time",
            "type": "string"
          }
        },
        "required": [
          "id",
          "dashboard_id",
          "invitee_user_id",
          "invitee_email",
          "access",
          "invited_by_user_id",
          "created_at",
          "updated_at"
        ],
        "type": "object"
      },
      "DashboardSharesEnvelope": {
        "properties": {
          "pending": {
            "items": {
              "$ref": "#/components/schemas/PendingShareInviteView"
            },
            "type": "array"
          },
          "shares": {
            "items": {
              "$ref": "#/components/schemas/DashboardShareView"
            },
            "type": "array"
          }
        },
        "required": [
          "shares",
          "pending"
        ],
        "type": "object"
      },
      "DashboardSummary": {
        "description": "Lightweight row for switchers / settings (no sections).",
        "properties": {
          "access": {
            "$ref": "#/components/schemas/CategoryAccess"
          },
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "deleted_at": {
            "format": "date-time",
            "type": [
              "string",
              "null"
            ]
          },
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "is_default": {
            "type": "boolean"
          },
          "owner_display_name": {
            "type": [
              "string",
              "null"
            ]
          },
          "owner_user_id": {
            "format": "uuid",
            "type": "string"
          },
          "shared_out": {
            "type": "boolean"
          },
          "shared_with": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "title": {
            "type": "string"
          },
          "updated_at": {
            "format": "date-time",
            "type": "string"
          }
        },
        "required": [
          "id",
          "owner_user_id",
          "title",
          "is_default",
          "access",
          "created_at",
          "updated_at"
        ],
        "type": "object"
      },
      "DashboardView": {
        "properties": {
          "access": {
            "$ref": "#/components/schemas/CategoryAccess"
          },
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "deleted_at": {
            "format": "date-time",
            "type": [
              "string",
              "null"
            ]
          },
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "is_default": {
            "type": "boolean"
          },
          "owner_display_name": {
            "type": [
              "string",
              "null"
            ]
          },
          "owner_user_id": {
            "format": "uuid",
            "type": "string"
          },
          "sections": {
            "items": {
              "$ref": "#/components/schemas/DashboardSectionView"
            },
            "type": "array"
          },
          "shared_out": {
            "description": "True when the owner has shared this dashboard with someone.",
            "type": "boolean"
          },
          "shared_with": {
            "description": "Owner-only: invitee display labels for the outgoing share pill tooltip.",
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "title": {
            "type": "string"
          },
          "updated_at": {
            "format": "date-time",
            "type": "string"
          }
        },
        "required": [
          "id",
          "owner_user_id",
          "title",
          "is_default",
          "sections",
          "access",
          "created_at",
          "updated_at"
        ],
        "type": "object"
      },
      "DeleteVaultRequest": {
        "properties": {
          "name": {
            "type": "string"
          },
          "password": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "name"
        ],
        "type": "object"
      },
      "DisconnectRequest": {
        "properties": {
          "password": {
            "type": "string"
          }
        },
        "required": [
          "password"
        ],
        "type": "object"
      },
      "DuplicateAction": {
        "description": "What to do with an imported bookmark whose URL is already in the library.",
        "enum": [
          "skip",
          "replace",
          "merge",
          "keep"
        ],
        "type": "string"
      },
      "DuplicateDecisions": {
        "description": "The person's choices, by index into the parsed file. Missing means `Keep` for every row.",
        "properties": {
          "default": {
            "$ref": "#/components/schemas/DuplicateAction"
          },
          "overrides": {
            "additionalProperties": {
              "$ref": "#/components/schemas/DuplicateAction"
            },
            "propertyNames": {
              "minimum": 0,
              "type": "integer"
            },
            "type": "object"
          }
        },
        "type": "object"
      },
      "DuplicateExisting": {
        "properties": {
          "description": {
            "type": [
              "string",
              "null"
            ]
          },
          "folders": {
            "description": "Full paths, `Work / Rust`.",
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "tags": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "title": {
            "type": "string"
          },
          "updated_at": {
            "format": "date-time",
            "type": "string"
          }
        },
        "required": [
          "id",
          "title",
          "tags",
          "folders",
          "updated_at"
        ],
        "type": "object"
      },
      "DuplicateIncoming": {
        "properties": {
          "description": {
            "type": [
              "string",
              "null"
            ]
          },
          "folders": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "tags": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "title": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "tags",
          "folders"
        ],
        "type": "object"
      },
      "EmailDelivery": {
        "description": "How a notification kind's email arrives.",
        "enum": [
          "instant",
          "daily"
        ],
        "type": "string"
      },
      "ErrorBody": {
        "description": "The error body. See the module docs.",
        "properties": {
          "code": {
            "description": "Stable machine-readable id, such as `not_found` or `quota_exceeded`.",
            "type": "string"
          },
          "details": {
            "description": "Extra data for some codes: `ban` for `banned`, `meter`/`limit`/`used` for\n`quota_exceeded`, `blockers` for `vault_move_blocked`.",
            "type": [
              "object",
              "null"
            ]
          },
          "error": {
            "description": "Same as `message`. Kept for older clients.",
            "type": "string"
          },
          "message": {
            "description": "Human-readable text. Wording may change between releases; match on `code`.",
            "type": "string"
          }
        },
        "required": [
          "code",
          "message",
          "error"
        ],
        "type": "object"
      },
      "FilingSuggestions": {
        "properties": {
          "folders": {
            "items": {
              "$ref": "#/components/schemas/FolderSuggestion"
            },
            "type": "array"
          },
          "tags": {
            "items": {
              "$ref": "#/components/schemas/TagSuggestion"
            },
            "type": "array"
          }
        },
        "required": [
          "folders",
          "tags"
        ],
        "type": "object"
      },
      "FolderCounts": {
        "description": "Live bookmarks per folder the person can open, and in their Unsorted.",
        "properties": {
          "folders": {
            "additionalProperties": {
              "format": "int64",
              "type": "integer"
            },
            "description": "Direct bookmarks per folder (not counting subfolders). Folders with none are absent.",
            "propertyNames": {
              "format": "uuid",
              "type": "string"
            },
            "type": "object"
          },
          "uncategorized": {
            "format": "int64",
            "type": "integer"
          }
        },
        "required": [
          "folders",
          "uncategorized"
        ],
        "type": "object"
      },
      "FolderSuggestion": {
        "properties": {
          "count": {
            "description": "Bookmarks on the same site in this folder.",
            "format": "int64",
            "type": "integer"
          },
          "id": {
            "format": "uuid",
            "type": "string"
          }
        },
        "required": [
          "id",
          "count"
        ],
        "type": "object"
      },
      "FollowRelation": {
        "properties": {
          "followers": {
            "format": "int64",
            "type": "integer"
          },
          "following": {
            "type": "boolean"
          },
          "following_count": {
            "format": "int64",
            "type": "integer"
          }
        },
        "required": [
          "following",
          "followers",
          "following_count"
        ],
        "type": "object"
      },
      "ForgotRequest": {
        "properties": {
          "email": {
            "type": "string"
          }
        },
        "required": [
          "email"
        ],
        "type": "object"
      },
      "ForkCategory": {
        "description": "Copy a readable category tree (+ bookmarks) into a new owned root.",
        "properties": {
          "name": {
            "description": "Defaults to `{name} (copy)`.",
            "type": [
              "string",
              "null"
            ]
          }
        },
        "type": "object"
      },
      "ImportBody": {
        "properties": {
          "content": {
            "type": "string"
          },
          "duplicates": {
            "$ref": "#/components/schemas/DuplicateDecisions",
            "description": "What to do with bookmarks already in the library. Missing: create them all, as before."
          },
          "format": {
            "type": "string"
          }
        },
        "required": [
          "format",
          "content"
        ],
        "type": "object"
      },
      "ImportDuplicate": {
        "properties": {
          "existing": {
            "$ref": "#/components/schemas/DuplicateExisting"
          },
          "incoming": {
            "$ref": "#/components/schemas/DuplicateIncoming"
          },
          "index": {
            "minimum": 0,
            "type": "integer"
          },
          "url": {
            "type": "string"
          }
        },
        "required": [
          "index",
          "url",
          "existing",
          "incoming"
        ],
        "type": "object"
      },
      "ImportFolderCounts": {
        "properties": {
          "created": {
            "minimum": 0,
            "type": "integer"
          },
          "reused": {
            "minimum": 0,
            "type": "integer"
          }
        },
        "required": [
          "reused",
          "created"
        ],
        "type": "object"
      },
      "ImportPreview": {
        "properties": {
          "duplicates": {
            "items": {
              "$ref": "#/components/schemas/ImportDuplicate"
            },
            "type": "array"
          },
          "folders": {
            "$ref": "#/components/schemas/ImportFolderCounts"
          },
          "new": {
            "minimum": 0,
            "type": "integer"
          },
          "total": {
            "minimum": 0,
            "type": "integer"
          }
        },
        "required": [
          "total",
          "new",
          "duplicates",
          "folders"
        ],
        "type": "object"
      },
      "LiftBans": {
        "properties": {
          "user_ids": {
            "items": {
              "format": "uuid",
              "type": "string"
            },
            "type": "array"
          }
        },
        "required": [
          "user_ids"
        ],
        "type": "object"
      },
      "LinkCheckStatus": {
        "description": "Last probe result from the broken-link checker worker.",
        "enum": [
          "ok",
          "broken",
          "unreachable",
          "unverifiable"
        ],
        "type": "string"
      },
      "LoginFinish": {
        "properties": {
          "challenge_id": {
            "format": "uuid",
            "type": "string"
          },
          "credential": {
            "description": "The browser's WebAuthn credential, as JSON.",
            "type": "object"
          }
        },
        "required": [
          "challenge_id",
          "credential"
        ],
        "type": "object"
      },
      "LoginRequest": {
        "properties": {
          "email": {
            "type": "string"
          },
          "password": {
            "type": "string"
          }
        },
        "required": [
          "email",
          "password"
        ],
        "type": "object"
      },
      "ModerateAction": {
        "properties": {
          "action": {
            "type": "string"
          },
          "subject_id": {
            "format": "uuid",
            "type": "string"
          },
          "subject_type": {
            "description": "Needed for `removed_to_trash` and `share_revoked`.",
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "action",
          "subject_id"
        ],
        "type": "object"
      },
      "ModerateRequest": {
        "properties": {
          "actions": {
            "items": {
              "$ref": "#/components/schemas/ModerateAction"
            },
            "type": "array"
          },
          "reason": {
            "type": "string"
          }
        },
        "required": [
          "reason",
          "actions"
        ],
        "type": "object"
      },
      "MoveToVaultRequest": {
        "properties": {
          "bookmark_ids": {
            "items": {
              "format": "uuid",
              "type": "string"
            },
            "type": "array"
          },
          "category_ids": {
            "items": {
              "format": "uuid",
              "type": "string"
            },
            "type": "array"
          },
          "destination_vault_id": {
            "format": "uuid",
            "type": [
              "string",
              "null"
            ]
          }
        },
        "type": "object"
      },
      "PageDetailsRequest": {
        "properties": {
          "url": {
            "type": "string"
          }
        },
        "required": [
          "url"
        ],
        "type": "object"
      },
      "PatchDashboard": {
        "description": "Rename and/or pin. Pinning a shared dashboard needs read access and only affects the caller.",
        "properties": {
          "is_default": {
            "type": [
              "boolean",
              "null"
            ]
          },
          "title": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "type": "object"
      },
      "PendingShareInviteView": {
        "properties": {
          "access": {
            "$ref": "#/components/schemas/ShareAccess"
          },
          "claim_token": {
            "description": "Single-use claim link token. Only present in the response that created it.",
            "type": [
              "string",
              "null"
            ]
          },
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "invited_by_user_id": {
            "format": "uuid",
            "type": "string"
          },
          "invitee_email": {
            "type": "string"
          },
          "subject_id": {
            "format": "uuid",
            "type": "string"
          },
          "subject_type": {
            "$ref": "#/components/schemas/PendingShareSubjectType"
          },
          "updated_at": {
            "format": "date-time",
            "type": "string"
          }
        },
        "required": [
          "id",
          "subject_type",
          "subject_id",
          "invitee_email",
          "access",
          "invited_by_user_id",
          "created_at",
          "updated_at"
        ],
        "type": "object"
      },
      "PendingShareSubjectType": {
        "description": "Subject for a pending (pre-account) share invite.",
        "enum": [
          "category",
          "dashboard"
        ],
        "type": "string"
      },
      "ProfileBookmarksPage": {
        "properties": {
          "bookmarks": {
            "items": {
              "$ref": "#/components/schemas/PublicBookmarkView"
            },
            "type": "array"
          },
          "total": {
            "format": "int64",
            "type": "integer"
          }
        },
        "required": [
          "bookmarks",
          "total"
        ],
        "type": "object"
      },
      "ProfileView": {
        "description": "A user's profile as another signed-in user sees it.",
        "properties": {
          "bio": {
            "type": [
              "string",
              "null"
            ]
          },
          "display_name": {
            "type": "string"
          },
          "email": {
            "description": "Self only.",
            "type": [
              "string",
              "null"
            ]
          },
          "follow": {
            "$ref": "#/components/schemas/FollowRelation"
          },
          "has_avatar": {
            "type": "boolean"
          },
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "is_self": {
            "type": "boolean"
          },
          "profile_visibility": {
            "description": "Self only.",
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "id",
          "display_name",
          "has_avatar",
          "is_self",
          "follow"
        ],
        "type": "object"
      },
      "ProfileVisibility": {
        "description": "Who can open a profile.",
        "enum": [
          "members",
          "followers",
          "hidden"
        ],
        "type": "string"
      },
      "PublicBookmarkView": {
        "description": "Bookmark fields safe to expose on a public list (no notes / vault / owner ids).",
        "properties": {
          "description": {
            "type": [
              "string",
              "null"
            ]
          },
          "favicon_url": {
            "type": [
              "string",
              "null"
            ]
          },
          "has_preview": {
            "type": "boolean"
          },
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "preview_image_url": {
            "type": [
              "string",
              "null"
            ]
          },
          "preview_url": {
            "description": "Where anyone may load the stored preview, when `has_preview` and the caller is\nanonymous. Set on public lists.",
            "type": [
              "string",
              "null"
            ]
          },
          "tags": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "title": {
            "type": "string"
          },
          "url": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "url",
          "title",
          "has_preview",
          "tags"
        ],
        "type": "object"
      },
      "PublicListView": {
        "description": "Anonymous read model for a published bookmark list.",
        "properties": {
          "bookmarks": {
            "description": "The newest bookmarks, at most `PUBLIC_LIST_LIMIT` of them.",
            "items": {
              "$ref": "#/components/schemas/PublicBookmarkView"
            },
            "type": "array"
          },
          "icon": {
            "type": [
              "string",
              "null"
            ]
          },
          "name": {
            "type": "string"
          },
          "owner_display_name": {
            "type": "string"
          },
          "total": {
            "description": "How many bookmarks the list holds, including any left out of `bookmarks`.",
            "format": "int64",
            "type": "integer"
          }
        },
        "required": [
          "name",
          "owner_display_name",
          "bookmarks"
        ],
        "type": "object"
      },
      "PurgeTrashRequest": {
        "properties": {
          "items": {
            "items": {
              "$ref": "#/components/schemas/TrashItemRef"
            },
            "type": "array"
          }
        },
        "required": [
          "items"
        ],
        "type": "object"
      },
      "PutDashboardLayout": {
        "description": "Full layout replace for a personal dashboard.",
        "properties": {
          "sections": {
            "items": {
              "$ref": "#/components/schemas/PutDashboardSection"
            },
            "type": "array"
          },
          "title": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "sections"
        ],
        "type": "object"
      },
      "PutDashboardSection": {
        "allOf": [
          {
            "$ref": "#/components/schemas/DashboardSectionSettings"
          },
          {
            "properties": {
              "bookmark_ids": {
                "description": "Pins, for a pinned section. Ignored for sections that fill themselves.",
                "items": {
                  "format": "uuid",
                  "type": "string"
                },
                "type": "array"
              },
              "title": {
                "type": "string"
              }
            },
            "required": [
              "title"
            ],
            "type": "object"
          }
        ]
      },
      "RecoverVaultRequest": {
        "properties": {
          "new_passphrase": {
            "type": "string"
          },
          "recovery_key": {
            "type": "string"
          }
        },
        "required": [
          "recovery_key",
          "new_passphrase"
        ],
        "type": "object"
      },
      "RegisterFinish": {
        "properties": {
          "challenge_id": {
            "format": "uuid",
            "type": "string"
          },
          "credential": {
            "description": "The browser's WebAuthn credential, as JSON.",
            "type": "object"
          },
          "name": {
            "type": "string"
          }
        },
        "required": [
          "challenge_id",
          "name",
          "credential"
        ],
        "type": "object"
      },
      "RegisterRequest": {
        "properties": {
          "bootstrap_token": {
            "description": "The server's `BOOTSTRAP_TOKEN`, needed for the first account when one is set.",
            "type": [
              "string",
              "null"
            ]
          },
          "display_name": {
            "type": [
              "string",
              "null"
            ]
          },
          "email": {
            "type": "string"
          },
          "invite_code": {
            "description": "Required when registration is closed (after bootstrap).",
            "type": [
              "string",
              "null"
            ]
          },
          "password": {
            "type": "string"
          },
          "share_token": {
            "description": "From a share invite's claim link.",
            "type": [
              "string",
              "null"
            ]
          },
          "terms_version": {
            "description": "Terms of Service version the user accepted; must equal `legal::TERMS_VERSION`.",
            "type": "string"
          },
          "turnstile_token": {
            "description": "Cloudflare Turnstile widget token; required when the server has Turnstile keys.",
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "email",
          "password"
        ],
        "type": "object"
      },
      "RegisterStart": {
        "properties": {
          "password": {
            "description": "Required when the account has a password.",
            "type": [
              "string",
              "null"
            ]
          }
        },
        "type": "object"
      },
      "Rename": {
        "properties": {
          "name": {
            "type": "string"
          }
        },
        "required": [
          "name"
        ],
        "type": "object"
      },
      "RenameVaultRequest": {
        "properties": {
          "name": {
            "type": "string"
          }
        },
        "required": [
          "name"
        ],
        "type": "object"
      },
      "ResetRequest": {
        "properties": {
          "password": {
            "type": "string"
          },
          "revoke_api_keys": {
            "type": "boolean"
          },
          "token": {
            "type": "string"
          }
        },
        "required": [
          "token",
          "password"
        ],
        "type": "object"
      },
      "ResolveAbuseReport": {
        "properties": {
          "action": {
            "$ref": "#/components/schemas/AbuseAction"
          },
          "note": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "action"
        ],
        "type": "object"
      },
      "ScheduleAccountDeletion": {
        "description": "Body of `POST /users/me/deletion`.",
        "properties": {
          "confirm_email": {
            "description": "Must match the account email (case-insensitive).",
            "type": "string"
          },
          "password": {
            "description": "Required for accounts with a local password; ignored for single sign-on only accounts.",
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "confirm_email"
        ],
        "type": "object"
      },
      "SetEmailVerified": {
        "properties": {
          "verified": {
            "type": "boolean"
          }
        },
        "required": [
          "verified"
        ],
        "type": "object"
      },
      "SetNotificationEmail": {
        "properties": {
          "delivery": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/EmailDelivery",
                "description": "Left out: keep how this kind is delivered now."
              },
              {
                "type": "null"
              }
            ]
          },
          "enabled": {
            "type": "boolean"
          }
        },
        "required": [
          "enabled"
        ],
        "type": "object"
      },
      "ShareAccess": {
        "description": "Membership grant on a shared category (`read` / `write` only).",
        "enum": [
          "read",
          "write"
        ],
        "type": "string"
      },
      "Tag": {
        "properties": {
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "owner_user_id": {
            "format": "uuid",
            "type": "string"
          }
        },
        "required": [
          "id",
          "owner_user_id",
          "name",
          "created_at"
        ],
        "type": "object"
      },
      "TagSuggestion": {
        "properties": {
          "count": {
            "format": "int64",
            "type": "integer"
          },
          "name": {
            "type": "string"
          }
        },
        "required": [
          "name",
          "count"
        ],
        "type": "object"
      },
      "TokenRequest": {
        "properties": {
          "code": {
            "type": "string"
          },
          "code_verifier": {
            "type": "string"
          },
          "extension_origin": {
            "type": "string"
          }
        },
        "required": [
          "code",
          "code_verifier",
          "extension_origin"
        ],
        "type": "object"
      },
      "TrashItem": {
        "properties": {
          "deleted_at": {
            "format": "date-time",
            "type": "string"
          },
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "kind": {
            "$ref": "#/components/schemas/TrashKind"
          },
          "title": {
            "type": "string"
          }
        },
        "required": [
          "kind",
          "id",
          "title",
          "deleted_at"
        ],
        "type": "object"
      },
      "TrashItemRef": {
        "properties": {
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "kind": {
            "$ref": "#/components/schemas/TrashKind"
          }
        },
        "required": [
          "kind",
          "id"
        ],
        "type": "object"
      },
      "TrashKind": {
        "enum": [
          "bookmark",
          "category",
          "dashboard"
        ],
        "type": "string"
      },
      "UpdateAdminUser": {
        "properties": {
          "api_keys_enabled": {
            "type": [
              "boolean",
              "null"
            ]
          },
          "is_admin": {
            "type": [
              "boolean",
              "null"
            ]
          }
        },
        "type": "object"
      },
      "UpdateBookmark": {
        "properties": {
          "add_category_ids": {
            "description": "Folders to add the bookmark to, alongside the ones it is in when the edit is saved.",
            "items": {
              "format": "uuid",
              "type": "string"
            },
            "type": [
              "array",
              "null"
            ]
          },
          "add_tags": {
            "description": "Tags to add to whatever the bookmark has when the edit is saved.",
            "items": {
              "type": "string"
            },
            "type": [
              "array",
              "null"
            ]
          },
          "category_id": {
            "format": "uuid",
            "type": [
              "string",
              "null"
            ]
          },
          "category_ids": {
            "items": {
              "format": "uuid",
              "type": "string"
            },
            "type": [
              "array",
              "null"
            ]
          },
          "description": {
            "type": [
              "string",
              "null"
            ]
          },
          "is_favorite": {
            "type": [
              "boolean",
              "null"
            ]
          },
          "is_pinned": {
            "type": [
              "boolean",
              "null"
            ]
          },
          "is_private": {
            "type": [
              "boolean",
              "null"
            ]
          },
          "is_unread": {
            "type": [
              "boolean",
              "null"
            ]
          },
          "notes": {
            "type": [
              "string",
              "null"
            ]
          },
          "tags": {
            "items": {
              "type": "string"
            },
            "type": [
              "array",
              "null"
            ]
          },
          "title": {
            "type": [
              "string",
              "null"
            ]
          },
          "url": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "type": "object"
      },
      "UpdateCategory": {
        "properties": {
          "icon": {
            "description": "`Some(None)` clears the icon; `Some(Some(key))` sets it.",
            "type": [
              "string",
              "null"
            ]
          },
          "is_hidden": {
            "type": [
              "boolean",
              "null"
            ]
          },
          "name": {
            "type": [
              "string",
              "null"
            ]
          },
          "parent_id": {
            "format": "uuid",
            "type": [
              "string",
              "null"
            ]
          },
          "position": {
            "format": "int32",
            "type": [
              "integer",
              "null"
            ]
          },
          "visibility": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/CategoryVisibility"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "type": "object"
      },
      "UpdateCategoryShare": {
        "properties": {
          "access": {
            "$ref": "#/components/schemas/ShareAccess"
          }
        },
        "required": [
          "access"
        ],
        "type": "object"
      },
      "UpdateDashboardShare": {
        "properties": {
          "access": {
            "$ref": "#/components/schemas/ShareAccess"
          }
        },
        "required": [
          "access"
        ],
        "type": "object"
      },
      "UpdatePendingShareInvite": {
        "properties": {
          "access": {
            "$ref": "#/components/schemas/ShareAccess"
          }
        },
        "required": [
          "access"
        ],
        "type": "object"
      },
      "UpdatePlatformSettings": {
        "properties": {
          "abuse_contact_email": {
            "description": "`Some(None)` clears; `Some(Some(email))` sets; omit = no change.",
            "type": [
              "string",
              "null"
            ]
          },
          "api_keys_enabled": {
            "type": [
              "boolean",
              "null"
            ]
          },
          "max_bookmarks": {
            "description": "`Some(None)` clears; `Some(Some(n))` sets; omit = no change.",
            "format": "int64",
            "type": [
              "integer",
              "null"
            ]
          },
          "max_enrich_actions_per_day": {
            "format": "int64",
            "type": [
              "integer",
              "null"
            ]
          },
          "max_import_bytes": {
            "format": "int64",
            "type": [
              "integer",
              "null"
            ]
          },
          "max_stored_image_bytes": {
            "format": "int64",
            "type": [
              "integer",
              "null"
            ]
          },
          "max_upload_image_bytes": {
            "format": "int64",
            "type": [
              "integer",
              "null"
            ]
          },
          "registration_open": {
            "type": [
              "boolean",
              "null"
            ]
          },
          "require_verified_email": {
            "type": [
              "boolean",
              "null"
            ]
          },
          "screenshot_auto_retry_days": {
            "description": "1 to 90.",
            "format": "int32",
            "type": [
              "integer",
              "null"
            ]
          },
          "screenshot_retry_cooldown_hours": {
            "description": "1 to 720.",
            "format": "int32",
            "type": [
              "integer",
              "null"
            ]
          }
        },
        "type": "object"
      },
      "UpdateProfile": {
        "properties": {
          "bio": {
            "type": [
              "string",
              "null"
            ]
          },
          "display_name": {
            "type": [
              "string",
              "null"
            ]
          },
          "email": {
            "description": "Accepted only when it matches the current address. An address changes through an\nemailed confirmation link, or by an instance admin.",
            "type": [
              "string",
              "null"
            ]
          },
          "profile_visibility": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/ProfileVisibility"
              },
              {
                "type": "null"
              }
            ]
          },
          "timezone": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "type": "object"
      },
      "UpdateSettings": {
        "properties": {
          "default_landing": {
            "type": [
              "string",
              "null"
            ]
          },
          "library_view": {
            "type": [
              "string",
              "null"
            ]
          },
          "show_deleted_in_library": {
            "type": [
              "boolean",
              "null"
            ]
          },
          "show_hidden": {
            "type": [
              "boolean",
              "null"
            ]
          },
          "show_keyboard_hints": {
            "description": "Hide key numbers, key hint lines and shortcut keycaps. Missing means unchanged.",
            "type": [
              "boolean",
              "null"
            ]
          },
          "show_vault_in_library": {
            "type": [
              "boolean",
              "null"
            ]
          },
          "theme": {
            "type": [
              "string",
              "null"
            ]
          },
          "trash_retention_days": {
            "format": "int32",
            "type": [
              "integer",
              "null"
            ]
          },
          "vault_auto_lock_minutes": {
            "format": "int32",
            "type": [
              "integer",
              "null"
            ]
          },
          "vault_delete_mode": {
            "type": [
              "string",
              "null"
            ]
          },
          "vault_search_mode": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "type": "object"
      },
      "UpsertSocialRating": {
        "properties": {
          "rating": {
            "format": "int32",
            "type": "integer"
          }
        },
        "required": [
          "rating"
        ],
        "type": "object"
      },
      "VaultUnlockRequest": {
        "properties": {
          "passphrase": {
            "type": "string"
          }
        },
        "required": [
          "passphrase"
        ],
        "type": "object"
      }
    },
    "securitySchemes": {
      "api_key": {
        "description": "An API key (`ldk_…`) from Config options → API keys, or a sign-in session token, as `Authorization: Bearer <token>`.",
        "scheme": "bearer",
        "type": "http"
      },
      "session_cookie": {
        "description": "The browser's sign-in cookie. Writes also need the `X-Linkdean-Client` header.",
        "in": "cookie",
        "name": "linkdean_session",
        "type": "apiKey"
      },
      "session_token": {
        "description": "A sign-in session token as `Authorization: Bearer <token>`. API keys are refused here.",
        "scheme": "bearer",
        "type": "http"
      }
    }
  },
  "info": {
    "description": "The HTTP API behind the Linkdean web app, browser extension and integrations. Every error answers `{ code, message, details?, error }`: match on `code`, show `message`. Successful JSON reads carry an `ETag`; send it back in `If-None-Match` to get `304 Not Modified`. Every response has an `X-Request-Id` to quote in bug reports.",
    "title": "Linkdean API",
    "version": "0.0.11"
  },
  "openapi": "3.1.0",
  "paths": {
    "/activity": {
      "get": {
        "operationId": "activity_list",
        "parameters": [
          {
            "in": "query",
            "name": "limit",
            "required": false,
            "schema": {
              "format": "int64",
              "type": "integer"
            }
          },
          {
            "in": "query",
            "name": "subject_type",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "action",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "activity"
        ]
      }
    },
    "/admin/bans": {
      "get": {
        "operationId": "admin_list_bans",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "session_token": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "admin"
        ]
      },
      "patch": {
        "operationId": "admin_change_bans",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ChangeBans"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "session_token": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "admin"
        ]
      }
    },
    "/admin/bans/lift": {
      "post": {
        "operationId": "admin_lift_bans",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/LiftBans"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "session_token": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "admin"
        ]
      }
    },
    "/admin/email": {
      "get": {
        "operationId": "admin_email_status",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "session_token": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "admin"
        ]
      }
    },
    "/admin/email/test": {
      "post": {
        "operationId": "admin_email_send_test",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "session_token": []
          },
          {
            "session_cookie": []
          }
        ],
        "summary": "Sends straight away, skipping the outbox, so the admin sees the SMTP result at once.",
        "tags": [
          "admin"
        ]
      }
    },
    "/admin/invites": {
      "get": {
        "operationId": "admin_list_invites",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "session_token": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "admin"
        ]
      },
      "post": {
        "operationId": "admin_create_invite",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateRegistrationInvite"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "session_token": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "admin"
        ]
      }
    },
    "/admin/invites/{id}": {
      "delete": {
        "operationId": "admin_revoke_invite",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "session_token": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "admin"
        ]
      }
    },
    "/admin/platform-settings": {
      "get": {
        "operationId": "admin_get_platform_settings",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "session_token": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "admin"
        ]
      },
      "patch": {
        "operationId": "admin_patch_platform_settings",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdatePlatformSettings"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "session_token": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "admin"
        ]
      }
    },
    "/admin/reports": {
      "get": {
        "operationId": "admin_reports_list_reports",
        "parameters": [
          {
            "in": "query",
            "name": "status",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "session_token": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "admin"
        ]
      }
    },
    "/admin/reports/{id}/resolve": {
      "post": {
        "operationId": "admin_reports_resolve_report",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ResolveAbuseReport"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "session_token": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "admin"
        ]
      }
    },
    "/admin/screenshots/retry": {
      "get": {
        "operationId": "admin_screenshot_retry_status",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "session_token": []
          },
          {
            "session_cookie": []
          }
        ],
        "summary": "What the retry button needs: how many failed screenshots a retry would take, and when it\nis next allowed.",
        "tags": [
          "admin"
        ]
      },
      "post": {
        "operationId": "admin_retry_screenshots",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "session_token": []
          },
          {
            "session_cookie": []
          }
        ],
        "summary": "Queue failed screenshots for another try, at most once per cooldown. Only failures older\nthan the cooldown are taken, so a page that just failed is not tried again at once.",
        "tags": [
          "admin"
        ]
      }
    },
    "/admin/search/reindex": {
      "post": {
        "operationId": "admin_reindex_search",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "session_token": []
          },
          {
            "session_cookie": []
          }
        ],
        "summary": "Clear Meili bookmarks index and re-upsert all non-vault, non-deleted bookmarks.",
        "tags": [
          "admin"
        ]
      }
    },
    "/admin/users": {
      "get": {
        "operationId": "admin_list_users",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "session_token": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "admin"
        ]
      }
    },
    "/admin/users/{id}": {
      "patch": {
        "operationId": "admin_patch_user",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateAdminUser"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "session_token": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "admin"
        ]
      }
    },
    "/admin/users/{id}/ban": {
      "post": {
        "operationId": "admin_ban_user",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateBan"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "session_token": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "admin"
        ]
      }
    },
    "/admin/users/{id}/email": {
      "post": {
        "operationId": "admin_change_email",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ChangeEmail"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "session_token": []
          },
          {
            "session_cookie": []
          }
        ],
        "summary": "Change an account's email at once. The admin vouches for the address, so it counts as\nverified.",
        "tags": [
          "admin"
        ]
      }
    },
    "/admin/users/{id}/email-verified": {
      "post": {
        "operationId": "admin_set_email_verified",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SetEmailVerified"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "session_token": []
          },
          {
            "session_cookie": []
          }
        ],
        "summary": "Mark an account verified (its waiting invites attach) or remove its verification (new\ninvites wait; accepted shares stay).",
        "tags": [
          "admin"
        ]
      }
    },
    "/admin/users/{id}/exposed-content": {
      "get": {
        "operationId": "admin_exposed_content",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "session_token": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "admin"
        ]
      }
    },
    "/admin/users/{id}/moderate": {
      "post": {
        "operationId": "admin_moderate",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ModerateRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "session_token": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "admin"
        ]
      }
    },
    "/admin/users/{id}/moderation-actions": {
      "get": {
        "operationId": "admin_moderation_actions",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "session_token": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "admin"
        ]
      }
    },
    "/admin/users/{id}/reset-link": {
      "post": {
        "operationId": "admin_create_reset_link",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "session_token": []
          },
          {
            "session_cookie": []
          }
        ],
        "summary": "A reset link to hand over privately; the only way back in when mail is off.",
        "tags": [
          "admin"
        ]
      }
    },
    "/agent-skill": {
      "get": {
        "operationId": "agent_skills_agent_skill",
        "parameters": [
          {
            "in": "query",
            "name": "folder",
            "required": false,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "tag",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "`zip` (default): a `<name>/` folder. `md`: the `SKILL.md` alone, every link inline.",
            "in": "query",
            "name": "format",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "agent-skill"
        ]
      }
    },
    "/api-keys": {
      "get": {
        "operationId": "api_keys_list_keys",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "api-keys"
        ]
      },
      "post": {
        "operationId": "api_keys_create_key",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateApiKey"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CreateApiKeyResponse"
                }
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "session_token": []
          },
          {
            "session_cookie": []
          }
        ],
        "summary": "Login sessions only: a key that could mint keys would survive its own revocation.",
        "tags": [
          "api-keys"
        ]
      }
    },
    "/api-keys/{id}": {
      "delete": {
        "operationId": "api_keys_revoke_key",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "api-keys"
        ]
      }
    },
    "/auth/bootstrap-status": {
      "get": {
        "operationId": "auth_bootstrap_status",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "tags": [
          "auth"
        ]
      }
    },
    "/auth/config": {
      "get": {
        "operationId": "auth_auth_config",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "tags": [
          "auth"
        ]
      }
    },
    "/auth/email/change": {
      "post": {
        "operationId": "auth_email_verification_change",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ChangeRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "summary": "Start an email change: the link goes to the new address, a notice to the old one. The\naddress stays the same until the link is opened.",
        "tags": [
          "auth"
        ]
      }
    },
    "/auth/email/confirm-change": {
      "post": {
        "operationId": "auth_email_verification_confirm_change",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/TokenRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "summary": "Finish an email change with its link. No session needed.",
        "tags": [
          "auth"
        ]
      }
    },
    "/auth/email/resend": {
      "post": {
        "operationId": "auth_email_verification_resend",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "summary": "Send a new verification link to the signed-in account's address.",
        "tags": [
          "auth"
        ]
      }
    },
    "/auth/email/verify": {
      "post": {
        "operationId": "auth_email_verification_verify",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/TokenRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "summary": "Verify an address with its link. No session needed.",
        "tags": [
          "auth"
        ]
      }
    },
    "/auth/extension/authorize": {
      "post": {
        "operationId": "auth_extension_authorize",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AuthorizeRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "session_token": []
          },
          {
            "session_cookie": []
          }
        ],
        "summary": "Login sessions only, like creating any API key: a key must never mint another.",
        "tags": [
          "auth"
        ]
      }
    },
    "/auth/extension/token": {
      "post": {
        "operationId": "auth_extension_token",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/TokenRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "summary": "No session: the extension proves itself with the verifier only it holds.",
        "tags": [
          "auth"
        ]
      }
    },
    "/auth/login": {
      "post": {
        "operationId": "auth_login",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/LoginRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "tags": [
          "auth"
        ]
      }
    },
    "/auth/logout": {
      "post": {
        "operationId": "auth_logout",
        "responses": {
          "200": {
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "tags": [
          "auth"
        ]
      }
    },
    "/auth/me": {
      "get": {
        "operationId": "auth_me",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "auth"
        ]
      }
    },
    "/auth/oidc/callback": {
      "get": {
        "operationId": "auth_oidc_callback",
        "parameters": [
          {
            "in": "query",
            "name": "code",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "state",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "error",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "summary": "Always redirects: home with a session, the login page with a pending link or a reason, or\nback to the profile page in connect mode.",
        "tags": [
          "auth"
        ]
      }
    },
    "/auth/oidc/disconnect": {
      "post": {
        "operationId": "auth_oidc_disconnect",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/DisconnectRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "summary": "Detach single sign-on after a password check. Accounts without a password cannot, so they\nkeep a way to sign in. Wrong passwords count against the sign-in limits.",
        "tags": [
          "auth"
        ]
      }
    },
    "/auth/oidc/pending-link": {
      "get": {
        "operationId": "auth_oidc_pending_link",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "summary": "The masked provider address of the browser's pending link, for the login prompt. 404 when\nthere is none or it expired or was used.",
        "tags": [
          "auth"
        ]
      }
    },
    "/auth/oidc/start": {
      "get": {
        "operationId": "auth_oidc_start",
        "parameters": [
          {
            "in": "query",
            "name": "mode",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "terms_version",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "`oidc`, `google`, `microsoft` or `github`; the first configured one when unset.",
            "in": "query",
            "name": "provider",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Reauth mode: `profile` returns to the profile page, anything else to settings.",
            "in": "query",
            "name": "return",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {},
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "summary": "`?mode=connect` attaches the provider identity to the signed-in account instead of signing\nin; it needs a session. Sign-in may create an account, so it needs `?terms_version=` equal to\nthe current terms version; the flow cookie carries it to the callback, which records it on a\nnew account. Existing accounts sign in unchanged. Connect mode never creates an account.",
        "tags": [
          "auth"
        ]
      }
    },
    "/auth/onboarding/complete": {
      "post": {
        "operationId": "auth_complete_onboarding",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "auth"
        ]
      }
    },
    "/auth/passkey/finish": {
      "post": {
        "operationId": "auth_passkey_login_finish",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/LoginFinish"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "summary": "Checks the passkey's answer and signs in. Failures count against the address's sign-in limit.",
        "tags": [
          "auth"
        ]
      }
    },
    "/auth/passkey/start": {
      "post": {
        "operationId": "auth_passkey_login_start",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "summary": "Starts a passkey sign-in. Anyone may ask; it costs a row that expires in minutes.",
        "tags": [
          "auth"
        ]
      }
    },
    "/auth/password/forgot": {
      "post": {
        "operationId": "auth_password_reset_forgot",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ForgotRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "summary": "Always answers the same, at once; the lookup and email happen in the background, so neither\nthe reply nor its timing says whether the address has an account.",
        "tags": [
          "auth"
        ]
      }
    },
    "/auth/password/reset": {
      "post": {
        "operationId": "auth_password_reset_reset",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ResetRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "summary": "Set the new password, end every session and sign this browser in.",
        "tags": [
          "auth"
        ]
      }
    },
    "/auth/register": {
      "post": {
        "operationId": "auth_register",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/RegisterRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "summary": "Local sign-up. The first account becomes admin and needs `BOOTSTRAP_TOKEN` when one is set;\nlater ones need open registration or an invite. `create_user_gated` checks both and claims\nthe invite under one lock and transaction.",
        "tags": [
          "auth"
        ]
      }
    },
    "/bookmarks": {
      "get": {
        "operationId": "bookmarks_list",
        "parameters": [
          {
            "in": "query",
            "name": "category_id",
            "required": false,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "folder",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "limit",
            "required": false,
            "schema": {
              "format": "int64",
              "type": "integer"
            }
          },
          {
            "in": "query",
            "name": "cursor",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "sort",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Comma-separated or single tag name(s).",
            "in": "query",
            "name": "tag",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Comma-separated or single flag name(s).",
            "in": "query",
            "name": "flag",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "RFC3339 timestamp lower bound on `created_at`.",
            "in": "query",
            "name": "since",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "include_vault",
            "required": false,
            "schema": {
              "type": "boolean"
            }
          },
          {
            "description": "Alias: `vault=1` also sets vault-only filter.",
            "in": "query",
            "name": "vault",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "vault_only",
            "required": false,
            "schema": {
              "type": "boolean"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BookmarkListResponse"
                }
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "bookmarks"
        ]
      },
      "post": {
        "operationId": "bookmarks_create",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateBookmark"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BookmarkView"
                }
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "bookmarks"
        ]
      }
    },
    "/bookmarks/broken": {
      "get": {
        "operationId": "bookmarks_broken",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/BookmarkView"
                  },
                  "type": "array"
                }
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "bookmarks"
        ]
      }
    },
    "/bookmarks/duplicates": {
      "get": {
        "operationId": "bookmarks_duplicates",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "bookmarks"
        ]
      }
    },
    "/bookmarks/folder-counts": {
      "get": {
        "operationId": "bookmarks_folder_counts",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/FolderCounts"
                }
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "summary": "Live bookmarks per folder and in Unsorted, for Explorer's folder tiles.",
        "tags": [
          "bookmarks"
        ]
      }
    },
    "/bookmarks/ids": {
      "get": {
        "operationId": "bookmarks_list_ids",
        "parameters": [
          {
            "in": "query",
            "name": "category_id",
            "required": false,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "folder",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "limit",
            "required": false,
            "schema": {
              "format": "int64",
              "type": "integer"
            }
          },
          {
            "in": "query",
            "name": "cursor",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "sort",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Comma-separated or single tag name(s).",
            "in": "query",
            "name": "tag",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Comma-separated or single flag name(s).",
            "in": "query",
            "name": "flag",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "RFC3339 timestamp lower bound on `created_at`.",
            "in": "query",
            "name": "since",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "include_vault",
            "required": false,
            "schema": {
              "type": "boolean"
            }
          },
          {
            "description": "Alias: `vault=1` also sets vault-only filter.",
            "in": "query",
            "name": "vault",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "vault_only",
            "required": false,
            "schema": {
              "type": "boolean"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BookmarkIdsResponse"
                }
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "bookmarks"
        ]
      }
    },
    "/bookmarks/lookup": {
      "get": {
        "operationId": "bookmarks_lookup",
        "parameters": [
          {
            "in": "query",
            "name": "url",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "summary": "The person's own bookmark at exactly this URL, if any, so quick save can open it instead\nof saving a second copy. Vault bookmarks are never matched.",
        "tags": [
          "bookmarks"
        ]
      }
    },
    "/bookmarks/page-details": {
      "post": {
        "operationId": "bookmarks_page_details",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PageDetailsRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "summary": "Fetches a page's title, description and keyword tags so the bookmark form can fill in\nwhat the person has not typed yet. Nothing is saved. Counts as one enrich action and is\nrate limited per user. The SPA never calls it for a bookmark headed into a vault.",
        "tags": [
          "bookmarks"
        ]
      }
    },
    "/bookmarks/url-hashes": {
      "get": {
        "operationId": "bookmarks_url_hashes",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "summary": "Hashes of every URL the person has saved, for the browser extension's saved-page icon.",
        "tags": [
          "bookmarks"
        ]
      }
    },
    "/bookmarks/{id}": {
      "delete": {
        "operationId": "bookmarks_delete_one",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "bookmarks"
        ]
      },
      "get": {
        "operationId": "bookmarks_get_one",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BookmarkView"
                }
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "bookmarks"
        ]
      },
      "patch": {
        "operationId": "bookmarks_update",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateBookmark"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BookmarkView"
                }
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "bookmarks"
        ]
      }
    },
    "/bookmarks/{id}/check-link": {
      "post": {
        "operationId": "bookmarks_check_link",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BookmarkView"
                }
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "bookmarks"
        ]
      }
    },
    "/bookmarks/{id}/favicon": {
      "get": {
        "operationId": "bookmarks_get_favicon",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "bookmarks"
        ]
      }
    },
    "/bookmarks/{id}/filing-suggestions": {
      "get": {
        "operationId": "bookmarks_filing_suggestions",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/FilingSuggestions"
                }
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "summary": "Folders and tags the person already uses on this bookmark's site, for the filing queue.",
        "tags": [
          "bookmarks"
        ]
      }
    },
    "/bookmarks/{id}/og": {
      "get": {
        "operationId": "bookmarks_get_og",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "bookmarks"
        ]
      }
    },
    "/bookmarks/{id}/open": {
      "post": {
        "operationId": "bookmarks_record_open",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "summary": "Records that the signed-in person opened the bookmark, for the dashboard's Most opened\nand Recently visited sections. Vault bookmarks are not recorded.",
        "tags": [
          "bookmarks"
        ]
      }
    },
    "/bookmarks/{id}/preview": {
      "delete": {
        "operationId": "bookmarks_delete_preview",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BookmarkView"
                }
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "bookmarks"
        ]
      },
      "get": {
        "operationId": "bookmarks_get_preview",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "bookmarks"
        ]
      },
      "post": {
        "operationId": "bookmarks_upload_preview",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "multipart/form-data": {}
          },
          "description": "A `file` field with a PNG, JPEG or WebP image."
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BookmarkView"
                }
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "bookmarks"
        ]
      }
    },
    "/bookmarks/{id}/save": {
      "post": {
        "operationId": "bookmarks_save_copy",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BookmarkView"
                }
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "bookmarks"
        ]
      }
    },
    "/categories": {
      "get": {
        "operationId": "categories_list",
        "parameters": [
          {
            "in": "query",
            "name": "include_hidden",
            "required": false,
            "schema": {
              "type": "boolean"
            }
          },
          {
            "in": "query",
            "name": "include_vault",
            "required": false,
            "schema": {
              "type": "boolean"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/CategoryView"
                  },
                  "type": "array"
                }
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "categories"
        ]
      },
      "post": {
        "operationId": "categories_create",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateCategory"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CategoryView"
                }
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "categories"
        ]
      }
    },
    "/categories/{id}": {
      "delete": {
        "operationId": "categories_delete_one",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "categories"
        ]
      },
      "patch": {
        "operationId": "categories_update",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateCategory"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CategoryView"
                }
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "categories"
        ]
      }
    },
    "/categories/{id}/fork": {
      "post": {
        "operationId": "categories_fork",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ForkCategory"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "categories"
        ]
      }
    },
    "/categories/{id}/pending-shares/{pending_id}": {
      "delete": {
        "operationId": "categories_delete_pending_share",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "pending_id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "categories"
        ]
      },
      "patch": {
        "operationId": "categories_update_pending_share",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "pending_id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdatePendingShareInvite"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PendingShareInviteView"
                }
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "categories"
        ]
      }
    },
    "/categories/{id}/public-link": {
      "delete": {
        "operationId": "categories_disable_public_link",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CategoryPublicLinkView"
                }
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "categories"
        ]
      },
      "get": {
        "operationId": "categories_get_public_link",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CategoryPublicLinkView"
                }
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "categories"
        ]
      },
      "post": {
        "operationId": "categories_enable_public_link",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CategoryPublicLinkView"
                }
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "categories"
        ]
      }
    },
    "/categories/{id}/public-link/rotate": {
      "post": {
        "operationId": "categories_rotate_public_link",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CategoryPublicLinkView"
                }
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "categories"
        ]
      }
    },
    "/categories/{id}/shares": {
      "get": {
        "operationId": "categories_list_shares",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CategorySharesEnvelope"
                }
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "categories"
        ]
      },
      "post": {
        "operationId": "categories_create_share",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateCategoryShare"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "categories"
        ]
      }
    },
    "/categories/{id}/shares/{user_id}": {
      "delete": {
        "operationId": "categories_delete_share",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "user_id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "categories"
        ]
      },
      "patch": {
        "operationId": "categories_update_share",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "user_id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateCategoryShare"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CategoryShareView"
                }
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "categories"
        ]
      }
    },
    "/dashboards": {
      "get": {
        "operationId": "dashboards_list",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/DashboardSummary"
                  },
                  "type": "array"
                }
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "dashboards"
        ]
      },
      "post": {
        "operationId": "dashboards_create",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateDashboard"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DashboardView"
                }
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "dashboards"
        ]
      }
    },
    "/dashboards/default": {
      "get": {
        "operationId": "dashboards_get_default",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DashboardView"
                }
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "dashboards"
        ]
      },
      "put": {
        "operationId": "dashboards_put_default",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PutDashboardLayout"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DashboardView"
                }
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "dashboards"
        ]
      }
    },
    "/dashboards/{id}": {
      "delete": {
        "operationId": "dashboards_delete_one",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/DashboardSummary"
                  },
                  "type": "array"
                }
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "dashboards"
        ]
      },
      "get": {
        "operationId": "dashboards_get_one",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DashboardView"
                }
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "dashboards"
        ]
      },
      "patch": {
        "operationId": "dashboards_patch_one",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PatchDashboard"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DashboardView"
                }
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "dashboards"
        ]
      },
      "put": {
        "operationId": "dashboards_put_one",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PutDashboardLayout"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DashboardView"
                }
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "dashboards"
        ]
      }
    },
    "/dashboards/{id}/pending-shares/{pending_id}": {
      "delete": {
        "operationId": "dashboards_delete_pending_share",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "pending_id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "dashboards"
        ]
      },
      "patch": {
        "operationId": "dashboards_update_pending_share",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "pending_id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdatePendingShareInvite"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PendingShareInviteView"
                }
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "dashboards"
        ]
      }
    },
    "/dashboards/{id}/shares": {
      "get": {
        "operationId": "dashboards_list_shares",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DashboardSharesEnvelope"
                }
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "dashboards"
        ]
      },
      "post": {
        "operationId": "dashboards_create_share",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateDashboardShare"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "dashboards"
        ]
      }
    },
    "/dashboards/{id}/shares/{user_id}": {
      "delete": {
        "operationId": "dashboards_delete_share",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "user_id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "default": null
                }
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "dashboards"
        ]
      },
      "patch": {
        "operationId": "dashboards_update_share",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "user_id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateDashboardShare"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DashboardShareView"
                }
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "dashboards"
        ]
      }
    },
    "/email/unsubscribe": {
      "get": {
        "operationId": "email_unsubscribe_check",
        "parameters": [
          {
            "in": "query",
            "name": "u",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "s",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "t",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "tags": [
          "email"
        ]
      },
      "post": {
        "operationId": "email_unsubscribe_apply",
        "parameters": [
          {
            "in": "query",
            "name": "u",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "s",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "t",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "tags": [
          "email"
        ]
      }
    },
    "/export": {
      "get": {
        "operationId": "import_export_export",
        "parameters": [
          {
            "in": "query",
            "name": "format",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "export"
        ]
      }
    },
    "/health": {
      "get": {
        "operationId": "health_health",
        "responses": {
          "200": {
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "summary": "Liveness. Reports the running version so a deploy can confirm which build is live.",
        "tags": [
          "health"
        ]
      }
    },
    "/import": {
      "post": {
        "operationId": "import_export_import",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ImportBody"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "import"
        ]
      }
    },
    "/import/preview": {
      "post": {
        "operationId": "import_export_preview",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ImportBody"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ImportPreview"
                }
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "summary": "What an import of this file would do: which bookmarks are already in the library, and\nhow many folders would be reused. Writes nothing.",
        "tags": [
          "import"
        ]
      }
    },
    "/metrics": {
      "get": {
        "operationId": "metrics_metrics_handler",
        "responses": {
          "200": {
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "tags": [
          "metrics"
        ]
      }
    },
    "/notifications": {
      "get": {
        "operationId": "notifications_list",
        "parameters": [
          {
            "in": "query",
            "name": "limit",
            "required": false,
            "schema": {
              "format": "int64",
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "notifications"
        ]
      }
    },
    "/notifications/read-all": {
      "post": {
        "operationId": "notifications_read_all",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "notifications"
        ]
      }
    },
    "/notifications/unread-count": {
      "get": {
        "operationId": "notifications_unread_count",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "notifications"
        ]
      }
    },
    "/notifications/{id}/read": {
      "post": {
        "operationId": "notifications_read_one",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "notifications"
        ]
      }
    },
    "/openapi.json": {
      "get": {
        "operationId": "api_openapi_json",
        "responses": {
          "200": {
            "content": {
              "application/json": {}
            },
            "description": "OpenAPI 3.1 document"
          }
        },
        "summary": "This API's OpenAPI 3.1 description.",
        "tags": [
          "meta"
        ]
      }
    },
    "/public/lists/{slug}": {
      "get": {
        "operationId": "public_get_public_list",
        "parameters": [
          {
            "in": "path",
            "name": "slug",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicListView"
                }
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "tags": [
          "public"
        ]
      }
    },
    "/public/lists/{slug}/bookmarks/{id}/favicon": {
      "get": {
        "operationId": "public_get_public_favicon",
        "parameters": [
          {
            "in": "path",
            "name": "slug",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "tags": [
          "public"
        ]
      }
    },
    "/public/lists/{slug}/bookmarks/{id}/og": {
      "get": {
        "operationId": "public_get_public_og",
        "parameters": [
          {
            "in": "path",
            "name": "slug",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "tags": [
          "public"
        ]
      }
    },
    "/public/lists/{slug}/bookmarks/{id}/preview": {
      "get": {
        "operationId": "public_get_public_preview",
        "parameters": [
          {
            "in": "path",
            "name": "slug",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "tags": [
          "public"
        ]
      }
    },
    "/ready": {
      "get": {
        "operationId": "health_ready",
        "responses": {
          "200": {
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "summary": "Liveness of dependencies (Postgres + Meilisearch). Use for Compose / k8s probes.",
        "tags": [
          "ready"
        ]
      }
    },
    "/reports": {
      "post": {
        "operationId": "reports_create_report",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateAbuseReport"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "reports"
        ]
      }
    },
    "/reports/config": {
      "get": {
        "operationId": "reports_report_config",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "summary": "Where to send abuse and takedown requests that do not fit the report form.",
        "tags": [
          "reports"
        ]
      }
    },
    "/search": {
      "get": {
        "operationId": "search_search",
        "parameters": [
          {
            "in": "query",
            "name": "q",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "limit",
            "required": false,
            "schema": {
              "minimum": 0,
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "search"
        ]
      }
    },
    "/share-invites": {
      "get": {
        "operationId": "share_invites_list",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "share-invites"
        ]
      }
    },
    "/share-invites/{id}/accept": {
      "post": {
        "operationId": "share_invites_accept",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "share-invites"
        ]
      }
    },
    "/share-invites/{id}/reject": {
      "post": {
        "operationId": "share_invites_reject",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "share-invites"
        ]
      }
    },
    "/share-invites/{id}/restore": {
      "post": {
        "operationId": "share_invites_restore",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "share-invites"
        ]
      }
    },
    "/shares/claim": {
      "post": {
        "operationId": "share_invites_claim",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ClaimRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "summary": "Claim an invite link while signed in. The invite must be for this account's address; it\nthen shows up with the other invites to accept.",
        "tags": [
          "shares"
        ]
      }
    },
    "/social/comments/{id}": {
      "delete": {
        "operationId": "social_delete_comment",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "social"
        ]
      }
    },
    "/social/{subject_type}/{subject_id}": {
      "get": {
        "operationId": "social_summary",
        "parameters": [
          {
            "in": "path",
            "name": "subject_type",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "subject_id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "social"
        ]
      }
    },
    "/social/{subject_type}/{subject_id}/comments": {
      "post": {
        "operationId": "social_comment",
        "parameters": [
          {
            "in": "path",
            "name": "subject_type",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "subject_id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateSocialComment"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "social"
        ]
      }
    },
    "/social/{subject_type}/{subject_id}/like": {
      "delete": {
        "operationId": "social_unlike",
        "parameters": [
          {
            "in": "path",
            "name": "subject_type",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "subject_id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "social"
        ]
      },
      "post": {
        "operationId": "social_like",
        "parameters": [
          {
            "in": "path",
            "name": "subject_type",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "subject_id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "social"
        ]
      }
    },
    "/social/{subject_type}/{subject_id}/rating": {
      "delete": {
        "operationId": "social_unrate",
        "parameters": [
          {
            "in": "path",
            "name": "subject_type",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "subject_id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "social"
        ]
      },
      "post": {
        "operationId": "social_rate",
        "parameters": [
          {
            "in": "path",
            "name": "subject_type",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "subject_id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpsertSocialRating"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "social"
        ]
      }
    },
    "/tags": {
      "get": {
        "operationId": "tags_list",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/Tag"
                  },
                  "type": "array"
                }
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "tags"
        ]
      }
    },
    "/trash": {
      "get": {
        "operationId": "trash_list",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/TrashItem"
                  },
                  "type": "array"
                }
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "trash"
        ]
      }
    },
    "/trash/purge": {
      "post": {
        "operationId": "trash_purge_selected",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PurgeTrashRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "trash"
        ]
      }
    },
    "/trash/{kind}/{id}": {
      "delete": {
        "operationId": "trash_purge_one",
        "parameters": [
          {
            "in": "path",
            "name": "kind",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "trash"
        ]
      }
    },
    "/trash/{kind}/{id}/restore": {
      "post": {
        "operationId": "trash_restore",
        "parameters": [
          {
            "in": "path",
            "name": "kind",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "trash"
        ]
      }
    },
    "/users/me": {
      "patch": {
        "operationId": "users_update_me",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateProfile"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "users"
        ]
      }
    },
    "/users/me/avatar": {
      "delete": {
        "operationId": "users_delete_avatar",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "users"
        ]
      },
      "get": {
        "operationId": "users_get_avatar",
        "responses": {
          "200": {
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "users"
        ]
      },
      "post": {
        "operationId": "users_upload_avatar",
        "requestBody": {
          "content": {
            "multipart/form-data": {}
          },
          "description": "A `file` field with the image."
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "users"
        ]
      }
    },
    "/users/me/blocked": {
      "get": {
        "operationId": "users_my_blocked",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "users"
        ]
      }
    },
    "/users/me/deletion": {
      "delete": {
        "operationId": "users_cancel_deletion",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "users"
        ]
      },
      "post": {
        "operationId": "users_schedule_deletion",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ScheduleAccountDeletion"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "summary": "Schedules the account for deletion after the grace period. The session stays signed in, so\nthe person can still export their data and cancel.",
        "tags": [
          "users"
        ]
      }
    },
    "/users/me/followers": {
      "get": {
        "operationId": "users_my_followers",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "users"
        ]
      }
    },
    "/users/me/following": {
      "get": {
        "operationId": "users_my_following",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "users"
        ]
      }
    },
    "/users/me/muted": {
      "get": {
        "operationId": "users_my_muted",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "users"
        ]
      }
    },
    "/users/me/notification-emails": {
      "get": {
        "operationId": "users_notification_emails",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "summary": "Which notification kinds the user also gets by email, and how, in settings order.",
        "tags": [
          "users"
        ]
      }
    },
    "/users/me/notification-emails/{kind}": {
      "put": {
        "operationId": "users_set_notification_email",
        "parameters": [
          {
            "in": "path",
            "name": "kind",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SetNotificationEmail"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "users"
        ]
      }
    },
    "/users/me/passkeys": {
      "get": {
        "operationId": "auth_passkey_list",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "users"
        ]
      }
    },
    "/users/me/passkeys/register/finish": {
      "post": {
        "operationId": "auth_passkey_register_finish",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/RegisterFinish"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "summary": "Saves the passkey the browser made, and tells the account's address.",
        "tags": [
          "users"
        ]
      }
    },
    "/users/me/passkeys/register/start": {
      "post": {
        "operationId": "auth_passkey_register_start",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/RegisterStart"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "summary": "Starts adding a passkey to the signed-in account. Login sessions only, not API keys.",
        "tags": [
          "users"
        ]
      }
    },
    "/users/me/passkeys/{id}": {
      "delete": {
        "operationId": "auth_passkey_remove",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "summary": "Removes a passkey. Passkeys are never an account's only way in, so no check is needed.",
        "tags": [
          "users"
        ]
      },
      "patch": {
        "operationId": "auth_passkey_rename",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Rename"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "users"
        ]
      }
    },
    "/users/me/password": {
      "post": {
        "operationId": "users_change_password",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ChangePassword"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "users"
        ]
      }
    },
    "/users/me/quota-usage": {
      "get": {
        "operationId": "users_quota_usage",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "users"
        ]
      }
    },
    "/users/me/settings": {
      "get": {
        "operationId": "users_get_settings",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "users"
        ]
      },
      "patch": {
        "operationId": "users_patch_settings",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateSettings"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "users"
        ]
      }
    },
    "/users/me/terms": {
      "post": {
        "operationId": "users_accept_terms",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AcceptTerms"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "summary": "Accepts the current Terms of Service, after they changed since the account last did.",
        "tags": [
          "users"
        ]
      }
    },
    "/users/{id}/avatar": {
      "get": {
        "operationId": "users_user_avatar",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "users"
        ]
      }
    },
    "/users/{id}/block": {
      "delete": {
        "operationId": "users_unblock_user",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "users"
        ]
      },
      "post": {
        "operationId": "users_block_user",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "users"
        ]
      }
    },
    "/users/{id}/block-status": {
      "get": {
        "operationId": "users_block_status",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "users"
        ]
      }
    },
    "/users/{id}/bookmarks": {
      "get": {
        "operationId": "users_user_bookmarks",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "limit",
            "required": false,
            "schema": {
              "format": "int64",
              "type": "integer"
            }
          },
          {
            "in": "query",
            "name": "offset",
            "required": false,
            "schema": {
              "format": "int64",
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProfileBookmarksPage"
                }
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "users"
        ]
      }
    },
    "/users/{id}/follow": {
      "delete": {
        "operationId": "users_unfollow_user",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "users"
        ]
      },
      "post": {
        "operationId": "users_follow_user",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "users"
        ]
      }
    },
    "/users/{id}/follow-status": {
      "get": {
        "operationId": "users_follow_status",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "users"
        ]
      }
    },
    "/users/{id}/followers": {
      "get": {
        "operationId": "users_user_followers",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "users"
        ]
      }
    },
    "/users/{id}/following": {
      "get": {
        "operationId": "users_user_following",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "users"
        ]
      }
    },
    "/users/{id}/mute": {
      "delete": {
        "operationId": "users_unmute_user",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "users"
        ]
      },
      "post": {
        "operationId": "users_mute_user",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "users"
        ]
      }
    },
    "/users/{id}/mute-status": {
      "get": {
        "operationId": "users_mute_status",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "users"
        ]
      }
    },
    "/users/{id}/profile": {
      "get": {
        "operationId": "users_user_profile",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProfileView"
                }
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "users"
        ]
      }
    },
    "/vaults": {
      "get": {
        "operationId": "vault_list",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "vaults"
        ]
      },
      "post": {
        "operationId": "vault_create",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateVaultRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "vaults"
        ]
      }
    },
    "/vaults/global": {
      "delete": {
        "operationId": "vault_global_disable",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/VaultUnlockRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "vaults"
        ]
      },
      "get": {
        "operationId": "vault_global_status",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "vaults"
        ]
      },
      "post": {
        "operationId": "vault_global_enable",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/VaultUnlockRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "vaults"
        ]
      },
      "put": {
        "operationId": "vault_global_change",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ChangeGlobalPassphraseRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "vaults"
        ]
      }
    },
    "/vaults/global/unlock": {
      "post": {
        "operationId": "vault_global_unlock",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/VaultUnlockRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "vaults"
        ]
      }
    },
    "/vaults/lock-all": {
      "post": {
        "operationId": "vault_lock_all",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "vaults"
        ]
      }
    },
    "/vaults/move": {
      "post": {
        "operationId": "vault_move_items",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/MoveToVaultRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "vaults"
        ]
      }
    },
    "/vaults/{id}": {
      "delete": {
        "operationId": "vault_delete_one",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/DeleteVaultRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "vaults"
        ]
      },
      "patch": {
        "operationId": "vault_rename",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/RenameVaultRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "vaults"
        ]
      }
    },
    "/vaults/{id}/global": {
      "delete": {
        "operationId": "vault_global_leave",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "vaults"
        ]
      },
      "post": {
        "operationId": "vault_global_join",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "vaults"
        ]
      }
    },
    "/vaults/{id}/lock": {
      "post": {
        "operationId": "vault_lock_one",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "vaults"
        ]
      }
    },
    "/vaults/{id}/recover": {
      "post": {
        "operationId": "vault_recover",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/RecoverVaultRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "vaults"
        ]
      }
    },
    "/vaults/{id}/recovery-key": {
      "post": {
        "operationId": "vault_new_recovery_key",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/VaultUnlockRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "summary": "Replacing the recovery key cancels the old one, so it takes the vault passphrase even\nwhen the vault is unlocked.",
        "tags": [
          "vaults"
        ]
      }
    },
    "/vaults/{id}/unlock": {
      "post": {
        "operationId": "vault_unlock_one",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/VaultUnlockRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "OK"
          },
          "4XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Client error"
          },
          "5XX": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "description": "Server error"
          }
        },
        "security": [
          {
            "api_key": []
          },
          {
            "session_cookie": []
          }
        ],
        "tags": [
          "vaults"
        ]
      }
    }
  },
  "servers": [
    {
      "description": "This instance",
      "url": "/api"
    }
  ]
}
