Skip to content

High performance self-hosted photo and video management solution.

1.0 MB
Raw Blame
{
  "openapi": "3.0.0",
  "paths": {
    "/activities": {
      "get": {
        "description": "Returns a list of activities for the selected asset or album. The activities are returned in sorted order, with the oldest activities appearing first.",
        "operationId": "getActivities",
        "parameters": [
          {
            "name": "albumId",
            "required": true,
            "in": "query",
            "description": "Album ID",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          },
          {
            "name": "assetId",
            "required": false,
            "in": "query",
            "description": "Asset ID (if activity is for an asset)",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          },
          {
            "name": "level",
            "required": false,
            "in": "query",
            "schema": {
              "$ref": "#/components/schemas/ReactionLevel"
            }
          },
          {
            "name": "type",
            "required": false,
            "in": "query",
            "schema": {
              "$ref": "#/components/schemas/ReactionType"
            }
          },
          {
            "name": "userId",
            "required": false,
            "in": "query",
            "description": "Filter by user ID",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/ActivityResponseDto"
                  },
                  "type": "array"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "List all activities",
        "tags": [
          "Activities"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "activity.read",
        "x-immich-state": "Stable"
      },
      "post": {
        "description": "Create a like or a comment for an album, or an asset in an album.",
        "operationId": "createActivity",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ActivityCreateDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ActivityResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Create an activity",
        "tags": [
          "Activities"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "activity.create",
        "x-immich-state": "Stable"
      }
    },
    "/activities/statistics": {
      "get": {
        "description": "Returns the number of likes and comments for a given album or asset in an album.",
        "operationId": "getActivityStatistics",
        "parameters": [
          {
            "name": "albumId",
            "required": true,
            "in": "query",
            "description": "Album ID",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          },
          {
            "name": "assetId",
            "required": false,
            "in": "query",
            "description": "Asset ID (if activity is for an asset)",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ActivityStatisticsResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Retrieve activity statistics",
        "tags": [
          "Activities"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "activity.statistics",
        "x-immich-state": "Stable"
      }
    },
    "/activities/{id}": {
      "delete": {
        "description": "Removes a like or comment from a given album or asset in an album.",
        "operationId": "deleteActivity",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          }
        ],
        "responses": {
          "204": {
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Delete an activity",
        "tags": [
          "Activities"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "activity.delete",
        "x-immich-state": "Stable"
      }
    },
    "/admin/auth/unlink-all": {
      "post": {
        "description": "Unlinks all OAuth accounts associated with user accounts in the system.",
        "operationId": "unlinkAllOAuthAccountsAdmin",
        "parameters": [],
        "responses": {
          "204": {
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Unlink all OAuth accounts",
        "tags": [
          "Authentication (admin)"
        ],
        "x-immich-admin-only": true,
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "adminAuth.unlinkAll",
        "x-immich-state": "Stable"
      }
    },
    "/admin/config": {
      "get": {
        "description": "Retrieve admin configuration.",
        "operationId": "getAdminConfig",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AdminConfigDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Get the admin configuration",
        "tags": [
          "Config (admin)"
        ],
        "x-immich-admin-only": true,
        "x-immich-history": [
          {
            "version": "v3.2.0",
            "state": "Added"
          },
          {
            "version": "v3.2.0",
            "state": "Alpha"
          }
        ],
        "x-immich-permission": "adminConfig.read",
        "x-immich-state": "Alpha"
      },
      "put": {
        "description": "Update the system configuration with a new system configuration.",
        "operationId": "updateAdminConfig",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AdminConfigDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AdminConfigDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Update the system configuration",
        "tags": [
          "Config (admin)"
        ],
        "x-immich-admin-only": true,
        "x-immich-history": [
          {
            "version": "v3.2.0",
            "state": "Added"
          },
          {
            "version": "v3.2.0",
            "state": "Alpha"
          }
        ],
        "x-immich-permission": "adminConfig.update",
        "x-immich-state": "Alpha"
      }
    },
    "/admin/config/defaults": {
      "get": {
        "description": "Retrieve the default value of every system configuration property.",
        "operationId": "getAdminConfigDefaults",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AdminConfigDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Get the system configuration defaults",
        "tags": [
          "Config (admin)"
        ],
        "x-immich-admin-only": true,
        "x-immich-history": [
          {
            "version": "v3.2.0",
            "state": "Added"
          },
          {
            "version": "v3.2.0",
            "state": "Alpha"
          }
        ],
        "x-immich-permission": "adminConfig.read",
        "x-immich-state": "Alpha"
      }
    },
    "/admin/database-backups": {
      "delete": {
        "description": "Delete a backup by its filename",
        "operationId": "deleteDatabaseBackup",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/DatabaseBackupDeleteDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Delete database backup",
        "tags": [
          "Database Backups (admin)"
        ],
        "x-immich-admin-only": true,
        "x-immich-history": [
          {
            "version": "v2.5.0",
            "state": "Added"
          },
          {
            "version": "v2.5.0",
            "state": "Alpha"
          }
        ],
        "x-immich-permission": "backup.delete",
        "x-immich-state": "Alpha"
      },
      "get": {
        "description": "Get the list of the successful and failed backups",
        "operationId": "listDatabaseBackups",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DatabaseBackupListResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "List database backups",
        "tags": [
          "Database Backups (admin)"
        ],
        "x-immich-admin-only": true,
        "x-immich-history": [
          {
            "version": "v2.5.0",
            "state": "Added"
          },
          {
            "version": "v2.5.0",
            "state": "Alpha"
          }
        ],
        "x-immich-permission": "maintenance",
        "x-immich-state": "Alpha"
      }
    },
    "/admin/database-backups/start-restore": {
      "post": {
        "description": "Put Immich into maintenance mode to restore a backup (Immich must not be configured)",
        "operationId": "startDatabaseRestoreFlow",
        "parameters": [],
        "responses": {
          "201": {
            "description": ""
          }
        },
        "summary": "Start database backup restore flow",
        "tags": [
          "Database Backups (admin)"
        ],
        "x-immich-history": [
          {
            "version": "v2.5.0",
            "state": "Added"
          },
          {
            "version": "v2.5.0",
            "state": "Alpha"
          }
        ],
        "x-immich-state": "Alpha"
      }
    },
    "/admin/database-backups/upload": {
      "post": {
        "description": "Uploads .sql/.sql.gz file to restore backup from",
        "operationId": "uploadDatabaseBackup",
        "parameters": [],
        "requestBody": {
          "content": {
            "multipart/form-data": {
              "schema": {
                "$ref": "#/components/schemas/DatabaseBackupUploadDto"
              }
            }
          },
          "description": "Backup Upload",
          "required": true
        },
        "responses": {
          "201": {
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Upload database backup",
        "tags": [
          "Database Backups (admin)"
        ],
        "x-immich-admin-only": true,
        "x-immich-history": [
          {
            "version": "v2.5.0",
            "state": "Added"
          },
          {
            "version": "v2.5.0",
            "state": "Alpha"
          }
        ],
        "x-immich-permission": "backup.upload",
        "x-immich-state": "Alpha"
      }
    },
    "/admin/database-backups/{filename}": {
      "get": {
        "description": "Downloads the database backup file",
        "operationId": "downloadDatabaseBackup",
        "parameters": [
          {
            "name": "filename",
            "required": true,
            "in": "path",
            "schema": {
              "pattern": "^[a-zA-Z0-9_\\-.]+$",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/octet-stream": {
                "schema": {
                  "format": "binary",
                  "type": "string"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Download database backup",
        "tags": [
          "Database Backups (admin)"
        ],
        "x-immich-admin-only": true,
        "x-immich-history": [
          {
            "version": "v2.5.0",
            "state": "Added"
          },
          {
            "version": "v2.5.0",
            "state": "Alpha"
          }
        ],
        "x-immich-permission": "backup.download",
        "x-immich-state": "Alpha"
      }
    },
    "/admin/integrity/report": {
      "get": {
        "description": "Get all flagged items by integrity report type",
        "operationId": "getIntegrityReport",
        "parameters": [
          {
            "name": "cursor",
            "required": false,
            "in": "query",
            "description": "Cursor for pagination",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "limit",
            "required": false,
            "in": "query",
            "description": "Number of items per page",
            "schema": {
              "maximum": 9007199254740991,
              "exclusiveMinimum": true,
              "default": 500,
              "type": "integer",
              "minimum": 0
            }
          },
          {
            "name": "type",
            "required": true,
            "in": "query",
            "schema": {
              "$ref": "#/components/schemas/IntegrityReport"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/IntegrityReportResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Get integrity report by type",
        "tags": [
          "Maintenance (admin)"
        ],
        "x-immich-admin-only": true,
        "x-immich-history": [
          {
            "version": "v3.0.0",
            "state": "Added"
          },
          {
            "version": "v3.0.0",
            "state": "Alpha"
          }
        ],
        "x-immich-permission": "maintenance",
        "x-immich-state": "Alpha"
      }
    },
    "/admin/integrity/report/{id}": {
      "delete": {
        "description": "Delete a given report item and perform corresponding deletion (e.g. trash asset, delete file)",
        "operationId": "deleteIntegrityReport",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-7[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Delete integrity report item",
        "tags": [
          "Maintenance (admin)"
        ],
        "x-immich-admin-only": true,
        "x-immich-history": [
          {
            "version": "v3.0.0",
            "state": "Added"
          },
          {
            "version": "v3.0.0",
            "state": "Alpha"
          }
        ],
        "x-immich-permission": "maintenance",
        "x-immich-state": "Alpha"
      }
    },
    "/admin/integrity/report/{id}/file": {
      "get": {
        "description": "Download the untracked/broken file if one exists",
        "operationId": "getIntegrityReportFile",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-7[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/octet-stream": {
                "schema": {
                  "format": "binary",
                  "type": "string"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Download flagged file",
        "tags": [
          "Maintenance (admin)"
        ],
        "x-immich-admin-only": true,
        "x-immich-history": [
          {
            "version": "v3.0.0",
            "state": "Added"
          },
          {
            "version": "v3.0.0",
            "state": "Alpha"
          }
        ],
        "x-immich-permission": "maintenance",
        "x-immich-state": "Alpha"
      }
    },
    "/admin/integrity/report/{type}/csv": {
      "get": {
        "description": "Get all integrity report entries for a given type as a CSV",
        "operationId": "getIntegrityReportCsv",
        "parameters": [
          {
            "name": "type",
            "required": true,
            "in": "path",
            "schema": {
              "$ref": "#/components/schemas/IntegrityReport"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/octet-stream": {
                "schema": {
                  "format": "binary",
                  "type": "string"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Export integrity report by type as CSV",
        "tags": [
          "Maintenance (admin)"
        ],
        "x-immich-admin-only": true,
        "x-immich-history": [
          {
            "version": "v3.0.0",
            "state": "Added"
          },
          {
            "version": "v3.0.0",
            "state": "Alpha"
          }
        ],
        "x-immich-permission": "maintenance",
        "x-immich-state": "Alpha"
      }
    },
    "/admin/integrity/summary": {
      "get": {
        "description": "Get a count of the items flagged in each integrity report",
        "operationId": "getIntegrityReportSummary",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/IntegrityReportSummaryResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Get integrity report summary",
        "tags": [
          "Maintenance (admin)"
        ],
        "x-immich-admin-only": true,
        "x-immich-history": [
          {
            "version": "v3.0.0",
            "state": "Added"
          },
          {
            "version": "v3.0.0",
            "state": "Alpha"
          }
        ],
        "x-immich-permission": "maintenance",
        "x-immich-state": "Alpha"
      }
    },
    "/admin/maintenance": {
      "post": {
        "description": "Put Immich into or take it out of maintenance mode",
        "operationId": "setMaintenanceMode",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SetMaintenanceModeDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Set maintenance mode",
        "tags": [
          "Maintenance (admin)"
        ],
        "x-immich-admin-only": true,
        "x-immich-history": [
          {
            "version": "v2.3.0",
            "state": "Added"
          },
          {
            "version": "v2.3.0",
            "state": "Alpha"
          }
        ],
        "x-immich-permission": "maintenance",
        "x-immich-state": "Alpha"
      }
    },
    "/admin/maintenance/detect-install": {
      "get": {
        "description": "Collect integrity checks and other heuristics about local data.",
        "operationId": "detectPriorInstall",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MaintenanceDetectInstallResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Detect existing install",
        "tags": [
          "Maintenance (admin)"
        ],
        "x-immich-admin-only": true,
        "x-immich-history": [
          {
            "version": "v2.5.0",
            "state": "Added"
          },
          {
            "version": "v2.5.0",
            "state": "Alpha"
          }
        ],
        "x-immich-permission": "maintenance",
        "x-immich-state": "Alpha"
      }
    },
    "/admin/maintenance/login": {
      "post": {
        "description": "Login with maintenance token or cookie to receive current information and perform further actions.",
        "operationId": "maintenanceLogin",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/MaintenanceLoginDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MaintenanceAuthDto"
                }
              }
            },
            "description": ""
          }
        },
        "summary": "Log into maintenance mode",
        "tags": [
          "Maintenance (admin)"
        ],
        "x-immich-history": [
          {
            "version": "v2.3.0",
            "state": "Added"
          },
          {
            "version": "v2.3.0",
            "state": "Alpha"
          }
        ],
        "x-immich-state": "Alpha"
      }
    },
    "/admin/maintenance/status": {
      "get": {
        "description": "Fetch information about the currently running maintenance action.",
        "operationId": "getMaintenanceStatus",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MaintenanceStatusResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "summary": "Get maintenance mode status",
        "tags": [
          "Maintenance (admin)"
        ],
        "x-immich-history": [
          {
            "version": "v2.5.0",
            "state": "Added"
          },
          {
            "version": "v2.5.0",
            "state": "Alpha"
          }
        ],
        "x-immich-state": "Alpha"
      }
    },
    "/admin/notifications": {
      "post": {
        "description": "Create a new notification for a specific user.",
        "operationId": "createNotification",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/NotificationCreateDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/NotificationDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Create a notification",
        "tags": [
          "Notifications (admin)"
        ],
        "x-immich-admin-only": true,
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "notification.create",
        "x-immich-state": "Stable"
      }
    },
    "/admin/notifications/templates/{name}": {
      "post": {
        "description": "Retrieve a preview of the provided email template.",
        "operationId": "getNotificationTemplateAdmin",
        "parameters": [
          {
            "name": "name",
            "required": true,
            "in": "path",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/TemplateDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TemplateResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Render email template",
        "tags": [
          "Notifications (admin)"
        ],
        "x-immich-admin-only": true,
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "notification.create",
        "x-immich-state": "Stable"
      }
    },
    "/admin/notifications/test-email": {
      "post": {
        "description": "Send a test email using the provided SMTP configuration.",
        "operationId": "sendTestEmailAdmin",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AdminConfigSmtpDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TestEmailResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Send test email",
        "tags": [
          "Notifications (admin)"
        ],
        "x-immich-admin-only": true,
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "notification.create",
        "x-immich-state": "Stable"
      }
    },
    "/admin/users": {
      "get": {
        "description": "Search for users.",
        "operationId": "searchUsersAdmin",
        "parameters": [
          {
            "name": "id",
            "required": false,
            "in": "query",
            "description": "User ID filter",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          },
          {
            "name": "withDeleted",
            "required": false,
            "in": "query",
            "description": "Include deleted users",
            "schema": {
              "type": "boolean"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/UserAdminResponseDto"
                  },
                  "type": "array"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Search users",
        "tags": [
          "Users (admin)"
        ],
        "x-immich-admin-only": true,
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "adminUser.read",
        "x-immich-state": "Stable"
      },
      "post": {
        "description": "Create a new user.",
        "operationId": "createUserAdmin",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UserAdminCreateDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UserAdminResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Create a user",
        "tags": [
          "Users (admin)"
        ],
        "x-immich-admin-only": true,
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "adminUser.create",
        "x-immich-state": "Stable"
      }
    },
    "/admin/users/{id}": {
      "delete": {
        "description": "Delete a user.",
        "operationId": "deleteUserAdmin",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UserAdminDeleteDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UserAdminResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Delete a user",
        "tags": [
          "Users (admin)"
        ],
        "x-immich-admin-only": true,
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "adminUser.delete",
        "x-immich-state": "Stable"
      },
      "get": {
        "description": "Retrieve  a specific user by their ID.",
        "operationId": "getUserAdmin",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UserAdminResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Retrieve a user",
        "tags": [
          "Users (admin)"
        ],
        "x-immich-admin-only": true,
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "adminUser.read",
        "x-immich-state": "Stable"
      },
      "put": {
        "description": "Update an existing user.",
        "operationId": "updateUserAdmin",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UserAdminUpdateDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UserAdminResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Update a user",
        "tags": [
          "Users (admin)"
        ],
        "x-immich-admin-only": true,
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          },
          {
            "version": "v3.0.0",
            "state": "Updated",
            "description": "This endpoint now also supports PATCH, in addition to PUT. PATCH will become the default in v4, and then PUT will be dropped in v5. Please migrate accordingly."
          }
        ],
        "x-immich-permission": "adminUser.update",
        "x-immich-state": "Stable"
      }
    },
    "/admin/users/{id}/calendar-heatmap": {
      "get": {
        "description": "Retrieve activity counts for a specified period, in a calendar heatmap format.",
        "operationId": "getUserCalendarHeatmapAdmin",
        "parameters": [
          {
            "name": "from",
            "required": false,
            "in": "query",
            "description": "Start date in UTC",
            "schema": {
              "format": "date",
              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
              "example": "2024-01-01",
              "type": "string"
            }
          },
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          },
          {
            "name": "to",
            "required": false,
            "in": "query",
            "description": "End date in UTC",
            "schema": {
              "format": "date",
              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
              "example": "2024-01-01",
              "type": "string"
            }
          },
          {
            "name": "type",
            "required": false,
            "in": "query",
            "schema": {
              "default": "Upload",
              "$ref": "#/components/schemas/CalendarHeatmapType"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CalendarHeatmapResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Retrieve calendar heatmap activity",
        "tags": [
          "Users (admin)"
        ],
        "x-immich-admin-only": true,
        "x-immich-history": [
          {
            "version": "v3",
            "state": "Added"
          },
          {
            "version": "v3",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "adminUser.read",
        "x-immich-state": "Stable"
      }
    },
    "/admin/users/{id}/preferences": {
      "get": {
        "description": "Retrieve the preferences of a specific user.",
        "operationId": "getUserPreferencesAdmin",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UserPreferencesResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Retrieve user preferences",
        "tags": [
          "Users (admin)"
        ],
        "x-immich-admin-only": true,
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "adminUser.read",
        "x-immich-state": "Stable"
      },
      "put": {
        "description": "Update the preferences of a specific user.",
        "operationId": "updateUserPreferencesAdmin",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UserPreferencesUpdateDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UserPreferencesResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Update user preferences",
        "tags": [
          "Users (admin)"
        ],
        "x-immich-admin-only": true,
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          },
          {
            "version": "v3.0.0",
            "state": "Updated",
            "description": "This endpoint now also supports PATCH, in addition to PUT. PATCH will become the default in v4, and then PUT will be dropped in v5. Please migrate accordingly."
          }
        ],
        "x-immich-permission": "adminUser.update",
        "x-immich-state": "Stable"
      }
    },
    "/admin/users/{id}/restore": {
      "post": {
        "description": "Restore a previously deleted user.",
        "operationId": "restoreUserAdmin",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UserAdminResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Restore a deleted user",
        "tags": [
          "Users (admin)"
        ],
        "x-immich-admin-only": true,
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "adminUser.delete",
        "x-immich-state": "Stable"
      }
    },
    "/admin/users/{id}/sessions": {
      "get": {
        "description": "Retrieve all sessions for a specific user.",
        "operationId": "getUserSessionsAdmin",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/SessionResponseDto"
                  },
                  "type": "array"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Retrieve user sessions",
        "tags": [
          "Users (admin)"
        ],
        "x-immich-admin-only": true,
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "adminSession.read",
        "x-immich-state": "Stable"
      }
    },
    "/admin/users/{id}/statistics": {
      "get": {
        "description": "Retrieve asset statistics for a specific user.",
        "operationId": "getUserStatisticsAdmin",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          },
          {
            "name": "isFavorite",
            "required": false,
            "in": "query",
            "description": "Filter by favorite status",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "isTrashed",
            "required": false,
            "in": "query",
            "description": "Filter by trash status",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "visibility",
            "required": false,
            "in": "query",
            "schema": {
              "$ref": "#/components/schemas/AssetVisibility"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AssetStatsResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Retrieve user statistics",
        "tags": [
          "Users (admin)"
        ],
        "x-immich-admin-only": true,
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "adminUser.read",
        "x-immich-state": "Stable"
      }
    },
    "/albums": {
      "get": {
        "description": "Retrieve a list of albums available to the authenticated user.",
        "operationId": "getAllAlbums",
        "parameters": [
          {
            "name": "assetId",
            "required": false,
            "in": "query",
            "description": "Filter albums containing this asset ID (ignores other parameters)",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          },
          {
            "name": "id",
            "required": false,
            "in": "query",
            "description": "Album ID",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          },
          {
            "name": "isOwned",
            "required": false,
            "in": "query",
            "description": "Filter by ownership: true = only owned, false = only shared-with-me, undefined = no filter",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "isShared",
            "required": false,
            "in": "query",
            "description": "Filter by shared status: true = only shared, false = not shared, undefined = no filter",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "name",
            "required": false,
            "in": "query",
            "description": "Album name (exact match)",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/AlbumResponseDto"
                  },
                  "type": "array"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "List all albums",
        "tags": [
          "Albums"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "album.read",
        "x-immich-state": "Stable"
      },
      "post": {
        "description": "Create a new album. The album can also be created with initial users and assets.",
        "operationId": "createAlbum",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateAlbumDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AlbumResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Create an album",
        "tags": [
          "Albums"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "album.create",
        "x-immich-state": "Stable"
      }
    },
    "/albums/assets": {
      "put": {
        "description": "Send a list of asset IDs and album IDs to add each asset to each album.",
        "operationId": "addAssetsToAlbums",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AlbumsAddAssetsDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AlbumsAddAssetsResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Add assets to albums",
        "tags": [
          "Albums"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "albumAsset.create",
        "x-immich-state": "Stable"
      }
    },
    "/albums/statistics": {
      "get": {
        "description": "Returns statistics about the albums available to the authenticated user.",
        "operationId": "getAlbumStatistics",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AlbumStatisticsResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Retrieve album statistics",
        "tags": [
          "Albums"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "album.statistics",
        "x-immich-state": "Stable"
      }
    },
    "/albums/{id}": {
      "delete": {
        "description": "Delete a specific album by its ID. Note the album is initially trashed and then immediately scheduled for deletion, but relies on a background job to complete the process.",
        "operationId": "deleteAlbum",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          }
        ],
        "responses": {
          "204": {
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Delete an album",
        "tags": [
          "Albums"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "album.delete",
        "x-immich-state": "Stable"
      },
      "get": {
        "description": "Retrieve information about a specific album by its ID.",
        "operationId": "getAlbumInfo",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          },
          {
            "name": "key",
            "required": false,
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "slug",
            "required": false,
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AlbumResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Retrieve an album",
        "tags": [
          "Albums"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "album.read",
        "x-immich-state": "Stable"
      },
      "patch": {
        "description": "Update the information of a specific album by its ID. This endpoint can be used to update the album name, description, sort order, etc. However, it is not used to add or remove assets or users from the album.",
        "operationId": "updateAlbumInfo",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateAlbumDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AlbumResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Update an album",
        "tags": [
          "Albums"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "album.update",
        "x-immich-state": "Stable"
      }
    },
    "/albums/{id}/assets": {
      "delete": {
        "description": "Remove multiple assets from a specific album by its ID.",
        "operationId": "removeAssetFromAlbum",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/BulkIdsDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/BulkIdResponseDto"
                  },
                  "type": "array"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Remove assets from an album",
        "tags": [
          "Albums"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "albumAsset.delete",
        "x-immich-state": "Stable"
      },
      "put": {
        "description": "Add multiple assets to a specific album by its ID.",
        "operationId": "addAssetsToAlbum",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/BulkIdsDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/BulkIdResponseDto"
                  },
                  "type": "array"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Add assets to an album",
        "tags": [
          "Albums"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "albumAsset.create",
        "x-immich-state": "Stable"
      }
    },
    "/albums/{id}/map-markers": {
      "get": {
        "description": "Retrieve map marker information for a specific album by its ID.",
        "operationId": "getAlbumMapMarkers",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          },
          {
            "name": "key",
            "required": false,
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "slug",
            "required": false,
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/MapMarkerResponseDto"
                  },
                  "type": "array"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Retrieve album map markers",
        "tags": [
          "Albums"
        ],
        "x-immich-history": [
          {
            "version": "v3",
            "state": "Added"
          }
        ],
        "x-immich-permission": "album.read"
      }
    },
    "/albums/{id}/user/{userId}": {
      "delete": {
        "description": "Remove a user from an album. Use an ID of \"me\" to leave a shared album.",
        "operationId": "removeUserFromAlbum",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "description": "Album ID",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          },
          {
            "name": "userId",
            "required": true,
            "in": "path",
            "description": "Album user ID, or \"me\" to reference the current user.",
            "x-immich-history": [
              {
                "version": "v3",
                "state": "Updated",
                "description": "\"me\" as a value is deprecated"
              }
            ],
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "204": {
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Remove user from album",
        "tags": [
          "Albums"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "albumUser.delete",
        "x-immich-state": "Stable"
      },
      "put": {
        "description": "Change the role for a specific user in a specific album.",
        "operationId": "updateAlbumUser",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "description": "Album ID",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          },
          {
            "name": "userId",
            "required": true,
            "in": "path",
            "description": "Album user ID, or \"me\" to reference the current user.",
            "x-immich-history": [
              {
                "version": "v3",
                "state": "Updated",
                "description": "\"me\" as a value is deprecated"
              }
            ],
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateAlbumUserDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "204": {
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Update user role",
        "tags": [
          "Albums"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "albumUser.update",
        "x-immich-state": "Stable"
      }
    },
    "/albums/{id}/users": {
      "put": {
        "description": "Share an album with multiple users. Each user can be given a specific role in the album.",
        "operationId": "addUsersToAlbum",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AddUsersDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AlbumResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Share album with users",
        "tags": [
          "Albums"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "albumUser.create",
        "x-immich-state": "Stable"
      }
    },
    "/api-keys": {
      "get": {
        "description": "Retrieve all API keys of the current user.",
        "operationId": "getApiKeys",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/ApiKeyResponseDto"
                  },
                  "type": "array"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "List all API keys",
        "tags": [
          "API keys"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "apiKey.read",
        "x-immich-state": "Stable"
      },
      "post": {
        "description": "Creates a new API key. It will be limited to the permissions specified.",
        "operationId": "createApiKey",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ApiKeyCreateDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiKeyCreateResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Create an API key",
        "tags": [
          "API keys"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "apiKey.create",
        "x-immich-state": "Stable"
      }
    },
    "/api-keys/me": {
      "get": {
        "description": "Retrieve the API key that is used to access this endpoint.",
        "operationId": "getMyApiKey",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiKeyResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Retrieve the current API key",
        "tags": [
          "API keys"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-state": "Stable"
      }
    },
    "/api-keys/{id}": {
      "delete": {
        "description": "Deletes an API key identified by its ID. The current user must own this API key.",
        "operationId": "deleteApiKey",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          }
        ],
        "responses": {
          "204": {
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Delete an API key",
        "tags": [
          "API keys"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "apiKey.delete",
        "x-immich-state": "Stable"
      },
      "get": {
        "description": "Retrieve an API key by its ID. The current user must own this API key.",
        "operationId": "getApiKey",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiKeyResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Retrieve an API key",
        "tags": [
          "API keys"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "apiKey.read",
        "x-immich-state": "Stable"
      },
      "put": {
        "description": "Updates the name and permissions of an API key by its ID. The current user must own this API key.",
        "operationId": "updateApiKey",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ApiKeyUpdateDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiKeyResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Update an API key",
        "tags": [
          "API keys"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          },
          {
            "version": "v3.0.0",
            "state": "Updated",
            "description": "This endpoint now also supports PATCH, in addition to PUT. PATCH will become the default in v4, and then PUT will be dropped in v5. Please migrate accordingly."
          }
        ],
        "x-immich-permission": "apiKey.update",
        "x-immich-state": "Stable"
      }
    },
    "/api-keys/{id}/rotate": {
      "post": {
        "description": "Generates a new secret for an API key, immediately invalidating the previous one. The current user must own this API key.",
        "operationId": "rotateApiKey",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          }
        ],
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiKeyCreateResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Rotate an API key",
        "tags": [
          "API keys"
        ],
        "x-immich-history": [
          {
            "version": "v3",
            "state": "Added"
          }
        ],
        "x-immich-permission": "apiKey.rotate"
      }
    },
    "/asset-files": {
      "get": {
        "description": "Returns all matching asset files.",
        "operationId": "searchAssetFiles",
        "parameters": [
          {
            "name": "assetId",
            "required": true,
            "in": "query",
            "description": "Asset ID to filter files by",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          },
          {
            "name": "isEdited",
            "required": false,
            "in": "query",
            "description": "The file was generated from an edit",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "isProgressive",
            "required": false,
            "in": "query",
            "description": "The file is a progressively encoded JPEG",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "isTransparent",
            "required": false,
            "in": "query",
            "description": "The file is transparent",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "type",
            "required": false,
            "in": "query",
            "description": "Filter by type of file",
            "schema": {
              "$ref": "#/components/schemas/AssetFileType"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/AssetFileResponseDto"
                  },
                  "type": "array"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Search asset files",
        "tags": [
          "Asset files"
        ],
        "x-immich-history": [
          {
            "version": "v3.2.0",
            "state": "Added"
          },
          {
            "version": "v3.2.0",
            "state": "Alpha"
          }
        ],
        "x-immich-permission": "assetFile.read",
        "x-immich-state": "Alpha"
      }
    },
    "/asset-files/{id}": {
      "delete": {
        "description": "Delete a file and remove it from the database.",
        "operationId": "deleteAssetFile",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          }
        ],
        "responses": {
          "204": {
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Delete an asset file",
        "tags": [
          "Asset files"
        ],
        "x-immich-history": [
          {
            "version": "v3.2.0",
            "state": "Added"
          },
          {
            "version": "v3.2.0",
            "state": "Alpha"
          }
        ],
        "x-immich-permission": "assetFile.delete",
        "x-immich-state": "Alpha"
      },
      "get": {
        "description": "Returns metadata about a specific asset file.",
        "operationId": "getAssetFile",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AssetFileResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Retrieve an asset file",
        "tags": [
          "Asset files"
        ],
        "x-immich-history": [
          {
            "version": "v3.2.0",
            "state": "Added"
          },
          {
            "version": "v3.2.0",
            "state": "Alpha"
          }
        ],
        "x-immich-permission": "assetFile.read",
        "x-immich-state": "Alpha"
      }
    },
    "/asset-files/{id}/download": {
      "get": {
        "description": "Serve the contents of a specific asset file.",
        "operationId": "downloadAssetFile",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/octet-stream": {
                "schema": {
                  "format": "binary",
                  "type": "string"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Download an asset file",
        "tags": [
          "Asset files"
        ],
        "x-immich-history": [
          {
            "version": "v3.2.0",
            "state": "Added"
          },
          {
            "version": "v3.2.0",
            "state": "Alpha"
          }
        ],
        "x-immich-permission": "assetFile.download",
        "x-immich-state": "Alpha"
      }
    },
    "/assets": {
      "delete": {
        "description": "Deletes multiple assets at the same time.",
        "operationId": "deleteAssets",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AssetBulkDeleteDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "204": {
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Delete assets",
        "tags": [
          "Assets"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "asset.delete",
        "x-immich-state": "Stable"
      },
      "post": {
        "description": "Uploads a new asset to the server.",
        "operationId": "uploadAsset",
        "parameters": [
          {
            "name": "key",
            "required": false,
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "slug",
            "required": false,
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "x-immich-checksum",
            "in": "header",
            "description": "sha1 checksum that can be used for duplicate detection before the file is uploaded",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "multipart/form-data": {
              "schema": {
                "$ref": "#/components/schemas/AssetMediaCreateDto"
              }
            }
          },
          "description": "Asset Upload Information",
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AssetMediaResponseDto"
                }
              }
            },
            "description": "Asset is a duplicate"
          },
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AssetMediaResponseDto"
                }
              }
            },
            "description": "Asset uploaded successfully"
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Upload asset",
        "tags": [
          "Assets"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "asset.upload",
        "x-immich-state": "Stable"
      },
      "put": {
        "description": "Updates multiple assets at the same time.",
        "operationId": "updateAssets",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AssetBulkUpdateDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "204": {
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Update assets",
        "tags": [
          "Assets"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          },
          {
            "version": "v3.0.0",
            "state": "Updated",
            "description": "This endpoint now also supports PATCH, in addition to PUT. PATCH will become the default in v4, and then PUT will be dropped in v5. Please migrate accordingly."
          }
        ],
        "x-immich-permission": "asset.update",
        "x-immich-state": "Stable"
      }
    },
    "/assets/bulk-upload-check": {
      "post": {
        "description": "Determine which assets have already been uploaded to the server based on their SHA1 checksums.",
        "operationId": "checkBulkUpload",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AssetBulkUploadCheckDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AssetBulkUploadCheckResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Check bulk upload",
        "tags": [
          "Assets"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "asset.upload",
        "x-immich-state": "Stable"
      }
    },
    "/assets/copy": {
      "put": {
        "description": "Copy asset information like albums, tags, etc. from one asset to another.",
        "operationId": "copyAsset",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AssetCopyDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "204": {
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Copy asset",
        "tags": [
          "Assets"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "asset.copy",
        "x-immich-state": "Stable"
      }
    },
    "/assets/jobs": {
      "post": {
        "description": "Run a specific job on a set of assets.",
        "operationId": "runAssetJobs",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AssetJobsDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "204": {
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Run an asset job",
        "tags": [
          "Assets"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "job.create",
        "x-immich-state": "Stable"
      }
    },
    "/assets/metadata": {
      "delete": {
        "description": "Delete metadata key-value pairs for multiple assets.",
        "operationId": "deleteBulkAssetMetadata",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AssetMetadataBulkDeleteDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "204": {
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Delete asset metadata",
        "tags": [
          "Assets"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v2.5.0",
            "state": "Beta"
          }
        ],
        "x-immich-permission": "asset.update",
        "x-immich-state": "Beta"
      },
      "put": {
        "description": "Upsert metadata key-value pairs for multiple assets.",
        "operationId": "updateBulkAssetMetadata",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AssetMetadataBulkUpsertDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/AssetMetadataBulkResponseDto"
                  },
                  "type": "array"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Upsert asset metadata",
        "tags": [
          "Assets"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v2.5.0",
            "state": "Beta"
          }
        ],
        "x-immich-permission": "asset.update",
        "x-immich-state": "Beta"
      }
    },
    "/assets/statistics": {
      "get": {
        "description": "Retrieve various statistics about the assets owned by the authenticated user.",
        "operationId": "getAssetStatistics",
        "parameters": [
          {
            "name": "isFavorite",
            "required": false,
            "in": "query",
            "description": "Filter by favorite status",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "isTrashed",
            "required": false,
            "in": "query",
            "description": "Filter by trash status",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "visibility",
            "required": false,
            "in": "query",
            "schema": {
              "$ref": "#/components/schemas/AssetVisibility"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AssetStatsResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Get asset statistics",
        "tags": [
          "Assets"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "asset.statistics",
        "x-immich-state": "Stable"
      }
    },
    "/assets/{id}": {
      "get": {
        "description": "Retrieve detailed information about a specific asset.",
        "operationId": "getAssetInfo",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          },
          {
            "name": "key",
            "required": false,
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "slug",
            "required": false,
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AssetResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Retrieve an asset",
        "tags": [
          "Assets"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "asset.read",
        "x-immich-state": "Stable"
      },
      "put": {
        "description": "Update information of a specific asset.",
        "operationId": "updateAsset",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateAssetDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AssetResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Update an asset",
        "tags": [
          "Assets"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          },
          {
            "version": "v3.0.0",
            "state": "Updated",
            "description": "This endpoint now also supports PATCH, in addition to PUT. PATCH will become the default in v4, and then PUT will be dropped in v5. Please migrate accordingly."
          }
        ],
        "x-immich-permission": "asset.update",
        "x-immich-state": "Stable"
      }
    },
    "/assets/{id}/edits": {
      "delete": {
        "description": "Removes all edit actions (crop, rotate, mirror) associated with the specified asset.",
        "operationId": "removeAssetEdits",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          }
        ],
        "responses": {
          "204": {
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Remove edits from an existing asset",
        "tags": [
          "Assets"
        ],
        "x-immich-history": [
          {
            "version": "v2.5.0",
            "state": "Added"
          },
          {
            "version": "v2.5.0",
            "state": "Beta"
          }
        ],
        "x-immich-permission": "asset.edit.delete",
        "x-immich-state": "Beta"
      },
      "get": {
        "description": "Retrieve a series of edit actions (crop, rotate, mirror) associated with the specified asset.",
        "operationId": "getAssetEdits",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AssetEditsResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Retrieve edits for an existing asset",
        "tags": [
          "Assets"
        ],
        "x-immich-history": [
          {
            "version": "v2.5.0",
            "state": "Added"
          },
          {
            "version": "v2.5.0",
            "state": "Beta"
          }
        ],
        "x-immich-permission": "asset.edit.get",
        "x-immich-state": "Beta"
      },
      "put": {
        "description": "Apply a series of edit actions (crop, rotate, mirror) to the specified asset.",
        "operationId": "editAsset",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AssetEditsCreateDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AssetEditsResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Apply edits to an existing asset",
        "tags": [
          "Assets"
        ],
        "x-immich-history": [
          {
            "version": "v2.5.0",
            "state": "Added"
          },
          {
            "version": "v2.5.0",
            "state": "Beta"
          }
        ],
        "x-immich-permission": "asset.edit.create",
        "x-immich-state": "Beta"
      }
    },
    "/assets/{id}/metadata": {
      "get": {
        "description": "Retrieve all metadata key-value pairs associated with the specified asset.",
        "operationId": "getAssetMetadata",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/AssetMetadataResponseDto"
                  },
                  "type": "array"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Get asset metadata",
        "tags": [
          "Assets"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "asset.read",
        "x-immich-state": "Stable"
      },
      "put": {
        "description": "Update or add metadata key-value pairs for the specified asset.",
        "operationId": "updateAssetMetadata",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AssetMetadataUpsertDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/AssetMetadataResponseDto"
                  },
                  "type": "array"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Update asset metadata",
        "tags": [
          "Assets"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "asset.update",
        "x-immich-state": "Stable"
      }
    },
    "/assets/{id}/metadata/{key}": {
      "delete": {
        "description": "Delete a specific metadata key-value pair associated with the specified asset.",
        "operationId": "deleteAssetMetadata",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "description": "Asset ID",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          },
          {
            "name": "key",
            "required": true,
            "in": "path",
            "description": "Metadata key",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "204": {
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Delete asset metadata by key",
        "tags": [
          "Assets"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "asset.update",
        "x-immich-state": "Stable"
      },
      "get": {
        "description": "Retrieve the value of a specific metadata key associated with the specified asset.",
        "operationId": "getAssetMetadataByKey",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "description": "Asset ID",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          },
          {
            "name": "key",
            "required": true,
            "in": "path",
            "description": "Metadata key",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AssetMetadataResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Retrieve asset metadata by key",
        "tags": [
          "Assets"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "asset.read",
        "x-immich-state": "Stable"
      }
    },
    "/assets/{id}/ocr": {
      "get": {
        "description": "Retrieve all OCR (Optical Character Recognition) data associated with the specified asset.",
        "operationId": "getAssetOcr",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/AssetOcrResponseDto"
                  },
                  "type": "array"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Retrieve asset OCR data",
        "tags": [
          "Assets"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "asset.read",
        "x-immich-state": "Stable"
      }
    },
    "/assets/{id}/original": {
      "get": {
        "description": "Downloads the original file of the specified asset.",
        "operationId": "downloadAsset",
        "parameters": [
          {
            "name": "edited",
            "required": false,
            "in": "query",
            "description": "Return edited asset if available",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          },
          {
            "name": "key",
            "required": false,
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "slug",
            "required": false,
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/octet-stream": {
                "schema": {
                  "format": "binary",
                  "type": "string"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Download original asset",
        "tags": [
          "Assets"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "asset.download",
        "x-immich-state": "Stable"
      }
    },
    "/assets/{id}/thumbnail": {
      "get": {
        "description": "Retrieve the thumbnail image for the specified asset. Viewing the fullsize thumbnail might redirect to downloadAsset, which requires a different permission.",
        "operationId": "viewAsset",
        "parameters": [
          {
            "name": "edited",
            "required": false,
            "in": "query",
            "description": "Return edited asset if available",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          },
          {
            "name": "key",
            "required": false,
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "size",
            "required": false,
            "in": "query",
            "x-immich-history": [
              {
                "version": "v3",
                "state": "Updated",
                "description": "Specifying 'original' is deprecated. Use the original endpoint directly instead"
              }
            ],
            "schema": {
              "$ref": "#/components/schemas/AssetMediaSize"
            }
          },
          {
            "name": "slug",
            "required": false,
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/octet-stream": {
                "schema": {
                  "format": "binary",
                  "type": "string"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "View asset thumbnail",
        "tags": [
          "Assets"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "asset.view",
        "x-immich-state": "Stable"
      }
    },
    "/assets/{id}/video/playback": {
      "get": {
        "description": "Streams the video file for the specified asset. This endpoint also supports byte range requests.",
        "operationId": "playAssetVideo",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          },
          {
            "name": "key",
            "required": false,
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "slug",
            "required": false,
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/octet-stream": {
                "schema": {
                  "format": "binary",
                  "type": "string"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Play asset video",
        "tags": [
          "Assets"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "asset.view",
        "x-immich-state": "Stable"
      }
    },
    "/assets/{id}/video/stream/main.m3u8": {
      "get": {
        "description": "Returns an HLS main playlist with all available variants for the asset.",
        "operationId": "getMainPlaylist",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          },
          {
            "name": "key",
            "required": false,
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "slug",
            "required": false,
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/vnd.apple.mpegurl": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Get HLS main playlist",
        "tags": [
          "Assets"
        ],
        "x-immich-history": [
          {
            "version": "v3",
            "state": "Added"
          },
          {
            "version": "v3",
            "state": "Alpha"
          }
        ],
        "x-immich-permission": "asset.view",
        "x-immich-state": "Alpha"
      }
    },
    "/assets/{id}/video/stream/{sessionId}": {
      "delete": {
        "description": "Releases server resources for the streaming session.",
        "operationId": "endSession",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          },
          {
            "name": "key",
            "required": false,
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "sessionId",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          },
          {
            "name": "slug",
            "required": false,
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "204": {
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "End HLS streaming session",
        "tags": [
          "Assets"
        ],
        "x-immich-history": [
          {
            "version": "v3",
            "state": "Added"
          },
          {
            "version": "v3",
            "state": "Alpha"
          }
        ],
        "x-immich-permission": "asset.view",
        "x-immich-state": "Alpha"
      }
    },
    "/assets/{id}/video/stream/{sessionId}/{variantIndex}/playlist.m3u8": {
      "get": {
        "description": "Returns an HLS media playlist for one variant of the streaming session.",
        "operationId": "getMediaPlaylist",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          },
          {
            "name": "key",
            "required": false,
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "sessionId",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          },
          {
            "name": "slug",
            "required": false,
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "variantIndex",
            "required": true,
            "in": "path",
            "schema": {
              "minimum": 0,
              "maximum": 9007199254740991,
              "type": "integer"
            }
          },
          {
            "name": "x-immich-hls-pos",
            "required": false,
            "in": "header",
            "schema": {
              "minimum": 0,
              "type": "number"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/vnd.apple.mpegurl": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Get HLS media playlist",
        "tags": [
          "Assets"
        ],
        "x-immich-history": [
          {
            "version": "v3",
            "state": "Added"
          },
          {
            "version": "v3",
            "state": "Alpha"
          }
        ],
        "x-immich-permission": "asset.view",
        "x-immich-state": "Alpha"
      }
    },
    "/assets/{id}/video/stream/{sessionId}/{variantIndex}/{filename}": {
      "get": {
        "description": "Streams an HLS init segment (init.mp4) or media segment (seg_N.m4s).",
        "operationId": "getSegment",
        "parameters": [
          {
            "name": "filename",
            "required": true,
            "in": "path",
            "schema": {
              "pattern": "^(init\\.mp4|seg_\\d+\\.m4s)$",
              "type": "string"
            }
          },
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          },
          {
            "name": "key",
            "required": false,
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "sessionId",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          },
          {
            "name": "slug",
            "required": false,
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "variantIndex",
            "required": true,
            "in": "path",
            "schema": {
              "minimum": 0,
              "maximum": 9007199254740991,
              "type": "integer"
            }
          },
          {
            "name": "x-immich-hls-msn",
            "required": false,
            "in": "header",
            "schema": {
              "minimum": 0,
              "maximum": 9007199254740991,
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/octet-stream": {
                "schema": {
                  "format": "binary",
                  "type": "string"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Get HLS segment or init file",
        "tags": [
          "Assets"
        ],
        "x-immich-history": [
          {
            "version": "v3",
            "state": "Added"
          },
          {
            "version": "v3",
            "state": "Alpha"
          }
        ],
        "x-immich-permission": "asset.view",
        "x-immich-state": "Alpha"
      }
    },
    "/auth/admin-sign-up": {
      "post": {
        "description": "Create the first admin user in the system.",
        "operationId": "signUpAdmin",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SignUpDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UserAdminResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "summary": "Register admin",
        "tags": [
          "Authentication"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-state": "Stable"
      }
    },
    "/auth/change-password": {
      "post": {
        "description": "Change the password of the current user.",
        "operationId": "changePassword",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ChangePasswordDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UserAdminResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Change password",
        "tags": [
          "Authentication"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "auth.changePassword",
        "x-immich-state": "Stable"
      }
    },
    "/auth/login": {
      "post": {
        "description": "Login with username and password and receive a session token.",
        "operationId": "login",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/LoginCredentialDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/LoginResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "summary": "Login",
        "tags": [
          "Authentication"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-state": "Stable"
      }
    },
    "/auth/logout": {
      "post": {
        "description": "Logout the current user and invalidate the session token.",
        "operationId": "logout",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/LogoutResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Logout",
        "tags": [
          "Authentication"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-state": "Stable"
      }
    },
    "/auth/pin-code": {
      "delete": {
        "description": "Reset the pin code for the current user by providing the account password",
        "operationId": "resetPinCode",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PinCodeResetDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "204": {
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Reset pin code",
        "tags": [
          "Authentication"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "pinCode.delete",
        "x-immich-state": "Stable"
      },
      "post": {
        "description": "Setup a new pin code for the current user.",
        "operationId": "setupPinCode",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PinCodeSetupDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "204": {
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Setup pin code",
        "tags": [
          "Authentication"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "pinCode.create",
        "x-immich-state": "Stable"
      },
      "put": {
        "description": "Change the pin code for the current user.",
        "operationId": "changePinCode",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PinCodeChangeDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "204": {
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Change pin code",
        "tags": [
          "Authentication"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "pinCode.update",
        "x-immich-state": "Stable"
      }
    },
    "/auth/session/lock": {
      "post": {
        "description": "Remove elevated access to locked assets from the current session.",
        "operationId": "lockAuthSession",
        "parameters": [],
        "responses": {
          "204": {
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Lock auth session",
        "tags": [
          "Authentication"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-state": "Stable"
      }
    },
    "/auth/session/unlock": {
      "post": {
        "description": "Temporarily grant the session elevated access to locked assets by providing the correct PIN code.",
        "operationId": "unlockAuthSession",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SessionUnlockDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "204": {
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Unlock auth session",
        "tags": [
          "Authentication"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-state": "Stable"
      }
    },
    "/auth/status": {
      "get": {
        "description": "Get information about the current session, including whether the user has a password, and if the session can access locked assets.",
        "operationId": "getAuthStatus",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AuthStatusResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Retrieve auth status",
        "tags": [
          "Authentication"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-state": "Stable"
      }
    },
    "/auth/validateToken": {
      "post": {
        "description": "Validate the current authorization method is still valid.",
        "operationId": "validateAccessToken",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ValidateAccessTokenResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Validate access token",
        "tags": [
          "Authentication"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-state": "Stable"
      }
    },
    "/cluster-groups/requests": {
      "get": {
        "description": "Retrieve the pending requests for the current user to join a cluster group.",
        "operationId": "getClusterGroupRequests",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/ClusterGroupRequestResponseDto"
                  },
                  "type": "array"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Retrieve cluster group requests",
        "tags": [
          "Cluster groups"
        ],
        "x-immich-history": [
          {
            "version": "v3.2.0",
            "state": "Added"
          }
        ],
        "x-immich-permission": "clusterGroupRequest.read"
      }
    },
    "/cluster-groups/requests/{id}": {
      "delete": {
        "description": "Delete a pending request to join a cluster group.",
        "operationId": "deleteClusterGroupRequest",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          }
        ],
        "responses": {
          "204": {
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Decline a cluster group request",
        "tags": [
          "Cluster groups"
        ],
        "x-immich-history": [
          {
            "version": "v3.2.0",
            "state": "Added"
          }
        ],
        "x-immich-permission": "clusterGroupRequest.delete"
      }
    },
    "/cluster-groups/requests/{id}/accept": {
      "post": {
        "description": "Join the cluster group the request was created for.",
        "operationId": "acceptClusterGroupRequest",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          }
        ],
        "responses": {
          "204": {
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Accept a cluster group request",
        "tags": [
          "Cluster groups"
        ],
        "x-immich-history": [
          {
            "version": "v3.2.0",
            "state": "Added"
          }
        ],
        "x-immich-permission": "clusterGroupRequest.create"
      }
    },
    "/cluster-groups/{id}/leave": {
      "post": {
        "description": "Move the current user into a new cluster group of their own.",
        "operationId": "leaveClusterGroup",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          }
        ],
        "responses": {
          "204": {
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Leave a cluster group",
        "tags": [
          "Cluster groups"
        ],
        "x-immich-history": [
          {
            "version": "v3.2.0",
            "state": "Added"
          }
        ],
        "x-immich-permission": "clusterGroup.leave"
      }
    },
    "/cluster-groups/{id}/regenerate-people": {
      "post": {
        "description": "Forcefully re-run facial recognition for all faces of users in this group.",
        "operationId": "clusterGroupRegeneratePeople",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          }
        ],
        "responses": {
          "204": {
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Regenerate people of users in cluster group",
        "tags": [
          "Cluster groups"
        ],
        "x-immich-history": [
          {
            "version": "v3.2.0",
            "state": "Added"
          }
        ],
        "x-immich-permission": "clusterGroup.admin"
      }
    },
    "/cluster-groups/{id}/requests": {
      "get": {
        "description": "Retrieve the pending requests for other users to join the cluster group.",
        "operationId": "getClusterGroupRequestsForGroup",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/ClusterGroupRequestResponseDto"
                  },
                  "type": "array"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Retrieve the requests sent by a cluster group",
        "tags": [
          "Cluster groups"
        ],
        "x-immich-history": [
          {
            "version": "v3.2.0",
            "state": "Added"
          }
        ],
        "x-immich-permission": "clusterGroupRequest.read"
      },
      "put": {
        "description": "Ask another user to join the cluster group of the current user.",
        "operationId": "createClusterGroupRequest",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ClusterGroupRequestCreateDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ClusterGroupRequestResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Create a cluster group request",
        "tags": [
          "Cluster groups"
        ],
        "x-immich-history": [
          {
            "version": "v3.2.0",
            "state": "Added"
          }
        ],
        "x-immich-permission": "clusterGroupRequest.create"
      }
    },
    "/cluster-groups/{id}/users": {
      "get": {
        "description": "Retrieve the users that are a member of the cluster group.",
        "operationId": "getClusterGroupUsers",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/UserResponseDto"
                  },
                  "type": "array"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Retrieve the users of a cluster group",
        "tags": [
          "Cluster groups"
        ],
        "x-immich-history": [
          {
            "version": "v3.2.0",
            "state": "Added"
          }
        ],
        "x-immich-permission": "clusterGroup.read"
      }
    },
    "/config": {
      "get": {
        "description": "Retrieve the system configuration properties that are visible to logged in users.",
        "operationId": "getUserConfig",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UserConfigDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Get the configuration with user visibility",
        "tags": [
          "Config (user)"
        ],
        "x-immich-history": [
          {
            "version": "v3.2.0",
            "state": "Added"
          },
          {
            "version": "v3.2.0",
            "state": "Alpha"
          }
        ],
        "x-immich-permission": "userConfig.read",
        "x-immich-state": "Alpha"
      }
    },
    "/config/defaults": {
      "get": {
        "description": "Retrieve the default value of the configuration properties that are visible to logged in users.",
        "operationId": "getUserConfigDefaults",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UserConfigDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Get the default configuration with user visibility",
        "tags": [
          "Config (user)"
        ],
        "x-immich-history": [
          {
            "version": "v3.2.0",
            "state": "Added"
          },
          {
            "version": "v3.2.0",
            "state": "Alpha"
          }
        ],
        "x-immich-permission": "userConfig.read",
        "x-immich-state": "Alpha"
      }
    },
    "/download/archive": {
      "post": {
        "description": "Download a ZIP archive containing the specified assets. The assets must have been previously requested via the \"getDownloadInfo\" endpoint.",
        "operationId": "downloadArchive",
        "parameters": [
          {
            "name": "key",
            "required": false,
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "slug",
            "required": false,
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/DownloadArchiveDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/octet-stream": {
                "schema": {
                  "format": "binary",
                  "type": "string"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Download asset archive",
        "tags": [
          "Download"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "asset.download",
        "x-immich-state": "Stable"
      }
    },
    "/download/info": {
      "post": {
        "description": "Retrieve information about how to request a download for the specified assets or album. The response includes groups of assets that can be downloaded together.",
        "operationId": "getDownloadInfo",
        "parameters": [
          {
            "name": "key",
            "required": false,
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "slug",
            "required": false,
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/DownloadInfoDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DownloadResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Retrieve download information",
        "tags": [
          "Download"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "asset.download",
        "x-immich-state": "Stable"
      }
    },
    "/duplicates": {
      "delete": {
        "description": "Delete multiple duplicate assets specified by their IDs.",
        "operationId": "deleteDuplicates",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/BulkIdsDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "204": {
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Delete duplicates",
        "tags": [
          "Duplicates"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "duplicate.delete",
        "x-immich-state": "Stable"
      },
      "get": {
        "description": "Retrieve a list of duplicate assets available to the authenticated user.",
        "operationId": "getAssetDuplicates",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/DuplicateResponseDto"
                  },
                  "type": "array"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Retrieve duplicates",
        "tags": [
          "Duplicates"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "duplicate.read",
        "x-immich-state": "Stable"
      }
    },
    "/duplicates/resolve": {
      "post": {
        "description": "Resolve duplicate groups by synchronizing metadata across assets and deleting/trashing duplicates.",
        "operationId": "resolveDuplicates",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/DuplicateResolveDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/BulkIdResponseDto"
                  },
                  "type": "array"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Resolve duplicate groups",
        "tags": [
          "Duplicates"
        ],
        "x-immich-history": [
          {
            "version": "v3.0.0",
            "state": "Added"
          },
          {
            "version": "v3.0.0",
            "state": "Alpha"
          }
        ],
        "x-immich-permission": "duplicate.delete",
        "x-immich-state": "Alpha"
      }
    },
    "/duplicates/{id}": {
      "delete": {
        "description": "Dismiss a duplicate group by its ID, unlinking all assets in the group without deleting them.",
        "operationId": "deleteDuplicate",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          }
        ],
        "responses": {
          "204": {
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Dismiss a duplicate group",
        "tags": [
          "Duplicates"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "duplicate.delete",
        "x-immich-state": "Stable"
      }
    },
    "/faces": {
      "get": {
        "description": "Retrieve all faces belonging to an asset.",
        "operationId": "getFaces",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "query",
            "description": "Face ID",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/AssetFaceResponseDto"
                  },
                  "type": "array"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Retrieve faces for asset",
        "tags": [
          "Faces"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "face.read",
        "x-immich-state": "Stable"
      },
      "post": {
        "description": "Create a new face that has not been discovered by facial recognition. The content of the bounding box is considered a face.",
        "operationId": "createFace",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AssetFaceCreateDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Create a face",
        "tags": [
          "Faces"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "face.create",
        "x-immich-state": "Stable"
      }
    },
    "/faces/{id}": {
      "delete": {
        "description": "Delete a face identified by the id. Optionally can be force deleted.",
        "operationId": "deleteFace",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AssetFaceDeleteDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "204": {
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Delete a face",
        "tags": [
          "Faces"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "face.delete",
        "x-immich-state": "Stable"
      },
      "put": {
        "description": "Re-assign the face provided in the body to the person identified by the id in the path parameter.",
        "operationId": "reassignFacesById",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/FaceDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PersonResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Re-assign a face to another person",
        "tags": [
          "Faces"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "face.update",
        "x-immich-state": "Stable"
      }
    },
    "/futo-backups/auth/oidc/device": {
      "get": {
        "description": "Connect an existing FUTO Backups account to this server.",
        "operationId": "futoBackupsConnectDeviceFlow",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DeviceFlowEventDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Connect a FUTO Backups account",
        "tags": [
          "Backups"
        ],
        "x-immich-admin-only": true,
        "x-immich-history": [
          {
            "version": "v3.4.0",
            "state": "Added"
          },
          {
            "version": "v3.4.0",
            "state": "Internal"
          }
        ],
        "x-immich-state": "Internal"
      }
    },
    "/futo-backups/auth/session": {
      "post": {
        "description": "Use existing session token to create a session on your device.",
        "operationId": "futoBackupsCreateSession",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateSessionRequestDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Create session",
        "tags": [
          "Backups"
        ],
        "x-immich-admin-only": true,
        "x-immich-history": [
          {
            "version": "v3.4.0",
            "state": "Added"
          },
          {
            "version": "v3.4.0",
            "state": "Internal"
          }
        ],
        "x-immich-state": "Internal"
      }
    },
    "/futo-backups/auth/session/device": {
      "get": {
        "description": "Log into standalone backups app using the associated cloud account.",
        "operationId": "futoBackupsSessionDeviceFlow",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DeviceFlowEventDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Sign in with FUTO Backups account",
        "tags": [
          "Backups"
        ],
        "x-immich-admin-only": true,
        "x-immich-history": [
          {
            "version": "v3.4.0",
            "state": "Added"
          },
          {
            "version": "v3.4.0",
            "state": "Internal"
          }
        ],
        "x-immich-state": "Internal"
      }
    },
    "/futo-backups/auth/ticket": {
      "post": {
        "description": "Create a ticket to perform a protected repository action.",
        "operationId": "futoBackupsCreateTicket",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/TicketCreateRequestDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TicketCreateResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Create a ticket",
        "tags": [
          "Backups"
        ],
        "x-immich-admin-only": true,
        "x-immich-history": [
          {
            "version": "v3.4.0",
            "state": "Added"
          },
          {
            "version": "v3.4.0",
            "state": "Internal"
          }
        ],
        "x-immich-state": "Internal"
      }
    },
    "/futo-backups/backend": {
      "get": {
        "description": "List the storage backends configured on this server.",
        "operationId": "futoBackupsGetBackends",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BackendsResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "List backends",
        "tags": [
          "Backups"
        ],
        "x-immich-admin-only": true,
        "x-immich-history": [
          {
            "version": "v3.4.0",
            "state": "Added"
          },
          {
            "version": "v3.4.0",
            "state": "Internal"
          }
        ],
        "x-immich-state": "Internal"
      }
    },
    "/futo-backups/backend/local": {
      "post": {
        "description": "Add a storage backend that writes to a local path on this server.",
        "operationId": "futoBackupsCreateLocalBackend",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLocalBackendRequestDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BackendResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Create a local backend",
        "tags": [
          "Backups"
        ],
        "x-immich-admin-only": true,
        "x-immich-history": [
          {
            "version": "v3.4.0",
            "state": "Added"
          },
          {
            "version": "v3.4.0",
            "state": "Internal"
          }
        ],
        "x-immich-state": "Internal"
      }
    },
    "/futo-backups/config": {
      "get": {
        "description": "Retrieve the current backups orchestrator configuration.",
        "operationId": "futoBackupsGetConfig",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ConfigResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Get backups orchestrator configuration",
        "tags": [
          "Backups"
        ],
        "x-immich-admin-only": true,
        "x-immich-history": [
          {
            "version": "v3.4.0",
            "state": "Added"
          },
          {
            "version": "v3.4.0",
            "state": "Internal"
          }
        ],
        "x-immich-state": "Internal"
      },
      "put": {
        "description": "Update the backups orchestrator configuration.",
        "operationId": "futoBackupsUpdateConfig",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ConfigUpdateRequestDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ConfigResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Update backups orchestrator configuration",
        "tags": [
          "Backups"
        ],
        "x-immich-admin-only": true,
        "x-immich-history": [
          {
            "version": "v3.4.0",
            "state": "Added"
          },
          {
            "version": "v3.4.0",
            "state": "Internal"
          }
        ],
        "x-immich-state": "Internal"
      }
    },
    "/futo-backups/debug/reset": {
      "post": {
        "description": "Delete all orchestrator state. Only available in development mode.",
        "operationId": "futoBackupsResetOrchestrator",
        "parameters": [],
        "responses": {
          "201": {
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Reset the backups orchestrator",
        "tags": [
          "Backups"
        ],
        "x-immich-admin-only": true,
        "x-immich-history": [
          {
            "version": "v3.4.0",
            "state": "Added"
          },
          {
            "version": "v3.4.0",
            "state": "Internal"
          }
        ],
        "x-immich-state": "Internal"
      }
    },
    "/futo-backups/fs": {
      "get": {
        "description": "List the files and folders at a path on this server.",
        "operationId": "futoBackupsGetFileListing",
        "parameters": [
          {
            "name": "path",
            "required": false,
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/FilesystemListingResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "List files",
        "tags": [
          "Backups"
        ],
        "x-immich-admin-only": true,
        "x-immich-history": [
          {
            "version": "v3.4.0",
            "state": "Added"
          },
          {
            "version": "v3.4.0",
            "state": "Internal"
          }
        ],
        "x-immich-state": "Internal"
      }
    },
    "/futo-backups/integrations": {
      "get": {
        "description": "Retrieve the configuration and state of each integration.",
        "operationId": "futoBackupsGetIntegrations",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/IntegrationsResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Get backup integrations",
        "tags": [
          "Backups"
        ],
        "x-immich-admin-only": true,
        "x-immich-history": [
          {
            "version": "v3.4.0",
            "state": "Added"
          },
          {
            "version": "v3.4.0",
            "state": "Internal"
          }
        ],
        "x-immich-state": "Internal"
      }
    },
    "/futo-backups/integrations/immich": {
      "post": {
        "description": "Set up backups for the Immich backup integration.",
        "operationId": "futoBackupsConfigureImmichIntegration",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ConfigureImmichIntegrationRequestDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ConfigureImmichIntegrationResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Configure the Immich backup integration",
        "tags": [
          "Backups"
        ],
        "x-immich-admin-only": true,
        "x-immich-history": [
          {
            "version": "v3.4.0",
            "state": "Added"
          },
          {
            "version": "v3.4.0",
            "state": "Internal"
          }
        ],
        "x-immich-state": "Internal"
      }
    },
    "/futo-backups/integrations/immich/database-dump": {
      "post": {
        "description": "Configure the Immich database dumps included in backups.",
        "operationId": "futoBackupsConfigureImmichDatabaseDump",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ConfigureImmichDatabaseDumpRequestDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Configure Immich database dumps",
        "tags": [
          "Backups"
        ],
        "x-immich-admin-only": true,
        "x-immich-history": [
          {
            "version": "v3.4.0",
            "state": "Added"
          },
          {
            "version": "v3.4.0",
            "state": "Internal"
          }
        ],
        "x-immich-state": "Internal"
      }
    },
    "/futo-backups/integrations/immich/database-dump/ignore-warning": {
      "post": {
        "description": "Stop warning that Immich database dumps are not configured.",
        "operationId": "futoBackupsIgnoreImmichDatabaseDumpWarning",
        "parameters": [],
        "responses": {
          "201": {
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Ignore the Immich database dump warning",
        "tags": [
          "Backups"
        ],
        "x-immich-admin-only": true,
        "x-immich-history": [
          {
            "version": "v3.4.0",
            "state": "Added"
          },
          {
            "version": "v3.4.0",
            "state": "Internal"
          }
        ],
        "x-immich-state": "Internal"
      }
    },
    "/futo-backups/integrations/immich/rollback": {
      "post": {
        "description": "Put Immich into maintenance mode and restore it from a snapshot.",
        "operationId": "futoBackupsStartImmichRollback",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ImmichRollbackRequestDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Roll Immich back to a snapshot",
        "tags": [
          "Backups"
        ],
        "x-immich-admin-only": true,
        "x-immich-history": [
          {
            "version": "v3.4.0",
            "state": "Added"
          },
          {
            "version": "v3.4.0",
            "state": "Internal"
          }
        ],
        "x-immich-state": "Internal"
      }
    },
    "/futo-backups/integrations/immich/status": {
      "get": {
        "description": "Retrieve the backup status of the Immich integration.",
        "operationId": "futoBackupsGetImmichBackupStatus",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ImmichBackupStatusDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Get Immich backup status",
        "tags": [
          "Backups"
        ],
        "x-immich-admin-only": true,
        "x-immich-history": [
          {
            "version": "v3.4.0",
            "state": "Added"
          },
          {
            "version": "v3.4.0",
            "state": "Internal"
          }
        ],
        "x-immich-state": "Internal"
      }
    },
    "/futo-backups/jobs": {
      "get": {
        "description": "List the jobs for a repository, newest first.",
        "operationId": "futoBackupsGetJobs",
        "parameters": [
          {
            "name": "repositoryId",
            "required": true,
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/JobListResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "List jobs",
        "tags": [
          "Backups"
        ],
        "x-immich-admin-only": true,
        "x-immich-history": [
          {
            "version": "v3.4.0",
            "state": "Added"
          },
          {
            "version": "v3.4.0",
            "state": "Internal"
          }
        ],
        "x-immich-state": "Internal"
      }
    },
    "/futo-backups/jobs/{id}": {
      "delete": {
        "description": "Cancel a queued job, or stop it if it is already running.",
        "operationId": "futoBackupsCancelJob",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "204": {
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Cancel a job",
        "tags": [
          "Backups"
        ],
        "x-immich-admin-only": true,
        "x-immich-history": [
          {
            "version": "v3.4.0",
            "state": "Added"
          },
          {
            "version": "v3.4.0",
            "state": "Internal"
          }
        ],
        "x-immich-state": "Internal"
      },
      "get": {
        "description": "Get the status of a job.",
        "operationId": "futoBackupsGetJob",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/JobDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Get a job",
        "tags": [
          "Backups"
        ],
        "x-immich-admin-only": true,
        "x-immich-history": [
          {
            "version": "v3.4.0",
            "state": "Added"
          },
          {
            "version": "v3.4.0",
            "state": "Internal"
          }
        ],
        "x-immich-state": "Internal"
      }
    },
    "/futo-backups/jobs/{id}/download": {
      "get": {
        "description": "Download the full log of a job as JSON lines.",
        "operationId": "futoBackupsDownloadJobLog",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/jsonl": {
                "schema": {
                  "format": "binary",
                  "type": "string"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Download a job log",
        "tags": [
          "Backups"
        ],
        "x-immich-admin-only": true,
        "x-immich-history": [
          {
            "version": "v3.4.0",
            "state": "Added"
          },
          {
            "version": "v3.4.0",
            "state": "Internal"
          }
        ],
        "x-immich-state": "Internal"
      }
    },
    "/futo-backups/jobs/{id}/support-log/download": {
      "get": {
        "description": "Download the verbose restic output recorded while the job ran in support mode, as JSON lines.",
        "operationId": "futoBackupsDownloadJobSupportLog",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/jsonl": {
                "schema": {
                  "format": "binary",
                  "type": "string"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Download a job support log",
        "tags": [
          "Backups"
        ],
        "x-immich-admin-only": true,
        "x-immich-history": [
          {
            "version": "v3.4.0",
            "state": "Added"
          },
          {
            "version": "v3.4.0",
            "state": "Internal"
          }
        ],
        "x-immich-state": "Internal"
      }
    },
    "/futo-backups/onboarding": {
      "get": {
        "description": "Retrieve which onboarding steps this server has completed.",
        "operationId": "futoBackupsOnboardingStatus",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OnboardingStatusResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Get backup onboarding status",
        "tags": [
          "Backups"
        ],
        "x-immich-admin-only": true,
        "x-immich-history": [
          {
            "version": "v3.4.0",
            "state": "Added"
          },
          {
            "version": "v3.4.0",
            "state": "Internal"
          }
        ],
        "x-immich-state": "Internal"
      }
    },
    "/futo-backups/onboarding/recovery-key": {
      "get": {
        "description": "Retrieve the recovery key that encrypts the backups of this server.",
        "operationId": "futoBackupsCurrentRecoveryKey",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CurrentRecoveryKeyResponse"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Get the backup recovery key",
        "tags": [
          "Backups"
        ],
        "x-immich-admin-only": true,
        "x-immich-history": [
          {
            "version": "v3.4.0",
            "state": "Added"
          },
          {
            "version": "v3.4.0",
            "state": "Internal"
          }
        ],
        "x-immich-state": "Internal"
      },
      "post": {
        "description": "Record that the user has saved the recovery key.",
        "operationId": "futoBackupsConfirmRecoveryKey",
        "parameters": [],
        "responses": {
          "201": {
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Confirm the backup recovery key",
        "tags": [
          "Backups"
        ],
        "x-immich-admin-only": true,
        "x-immich-history": [
          {
            "version": "v3.4.0",
            "state": "Added"
          },
          {
            "version": "v3.4.0",
            "state": "Internal"
          }
        ],
        "x-immich-state": "Internal"
      },
      "put": {
        "description": "Replace the recovery key with one from an earlier installation.",
        "operationId": "futoBackupsImportRecoveryKey",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ImportRecoveryKeyRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Import a backup recovery key",
        "tags": [
          "Backups"
        ],
        "x-immich-admin-only": true,
        "x-immich-history": [
          {
            "version": "v3.4.0",
            "state": "Added"
          },
          {
            "version": "v3.4.0",
            "state": "Internal"
          }
        ],
        "x-immich-state": "Internal"
      }
    },
    "/futo-backups/onboarding/report-error": {
      "post": {
        "description": "Send the current startup error to telemetry.",
        "operationId": "futoBackupsReportError",
        "parameters": [],
        "responses": {
          "201": {
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Report a startup error",
        "tags": [
          "Backups"
        ],
        "x-immich-admin-only": true,
        "x-immich-history": [
          {
            "version": "v3.4.0",
            "state": "Added"
          },
          {
            "version": "v3.4.0",
            "state": "Internal"
          }
        ],
        "x-immich-state": "Internal"
      }
    },
    "/futo-backups/onboarding/skip": {
      "post": {
        "description": "Skip the optional configuration steps of onboarding.",
        "operationId": "futoBackupsSkipOnboardingExtraConfig",
        "parameters": [],
        "responses": {
          "201": {
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Skip optional backup onboarding",
        "tags": [
          "Backups"
        ],
        "x-immich-admin-only": true,
        "x-immich-history": [
          {
            "version": "v3.4.0",
            "state": "Added"
          },
          {
            "version": "v3.4.0",
            "state": "Internal"
          }
        ],
        "x-immich-state": "Internal"
      }
    },
    "/futo-backups/onboarding/telemetry": {
      "post": {
        "description": "Record that the user consents to sending telemetry.",
        "operationId": "futoBackupsEnableTelemetry",
        "parameters": [],
        "responses": {
          "201": {
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Enable FUTO Backups telemetry",
        "tags": [
          "Backups"
        ],
        "x-immich-admin-only": true,
        "x-immich-history": [
          {
            "version": "v3.4.0",
            "state": "Added"
          },
          {
            "version": "v3.4.0",
            "state": "Internal"
          }
        ],
        "x-immich-state": "Internal"
      }
    },
    "/futo-backups/repository": {
      "get": {
        "description": "List the backup repositories known to this server.",
        "operationId": "futoBackupsGetRepositories",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RepositoryListResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "List backups",
        "tags": [
          "Backups"
        ],
        "x-immich-admin-only": true,
        "x-immich-history": [
          {
            "version": "v3.4.0",
            "state": "Added"
          },
          {
            "version": "v3.4.0",
            "state": "Internal"
          }
        ],
        "x-immich-state": "Internal"
      },
      "post": {
        "description": "Create a backup repository on a backend.",
        "operationId": "futoBackupsCreateRepository",
        "parameters": [
          {
            "name": "backend",
            "required": false,
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/RepositoryCreateRequestDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RepositoryCreateResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Create a new backup",
        "tags": [
          "Backups"
        ],
        "x-immich-admin-only": true,
        "x-immich-history": [
          {
            "version": "v3.4.0",
            "state": "Added"
          },
          {
            "version": "v3.4.0",
            "state": "Internal"
          }
        ],
        "x-immich-state": "Internal"
      }
    },
    "/futo-backups/repository/inspect": {
      "get": {
        "description": "List repositories on a backend that are not configured on this server.",
        "operationId": "futoBackupsInspectRepositories",
        "parameters": [
          {
            "name": "backend",
            "required": false,
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RepositoryInspectResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "List remote backups",
        "tags": [
          "Backups"
        ],
        "x-immich-admin-only": true,
        "x-immich-history": [
          {
            "version": "v3.4.0",
            "state": "Added"
          },
          {
            "version": "v3.4.0",
            "state": "Internal"
          }
        ],
        "x-immich-state": "Internal"
      }
    },
    "/futo-backups/repository/{id}": {
      "delete": {
        "description": "Remove a repository from this server.",
        "operationId": "futoBackupsDeleteRepository",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Remove a backup",
        "tags": [
          "Backups"
        ],
        "x-immich-admin-only": true,
        "x-immich-history": [
          {
            "version": "v3.4.0",
            "state": "Added"
          },
          {
            "version": "v3.4.0",
            "state": "Internal"
          }
        ],
        "x-immich-state": "Internal"
      },
      "patch": {
        "description": "Update the settings of a repository.",
        "operationId": "futoBackupsUpdateRepository",
        "parameters": [
          {
            "name": "backend",
            "required": false,
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/RepositoryUpdateRequestDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RepositoryUpdateResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Update a backup",
        "tags": [
          "Backups"
        ],
        "x-immich-admin-only": true,
        "x-immich-history": [
          {
            "version": "v3.4.0",
            "state": "Added"
          },
          {
            "version": "v3.4.0",
            "state": "Internal"
          }
        ],
        "x-immich-state": "Internal"
      },
      "post": {
        "description": "Queue a backup to a repository and return the ID of its job.",
        "operationId": "futoBackupsCreateBackup",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/JobResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Start a backup",
        "tags": [
          "Backups"
        ],
        "x-immich-admin-only": true,
        "x-immich-history": [
          {
            "version": "v3.4.0",
            "state": "Added"
          },
          {
            "version": "v3.4.0",
            "state": "Internal"
          }
        ],
        "x-immich-state": "Internal"
      }
    },
    "/futo-backups/repository/{id}/backend": {
      "put": {
        "description": "Create a new empty repository on the selected backend and redirect future backups to it. Existing snapshots are not migrated.",
        "operationId": "futoBackupsReconfigureRepositoryPrimaryBackend",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/RepositoryPrimaryBackendReconfigureRequestDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RepositoryCreateResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Change the primary backend",
        "tags": [
          "Backups"
        ],
        "x-immich-admin-only": true,
        "x-immich-history": [
          {
            "version": "v3.4.0",
            "state": "Added"
          },
          {
            "version": "v3.4.0",
            "state": "Internal"
          }
        ],
        "x-immich-state": "Internal"
      }
    },
    "/futo-backups/repository/{id}/import": {
      "get": {
        "description": "Check that an existing repository on a backend can be opened with the recovery key.",
        "operationId": "futoBackupsCheckImportRepository",
        "parameters": [
          {
            "name": "backend",
            "required": true,
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RepositoryCheckImportResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Check a repository import",
        "tags": [
          "Backups"
        ],
        "x-immich-admin-only": true,
        "x-immich-history": [
          {
            "version": "v3.4.0",
            "state": "Added"
          },
          {
            "version": "v3.4.0",
            "state": "Internal"
          }
        ],
        "x-immich-state": "Internal"
      },
      "post": {
        "description": "Add an existing repository on a backend to this server.",
        "operationId": "futoBackupsImportRepository",
        "parameters": [
          {
            "name": "backend",
            "required": true,
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RepositoryCreateResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Import a repository",
        "tags": [
          "Backups"
        ],
        "x-immich-admin-only": true,
        "x-immich-history": [
          {
            "version": "v3.4.0",
            "state": "Added"
          },
          {
            "version": "v3.4.0",
            "state": "Internal"
          }
        ],
        "x-immich-state": "Internal"
      }
    },
    "/futo-backups/repository/{id}/snapshots": {
      "get": {
        "description": "List the snapshots in a repository.",
        "operationId": "futoBackupsGetSnapshots",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ListSnapshotsResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "List snapshots",
        "tags": [
          "Backups"
        ],
        "x-immich-admin-only": true,
        "x-immich-history": [
          {
            "version": "v3.4.0",
            "state": "Added"
          },
          {
            "version": "v3.4.0",
            "state": "Internal"
          }
        ],
        "x-immich-state": "Internal"
      }
    },
    "/futo-backups/repository/{id}/snapshots/prune": {
      "post": {
        "description": "Queue the removal of snapshots outside the retention policy and return the ID of its job.",
        "operationId": "futoBackupsPruneRepository",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/JobResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Prune a repository",
        "tags": [
          "Backups"
        ],
        "x-immich-admin-only": true,
        "x-immich-history": [
          {
            "version": "v3.4.0",
            "state": "Added"
          },
          {
            "version": "v3.4.0",
            "state": "Internal"
          }
        ],
        "x-immich-state": "Internal"
      }
    },
    "/futo-backups/repository/{id}/snapshots/{snapshot}": {
      "delete": {
        "description": "Remove a snapshot from a repository.",
        "operationId": "futoBackupsForgetSnapshot",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "snapshot",
            "required": true,
            "in": "path",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ListSnapshotsResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Delete a snapshot",
        "tags": [
          "Backups"
        ],
        "x-immich-admin-only": true,
        "x-immich-history": [
          {
            "version": "v3.4.0",
            "state": "Added"
          },
          {
            "version": "v3.4.0",
            "state": "Internal"
          }
        ],
        "x-immich-state": "Internal"
      },
      "post": {
        "description": "Queue a restore of files from a snapshot and return the ID of its job.",
        "operationId": "futoBackupsRestoreSnapshot",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "snapshot",
            "required": true,
            "in": "path",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/RepositorySnapshotRestoreRequestDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/JobResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Restore a snapshot",
        "tags": [
          "Backups"
        ],
        "x-immich-admin-only": true,
        "x-immich-history": [
          {
            "version": "v3.4.0",
            "state": "Added"
          },
          {
            "version": "v3.4.0",
            "state": "Internal"
          }
        ],
        "x-immich-state": "Internal"
      }
    },
    "/futo-backups/repository/{id}/snapshots/{snapshot}/listing": {
      "get": {
        "description": "List the files and folders at a path in a snapshot.",
        "operationId": "futoBackupsGetSnapshotListing",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "path",
            "required": false,
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "snapshot",
            "required": true,
            "in": "path",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/FilesystemListingResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "List snapshot files",
        "tags": [
          "Backups"
        ],
        "x-immich-admin-only": true,
        "x-immich-history": [
          {
            "version": "v3.4.0",
            "state": "Added"
          },
          {
            "version": "v3.4.0",
            "state": "Internal"
          }
        ],
        "x-immich-state": "Internal"
      }
    },
    "/futo-backups/repository/{id}/snapshots/{snapshot}/restore-from-point": {
      "post": {
        "description": "Restore the orchestrator to a previous state, wiping the current state.",
        "operationId": "futoBackupsRestoreFromPoint",
        "parameters": [
          {
            "name": "backend",
            "required": true,
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "snapshot",
            "required": true,
            "in": "path",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/RepositorySnapshotRestoreFromPointRequestDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/JobResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Restore from snapshot",
        "tags": [
          "Backups"
        ],
        "x-immich-admin-only": true,
        "x-immich-history": [
          {
            "version": "v3.4.0",
            "state": "Added"
          },
          {
            "version": "v3.4.0",
            "state": "Internal"
          }
        ],
        "x-immich-state": "Internal"
      }
    },
    "/futo-backups/repository/{id}/sync-deletion": {
      "post": {
        "description": "Remove a repository from this server once it has been deleted from its backend.",
        "operationId": "futoBackupsSyncRepositoryDeletion",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RepositorySyncDeletionResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Sync a remote deletion",
        "tags": [
          "Backups"
        ],
        "x-immich-admin-only": true,
        "x-immich-history": [
          {
            "version": "v3.4.0",
            "state": "Added"
          },
          {
            "version": "v3.4.0",
            "state": "Internal"
          }
        ],
        "x-immich-state": "Internal"
      }
    },
    "/futo-backups/schedule": {
      "get": {
        "description": "List the backup schedules.",
        "operationId": "futoBackupsGetSchedules",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ScheduleListResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "List schedules",
        "tags": [
          "Backups"
        ],
        "x-immich-admin-only": true,
        "x-immich-history": [
          {
            "version": "v3.4.0",
            "state": "Added"
          },
          {
            "version": "v3.4.0",
            "state": "Internal"
          }
        ],
        "x-immich-state": "Internal"
      },
      "post": {
        "description": "Create a backup schedule for one or more repositories.",
        "operationId": "futoBackupsCreateSchedule",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ScheduleCreateRequestDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ScheduleCreateResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Create a schedule",
        "tags": [
          "Backups"
        ],
        "x-immich-admin-only": true,
        "x-immich-history": [
          {
            "version": "v3.4.0",
            "state": "Added"
          },
          {
            "version": "v3.4.0",
            "state": "Internal"
          }
        ],
        "x-immich-state": "Internal"
      }
    },
    "/futo-backups/schedule/{id}": {
      "delete": {
        "description": "Delete a backup schedule.",
        "operationId": "futoBackupsRemoveSchedule",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Delete a schedule",
        "tags": [
          "Backups"
        ],
        "x-immich-admin-only": true,
        "x-immich-history": [
          {
            "version": "v3.4.0",
            "state": "Added"
          },
          {
            "version": "v3.4.0",
            "state": "Internal"
          }
        ],
        "x-immich-state": "Internal"
      },
      "patch": {
        "description": "Update a backup schedule.",
        "operationId": "futoBackupsUpdateSchedule",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ScheduleUpdateRequestDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ScheduleUpdateResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Update a schedule",
        "tags": [
          "Backups"
        ],
        "x-immich-admin-only": true,
        "x-immich-history": [
          {
            "version": "v3.4.0",
            "state": "Added"
          },
          {
            "version": "v3.4.0",
            "state": "Internal"
          }
        ],
        "x-immich-state": "Internal"
      }
    },
    "/futo-backups/support-mode": {
      "get": {
        "description": "Retrieve how many upcoming runs use verbose restic logging, and whether they stream to FUTO.",
        "operationId": "futoBackupsGetSupportMode",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SupportModeResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Get support mode",
        "tags": [
          "Backups"
        ],
        "x-immich-admin-only": true,
        "x-immich-history": [
          {
            "version": "v3.4.0",
            "state": "Added"
          },
          {
            "version": "v3.4.0",
            "state": "Internal"
          }
        ],
        "x-immich-state": "Internal"
      },
      "put": {
        "description": "Set how many upcoming runs use verbose restic logging, and whether they stream to FUTO.",
        "operationId": "futoBackupsUpdateSupportMode",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SupportModeUpdateRequestDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SupportModeResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Update support mode",
        "tags": [
          "Backups"
        ],
        "x-immich-admin-only": true,
        "x-immich-history": [
          {
            "version": "v3.4.0",
            "state": "Added"
          },
          {
            "version": "v3.4.0",
            "state": "Internal"
          }
        ],
        "x-immich-state": "Internal"
      }
    },
    "/jobs": {
      "get": {
        "deprecated": true,
        "description": "Retrieve the counts of the current queue, as well as the current status.",
        "operationId": "getQueuesLegacy",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/QueuesResponseLegacyDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Retrieve queue counts and status",
        "tags": [
          "Jobs",
          "Deprecated"
        ],
        "x-immich-admin-only": true,
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          },
          {
            "version": "v2.4.0",
            "state": "Deprecated"
          }
        ],
        "x-immich-permission": "job.read",
        "x-immich-state": "Deprecated"
      },
      "post": {
        "description": "Run a specific job. Most jobs are queued automatically, but this endpoint allows for manual creation of a handful of jobs, including various cleanup tasks, as well as creating a new database backup.",
        "operationId": "createJob",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/JobCreateDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "204": {
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Create a manual job",
        "tags": [
          "Jobs"
        ],
        "x-immich-admin-only": true,
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "job.create",
        "x-immich-state": "Stable"
      }
    },
    "/jobs/{name}": {
      "put": {
        "deprecated": true,
        "description": "Queue all assets for a specific job type. Defaults to only queueing assets that have not yet been processed, but the force command can be used to re-process all assets.",
        "operationId": "runQueueCommandLegacy",
        "parameters": [
          {
            "name": "name",
            "required": true,
            "in": "path",
            "schema": {
              "$ref": "#/components/schemas/QueueName"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/QueueCommandDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/QueueResponseLegacyDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Run jobs",
        "tags": [
          "Jobs",
          "Deprecated"
        ],
        "x-immich-admin-only": true,
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          },
          {
            "version": "v2.4.0",
            "state": "Deprecated"
          }
        ],
        "x-immich-permission": "job.create",
        "x-immich-state": "Deprecated"
      }
    },
    "/libraries": {
      "get": {
        "description": "Retrieve a list of external libraries.",
        "operationId": "getAllLibraries",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/LibraryResponseDto"
                  },
                  "type": "array"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Retrieve libraries",
        "tags": [
          "Libraries"
        ],
        "x-immich-admin-only": true,
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "library.read",
        "x-immich-state": "Stable"
      },
      "post": {
        "description": "Create a new external library.",
        "operationId": "createLibrary",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateLibraryDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/LibraryResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Create a library",
        "tags": [
          "Libraries"
        ],
        "x-immich-admin-only": true,
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "library.create",
        "x-immich-state": "Stable"
      }
    },
    "/libraries/{id}": {
      "delete": {
        "description": "Delete an external library by its ID.",
        "operationId": "deleteLibrary",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          }
        ],
        "responses": {
          "204": {
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Delete a library",
        "tags": [
          "Libraries"
        ],
        "x-immich-admin-only": true,
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "library.delete",
        "x-immich-state": "Stable"
      },
      "get": {
        "description": "Retrieve an external library by its ID.",
        "operationId": "getLibrary",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/LibraryResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Retrieve a library",
        "tags": [
          "Libraries"
        ],
        "x-immich-admin-only": true,
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "library.read",
        "x-immich-state": "Stable"
      },
      "put": {
        "description": "Update an existing external library.",
        "operationId": "updateLibrary",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateLibraryDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/LibraryResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Update a library",
        "tags": [
          "Libraries"
        ],
        "x-immich-admin-only": true,
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          },
          {
            "version": "v3.0.0",
            "state": "Updated",
            "description": "This endpoint now also supports PATCH, in addition to PUT. PATCH will become the default in v4, and then PUT will be dropped in v5. Please migrate accordingly."
          }
        ],
        "x-immich-permission": "library.update",
        "x-immich-state": "Stable"
      }
    },
    "/libraries/{id}/scan": {
      "post": {
        "description": "Queue a scan for the external library to find and import new assets.",
        "operationId": "scanLibrary",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          }
        ],
        "responses": {
          "204": {
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Scan a library",
        "tags": [
          "Libraries"
        ],
        "x-immich-admin-only": true,
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "library.update",
        "x-immich-state": "Stable"
      }
    },
    "/libraries/{id}/statistics": {
      "get": {
        "description": "Retrieve statistics for a specific external library, including number of videos, images, and storage usage.",
        "operationId": "getLibraryStatistics",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/LibraryStatsResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Retrieve library statistics",
        "tags": [
          "Libraries"
        ],
        "x-immich-admin-only": true,
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "library.statistics",
        "x-immich-state": "Stable"
      }
    },
    "/libraries/{id}/validate": {
      "post": {
        "description": "Validate the settings of an external library.",
        "operationId": "validate",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ValidateLibraryDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ValidateLibraryResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Validate library settings",
        "tags": [
          "Libraries"
        ],
        "x-immich-admin-only": true,
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-state": "Stable"
      }
    },
    "/map/markers": {
      "get": {
        "description": "Retrieve a list of latitude and longitude coordinates for every asset with location data.",
        "operationId": "getMapMarkers",
        "parameters": [
          {
            "name": "fileCreatedAfter",
            "required": false,
            "in": "query",
            "description": "Filter assets created after this date",
            "schema": {
              "format": "date-time",
              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
              "example": "2024-01-01T00:00:00.000Z",
              "type": "string"
            }
          },
          {
            "name": "fileCreatedBefore",
            "required": false,
            "in": "query",
            "description": "Filter assets created before this date",
            "schema": {
              "format": "date-time",
              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
              "example": "2024-01-01T00:00:00.000Z",
              "type": "string"
            }
          },
          {
            "name": "isArchived",
            "required": false,
            "in": "query",
            "description": "Filter by archived status",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "isFavorite",
            "required": false,
            "in": "query",
            "description": "Filter by favorite status",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "withPartners",
            "required": false,
            "in": "query",
            "description": "Include partner assets",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "withSharedAlbums",
            "required": false,
            "in": "query",
            "description": "Include shared album assets",
            "schema": {
              "type": "boolean"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/MapMarkerResponseDto"
                  },
                  "type": "array"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Retrieve map markers",
        "tags": [
          "Map"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "map.read",
        "x-immich-state": "Stable"
      }
    },
    "/map/reverse-geocode": {
      "get": {
        "description": "Retrieve location information (e.g., city, country) for given latitude and longitude coordinates.",
        "operationId": "reverseGeocode",
        "parameters": [
          {
            "name": "lat",
            "required": true,
            "in": "query",
            "description": "Latitude (-90 to 90)",
            "schema": {
              "format": "double",
              "type": "number"
            }
          },
          {
            "name": "lon",
            "required": true,
            "in": "query",
            "description": "Longitude (-180 to 180)",
            "schema": {
              "format": "double",
              "type": "number"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/MapReverseGeocodeResponseDto"
                  },
                  "type": "array"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Reverse geocode coordinates",
        "tags": [
          "Map"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "map.search",
        "x-immich-state": "Stable"
      }
    },
    "/memories": {
      "get": {
        "description": "Retrieve a list of memories. Memories are sorted descending by creation date by default, although they can also be sorted in ascending order, or randomly.",
        "operationId": "searchMemories",
        "parameters": [
          {
            "name": "for",
            "required": false,
            "in": "query",
            "description": "Filter by date",
            "schema": {
              "format": "date",
              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
              "example": "2024-01-01",
              "type": "string"
            }
          },
          {
            "name": "id",
            "required": false,
            "in": "query",
            "description": "Memory ID",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          },
          {
            "name": "isSaved",
            "required": false,
            "in": "query",
            "description": "Filter by saved status",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "isTrashed",
            "required": false,
            "in": "query",
            "description": "Include trashed memories",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "isUpcoming",
            "required": false,
            "in": "query",
            "description": "Filter by memories that have not been shown yet",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "order",
            "required": false,
            "in": "query",
            "schema": {
              "$ref": "#/components/schemas/MemorySearchOrder"
            }
          },
          {
            "name": "page",
            "required": false,
            "in": "query",
            "description": "Page number",
            "schema": {
              "minimum": 1,
              "maximum": 9007199254740991,
              "type": "integer"
            }
          },
          {
            "name": "size",
            "required": false,
            "in": "query",
            "description": "Number of memories to return",
            "schema": {
              "minimum": 1,
              "maximum": 9007199254740991,
              "type": "integer"
            }
          },
          {
            "name": "type",
            "required": false,
            "in": "query",
            "schema": {
              "$ref": "#/components/schemas/MemoryType"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/MemoryResponseDto"
                  },
                  "type": "array"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Retrieve memories",
        "tags": [
          "Memories"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "memory.read",
        "x-immich-state": "Stable"
      },
      "post": {
        "description": "Create a new memory by providing a name, description, and a list of asset IDs to include in the memory.",
        "operationId": "createMemory",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/MemoryCreateDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MemoryResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Create a memory",
        "tags": [
          "Memories"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "memory.create",
        "x-immich-state": "Stable"
      }
    },
    "/memories/statistics": {
      "get": {
        "description": "Retrieve statistics about memories, such as total count and other relevant metrics.",
        "operationId": "memoriesStatistics",
        "parameters": [
          {
            "name": "for",
            "required": false,
            "in": "query",
            "description": "Filter by date",
            "schema": {
              "format": "date",
              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
              "example": "2024-01-01",
              "type": "string"
            }
          },
          {
            "name": "id",
            "required": false,
            "in": "query",
            "description": "Memory ID",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          },
          {
            "name": "isSaved",
            "required": false,
            "in": "query",
            "description": "Filter by saved status",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "isTrashed",
            "required": false,
            "in": "query",
            "description": "Include trashed memories",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "isUpcoming",
            "required": false,
            "in": "query",
            "description": "Filter by memories that have not been shown yet",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "order",
            "required": false,
            "in": "query",
            "schema": {
              "$ref": "#/components/schemas/MemorySearchOrder"
            }
          },
          {
            "name": "page",
            "required": false,
            "in": "query",
            "description": "Page number",
            "schema": {
              "minimum": 1,
              "maximum": 9007199254740991,
              "type": "integer"
            }
          },
          {
            "name": "size",
            "required": false,
            "in": "query",
            "description": "Number of memories to return",
            "schema": {
              "minimum": 1,
              "maximum": 9007199254740991,
              "type": "integer"
            }
          },
          {
            "name": "type",
            "required": false,
            "in": "query",
            "schema": {
              "$ref": "#/components/schemas/MemoryType"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MemoryStatisticsResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Retrieve memories statistics",
        "tags": [
          "Memories"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "memory.statistics",
        "x-immich-state": "Stable"
      }
    },
    "/memories/{id}": {
      "delete": {
        "description": "Delete a specific memory by its ID.",
        "operationId": "deleteMemory",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          }
        ],
        "responses": {
          "204": {
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Delete a memory",
        "tags": [
          "Memories"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "memory.delete",
        "x-immich-state": "Stable"
      },
      "get": {
        "description": "Retrieve a specific memory by its ID.",
        "operationId": "getMemory",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MemoryResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Retrieve a memory",
        "tags": [
          "Memories"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "memory.read",
        "x-immich-state": "Stable"
      },
      "put": {
        "description": "Update an existing memory by its ID.",
        "operationId": "updateMemory",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/MemoryUpdateDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MemoryResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Update a memory",
        "tags": [
          "Memories"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          },
          {
            "version": "v3.0.0",
            "state": "Updated",
            "description": "This endpoint now also supports PATCH, in addition to PUT. PATCH will become the default in v4, and then PUT will be dropped in v5. Please migrate accordingly."
          }
        ],
        "x-immich-permission": "memory.update",
        "x-immich-state": "Stable"
      }
    },
    "/memories/{id}/assets": {
      "delete": {
        "description": "Remove a list of asset IDs from a specific memory.",
        "operationId": "removeMemoryAssets",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/BulkIdsDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/BulkIdResponseDto"
                  },
                  "type": "array"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Remove assets from a memory",
        "tags": [
          "Memories"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "memoryAsset.delete",
        "x-immich-state": "Stable"
      },
      "put": {
        "description": "Add a list of asset IDs to a specific memory.",
        "operationId": "addMemoryAssets",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/BulkIdsDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/BulkIdResponseDto"
                  },
                  "type": "array"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Add assets to a memory",
        "tags": [
          "Memories"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "memoryAsset.create",
        "x-immich-state": "Stable"
      }
    },
    "/notifications": {
      "delete": {
        "description": "Delete a list of notifications at once.",
        "operationId": "deleteNotifications",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/NotificationDeleteAllDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "204": {
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Delete notifications",
        "tags": [
          "Notifications"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "notification.delete",
        "x-immich-state": "Stable"
      },
      "get": {
        "description": "Retrieve a list of notifications.",
        "operationId": "getNotifications",
        "parameters": [
          {
            "name": "id",
            "required": false,
            "in": "query",
            "description": "Filter by notification ID",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          },
          {
            "name": "level",
            "required": false,
            "in": "query",
            "schema": {
              "$ref": "#/components/schemas/NotificationLevel"
            }
          },
          {
            "name": "type",
            "required": false,
            "in": "query",
            "schema": {
              "$ref": "#/components/schemas/NotificationType"
            }
          },
          {
            "name": "unread",
            "required": false,
            "in": "query",
            "description": "Filter by unread status",
            "schema": {
              "type": "boolean"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/NotificationDto"
                  },
                  "type": "array"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Retrieve notifications",
        "tags": [
          "Notifications"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "notification.read",
        "x-immich-state": "Stable"
      },
      "put": {
        "description": "Update a list of notifications. Allows to bulk-set the read status of notifications.",
        "operationId": "updateNotifications",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/NotificationUpdateAllDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "204": {
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Update notifications",
        "tags": [
          "Notifications"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "notification.update",
        "x-immich-state": "Stable"
      }
    },
    "/notifications/{id}": {
      "delete": {
        "description": "Delete a specific notification.",
        "operationId": "deleteNotification",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          }
        ],
        "responses": {
          "204": {
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Delete a notification",
        "tags": [
          "Notifications"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "notification.delete",
        "x-immich-state": "Stable"
      },
      "get": {
        "description": "Retrieve a specific notification identified by id.",
        "operationId": "getNotification",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/NotificationDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Get a notification",
        "tags": [
          "Notifications"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "notification.read",
        "x-immich-state": "Stable"
      },
      "put": {
        "description": "Update a specific notification to set its read status.",
        "operationId": "updateNotification",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/NotificationUpdateDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/NotificationDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Update a notification",
        "tags": [
          "Notifications"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "notification.update",
        "x-immich-state": "Stable"
      }
    },
    "/oauth/authorize": {
      "post": {
        "description": "Initiate the OAuth authorization process.",
        "operationId": "startOAuth",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/OAuthConfigDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OAuthAuthorizeResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "summary": "Start OAuth",
        "tags": [
          "Authentication"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-state": "Stable"
      }
    },
    "/oauth/backchannel-logout": {
      "post": {
        "description": "Logout the OAuth account and invalidate the session specified by the sid claim or all sessions if the sid claim is not present.",
        "operationId": "logoutOAuth",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/x-www-form-urlencoded": {
              "schema": {
                "$ref": "#/components/schemas/OAuthBackchannelLogoutDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": ""
          }
        },
        "summary": "Backchannel OAuth logout",
        "tags": [
          "Authentication"
        ],
        "x-immich-history": [
          {
            "version": "v2",
            "state": "Added"
          }
        ]
      }
    },
    "/oauth/callback": {
      "post": {
        "description": "Complete the OAuth authorization process by exchanging the authorization code for a session token.",
        "operationId": "finishOAuth",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/OAuthCallbackDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/LoginResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "summary": "Finish OAuth",
        "tags": [
          "Authentication"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-state": "Stable"
      }
    },
    "/oauth/link": {
      "post": {
        "description": "Link an OAuth account to the authenticated user.",
        "operationId": "linkOAuthAccount",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/OAuthCallbackDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UserAdminResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Link OAuth account",
        "tags": [
          "Authentication"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-state": "Stable"
      }
    },
    "/oauth/mobile-redirect": {
      "get": {
        "description": "Requests to this URL are automatically forwarded to the mobile app, and is used in some cases for OAuth redirecting.",
        "operationId": "redirectOAuthToMobile",
        "parameters": [],
        "responses": {
          "200": {
            "description": ""
          }
        },
        "summary": "Redirect OAuth to mobile",
        "tags": [
          "Authentication"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-state": "Stable"
      }
    },
    "/oauth/unlink": {
      "post": {
        "description": "Unlink the OAuth account from the authenticated user.",
        "operationId": "unlinkOAuthAccount",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UserAdminResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Unlink OAuth account",
        "tags": [
          "Authentication"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-state": "Stable"
      }
    },
    "/partners": {
      "get": {
        "description": "Retrieve a list of partners with whom assets are shared.",
        "operationId": "getPartners",
        "parameters": [
          {
            "name": "direction",
            "required": true,
            "in": "query",
            "schema": {
              "$ref": "#/components/schemas/PartnerDirection"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/PartnerResponseDto"
                  },
                  "type": "array"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Retrieve partners",
        "tags": [
          "Partners"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "partner.read",
        "x-immich-state": "Stable"
      },
      "post": {
        "description": "Create a new partner to share assets with.",
        "operationId": "createPartner",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PartnerCreateDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PartnerResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Create a partner",
        "tags": [
          "Partners"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "partner.create",
        "x-immich-state": "Stable"
      }
    },
    "/partners/{id}": {
      "delete": {
        "description": "Stop sharing assets with a partner.",
        "operationId": "removePartner",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          }
        ],
        "responses": {
          "204": {
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Remove a partner",
        "tags": [
          "Partners"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "partner.delete",
        "x-immich-state": "Stable"
      },
      "post": {
        "deprecated": true,
        "description": "Create a new partner to share assets with.",
        "operationId": "createPartnerDeprecated",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          }
        ],
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PartnerResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Create a partner",
        "tags": [
          "Partners",
          "Deprecated"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Deprecated",
            "replacementId": "createPartner"
          }
        ],
        "x-immich-permission": "partner.create",
        "x-immich-state": "Deprecated"
      },
      "put": {
        "description": "Specify whether a partner's assets should appear in the user's timeline.",
        "operationId": "updatePartner",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PartnerUpdateDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PartnerResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Update a partner",
        "tags": [
          "Partners"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "partner.update",
        "x-immich-state": "Stable"
      }
    },
    "/passkeys": {
      "get": {
        "description": "Search the passkeys of the current user.",
        "operationId": "searchPasskeys",
        "parameters": [
          {
            "name": "id",
            "required": false,
            "in": "query",
            "description": "Filter by passkey ID",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/PasskeyResponseDto"
                  },
                  "type": "array"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Search passkeys",
        "tags": [
          "Passkeys"
        ],
        "x-immich-history": [
          {
            "version": "v4.0.0",
            "state": "Added"
          },
          {
            "version": "v4.0.0",
            "state": "Alpha"
          }
        ],
        "x-immich-permission": "passkey.read",
        "x-immich-state": "Alpha"
      }
    },
    "/passkeys/authentication/finish": {
      "post": {
        "description": "Verify the response from the authenticator and receive a session token.",
        "operationId": "finishAuthentication",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PasskeyAuthenticationFinishDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/LoginResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "summary": "Finish passkey authentication",
        "tags": [
          "Passkeys"
        ],
        "x-immich-history": [
          {
            "version": "v4.0.0",
            "state": "Added"
          },
          {
            "version": "v4.0.0",
            "state": "Alpha"
          }
        ],
        "x-immich-state": "Alpha"
      }
    },
    "/passkeys/authentication/start": {
      "post": {
        "description": "Generate the options used by the browser to sign in with a passkey.",
        "operationId": "startAuthentication",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PasskeyAuthenticationOptionsDto"
                }
              }
            },
            "description": ""
          }
        },
        "summary": "Start passkey authentication",
        "tags": [
          "Passkeys"
        ],
        "x-immich-history": [
          {
            "version": "v4.0.0",
            "state": "Added"
          },
          {
            "version": "v4.0.0",
            "state": "Alpha"
          }
        ],
        "x-immich-state": "Alpha"
      }
    },
    "/passkeys/registration/finish": {
      "post": {
        "description": "Verify the response from the authenticator and save the new passkey for the current user.",
        "operationId": "finishRegistration",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PasskeyRegistrationFinishDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PasskeyResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Finish passkey registration",
        "tags": [
          "Passkeys"
        ],
        "x-immich-history": [
          {
            "version": "v4.0.0",
            "state": "Added"
          },
          {
            "version": "v4.0.0",
            "state": "Alpha"
          }
        ],
        "x-immich-state": "Alpha"
      }
    },
    "/passkeys/registration/start": {
      "post": {
        "description": "Generate the options used by the browser to create a new passkey for the current user.",
        "operationId": "startRegistration",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PasskeyRegistrationOptionsDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Start passkey registration",
        "tags": [
          "Passkeys"
        ],
        "x-immich-history": [
          {
            "version": "v4.0.0",
            "state": "Added"
          },
          {
            "version": "v4.0.0",
            "state": "Alpha"
          }
        ],
        "x-immich-state": "Alpha"
      }
    },
    "/passkeys/{id}": {
      "delete": {
        "description": "Delete a passkey by its ID. The current user must own this passkey.",
        "operationId": "deletePasskey",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          }
        ],
        "responses": {
          "204": {
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Delete a passkey",
        "tags": [
          "Passkeys"
        ],
        "x-immich-history": [
          {
            "version": "v4.0.0",
            "state": "Added"
          },
          {
            "version": "v4.0.0",
            "state": "Alpha"
          }
        ],
        "x-immich-permission": "passkey.delete",
        "x-immich-state": "Alpha"
      },
      "get": {
        "description": "Retrieve a passkey by its ID. The current user must own this passkey.",
        "operationId": "getPasskey",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PasskeyResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Retrieve a passkey",
        "tags": [
          "Passkeys"
        ],
        "x-immich-history": [
          {
            "version": "v4.0.0",
            "state": "Added"
          },
          {
            "version": "v4.0.0",
            "state": "Alpha"
          }
        ],
        "x-immich-permission": "passkey.read",
        "x-immich-state": "Alpha"
      },
      "patch": {
        "description": "Update the name of a passkey by its ID. The current user must own this passkey.",
        "operationId": "updatePasskey",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PasskeyUpdateDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PasskeyResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Update a passkey",
        "tags": [
          "Passkeys"
        ],
        "x-immich-history": [
          {
            "version": "v4.0.0",
            "state": "Added"
          },
          {
            "version": "v4.0.0",
            "state": "Alpha"
          }
        ],
        "x-immich-permission": "passkey.update",
        "x-immich-state": "Alpha"
      }
    },
    "/people": {
      "delete": {
        "description": "Bulk delete a list of people at once.",
        "operationId": "deletePeople",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PeopleDeleteDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "204": {
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Delete people",
        "tags": [
          "People"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "person.delete",
        "x-immich-state": "Stable"
      },
      "get": {
        "description": "Retrieve a list of all people.",
        "operationId": "getAllPeople",
        "parameters": [
          {
            "name": "closestAssetId",
            "required": false,
            "in": "query",
            "description": "Closest asset ID for similarity search",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          },
          {
            "name": "closestPersonId",
            "required": false,
            "in": "query",
            "description": "Closest person ID for similarity search",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          },
          {
            "name": "isFavorite",
            "required": false,
            "in": "query",
            "description": "Filter by favorite status",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "isHidden",
            "required": false,
            "in": "query",
            "description": "Filter by hidden status",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "name",
            "required": false,
            "in": "query",
            "description": "Filter by person name",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "page",
            "required": false,
            "in": "query",
            "description": "Page number for pagination",
            "schema": {
              "minimum": 1,
              "maximum": 9007199254740991,
              "default": 1,
              "type": "integer"
            }
          },
          {
            "name": "sharedById",
            "required": false,
            "in": "query",
            "description": "Only include people to which the user gave access",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
              "type": "string"
            }
          },
          {
            "name": "sharedWithId",
            "required": false,
            "in": "query",
            "description": "Only include people to which the user was given access",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
              "type": "string"
            }
          },
          {
            "name": "size",
            "required": false,
            "in": "query",
            "description": "Number of items per page",
            "schema": {
              "minimum": 1,
              "maximum": 1000,
              "default": 500,
              "type": "integer"
            }
          },
          {
            "name": "withHidden",
            "required": false,
            "in": "query",
            "description": "Include hidden people",
            "schema": {
              "type": "boolean"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PeopleResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Get all people",
        "tags": [
          "People"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "person.read",
        "x-immich-state": "Stable"
      },
      "post": {
        "description": "Create a new person that can have multiple faces assigned to them.",
        "operationId": "createPerson",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PersonCreateDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PersonResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Create a person",
        "tags": [
          "People"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "person.create",
        "x-immich-state": "Stable"
      },
      "put": {
        "description": "Bulk update multiple people at once.",
        "operationId": "updatePeople",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PeopleUpdateDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/BulkIdResponseDto"
                  },
                  "type": "array"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Update people",
        "tags": [
          "People"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "person.update",
        "x-immich-state": "Stable"
      }
    },
    "/people/merge": {
      "post": {
        "description": "Merge an ordered list of people together into a single person. The final name and birth date are always the first defined value, following the order. Also automatically merges people for other users in the cluster group, skipping people that would result in overriding a previously set name or birth date.",
        "operationId": "mergePeople",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/MergePersonDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/BulkIdResponseDto"
                  },
                  "type": "array"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Merge people",
        "tags": [
          "People"
        ],
        "x-immich-history": [
          {
            "version": "v3.2.1",
            "state": "Added"
          },
          {
            "version": "v3.2.1",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "person.merge",
        "x-immich-state": "Stable"
      }
    },
    "/people/users": {
      "delete": {
        "description": "Remove user access to people",
        "operationId": "removeUsersFromPeople",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PersonUsersDeleteDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Remove users from people",
        "tags": [
          "People"
        ],
        "x-immich-history": [
          {
            "version": "v3.3.0",
            "state": "Added"
          },
          {
            "version": "v3.3.0",
            "state": "Beta"
          }
        ],
        "x-immich-permission": "person.update",
        "x-immich-state": "Beta"
      },
      "get": {
        "description": "Retrieve a list of users and the people to which they have been given access",
        "operationId": "getUsersForPeople",
        "parameters": [
          {
            "name": "direction",
            "required": false,
            "in": "query",
            "schema": {
              "$ref": "#/components/schemas/SharingDirection"
            }
          },
          {
            "name": "personId",
            "required": false,
            "in": "query",
            "description": "Person ID",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
              "type": "string"
            }
          },
          {
            "name": "role",
            "required": false,
            "in": "query",
            "description": "Role of user",
            "schema": {
              "$ref": "#/components/schemas/PersonUserRole"
            }
          },
          {
            "name": "sharedById",
            "required": false,
            "in": "query",
            "description": "User ID of the user that gave access",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
              "type": "string"
            }
          },
          {
            "name": "sharedWithId",
            "required": false,
            "in": "query",
            "description": "User ID of the user that was given access",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PersonUsersResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Get people access",
        "tags": [
          "People"
        ],
        "x-immich-history": [
          {
            "version": "v3.3.0",
            "state": "Added"
          },
          {
            "version": "v3.3.0",
            "state": "Beta"
          }
        ],
        "x-immich-permission": "person.read",
        "x-immich-state": "Beta"
      },
      "put": {
        "description": "Give users access to people",
        "operationId": "upsertPeopleUsers",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PeopleUsersUpsertDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Upsert user access",
        "tags": [
          "People"
        ],
        "x-immich-history": [
          {
            "version": "v3.3.0",
            "state": "Added"
          },
          {
            "version": "v3.3.0",
            "state": "Beta"
          }
        ],
        "x-immich-permission": "person.update",
        "x-immich-state": "Beta"
      }
    },
    "/people/{id}": {
      "delete": {
        "description": "Delete an individual person.",
        "operationId": "deletePerson",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PersonDeleteDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "204": {
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Delete person",
        "tags": [
          "People"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "person.delete",
        "x-immich-state": "Stable"
      },
      "get": {
        "description": "Retrieve a person by id.",
        "operationId": "getPerson",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PersonResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Get a person",
        "tags": [
          "People"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "person.read",
        "x-immich-state": "Stable"
      },
      "put": {
        "description": "Update an individual person.",
        "operationId": "updatePerson",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PersonUpdateDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PersonResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Update person",
        "tags": [
          "People"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          },
          {
            "version": "v3.0.0",
            "state": "Updated",
            "description": "This endpoint now also supports PATCH, in addition to PUT. PATCH will become the default in v4, and then PUT will be dropped in v5. Please migrate accordingly."
          }
        ],
        "x-immich-permission": "person.update",
        "x-immich-state": "Stable"
      }
    },
    "/people/{id}/merge": {
      "post": {
        "deprecated": true,
        "description": "Merge a list of people into the person specified in the path parameter.",
        "operationId": "mergePersonLegacy",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/MergePersonDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/BulkIdResponseDto"
                  },
                  "type": "array"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Merge people",
        "tags": [
          "People",
          "Deprecated"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          },
          {
            "version": "v3.2.1",
            "state": "Deprecated",
            "replacementId": "mergePeople"
          }
        ],
        "x-immich-permission": "person.merge",
        "x-immich-state": "Deprecated"
      }
    },
    "/people/{id}/reassign": {
      "put": {
        "description": "Bulk reassign a list of faces to a different person.",
        "operationId": "reassignFaces",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AssetFaceUpdateDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/PersonResponseDto"
                  },
                  "type": "array"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Reassign faces",
        "tags": [
          "People"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "person.reassign",
        "x-immich-state": "Stable"
      }
    },
    "/people/{id}/statistics": {
      "get": {
        "description": "Retrieve statistics about a specific person.",
        "operationId": "getPersonStatistics",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PersonStatisticsResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Get person statistics",
        "tags": [
          "People"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "person.statistics",
        "x-immich-state": "Stable"
      }
    },
    "/people/{id}/thumbnail": {
      "get": {
        "description": "Retrieve the thumbnail file for a person.",
        "operationId": "getPersonThumbnail",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/octet-stream": {
                "schema": {
                  "format": "binary",
                  "type": "string"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Get person thumbnail",
        "tags": [
          "People"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "person.read",
        "x-immich-state": "Stable"
      }
    },
    "/plugins": {
      "get": {
        "description": "Retrieve a list of plugins available to the authenticated user.",
        "operationId": "searchPlugins",
        "parameters": [
          {
            "name": "description",
            "required": false,
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "enabled",
            "required": false,
            "in": "query",
            "description": "Whether the plugin is enabled",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "id",
            "required": false,
            "in": "query",
            "description": "Plugin ID",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          },
          {
            "name": "name",
            "required": false,
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "title",
            "required": false,
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "version",
            "required": false,
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/PluginResponseDto"
                  },
                  "type": "array"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "List all plugins",
        "tags": [
          "Plugins"
        ],
        "x-immich-history": [
          {
            "version": "v3.0.0",
            "state": "Added"
          }
        ],
        "x-immich-permission": "plugin.read"
      }
    },
    "/plugins/methods": {
      "get": {
        "description": "Retrieve a list of plugin methods",
        "operationId": "searchPluginMethods",
        "parameters": [
          {
            "name": "description",
            "required": false,
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "enabled",
            "required": false,
            "in": "query",
            "description": "Whether the plugin method is enabled",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "id",
            "required": false,
            "in": "query",
            "description": "Plugin method ID",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          },
          {
            "name": "name",
            "required": false,
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "pluginName",
            "required": false,
            "in": "query",
            "description": "Plugin name",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "pluginVersion",
            "required": false,
            "in": "query",
            "description": "Plugin version",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "title",
            "required": false,
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "trigger",
            "required": false,
            "in": "query",
            "description": "Workflow trigger",
            "schema": {
              "$ref": "#/components/schemas/WorkflowTrigger"
            }
          },
          {
            "name": "type",
            "required": false,
            "in": "query",
            "description": "Workflow types",
            "schema": {
              "$ref": "#/components/schemas/WorkflowType"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/PluginMethodResponseDto"
                  },
                  "type": "array"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Retrieve plugin methods",
        "tags": [
          "Plugins"
        ],
        "x-immich-history": [
          {
            "version": "v3.0.0",
            "state": "Added"
          }
        ],
        "x-immich-permission": "plugin.read"
      }
    },
    "/plugins/templates": {
      "get": {
        "description": "Retrieve workflow templates provided by installed plugins",
        "operationId": "searchPluginTemplates",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/PluginTemplateResponseDto"
                  },
                  "type": "array"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Retrieve workflow templates",
        "tags": [
          "Plugins"
        ],
        "x-immich-history": [
          {
            "version": "v3.0.0",
            "state": "Added"
          }
        ],
        "x-immich-permission": "plugin.read"
      }
    },
    "/plugins/{id}": {
      "get": {
        "description": "Retrieve information about a specific plugin by its ID.",
        "operationId": "getPlugin",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PluginResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Retrieve a plugin",
        "tags": [
          "Plugins"
        ],
        "x-immich-history": [
          {
            "version": "v3.0.0",
            "state": "Added"
          }
        ],
        "x-immich-permission": "plugin.read"
      }
    },
    "/public/config": {
      "get": {
        "description": "Retrieve the system configuration properties that are visible to everyone.",
        "operationId": "getPublicConfig",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicConfigDto"
                }
              }
            },
            "description": ""
          }
        },
        "summary": "Get the public configuration",
        "tags": [
          "Config (public)"
        ],
        "x-immich-history": [
          {
            "version": "v3.2.0",
            "state": "Added"
          },
          {
            "version": "v3.2.0",
            "state": "Alpha"
          }
        ],
        "x-immich-state": "Alpha"
      }
    },
    "/public/config/defaults": {
      "get": {
        "description": "Retrieve the default value of the configuration properties that are visible to everyone.",
        "operationId": "getPublicConfigDefaults",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicConfigDto"
                }
              }
            },
            "description": ""
          }
        },
        "summary": "Get the public configuration defaults",
        "tags": [
          "Config (public)"
        ],
        "x-immich-history": [
          {
            "version": "v3.2.0",
            "state": "Added"
          },
          {
            "version": "v3.2.0",
            "state": "Alpha"
          }
        ],
        "x-immich-state": "Alpha"
      }
    },
    "/queues": {
      "get": {
        "description": "Retrieves a list of queues.",
        "operationId": "getQueues",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/QueueResponseDto"
                  },
                  "type": "array"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "List all queues",
        "tags": [
          "Queues"
        ],
        "x-immich-admin-only": true,
        "x-immich-history": [
          {
            "version": "v2.4.0",
            "state": "Added"
          },
          {
            "version": "v2.4.0",
            "state": "Alpha"
          }
        ],
        "x-immich-permission": "queue.read",
        "x-immich-state": "Alpha"
      }
    },
    "/queues/{name}": {
      "get": {
        "description": "Retrieves a specific queue by its name.",
        "operationId": "getQueue",
        "parameters": [
          {
            "name": "name",
            "required": true,
            "in": "path",
            "schema": {
              "$ref": "#/components/schemas/QueueName"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/QueueResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Retrieve a queue",
        "tags": [
          "Queues"
        ],
        "x-immich-admin-only": true,
        "x-immich-history": [
          {
            "version": "v2.4.0",
            "state": "Added"
          },
          {
            "version": "v2.4.0",
            "state": "Alpha"
          }
        ],
        "x-immich-permission": "queue.read",
        "x-immich-state": "Alpha"
      },
      "put": {
        "description": "Change the paused status of a specific queue.",
        "operationId": "updateQueue",
        "parameters": [
          {
            "name": "name",
            "required": true,
            "in": "path",
            "schema": {
              "$ref": "#/components/schemas/QueueName"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/QueueUpdateDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/QueueResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Update a queue",
        "tags": [
          "Queues"
        ],
        "x-immich-admin-only": true,
        "x-immich-history": [
          {
            "version": "v2.4.0",
            "state": "Added"
          },
          {
            "version": "v2.4.0",
            "state": "Alpha"
          }
        ],
        "x-immich-permission": "queue.update",
        "x-immich-state": "Alpha"
      }
    },
    "/queues/{name}/jobs": {
      "delete": {
        "description": "Removes all jobs from the specified queue.",
        "operationId": "emptyQueue",
        "parameters": [
          {
            "name": "name",
            "required": true,
            "in": "path",
            "schema": {
              "$ref": "#/components/schemas/QueueName"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/QueueDeleteDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "204": {
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Empty a queue",
        "tags": [
          "Queues"
        ],
        "x-immich-admin-only": true,
        "x-immich-history": [
          {
            "version": "v2.4.0",
            "state": "Added"
          },
          {
            "version": "v2.4.0",
            "state": "Alpha"
          }
        ],
        "x-immich-permission": "queueJob.delete",
        "x-immich-state": "Alpha"
      },
      "get": {
        "description": "Retrieves a list of queue jobs from the specified queue.",
        "operationId": "getQueueJobs",
        "parameters": [
          {
            "name": "name",
            "required": true,
            "in": "path",
            "schema": {
              "$ref": "#/components/schemas/QueueName"
            }
          },
          {
            "name": "status",
            "required": false,
            "in": "query",
            "description": "Filter jobs by status",
            "schema": {
              "type": "array",
              "items": {
                "$ref": "#/components/schemas/QueueJobStatus"
              }
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/QueueJobResponseDto"
                  },
                  "type": "array"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Retrieve queue jobs",
        "tags": [
          "Queues"
        ],
        "x-immich-admin-only": true,
        "x-immich-history": [
          {
            "version": "v2.4.0",
            "state": "Added"
          },
          {
            "version": "v2.4.0",
            "state": "Alpha"
          }
        ],
        "x-immich-permission": "queueJob.read",
        "x-immich-state": "Alpha"
      }
    },
    "/search/cities": {
      "get": {
        "description": "Retrieve a list of assets with each asset belonging to a different city. This endpoint is used on the places pages to show a single thumbnail for each city the user has assets in.",
        "operationId": "getAssetsByCity",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/AssetResponseDto"
                  },
                  "type": "array"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Retrieve assets by city",
        "tags": [
          "Search"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "asset.read",
        "x-immich-state": "Stable"
      }
    },
    "/search/explore": {
      "get": {
        "description": "Retrieve data for the explore section, such as popular people and places.",
        "operationId": "getExploreData",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/SearchExploreResponseDto"
                  },
                  "type": "array"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Retrieve explore data",
        "tags": [
          "Search"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "asset.read",
        "x-immich-state": "Stable"
      }
    },
    "/search/large-assets": {
      "post": {
        "deprecated": true,
        "description": "Search for assets that are considered large based on specified criteria.",
        "operationId": "searchLargeAssets",
        "parameters": [
          {
            "name": "albumIds",
            "required": false,
            "in": "query",
            "description": "Filter by album IDs",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated",
            "deprecated": true,
            "schema": {
              "type": "array",
              "items": {
                "type": "string",
                "format": "uuid",
                "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$"
              }
            }
          },
          {
            "name": "city",
            "required": false,
            "in": "query",
            "description": "Filter by city name",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated",
            "deprecated": true,
            "schema": {
              "type": "string",
              "nullable": true
            }
          },
          {
            "name": "country",
            "required": false,
            "in": "query",
            "description": "Filter by country name",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated",
            "deprecated": true,
            "schema": {
              "type": "string",
              "nullable": true
            }
          },
          {
            "name": "createdAfter",
            "required": false,
            "in": "query",
            "description": "Filter by creation date (after)",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated",
            "deprecated": true,
            "schema": {
              "format": "date-time",
              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
              "example": "2024-01-01T00:00:00.000Z",
              "type": "string"
            }
          },
          {
            "name": "createdBefore",
            "required": false,
            "in": "query",
            "description": "Filter by creation date (before)",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated",
            "deprecated": true,
            "schema": {
              "format": "date-time",
              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
              "example": "2024-01-01T00:00:00.000Z",
              "type": "string"
            }
          },
          {
            "name": "isEncoded",
            "required": false,
            "in": "query",
            "description": "Filter by encoded status",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated",
            "deprecated": true,
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "isFavorite",
            "required": false,
            "in": "query",
            "description": "Filter by favorite status",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated",
            "deprecated": true,
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "isMotion",
            "required": false,
            "in": "query",
            "description": "Filter by motion photo status",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated",
            "deprecated": true,
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "isNotInAlbum",
            "required": false,
            "in": "query",
            "description": "Filter assets not in any album",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated",
            "deprecated": true,
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "isOffline",
            "required": false,
            "in": "query",
            "description": "Filter by offline status",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated",
            "deprecated": true,
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "lensModel",
            "required": false,
            "in": "query",
            "description": "Filter by lens model",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated",
            "deprecated": true,
            "schema": {
              "type": "string",
              "nullable": true
            }
          },
          {
            "name": "libraryId",
            "required": false,
            "in": "query",
            "description": "Library ID to filter by",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated",
            "deprecated": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "nullable": true
            }
          },
          {
            "name": "make",
            "required": false,
            "in": "query",
            "description": "Filter by camera make",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated",
            "deprecated": true,
            "schema": {
              "type": "string",
              "nullable": true
            }
          },
          {
            "name": "minFileSize",
            "required": false,
            "in": "query",
            "description": "Minimum file size in bytes",
            "schema": {
              "minimum": 0,
              "maximum": 9007199254740991,
              "type": "integer"
            }
          },
          {
            "name": "model",
            "required": false,
            "in": "query",
            "description": "Filter by camera model",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated",
            "deprecated": true,
            "schema": {
              "type": "string",
              "nullable": true
            }
          },
          {
            "name": "ocr",
            "required": false,
            "in": "query",
            "description": "Filter by OCR text content",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated",
            "deprecated": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "personIds",
            "required": false,
            "in": "query",
            "description": "Filter by person IDs",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated",
            "deprecated": true,
            "schema": {
              "type": "array",
              "items": {
                "type": "string",
                "format": "uuid",
                "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$"
              }
            }
          },
          {
            "name": "rating",
            "required": false,
            "in": "query",
            "description": "Filter by rating [1-5], or null for unrated",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v2.6.0",
                "state": "Updated",
                "description": "Using -1 as a rating is deprecated and will be removed in the next major version."
              },
              {
                "version": "v3",
                "state": "Updated",
                "description": "Using -1 as a rating is no longer valid."
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated",
            "deprecated": true,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 5,
              "nullable": true
            }
          },
          {
            "name": "size",
            "required": false,
            "in": "query",
            "description": "Number of results to return",
            "schema": {
              "minimum": 1,
              "maximum": 1000,
              "default": 250,
              "type": "integer"
            }
          },
          {
            "name": "state",
            "required": false,
            "in": "query",
            "description": "Filter by state/province name",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated",
            "deprecated": true,
            "schema": {
              "type": "string",
              "nullable": true
            }
          },
          {
            "name": "tagIds",
            "required": false,
            "in": "query",
            "description": "Filter by tag IDs",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated",
            "deprecated": true,
            "schema": {
              "type": "array",
              "items": {
                "type": "string",
                "format": "uuid",
                "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$"
              },
              "nullable": true
            }
          },
          {
            "name": "takenAfter",
            "required": false,
            "in": "query",
            "description": "Filter by taken date (after)",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated",
            "deprecated": true,
            "schema": {
              "format": "date-time",
              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
              "example": "2024-01-01T00:00:00.000Z",
              "type": "string"
            }
          },
          {
            "name": "takenBefore",
            "required": false,
            "in": "query",
            "description": "Filter by taken date (before)",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated",
            "deprecated": true,
            "schema": {
              "format": "date-time",
              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
              "example": "2024-01-01T00:00:00.000Z",
              "type": "string"
            }
          },
          {
            "name": "trashedAfter",
            "required": false,
            "in": "query",
            "description": "Filter by trash date (after)",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated",
            "deprecated": true,
            "schema": {
              "format": "date-time",
              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
              "example": "2024-01-01T00:00:00.000Z",
              "type": "string"
            }
          },
          {
            "name": "trashedBefore",
            "required": false,
            "in": "query",
            "description": "Filter by trash date (before)",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated",
            "deprecated": true,
            "schema": {
              "format": "date-time",
              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
              "example": "2024-01-01T00:00:00.000Z",
              "type": "string"
            }
          },
          {
            "name": "type",
            "required": false,
            "in": "query",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated",
            "deprecated": true,
            "schema": {
              "$ref": "#/components/schemas/AssetTypeEnum"
            }
          },
          {
            "name": "updatedAfter",
            "required": false,
            "in": "query",
            "description": "Filter by update date (after)",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated",
            "deprecated": true,
            "schema": {
              "format": "date-time",
              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
              "example": "2024-01-01T00:00:00.000Z",
              "type": "string"
            }
          },
          {
            "name": "updatedBefore",
            "required": false,
            "in": "query",
            "description": "Filter by update date (before)",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated",
            "deprecated": true,
            "schema": {
              "format": "date-time",
              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
              "example": "2024-01-01T00:00:00.000Z",
              "type": "string"
            }
          },
          {
            "name": "visibility",
            "required": false,
            "in": "query",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated",
            "deprecated": true,
            "schema": {
              "$ref": "#/components/schemas/AssetVisibility"
            }
          },
          {
            "name": "withDeleted",
            "required": false,
            "in": "query",
            "description": "Include deleted assets",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated",
            "deprecated": true,
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "withExif",
            "required": false,
            "in": "query",
            "description": "Include EXIF data in response",
            "schema": {
              "type": "boolean"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/AssetResponseDto"
                  },
                  "type": "array"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Search large assets",
        "tags": [
          "Search",
          "Deprecated"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          },
          {
            "version": "v3.2.0",
            "state": "Deprecated",
            "replacementId": "searchAssets"
          }
        ],
        "x-immich-permission": "asset.read",
        "x-immich-state": "Deprecated"
      }
    },
    "/search/metadata": {
      "post": {
        "description": "Search for assets based on various metadata criteria.",
        "operationId": "searchAssets",
        "parameters": [
          {
            "name": "key",
            "required": false,
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "slug",
            "required": false,
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/MetadataSearchDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SearchResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Search assets by metadata",
        "tags": [
          "Search"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "asset.read",
        "x-immich-state": "Stable"
      }
    },
    "/search/person": {
      "get": {
        "description": "Search for people by name.",
        "operationId": "searchPerson",
        "parameters": [
          {
            "name": "name",
            "required": true,
            "in": "query",
            "description": "Person name to search for",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "withHidden",
            "required": false,
            "in": "query",
            "description": "Include hidden people",
            "schema": {
              "type": "boolean"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/PersonResponseDto"
                  },
                  "type": "array"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Search people",
        "tags": [
          "Search"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "person.read",
        "x-immich-state": "Stable"
      }
    },
    "/search/places": {
      "get": {
        "description": "Search for places by name.",
        "operationId": "searchPlaces",
        "parameters": [
          {
            "name": "name",
            "required": true,
            "in": "query",
            "description": "Place name to search for",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/PlacesResponseDto"
                  },
                  "type": "array"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Search places",
        "tags": [
          "Search"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "asset.read",
        "x-immich-state": "Stable"
      }
    },
    "/search/random": {
      "post": {
        "description": "Retrieve a random selection of assets based on the provided criteria.",
        "operationId": "searchRandom",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/RandomSearchDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/AssetResponseDto"
                  },
                  "type": "array"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Search random assets",
        "tags": [
          "Search"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "asset.read",
        "x-immich-state": "Stable"
      }
    },
    "/search/smart": {
      "post": {
        "description": "Perform a smart search for assets by using machine learning vectors to determine relevance.",
        "operationId": "searchSmart",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SmartSearchDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SearchResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Smart asset search",
        "tags": [
          "Search"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "asset.read",
        "x-immich-state": "Stable"
      }
    },
    "/search/statistics": {
      "post": {
        "description": "Retrieve statistical data about assets based on search criteria, such as the total matching count.",
        "operationId": "searchAssetStatistics",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/StatisticsSearchDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SearchStatisticsResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Search asset statistics",
        "tags": [
          "Search"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "asset.statistics",
        "x-immich-state": "Stable"
      }
    },
    "/search/suggestions": {
      "get": {
        "description": "Retrieve search suggestions based on partial input. This endpoint is used for typeahead search features.",
        "operationId": "getSearchSuggestions",
        "parameters": [
          {
            "name": "country",
            "required": false,
            "in": "query",
            "description": "Filter by country",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "includeNull",
            "required": false,
            "in": "query",
            "description": "Include null values in suggestions",
            "x-immich-history": [
              {
                "version": "v1.111.0",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              }
            ],
            "x-immich-state": "Stable",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "lensModel",
            "required": false,
            "in": "query",
            "description": "Filter by lens model",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "make",
            "required": false,
            "in": "query",
            "description": "Filter by camera make",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "model",
            "required": false,
            "in": "query",
            "description": "Filter by camera model",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "state",
            "required": false,
            "in": "query",
            "description": "Filter by state/province",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "type",
            "required": true,
            "in": "query",
            "schema": {
              "$ref": "#/components/schemas/SearchSuggestionType"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "type": "string"
                  },
                  "type": "array"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Retrieve search suggestions",
        "tags": [
          "Search"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "asset.read",
        "x-immich-state": "Stable"
      }
    },
    "/server/about": {
      "get": {
        "description": "Retrieve a list of information about the server.",
        "operationId": "getAboutInfo",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ServerAboutResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Get server information",
        "tags": [
          "Server"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "server.about",
        "x-immich-state": "Stable"
      }
    },
    "/server/apk-links": {
      "get": {
        "description": "Retrieve links to the APKs for the current server version.",
        "operationId": "getApkLinks",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ServerApkLinksDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Get APK links",
        "tags": [
          "Server"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "server.apkLinks",
        "x-immich-state": "Stable"
      }
    },
    "/server/config": {
      "get": {
        "deprecated": true,
        "description": "Retrieve the current server configuration.",
        "operationId": "getServerConfig",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ServerConfigDto"
                }
              }
            },
            "description": ""
          }
        },
        "summary": "Get config",
        "tags": [
          "Server",
          "Deprecated"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          },
          {
            "version": "v3.2.0",
            "state": "Deprecated",
            "replacementId": "getPublicConfig"
          }
        ],
        "x-immich-state": "Deprecated"
      }
    },
    "/server/features": {
      "get": {
        "deprecated": true,
        "description": "Retrieve available features supported by this server.",
        "operationId": "getServerFeatures",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ServerFeaturesDto"
                }
              }
            },
            "description": ""
          }
        },
        "summary": "Get features",
        "tags": [
          "Server",
          "Deprecated"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          },
          {
            "version": "v3.2.0",
            "state": "Deprecated",
            "replacementId": "getPublicConfig"
          }
        ],
        "x-immich-state": "Deprecated"
      }
    },
    "/server/license": {
      "delete": {
        "description": "Delete the currently set server product key.",
        "operationId": "deleteServerLicense",
        "parameters": [],
        "responses": {
          "204": {
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Delete server product key",
        "tags": [
          "Server"
        ],
        "x-immich-admin-only": true,
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "serverLicense.delete",
        "x-immich-state": "Stable"
      },
      "get": {
        "description": "Retrieve information about whether the server currently has a product key registered.",
        "operationId": "getServerLicense",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/LicenseResponseDto"
                }
              }
            },
            "description": ""
          },
          "404": {
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Get product key",
        "tags": [
          "Server"
        ],
        "x-immich-admin-only": true,
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "serverLicense.read",
        "x-immich-state": "Stable"
      },
      "put": {
        "description": "Validate and set the server product key if successful.",
        "operationId": "setServerLicense",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/LicenseKeyDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/LicenseResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Set server product key",
        "tags": [
          "Server"
        ],
        "x-immich-admin-only": true,
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "serverLicense.update",
        "x-immich-state": "Stable"
      }
    },
    "/server/media-types": {
      "get": {
        "description": "Retrieve all media types supported by the server.",
        "operationId": "getSupportedMediaTypes",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ServerMediaTypesResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "summary": "Get supported media types",
        "tags": [
          "Server"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-state": "Stable"
      }
    },
    "/server/ping": {
      "get": {
        "description": "Pong",
        "operationId": "pingServer",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ServerPingResponse"
                }
              }
            },
            "description": ""
          }
        },
        "summary": "Ping",
        "tags": [
          "Server"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-state": "Stable"
      }
    },
    "/server/statistics": {
      "get": {
        "description": "Retrieve statistics about the entire Immich instance such as asset counts.",
        "operationId": "getServerStatistics",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ServerStatsResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Get statistics",
        "tags": [
          "Server"
        ],
        "x-immich-admin-only": true,
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "server.statistics",
        "x-immich-state": "Stable"
      }
    },
    "/server/storage": {
      "get": {
        "description": "Retrieve the current storage utilization information of the server.",
        "operationId": "getStorage",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ServerStorageResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Get storage",
        "tags": [
          "Server"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "server.storage",
        "x-immich-state": "Stable"
      }
    },
    "/server/version": {
      "get": {
        "description": "Retrieve the current server version in semantic versioning (semver) format.",
        "operationId": "getServerVersion",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ServerVersionResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "summary": "Get server version",
        "tags": [
          "Server"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-state": "Stable"
      }
    },
    "/server/version-check": {
      "get": {
        "description": "Retrieve information about the last time the version check ran.",
        "operationId": "getVersionCheck",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/VersionCheckStateResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Get version check status",
        "tags": [
          "Server"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "server.versionCheck",
        "x-immich-state": "Stable"
      }
    },
    "/server/version-history": {
      "get": {
        "description": "Retrieve a list of past versions the server has been on.",
        "operationId": "getVersionHistory",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/ServerVersionHistoryResponseDto"
                  },
                  "type": "array"
                }
              }
            },
            "description": ""
          }
        },
        "summary": "Get version history",
        "tags": [
          "Server"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-state": "Stable"
      }
    },
    "/sessions": {
      "delete": {
        "description": "Delete all sessions for the user. This will not delete the current session.",
        "operationId": "deleteAllSessions",
        "parameters": [],
        "responses": {
          "204": {
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Delete all sessions",
        "tags": [
          "Sessions"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "session.delete",
        "x-immich-state": "Stable"
      },
      "get": {
        "description": "Retrieve a list of sessions for the user.",
        "operationId": "getSessions",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/SessionResponseDto"
                  },
                  "type": "array"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Retrieve sessions",
        "tags": [
          "Sessions"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "session.read",
        "x-immich-state": "Stable"
      },
      "post": {
        "description": "Create a session as a child to the current session. This endpoint is used for casting.",
        "operationId": "createSession",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SessionCreateDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SessionCreateResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Create a session",
        "tags": [
          "Sessions"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "session.create",
        "x-immich-state": "Stable"
      }
    },
    "/sessions/{id}": {
      "delete": {
        "description": "Delete a specific session by id.",
        "operationId": "deleteSession",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          }
        ],
        "responses": {
          "204": {
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Delete a session",
        "tags": [
          "Sessions"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "session.delete",
        "x-immich-state": "Stable"
      },
      "put": {
        "description": "Update a specific session identified by id.",
        "operationId": "updateSession",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SessionUpdateDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SessionResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Update a session",
        "tags": [
          "Sessions"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          },
          {
            "version": "v3.0.0",
            "state": "Updated",
            "description": "This endpoint now also supports PATCH, in addition to PUT. PATCH will become the default in v4, and then PUT will be dropped in v5. Please migrate accordingly."
          }
        ],
        "x-immich-permission": "session.update",
        "x-immich-state": "Stable"
      }
    },
    "/sessions/{id}/lock": {
      "post": {
        "description": "Lock a specific session by id.",
        "operationId": "lockSession",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          }
        ],
        "responses": {
          "204": {
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Lock a session",
        "tags": [
          "Sessions"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "session.lock",
        "x-immich-state": "Stable"
      }
    },
    "/shared-links": {
      "get": {
        "description": "Retrieve a list of all shared links.",
        "operationId": "getAllSharedLinks",
        "parameters": [
          {
            "name": "albumId",
            "required": false,
            "in": "query",
            "description": "Filter by album ID",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          },
          {
            "name": "id",
            "required": false,
            "in": "query",
            "description": "Filter by shared link ID",
            "x-immich-history": [
              {
                "version": "v2.5.0",
                "state": "Added"
              }
            ],
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/SharedLinkResponseDto"
                  },
                  "type": "array"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Retrieve all shared links",
        "tags": [
          "Shared links"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "sharedLink.read",
        "x-immich-state": "Stable"
      },
      "post": {
        "description": "Create a new shared link.",
        "operationId": "createSharedLink",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SharedLinkCreateDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SharedLinkResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Create a shared link",
        "tags": [
          "Shared links"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "sharedLink.create",
        "x-immich-state": "Stable"
      }
    },
    "/shared-links/login": {
      "post": {
        "description": "Login to a password protected shared link",
        "operationId": "sharedLinkLogin",
        "parameters": [
          {
            "name": "key",
            "required": false,
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "slug",
            "required": false,
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SharedLinkLoginDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SharedLinkResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Shared link login",
        "tags": [
          "Shared links"
        ],
        "x-immich-history": [
          {
            "version": "v2.6.0",
            "state": "Added"
          },
          {
            "version": "v2.6.0",
            "state": "Beta"
          }
        ],
        "x-immich-state": "Beta"
      }
    },
    "/shared-links/me": {
      "get": {
        "description": "Retrieve the current shared link associated with authentication method.",
        "operationId": "getMySharedLink",
        "parameters": [
          {
            "name": "key",
            "required": false,
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "slug",
            "required": false,
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SharedLinkResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Retrieve current shared link",
        "tags": [
          "Shared links"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-state": "Stable"
      }
    },
    "/shared-links/{id}": {
      "delete": {
        "description": "Delete a specific shared link by its ID.",
        "operationId": "removeSharedLink",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          }
        ],
        "responses": {
          "204": {
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Delete a shared link",
        "tags": [
          "Shared links"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "sharedLink.delete",
        "x-immich-state": "Stable"
      },
      "get": {
        "description": "Retrieve a specific shared link by its ID.",
        "operationId": "getSharedLinkById",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SharedLinkResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Retrieve a shared link",
        "tags": [
          "Shared links"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "sharedLink.read",
        "x-immich-state": "Stable"
      },
      "patch": {
        "description": "Update an existing shared link by its ID.",
        "operationId": "updateSharedLink",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SharedLinkEditDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SharedLinkResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Update a shared link",
        "tags": [
          "Shared links"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "sharedLink.update",
        "x-immich-state": "Stable"
      }
    },
    "/shared-links/{id}/assets": {
      "delete": {
        "description": "Remove assets from a specific shared link by its ID. This endpoint is only relevant for shared link of type individual.",
        "operationId": "removeSharedLinkAssets",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AssetIdsDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/AssetIdsResponseDto"
                  },
                  "type": "array"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Remove assets from a shared link",
        "tags": [
          "Shared links"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "sharedLink.update",
        "x-immich-state": "Stable"
      },
      "put": {
        "description": "Add assets to a specific shared link by its ID. This endpoint is only relevant for shared link of type individual.",
        "operationId": "addSharedLinkAssets",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AssetIdsDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/AssetIdsResponseDto"
                  },
                  "type": "array"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Add assets to a shared link",
        "tags": [
          "Shared links"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "sharedLink.update",
        "x-immich-state": "Stable"
      }
    },
    "/stacks": {
      "delete": {
        "description": "Delete multiple stacks by providing a list of stack IDs.",
        "operationId": "deleteStacks",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/BulkIdsDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "204": {
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Delete stacks",
        "tags": [
          "Stacks"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "stack.delete",
        "x-immich-state": "Stable"
      },
      "get": {
        "description": "Retrieve a list of stacks.",
        "operationId": "searchStacks",
        "parameters": [
          {
            "name": "primaryAssetId",
            "required": false,
            "in": "query",
            "description": "Filter by primary asset ID",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/StackResponseDto"
                  },
                  "type": "array"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Retrieve stacks",
        "tags": [
          "Stacks"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "stack.read",
        "x-immich-state": "Stable"
      },
      "post": {
        "description": "Create a new stack by providing a name and a list of asset IDs to include in the stack. If any of the provided asset IDs are primary assets of an existing stack, the existing stack will be merged into the newly created stack.",
        "operationId": "createStack",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/StackCreateDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StackResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Create a stack",
        "tags": [
          "Stacks"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "stack.create",
        "x-immich-state": "Stable"
      }
    },
    "/stacks/{id}": {
      "delete": {
        "description": "Delete a specific stack by its ID.",
        "operationId": "deleteStack",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          }
        ],
        "responses": {
          "204": {
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Delete a stack",
        "tags": [
          "Stacks"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "stack.delete",
        "x-immich-state": "Stable"
      },
      "get": {
        "description": "Retrieve a specific stack by its ID.",
        "operationId": "getStack",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StackResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Retrieve a stack",
        "tags": [
          "Stacks"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "stack.read",
        "x-immich-state": "Stable"
      },
      "put": {
        "description": "Update an existing stack by its ID.",
        "operationId": "updateStack",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/StackUpdateDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StackResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Update a stack",
        "tags": [
          "Stacks"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          },
          {
            "version": "v3.0.0",
            "state": "Updated",
            "description": "This endpoint now also supports PATCH, in addition to PUT. PATCH will become the default in v4, and then PUT will be dropped in v5. Please migrate accordingly."
          }
        ],
        "x-immich-permission": "stack.update",
        "x-immich-state": "Stable"
      }
    },
    "/stacks/{id}/assets/{assetId}": {
      "delete": {
        "description": "Remove a specific asset from a stack by providing the stack ID and asset ID.",
        "operationId": "removeAssetFromStack",
        "parameters": [
          {
            "name": "assetId",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          },
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          }
        ],
        "responses": {
          "204": {
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Remove an asset from a stack",
        "tags": [
          "Stacks"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "stack.update",
        "x-immich-state": "Stable"
      }
    },
    "/sync/ack": {
      "delete": {
        "description": "Delete specific synchronization acknowledgments.",
        "operationId": "deleteSyncAck",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SyncAckDeleteDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "204": {
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Delete acknowledgements",
        "tags": [
          "Sync"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "syncCheckpoint.delete",
        "x-immich-state": "Stable"
      },
      "get": {
        "description": "Retrieve the synchronization acknowledgments for the current session.",
        "operationId": "getSyncAck",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/SyncAckDto"
                  },
                  "type": "array"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Retrieve acknowledgements",
        "tags": [
          "Sync"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "syncCheckpoint.read",
        "x-immich-state": "Stable"
      },
      "post": {
        "description": "Send a list of synchronization acknowledgements to confirm that the latest changes have been received.",
        "operationId": "sendSyncAck",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SyncAckSetDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "204": {
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Acknowledge changes",
        "tags": [
          "Sync"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "syncCheckpoint.update",
        "x-immich-state": "Stable"
      }
    },
    "/sync/stream": {
      "post": {
        "description": "Retrieve a JSON lines streamed response of changes for synchronization. This endpoint is used by the mobile app to efficiently stay up to date with changes.",
        "operationId": "getSyncStream",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SyncStreamDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Stream sync changes",
        "tags": [
          "Sync"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "sync.stream",
        "x-immich-state": "Stable"
      }
    },
    "/system-config": {
      "get": {
        "deprecated": true,
        "description": "Retrieve the current system configuration.",
        "operationId": "getConfig",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AdminConfigDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Get system configuration",
        "tags": [
          "System config",
          "Deprecated"
        ],
        "x-immich-admin-only": true,
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          },
          {
            "version": "v3.2.0",
            "state": "Deprecated",
            "replacementId": "getAdminConfig"
          }
        ],
        "x-immich-permission": "systemConfig.read",
        "x-immich-state": "Deprecated"
      },
      "put": {
        "deprecated": true,
        "description": "Update the system configuration with a new system configuration.",
        "operationId": "updateConfig",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AdminConfigDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AdminConfigDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Update system configuration",
        "tags": [
          "System config",
          "Deprecated"
        ],
        "x-immich-admin-only": true,
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          },
          {
            "version": "v3.2.0",
            "state": "Deprecated",
            "replacementId": "updateAdminConfig"
          }
        ],
        "x-immich-permission": "systemConfig.update",
        "x-immich-state": "Deprecated"
      }
    },
    "/system-config/defaults": {
      "get": {
        "deprecated": true,
        "description": "Retrieve the default values for the system configuration.",
        "operationId": "getConfigDefaults",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AdminConfigDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Get system configuration defaults",
        "tags": [
          "System config",
          "Deprecated"
        ],
        "x-immich-admin-only": true,
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          },
          {
            "version": "v3.2.0",
            "state": "Deprecated",
            "replacementId": "getAdminConfigDefaults"
          }
        ],
        "x-immich-permission": "systemConfig.read",
        "x-immich-state": "Deprecated"
      }
    },
    "/system-config/storage-template-options": {
      "get": {
        "description": "Retrieve exemplary storage template options.",
        "operationId": "getStorageTemplateOptions",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SystemConfigTemplateStorageOptionDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Get storage template options",
        "tags": [
          "System config"
        ],
        "x-immich-admin-only": true,
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "systemConfig.read",
        "x-immich-state": "Stable"
      }
    },
    "/system-metadata/admin-onboarding": {
      "get": {
        "description": "Retrieve the current admin onboarding status.",
        "operationId": "getAdminOnboarding",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AdminOnboardingUpdateDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Retrieve admin onboarding",
        "tags": [
          "System metadata"
        ],
        "x-immich-admin-only": true,
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "systemMetadata.read",
        "x-immich-state": "Stable"
      },
      "post": {
        "description": "Update the admin onboarding status.",
        "operationId": "updateAdminOnboarding",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AdminOnboardingUpdateDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "204": {
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Update admin onboarding",
        "tags": [
          "System metadata"
        ],
        "x-immich-admin-only": true,
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "systemMetadata.update",
        "x-immich-state": "Stable"
      }
    },
    "/system-metadata/reverse-geocoding-state": {
      "get": {
        "description": "Retrieve the current state of the reverse geocoding import.",
        "operationId": "getReverseGeocodingState",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ReverseGeocodingStateResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Retrieve reverse geocoding state",
        "tags": [
          "System metadata"
        ],
        "x-immich-admin-only": true,
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "systemMetadata.read",
        "x-immich-state": "Stable"
      }
    },
    "/system-metadata/version-check-state": {
      "get": {
        "description": "Retrieve the current state of the version check process.",
        "operationId": "getVersionCheckState",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/VersionCheckStateResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Retrieve version check state",
        "tags": [
          "System metadata"
        ],
        "x-immich-admin-only": true,
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "systemMetadata.read",
        "x-immich-state": "Stable"
      }
    },
    "/tags": {
      "get": {
        "description": "Retrieve a list of all tags.",
        "operationId": "getAllTags",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/TagResponseDto"
                  },
                  "type": "array"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Retrieve tags",
        "tags": [
          "Tags"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "tag.read",
        "x-immich-state": "Stable"
      },
      "post": {
        "description": "Create a new tag by providing a name and optional color.",
        "operationId": "createTag",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/TagCreateDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TagResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Create a tag",
        "tags": [
          "Tags"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "tag.create",
        "x-immich-state": "Stable"
      },
      "put": {
        "description": "Create or update multiple tags in a single request.",
        "operationId": "upsertTags",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/TagUpsertDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/TagResponseDto"
                  },
                  "type": "array"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Upsert tags",
        "tags": [
          "Tags"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "tag.create",
        "x-immich-state": "Stable"
      }
    },
    "/tags/assets": {
      "put": {
        "description": "Add multiple tags to multiple assets in a single request.",
        "operationId": "bulkTagAssets",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/TagBulkAssetsDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TagBulkAssetsResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Tag assets",
        "tags": [
          "Tags"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "tag.asset",
        "x-immich-state": "Stable"
      }
    },
    "/tags/{id}": {
      "delete": {
        "description": "Delete a specific tag by its ID.",
        "operationId": "deleteTag",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          }
        ],
        "responses": {
          "204": {
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Delete a tag",
        "tags": [
          "Tags"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "tag.delete",
        "x-immich-state": "Stable"
      },
      "get": {
        "description": "Retrieve a specific tag by its ID.",
        "operationId": "getTagById",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TagResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Retrieve a tag",
        "tags": [
          "Tags"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "tag.read",
        "x-immich-state": "Stable"
      },
      "put": {
        "description": "Update an existing tag identified by its ID.",
        "operationId": "updateTag",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/TagUpdateDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TagResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Update a tag",
        "tags": [
          "Tags"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          },
          {
            "version": "v3.0.0",
            "state": "Updated",
            "description": "This endpoint now also supports PATCH, in addition to PUT. PATCH will become the default in v4, and then PUT will be dropped in v5. Please migrate accordingly."
          }
        ],
        "x-immich-permission": "tag.update",
        "x-immich-state": "Stable"
      }
    },
    "/tags/{id}/assets": {
      "delete": {
        "description": "Remove a tag from all the specified assets.",
        "operationId": "untagAssets",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/BulkIdsDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/BulkIdResponseDto"
                  },
                  "type": "array"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Untag assets",
        "tags": [
          "Tags"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "tag.asset",
        "x-immich-state": "Stable"
      },
      "put": {
        "description": "Add a tag to all the specified assets.",
        "operationId": "tagAssets",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/BulkIdsDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/BulkIdResponseDto"
                  },
                  "type": "array"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Tag assets",
        "tags": [
          "Tags"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "tag.asset",
        "x-immich-state": "Stable"
      }
    },
    "/timeline/bucket": {
      "get": {
        "description": "Retrieve a string of all asset ids in a given time bucket.",
        "operationId": "getTimeBucket",
        "parameters": [
          {
            "name": "albumId",
            "required": false,
            "in": "query",
            "description": "Filter assets belonging to a specific album",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          },
          {
            "name": "bbox",
            "required": false,
            "in": "query",
            "description": "Bounding box coordinates as west,south,east,north (WGS84)",
            "schema": {
              "example": "11.075683,49.416711,11.117589,49.454875",
              "type": "string"
            }
          },
          {
            "name": "isFavorite",
            "required": false,
            "in": "query",
            "description": "Filter by favorite status (true for favorites only, false for non-favorites only)",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "isTrashed",
            "required": false,
            "in": "query",
            "description": "Filter by trash status (true for trashed assets only, false for non-trashed only)",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "key",
            "required": false,
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "order",
            "required": false,
            "in": "query",
            "description": "Sort order for assets within time buckets (ASC for oldest first, DESC for newest first)",
            "schema": {
              "$ref": "#/components/schemas/AssetOrder"
            }
          },
          {
            "name": "orderBy",
            "required": false,
            "in": "query",
            "description": "Date to group and order assets by (takenAt for date taken, createdAt for date added to Immich)",
            "schema": {
              "$ref": "#/components/schemas/AssetOrderBy"
            }
          },
          {
            "name": "personId",
            "required": false,
            "in": "query",
            "description": "Filter assets containing a specific person (face recognition)",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          },
          {
            "name": "slug",
            "required": false,
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "tagId",
            "required": false,
            "in": "query",
            "description": "Filter assets with a specific tag",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          },
          {
            "name": "timeBucket",
            "required": true,
            "in": "query",
            "description": "Time bucket identifier in YYYY-MM-DDT00:00:00.000Z format",
            "schema": {
              "example": "2024-01-01T00:00:00.000Z",
              "type": "string"
            }
          },
          {
            "name": "userId",
            "required": false,
            "in": "query",
            "description": "Filter assets by specific user ID",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          },
          {
            "name": "visibility",
            "required": false,
            "in": "query",
            "description": "Filter by asset visibility status (ARCHIVE, TIMELINE, HIDDEN, LOCKED)",
            "schema": {
              "$ref": "#/components/schemas/AssetVisibility"
            }
          },
          {
            "name": "withCoordinates",
            "required": false,
            "in": "query",
            "description": "Include location data in the response",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "withPartners",
            "required": false,
            "in": "query",
            "description": "Include assets shared by partners",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "withStacked",
            "required": false,
            "in": "query",
            "description": "Include stacked assets in the response. When true, only primary assets from stacks are returned.",
            "schema": {
              "type": "boolean"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TimeBucketAssetResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Get time bucket",
        "tags": [
          "Timeline"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Internal"
          }
        ],
        "x-immich-permission": "asset.read",
        "x-immich-state": "Internal"
      }
    },
    "/timeline/buckets": {
      "get": {
        "description": "Retrieve a list of all minimal time buckets.",
        "operationId": "getTimeBuckets",
        "parameters": [
          {
            "name": "albumId",
            "required": false,
            "in": "query",
            "description": "Filter assets belonging to a specific album",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          },
          {
            "name": "bbox",
            "required": false,
            "in": "query",
            "description": "Bounding box coordinates as west,south,east,north (WGS84)",
            "schema": {
              "example": "11.075683,49.416711,11.117589,49.454875",
              "type": "string"
            }
          },
          {
            "name": "isFavorite",
            "required": false,
            "in": "query",
            "description": "Filter by favorite status (true for favorites only, false for non-favorites only)",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "isTrashed",
            "required": false,
            "in": "query",
            "description": "Filter by trash status (true for trashed assets only, false for non-trashed only)",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "key",
            "required": false,
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "order",
            "required": false,
            "in": "query",
            "description": "Sort order for assets within time buckets (ASC for oldest first, DESC for newest first)",
            "schema": {
              "$ref": "#/components/schemas/AssetOrder"
            }
          },
          {
            "name": "orderBy",
            "required": false,
            "in": "query",
            "description": "Date to group and order assets by (takenAt for date taken, createdAt for date added to Immich)",
            "schema": {
              "$ref": "#/components/schemas/AssetOrderBy"
            }
          },
          {
            "name": "personId",
            "required": false,
            "in": "query",
            "description": "Filter assets containing a specific person (face recognition)",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          },
          {
            "name": "slug",
            "required": false,
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "tagId",
            "required": false,
            "in": "query",
            "description": "Filter assets with a specific tag",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          },
          {
            "name": "userId",
            "required": false,
            "in": "query",
            "description": "Filter assets by specific user ID",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          },
          {
            "name": "visibility",
            "required": false,
            "in": "query",
            "description": "Filter by asset visibility status (ARCHIVE, TIMELINE, HIDDEN, LOCKED)",
            "schema": {
              "$ref": "#/components/schemas/AssetVisibility"
            }
          },
          {
            "name": "withCoordinates",
            "required": false,
            "in": "query",
            "description": "Include location data in the response",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "withPartners",
            "required": false,
            "in": "query",
            "description": "Include assets shared by partners",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "withStacked",
            "required": false,
            "in": "query",
            "description": "Include stacked assets in the response. When true, only primary assets from stacks are returned.",
            "schema": {
              "type": "boolean"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/TimeBucketsResponseDto"
                  },
                  "type": "array"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Get time buckets",
        "tags": [
          "Timeline"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Internal"
          }
        ],
        "x-immich-permission": "asset.read",
        "x-immich-state": "Internal"
      }
    },
    "/trash/empty": {
      "post": {
        "description": "Permanently delete all items in the trash.",
        "operationId": "emptyTrash",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TrashResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Empty trash",
        "tags": [
          "Trash"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "asset.delete",
        "x-immich-state": "Stable"
      }
    },
    "/trash/restore": {
      "post": {
        "description": "Restore all items in the trash.",
        "operationId": "restoreTrash",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TrashResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Restore trash",
        "tags": [
          "Trash"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "asset.delete",
        "x-immich-state": "Stable"
      }
    },
    "/trash/restore/assets": {
      "post": {
        "description": "Restore specific assets from the trash.",
        "operationId": "restoreAssets",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/BulkIdsDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TrashResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Restore assets",
        "tags": [
          "Trash"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "asset.delete",
        "x-immich-state": "Stable"
      }
    },
    "/users": {
      "get": {
        "description": "Retrieve a list of all users on the server.",
        "operationId": "searchUsers",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/UserResponseDto"
                  },
                  "type": "array"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Get all users",
        "tags": [
          "Users"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "user.read",
        "x-immich-state": "Stable"
      }
    },
    "/users/me": {
      "get": {
        "description": "Retrieve information about the user making the API request.",
        "operationId": "getMyUser",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UserAdminResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Get current user",
        "tags": [
          "Users"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "user.read",
        "x-immich-state": "Stable"
      },
      "put": {
        "description": "Update the current user making the API request.",
        "operationId": "updateMyUser",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UserUpdateMeDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UserAdminResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Update current user",
        "tags": [
          "Users"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          },
          {
            "version": "v3.0.0",
            "state": "Updated",
            "description": "This endpoint now also supports PATCH, in addition to PUT. PATCH will become the default in v4, and then PUT will be dropped in v5. Please migrate accordingly."
          }
        ],
        "x-immich-permission": "user.update",
        "x-immich-state": "Stable"
      }
    },
    "/users/me/calendar-heatmap": {
      "get": {
        "description": "Retrieve activity counts for a specified period, in a calendar heatmap format.",
        "operationId": "getMyCalendarHeatmap",
        "parameters": [
          {
            "name": "from",
            "required": false,
            "in": "query",
            "description": "Start date in UTC",
            "schema": {
              "format": "date",
              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
              "example": "2024-01-01",
              "type": "string"
            }
          },
          {
            "name": "to",
            "required": false,
            "in": "query",
            "description": "End date in UTC",
            "schema": {
              "format": "date",
              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
              "example": "2024-01-01",
              "type": "string"
            }
          },
          {
            "name": "type",
            "required": false,
            "in": "query",
            "schema": {
              "default": "Upload",
              "$ref": "#/components/schemas/CalendarHeatmapType"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CalendarHeatmapResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Retrieve calendar heatmap activity",
        "tags": [
          "Users"
        ],
        "x-immich-history": [
          {
            "version": "v3",
            "state": "Added"
          },
          {
            "version": "v3",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "user.read",
        "x-immich-state": "Stable"
      }
    },
    "/users/me/license": {
      "delete": {
        "description": "Delete the registered product key for the current user.",
        "operationId": "deleteUserLicense",
        "parameters": [],
        "responses": {
          "204": {
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Delete user product key",
        "tags": [
          "Users"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "userLicense.delete",
        "x-immich-state": "Stable"
      },
      "get": {
        "description": "Retrieve information about whether the current user has a registered product key.",
        "operationId": "getUserLicense",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/LicenseResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Retrieve user product key",
        "tags": [
          "Users"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "userLicense.read",
        "x-immich-state": "Stable"
      },
      "put": {
        "description": "Register a product key for the current user.",
        "operationId": "setUserLicense",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/LicenseKeyDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/LicenseResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Set user product key",
        "tags": [
          "Users"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "userLicense.update",
        "x-immich-state": "Stable"
      }
    },
    "/users/me/onboarding": {
      "delete": {
        "description": "Delete the onboarding status of the current user.",
        "operationId": "deleteUserOnboarding",
        "parameters": [],
        "responses": {
          "204": {
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Delete user onboarding",
        "tags": [
          "Users"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "userOnboarding.delete",
        "x-immich-state": "Stable"
      },
      "get": {
        "description": "Retrieve the onboarding status of the current user.",
        "operationId": "getUserOnboarding",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OnboardingResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Retrieve user onboarding",
        "tags": [
          "Users"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "userOnboarding.read",
        "x-immich-state": "Stable"
      },
      "put": {
        "description": "Update the onboarding status of the current user.",
        "operationId": "setUserOnboarding",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/OnboardingDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OnboardingResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Update user onboarding",
        "tags": [
          "Users"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "userOnboarding.update",
        "x-immich-state": "Stable"
      }
    },
    "/users/me/preferences": {
      "get": {
        "description": "Retrieve the preferences for the current user.",
        "operationId": "getMyPreferences",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UserPreferencesResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Get my preferences",
        "tags": [
          "Users"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "userPreference.read",
        "x-immich-state": "Stable"
      },
      "put": {
        "description": "Update the preferences of the current user.",
        "operationId": "updateMyPreferences",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UserPreferencesUpdateDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UserPreferencesResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Update my preferences",
        "tags": [
          "Users"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          },
          {
            "version": "v3.0.0",
            "state": "Updated",
            "description": "This endpoint now also supports PATCH, in addition to PUT. PATCH will become the default in v4, and then PUT will be dropped in v5. Please migrate accordingly."
          }
        ],
        "x-immich-permission": "userPreference.update",
        "x-immich-state": "Stable"
      }
    },
    "/users/profile-image": {
      "delete": {
        "description": "Delete the profile image of the current user.",
        "operationId": "deleteProfileImage",
        "parameters": [],
        "responses": {
          "204": {
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Delete user profile image",
        "tags": [
          "Users"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "userProfileImage.delete",
        "x-immich-state": "Stable"
      },
      "post": {
        "description": "Upload and set a new profile image for the current user.",
        "operationId": "createProfileImage",
        "parameters": [],
        "requestBody": {
          "content": {
            "multipart/form-data": {
              "schema": {
                "$ref": "#/components/schemas/CreateProfileImageDto"
              }
            }
          },
          "description": "A new avatar for the user",
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CreateProfileImageResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Create user profile image",
        "tags": [
          "Users"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "userProfileImage.update",
        "x-immich-state": "Stable"
      }
    },
    "/users/{id}": {
      "get": {
        "description": "Retrieve a specific user by their ID.",
        "operationId": "getUser",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UserResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Retrieve a user",
        "tags": [
          "Users"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "user.read",
        "x-immich-state": "Stable"
      }
    },
    "/users/{id}/profile-image": {
      "get": {
        "description": "Retrieve the profile image file for a user.",
        "operationId": "getProfileImage",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/octet-stream": {
                "schema": {
                  "format": "binary",
                  "type": "string"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Retrieve user profile image",
        "tags": [
          "Users"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "userProfileImage.read",
        "x-immich-state": "Stable"
      }
    },
    "/view/folder": {
      "get": {
        "description": "Retrieve assets that are children of a specific folder.",
        "operationId": "getAssetsByOriginalPath",
        "parameters": [
          {
            "name": "path",
            "required": true,
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/AssetResponseDto"
                  },
                  "type": "array"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Retrieve assets by original path",
        "tags": [
          "Views"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "folder.read",
        "x-immich-state": "Stable"
      }
    },
    "/view/folder/unique-paths": {
      "get": {
        "description": "Retrieve a list of unique folder paths from asset original paths.",
        "operationId": "getUniqueOriginalPaths",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "type": "string"
                  },
                  "type": "array"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Retrieve unique paths",
        "tags": [
          "Views"
        ],
        "x-immich-history": [
          {
            "version": "v1",
            "state": "Added"
          },
          {
            "version": "v1",
            "state": "Beta"
          },
          {
            "version": "v2",
            "state": "Stable"
          }
        ],
        "x-immich-permission": "folder.read",
        "x-immich-state": "Stable"
      }
    },
    "/workflows": {
      "get": {
        "description": "Retrieve a list of workflows available to the authenticated user.",
        "operationId": "searchWorkflows",
        "parameters": [
          {
            "name": "description",
            "required": false,
            "in": "query",
            "description": "Workflow description",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "enabled",
            "required": false,
            "in": "query",
            "description": "Workflow enabled",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "id",
            "required": false,
            "in": "query",
            "description": "Workflow ID",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          },
          {
            "name": "logging",
            "required": false,
            "in": "query",
            "description": "Workflow logs run results",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "name",
            "required": false,
            "in": "query",
            "description": "Workflow name",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "trigger",
            "required": false,
            "in": "query",
            "description": "Workflow trigger type",
            "schema": {
              "$ref": "#/components/schemas/WorkflowTrigger"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/WorkflowResponseDto"
                  },
                  "type": "array"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "List all workflows",
        "tags": [
          "Workflows"
        ],
        "x-immich-history": [
          {
            "version": "v3.0.0",
            "state": "Added"
          }
        ],
        "x-immich-permission": "workflow.read"
      },
      "post": {
        "description": "Create a new workflow, the workflow can also be created with empty filters and actions.",
        "operationId": "createWorkflow",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/WorkflowCreateDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/WorkflowResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Create a workflow",
        "tags": [
          "Workflows"
        ],
        "x-immich-history": [
          {
            "version": "v3.0.0",
            "state": "Added"
          }
        ],
        "x-immich-permission": "workflow.create"
      }
    },
    "/workflows/triggers": {
      "get": {
        "description": "Retrieve a list of all available workflow triggers.",
        "operationId": "getWorkflowTriggers",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/WorkflowTriggerResponseDto"
                  },
                  "type": "array"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "List all workflow triggers",
        "tags": [
          "Workflows"
        ],
        "x-immich-history": [
          {
            "version": "v3.0.0",
            "state": "Added"
          }
        ]
      }
    },
    "/workflows/{id}": {
      "delete": {
        "description": "Delete a workflow by its ID.",
        "operationId": "deleteWorkflow",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          }
        ],
        "responses": {
          "204": {
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Delete a workflow",
        "tags": [
          "Workflows"
        ],
        "x-immich-history": [
          {
            "version": "v3.0.0",
            "state": "Added"
          }
        ],
        "x-immich-permission": "workflow.delete"
      },
      "get": {
        "description": "Retrieve information about a specific workflow by its ID.",
        "operationId": "getWorkflow",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/WorkflowResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Retrieve a workflow",
        "tags": [
          "Workflows"
        ],
        "x-immich-history": [
          {
            "version": "v3.0.0",
            "state": "Added"
          }
        ],
        "x-immich-permission": "workflow.read"
      },
      "put": {
        "description": "Update the information of a specific workflow by its ID. This endpoint can be used to update the workflow name, description, trigger type, filters and actions order, etc.",
        "operationId": "updateWorkflow",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/WorkflowUpdateDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/WorkflowResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Update a workflow",
        "tags": [
          "Workflows"
        ],
        "x-immich-history": [
          {
            "version": "v3.0.0",
            "state": "Added"
          },
          {
            "version": "v3.0.0",
            "state": "Updated",
            "description": "This endpoint now also supports PATCH, in addition to PUT. PATCH will become the default in v4, and then PUT will be dropped in v5. Please migrate accordingly."
          }
        ],
        "x-immich-permission": "workflow.update"
      }
    },
    "/workflows/{id}/logs": {
      "get": {
        "description": "Retrieve logs of a workflows runs by ID",
        "operationId": "getWorkflowLogs",
        "parameters": [
          {
            "name": "before",
            "required": false,
            "in": "query",
            "description": "Filter by runs before a date/time",
            "schema": {
              "format": "date-time",
              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
              "example": "2024-01-01T00:00:00.000Z",
              "type": "string"
            }
          },
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          },
          {
            "name": "limit",
            "required": false,
            "in": "query",
            "description": "Maximum number of logs",
            "schema": {
              "maximum": 9007199254740991,
              "exclusiveMinimum": true,
              "default": 50,
              "type": "integer",
              "minimum": 0
            }
          },
          {
            "name": "result",
            "required": false,
            "in": "query",
            "description": "Filter by run result",
            "schema": {
              "$ref": "#/components/schemas/WorkflowResult"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/WorkflowLogEntryDto"
                  },
                  "type": "array"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Retrieve workflow logs",
        "tags": [
          "Workflows"
        ],
        "x-immich-history": [
          {
            "version": "v3.0.0",
            "state": "Added"
          }
        ],
        "x-immich-permission": "workflow.logs"
      }
    },
    "/workflows/{id}/share": {
      "get": {
        "description": "Retrieve a workflow details without ids, default values, etc.",
        "operationId": "getWorkflowForShare",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/WorkflowShareResponseDto"
                }
              }
            },
            "description": ""
          }
        },
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ],
        "summary": "Retrieve a workflow",
        "tags": [
          "Workflows"
        ],
        "x-immich-history": [
          {
            "version": "v3.0.0",
            "state": "Added"
          }
        ],
        "x-immich-permission": "workflow.read"
      }
    }
  },
  "info": {
    "title": "Immich",
    "description": "Immich API",
    "version": "3.4.0-rc.0",
    "contact": {}
  },
  "tags": [
    {
      "name": "Activities",
      "description": "An activity is a like or a comment made by a user on an asset or album."
    },
    {
      "name": "Albums",
      "description": "An album is a collection of assets that can be shared with other users or via shared links."
    },
    {
      "name": "API keys",
      "description": "An api key can be used to programmatically access the Immich API."
    },
    {
      "name": "Assets",
      "description": "An asset is an image or video that has been uploaded to Immich."
    },
    {
      "name": "Asset files",
      "description": "An asset file is a file associated with an asset, including edited versions, thumbnails, etc."
    },
    {
      "name": "Authentication",
      "description": "Endpoints related to user authentication, including OAuth."
    },
    {
      "name": "Authentication (admin)",
      "description": "Administrative endpoints related to authentication."
    },
    {
      "name": "Backups",
      "description": "FUTO Backups."
    },
    {
      "name": "Cluster groups",
      "description": "A cluster group is a set of users whose faces are clustered together, so that a person can be shared between them."
    },
    {
      "name": "Config (user)",
      "description": "The system configuration properties that are visible to logged in users."
    },
    {
      "name": "Config (admin)",
      "description": "Endpoints to view and modify the full system configuration."
    },
    {
      "name": "Config (public)",
      "description": "The system configuration properties that are visible to everyone."
    },
    {
      "name": "Database Backups (admin)",
      "description": "Manage backups of the Immich database."
    },
    {
      "name": "Deprecated",
      "description": "Deprecated endpoints that are planned for removal in the next major release."
    },
    {
      "name": "Download",
      "description": "Endpoints for downloading assets or collections of assets."
    },
    {
      "name": "Duplicates",
      "description": "Endpoints for managing and identifying duplicate assets."
    },
    {
      "name": "Faces",
      "description": "A face is a detected human face within an asset, which can be associated with a person. Faces are normally detected via machine learning, but can also be created manually."
    },
    {
      "name": "Integrity (admin)",
      "description": "Endpoints for viewing and managing integrity reports."
    },
    {
      "name": "Jobs",
      "description": "Queues and background jobs are used for processing tasks asynchronously. Queues can be paused and resumed as needed."
    },
    {
      "name": "Libraries",
      "description": "An external library is made up of input file paths or expressions that are scanned for asset files. Discovered files are automatically imported. Assets much be unique within a library, but can be duplicated across libraries. Each user has a default upload library, and can have one or more external libraries."
    },
    {
      "name": "Maintenance (admin)",
      "description": "Maintenance mode allows you to put Immich in a read-only state to perform various operations."
    },
    {
      "name": "Map",
      "description": "Map endpoints include supplemental functionality related to geolocation, such as reverse geocoding and retrieving map markers for assets with geolocation data."
    },
    {
      "name": "Memories",
      "description": "A memory is a specialized collection of assets with dedicated viewing implementations in the web and mobile clients. A memory includes fields related to visibility and are automatically generated per user via a background job."
    },
    {
      "name": "Notifications",
      "description": "A notification is a specialized message sent to users to inform them of important events. Currently, these notifications are only shown in the Immich web application."
    },
    {
      "name": "Notifications (admin)",
      "description": "Notification administrative endpoints."
    },
    {
      "name": "Partners",
      "description": "A partner is a link with another user that allows sharing of assets between two users."
    },
    {
      "name": "Passkeys",
      "description": "A passkey is a WebAuthn credential that can be used to login without a password."
    },
    {
      "name": "People",
      "description": "A person is a collection of faces, which can be favorited and named. A person can also be merged into another person. People are automatically created via the face recognition job."
    },
    {
      "name": "Plugins",
      "description": "A plugin is an installed module that makes filters and actions available for the workflow feature."
    },
    {
      "name": "Queues",
      "description": "Queues and background jobs are used for processing tasks asynchronously. Queues can be paused and resumed as needed."
    },
    {
      "name": "Search",
      "description": "Endpoints related to searching assets via text, smart search, optical character recognition (OCR), and other filters like person, album, and other metadata. Search endpoints usually support pagination and sorting."
    },
    {
      "name": "Server",
      "description": "Information about the current server deployment, including version and build information, available features, supported media types, and more."
    },
    {
      "name": "Sessions",
      "description": "A session represents an authenticated login session for a user. Sessions also appear in the web application as \"Authorized devices\"."
    },
    {
      "name": "Shared links",
      "description": "A shared link is a public url that provides access to a specific album, asset, or collection of assets. A shared link can be protected with a password, include a specific slug, allow or disallow downloads, and optionally include an expiration date."
    },
    {
      "name": "Stacks",
      "description": "A stack is a group of related assets. One asset is the \"primary\" asset, and the rest are \"child\" assets. On the main timeline, stack parents are included by default, while child assets are hidden."
    },
    {
      "name": "Sync",
      "description": "A collection of endpoints for the new mobile synchronization implementation."
    },
    {
      "name": "System config",
      "description": "Endpoints to view, modify, and validate the system configuration settings."
    },
    {
      "name": "System metadata",
      "description": "Endpoints to view, modify, and validate the system metadata, which includes information about things like admin onboarding status."
    },
    {
      "name": "Tags",
      "description": "A tag is a user-defined label that can be applied to assets for organizational purposes. Tags can also be hierarchical, allowing for parent-child relationships between tags."
    },
    {
      "name": "Timeline",
      "description": "Specialized endpoints related to the timeline implementation used in the web application. External applications or tools should not use or rely on these endpoints, as they are subject to change without notice."
    },
    {
      "name": "Trash",
      "description": "Endpoints for managing the trash can, which includes assets that have been discarded. Items in the trash are automatically deleted after a configured amount of time."
    },
    {
      "name": "Users (admin)",
      "description": "Administrative endpoints for managing users, including creating, updating, deleting, and restoring users. Also includes endpoints for resetting passwords and PIN codes."
    },
    {
      "name": "Users",
      "description": "Endpoints for viewing and updating the current users, including product key information, profile picture data, onboarding progress, and more."
    },
    {
      "name": "Views",
      "description": "Endpoints for specialized views, such as the folder view."
    },
    {
      "name": "Workflows",
      "description": "A workflow is a set of actions that run whenever a triggering event occurs. Workflows also can include filters to further limit execution."
    }
  ],
  "servers": [
    {
      "url": "/api"
    }
  ],
  "components": {
    "securitySchemes": {
      "bearer": {
        "scheme": "Bearer",
        "bearerFormat": "JWT",
        "type": "http",
        "in": "header"
      },
      "cookie": {
        "type": "apiKey",
        "in": "cookie",
        "name": "immich_access_token"
      },
      "api_key": {
        "type": "apiKey",
        "in": "header",
        "name": "x-api-key"
      }
    },
    "schemas": {
      "ActivityCreateDto": {
        "description": "Activity create",
        "properties": {
          "albumId": {
            "description": "Album ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          },
          "assetId": {
            "description": "Asset ID (if activity is for an asset)",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          },
          "comment": {
            "description": "Comment text (required if type is comment)",
            "type": "string"
          },
          "type": {
            "$ref": "#/components/schemas/ReactionType"
          }
        },
        "required": [
          "albumId",
          "type"
        ],
        "type": "object"
      },
      "ActivityResponseDto": {
        "properties": {
          "assetId": {
            "description": "Asset ID (if activity is for an asset)",
            "format": "uuid",
            "nullable": true,
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          },
          "comment": {
            "description": "Comment text (for comment activities)",
            "nullable": true,
            "type": "string"
          },
          "createdAt": {
            "description": "Creation date",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string"
          },
          "id": {
            "description": "Activity ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          },
          "type": {
            "$ref": "#/components/schemas/ReactionType"
          },
          "user": {
            "$ref": "#/components/schemas/UserResponseDto"
          }
        },
        "required": [
          "assetId",
          "createdAt",
          "id",
          "type",
          "user"
        ],
        "type": "object"
      },
      "ActivityStatisticsResponseDto": {
        "properties": {
          "comments": {
            "description": "Number of comments",
            "maximum": 9007199254740991,
            "minimum": 0,
            "type": "integer"
          },
          "likes": {
            "description": "Number of likes",
            "maximum": 9007199254740991,
            "minimum": 0,
            "type": "integer"
          }
        },
        "required": [
          "comments",
          "likes"
        ],
        "type": "object"
      },
      "AddUsersDto": {
        "properties": {
          "albumUsers": {
            "description": "Album users to add",
            "items": {
              "$ref": "#/components/schemas/AlbumUserAddDto"
            },
            "minItems": 1,
            "type": "array"
          }
        },
        "required": [
          "albumUsers"
        ],
        "type": "object"
      },
      "AdminConfigBackupsDto": {
        "properties": {
          "beta": {
            "description": "Whether the backups feature is enabled",
            "type": "boolean"
          },
          "database": {
            "$ref": "#/components/schemas/AdminConfigDatabaseBackupDto"
          }
        },
        "required": [
          "database"
        ],
        "type": "object"
      },
      "AdminConfigClipDto": {
        "properties": {
          "enabled": {
            "description": "Whether the task is enabled",
            "type": "boolean"
          },
          "modelName": {
            "description": "Name of the model to use",
            "type": "string"
          }
        },
        "required": [
          "enabled",
          "modelName"
        ],
        "type": "object"
      },
      "AdminConfigDatabaseBackupDto": {
        "properties": {
          "cronExpression": {
            "description": "Cron expression",
            "type": "string"
          },
          "enabled": {
            "description": "Enabled",
            "type": "boolean"
          },
          "keepLastAmount": {
            "description": "Keep last amount",
            "maximum": 9007199254740991,
            "minimum": 1,
            "type": "integer"
          }
        },
        "required": [
          "cronExpression",
          "enabled",
          "keepLastAmount"
        ],
        "type": "object"
      },
      "AdminConfigDto": {
        "description": "Configuration properties that are visible to the admin",
        "properties": {
          "backup": {
            "$ref": "#/components/schemas/AdminConfigBackupsDto"
          },
          "ffmpeg": {
            "$ref": "#/components/schemas/AdminConfigFFmpegDto"
          },
          "image": {
            "$ref": "#/components/schemas/AdminConfigImageDto"
          },
          "integrityChecks": {
            "$ref": "#/components/schemas/AdminConfigIntegrityChecksDto"
          },
          "job": {
            "$ref": "#/components/schemas/AdminConfigJobDto"
          },
          "library": {
            "$ref": "#/components/schemas/AdminConfigLibraryDto"
          },
          "logging": {
            "$ref": "#/components/schemas/AdminConfigLoggingDto"
          },
          "machineLearning": {
            "$ref": "#/components/schemas/AdminConfigMachineLearningDto"
          },
          "map": {
            "$ref": "#/components/schemas/AdminConfigMapDto"
          },
          "metadata": {
            "$ref": "#/components/schemas/AdminConfigMetadataDto"
          },
          "newVersionCheck": {
            "$ref": "#/components/schemas/AdminConfigNewVersionCheckDto"
          },
          "nightlyTasks": {
            "$ref": "#/components/schemas/AdminConfigNightlyTasksDto"
          },
          "notifications": {
            "$ref": "#/components/schemas/AdminConfigNotificationsDto"
          },
          "oauth": {
            "$ref": "#/components/schemas/AdminConfigOAuthDto"
          },
          "passkey": {
            "$ref": "#/components/schemas/AdminConfigPasskeyDto"
          },
          "passwordLogin": {
            "$ref": "#/components/schemas/AdminConfigPasswordLoginDto"
          },
          "reverseGeocoding": {
            "$ref": "#/components/schemas/AdminConfigReverseGeocodingDto"
          },
          "server": {
            "$ref": "#/components/schemas/AdminConfigServerDto"
          },
          "storageTemplate": {
            "$ref": "#/components/schemas/AdminConfigStorageTemplateDto"
          },
          "templates": {
            "$ref": "#/components/schemas/AdminConfigTemplatesDto"
          },
          "theme": {
            "$ref": "#/components/schemas/AdminConfigThemeDto"
          },
          "trash": {
            "$ref": "#/components/schemas/AdminConfigTrashDto"
          },
          "user": {
            "$ref": "#/components/schemas/AdminConfigUserDto"
          }
        },
        "required": [
          "backup",
          "ffmpeg",
          "image",
          "integrityChecks",
          "job",
          "library",
          "logging",
          "machineLearning",
          "map",
          "metadata",
          "newVersionCheck",
          "nightlyTasks",
          "notifications",
          "oauth",
          "passkey",
          "passwordLogin",
          "reverseGeocoding",
          "server",
          "storageTemplate",
          "templates",
          "theme",
          "trash",
          "user"
        ],
        "type": "object"
      },
      "AdminConfigDuplicateDetectionDto": {
        "properties": {
          "enabled": {
            "description": "Whether the task is enabled",
            "type": "boolean"
          },
          "maxDistance": {
            "description": "Maximum distance threshold for duplicate detection",
            "format": "double",
            "maximum": 0.1,
            "minimum": 0.001,
            "type": "number"
          }
        },
        "required": [
          "enabled",
          "maxDistance"
        ],
        "type": "object"
      },
      "AdminConfigFFmpegDto": {
        "properties": {
          "accel": {
            "$ref": "#/components/schemas/TranscodeHWAccel"
          },
          "accelDecode": {
            "description": "Accelerated decode",
            "type": "boolean"
          },
          "acceptedAudioCodecs": {
            "description": "Accepted audio codecs",
            "items": {
              "$ref": "#/components/schemas/AudioCodec"
            },
            "type": "array"
          },
          "acceptedContainers": {
            "description": "Accepted containers",
            "items": {
              "$ref": "#/components/schemas/VideoContainer"
            },
            "type": "array"
          },
          "acceptedVideoCodecs": {
            "description": "Accepted video codecs",
            "items": {
              "$ref": "#/components/schemas/VideoCodec"
            },
            "type": "array"
          },
          "bframes": {
            "description": "B-frames",
            "maximum": 16,
            "minimum": -1,
            "type": "integer"
          },
          "cqMode": {
            "$ref": "#/components/schemas/CQMode"
          },
          "crf": {
            "description": "CRF",
            "maximum": 51,
            "minimum": 0,
            "type": "integer"
          },
          "gopSize": {
            "description": "GOP size",
            "maximum": 9007199254740991,
            "minimum": 0,
            "type": "integer"
          },
          "maxBitrate": {
            "description": "Max bitrate",
            "type": "string"
          },
          "preferredHwDevice": {
            "description": "Preferred hardware device",
            "type": "string"
          },
          "preset": {
            "description": "Preset",
            "type": "string"
          },
          "realtime": {
            "$ref": "#/components/schemas/AdminConfigFFmpegRealtimeDto"
          },
          "refs": {
            "description": "References",
            "maximum": 6,
            "minimum": 0,
            "type": "integer"
          },
          "targetAudioCodec": {
            "$ref": "#/components/schemas/AudioCodec"
          },
          "targetResolution": {
            "description": "Target resolution",
            "type": "string"
          },
          "targetVideoCodec": {
            "$ref": "#/components/schemas/VideoCodec"
          },
          "temporalAQ": {
            "description": "Temporal AQ",
            "type": "boolean"
          },
          "threads": {
            "description": "Threads",
            "maximum": 9007199254740991,
            "minimum": 0,
            "type": "integer"
          },
          "tonemap": {
            "$ref": "#/components/schemas/ToneMapping"
          },
          "transcode": {
            "$ref": "#/components/schemas/TranscodePolicy"
          },
          "twoPass": {
            "description": "Two pass",
            "type": "boolean"
          }
        },
        "required": [
          "accel",
          "accelDecode",
          "acceptedAudioCodecs",
          "acceptedContainers",
          "acceptedVideoCodecs",
          "bframes",
          "cqMode",
          "crf",
          "gopSize",
          "maxBitrate",
          "preferredHwDevice",
          "preset",
          "realtime",
          "refs",
          "targetAudioCodec",
          "targetResolution",
          "targetVideoCodec",
          "temporalAQ",
          "threads",
          "tonemap",
          "transcode",
          "twoPass"
        ],
        "type": "object"
      },
      "AdminConfigFFmpegRealtimeDto": {
        "properties": {
          "enabled": {
            "description": "Enable real-time HLS transcoding (alpha)",
            "type": "boolean"
          },
          "resolutions": {
            "description": "Resolutions to use for real-time HLS transcoding",
            "items": {
              "$ref": "#/components/schemas/HlsVideoResolution"
            },
            "type": "array"
          },
          "videoCodecs": {
            "description": "Video codecs to use for real-time HLS transcoding",
            "items": {
              "$ref": "#/components/schemas/VideoCodec"
            },
            "type": "array"
          }
        },
        "required": [
          "enabled",
          "resolutions",
          "videoCodecs"
        ],
        "type": "object"
      },
      "AdminConfigFacesDto": {
        "properties": {
          "import": {
            "description": "Import",
            "type": "boolean"
          }
        },
        "required": [
          "import"
        ],
        "type": "object"
      },
      "AdminConfigFacialRecognitionDto": {
        "properties": {
          "enabled": {
            "description": "Whether the task is enabled",
            "type": "boolean"
          },
          "maxDistance": {
            "description": "Maximum distance threshold for face recognition",
            "format": "double",
            "maximum": 2,
            "minimum": 0.1,
            "type": "number"
          },
          "minFaces": {
            "description": "Minimum number of faces required for recognition",
            "maximum": 9007199254740991,
            "minimum": 1,
            "type": "integer"
          },
          "minScore": {
            "description": "Minimum confidence score for face detection",
            "format": "double",
            "maximum": 1,
            "minimum": 0.1,
            "type": "number"
          },
          "modelName": {
            "description": "Name of the model to use",
            "type": "string"
          }
        },
        "required": [
          "enabled",
          "maxDistance",
          "minFaces",
          "minScore",
          "modelName"
        ],
        "type": "object"
      },
      "AdminConfigGeneratedFullsizeImageDto": {
        "properties": {
          "enabled": {
            "description": "Enabled",
            "type": "boolean"
          },
          "format": {
            "$ref": "#/components/schemas/ImageFormat"
          },
          "progressive": {
            "description": "Progressive",
            "type": "boolean"
          },
          "quality": {
            "description": "Quality",
            "maximum": 100,
            "minimum": 1,
            "type": "integer"
          }
        },
        "required": [
          "enabled",
          "format",
          "quality"
        ],
        "type": "object"
      },
      "AdminConfigGeneratedImageDto": {
        "properties": {
          "format": {
            "$ref": "#/components/schemas/ImageFormat"
          },
          "progressive": {
            "description": "Progressive",
            "type": "boolean"
          },
          "quality": {
            "description": "Quality",
            "maximum": 100,
            "minimum": 1,
            "type": "integer"
          },
          "size": {
            "description": "Size",
            "maximum": 9007199254740991,
            "minimum": 1,
            "type": "integer"
          }
        },
        "required": [
          "format",
          "quality",
          "size"
        ],
        "type": "object"
      },
      "AdminConfigImageDto": {
        "properties": {
          "colorspace": {
            "$ref": "#/components/schemas/Colorspace"
          },
          "extractEmbedded": {
            "description": "Extract embedded",
            "type": "boolean"
          },
          "fullsize": {
            "$ref": "#/components/schemas/AdminConfigGeneratedFullsizeImageDto"
          },
          "preview": {
            "$ref": "#/components/schemas/AdminConfigGeneratedImageDto"
          },
          "thumbnail": {
            "$ref": "#/components/schemas/AdminConfigGeneratedImageDto"
          }
        },
        "required": [
          "colorspace",
          "extractEmbedded",
          "fullsize",
          "preview",
          "thumbnail"
        ],
        "type": "object"
      },
      "AdminConfigIntegrityChecksDto": {
        "description": "Integrity checks config",
        "properties": {
          "checksumFiles": {
            "$ref": "#/components/schemas/AdminConfigIntegrityChecksumJobDto"
          },
          "missingFiles": {
            "$ref": "#/components/schemas/AdminConfigIntegrityJobDto"
          },
          "untrackedFiles": {
            "$ref": "#/components/schemas/AdminConfigIntegrityJobDto"
          }
        },
        "required": [
          "checksumFiles",
          "missingFiles",
          "untrackedFiles"
        ],
        "type": "object"
      },
      "AdminConfigIntegrityChecksumJobDto": {
        "description": "Integrity checksum job config",
        "properties": {
          "cronExpression": {
            "description": "Cron expression for when the integrity check should run",
            "type": "string"
          },
          "enabled": {
            "description": "Enabled",
            "type": "boolean"
          },
          "percentageLimit": {
            "description": "Percentage limit of the integrity checksum job",
            "format": "double",
            "maximum": 1,
            "minimum": 0,
            "type": "number"
          },
          "timeLimit": {
            "description": "How long the integrity checksum job may run for",
            "maximum": 9007199254740991,
            "minimum": 0,
            "type": "integer"
          }
        },
        "required": [
          "cronExpression",
          "enabled",
          "percentageLimit",
          "timeLimit"
        ],
        "type": "object"
      },
      "AdminConfigIntegrityJobDto": {
        "description": "Integrity job config",
        "properties": {
          "cronExpression": {
            "description": "Cron expression for when the integrity check should run",
            "type": "string"
          },
          "enabled": {
            "description": "Enabled",
            "type": "boolean"
          }
        },
        "required": [
          "cronExpression",
          "enabled"
        ],
        "type": "object"
      },
      "AdminConfigJobDto": {
        "properties": {
          "backgroundTask": {
            "$ref": "#/components/schemas/AdminConfigJobSettingsDto"
          },
          "editor": {
            "$ref": "#/components/schemas/AdminConfigJobSettingsDto"
          },
          "faceDetection": {
            "$ref": "#/components/schemas/AdminConfigJobSettingsDto"
          },
          "integrityCheck": {
            "$ref": "#/components/schemas/AdminConfigJobSettingsDto"
          },
          "library": {
            "$ref": "#/components/schemas/AdminConfigJobSettingsDto"
          },
          "metadataExtraction": {
            "$ref": "#/components/schemas/AdminConfigJobSettingsDto"
          },
          "migration": {
            "$ref": "#/components/schemas/AdminConfigJobSettingsDto"
          },
          "notifications": {
            "$ref": "#/components/schemas/AdminConfigJobSettingsDto"
          },
          "ocr": {
            "$ref": "#/components/schemas/AdminConfigJobSettingsDto"
          },
          "search": {
            "$ref": "#/components/schemas/AdminConfigJobSettingsDto"
          },
          "sidecar": {
            "$ref": "#/components/schemas/AdminConfigJobSettingsDto"
          },
          "smartSearch": {
            "$ref": "#/components/schemas/AdminConfigJobSettingsDto"
          },
          "thumbnailGeneration": {
            "$ref": "#/components/schemas/AdminConfigJobSettingsDto"
          },
          "videoConversion": {
            "$ref": "#/components/schemas/AdminConfigJobSettingsDto"
          },
          "workflow": {
            "$ref": "#/components/schemas/AdminConfigJobSettingsDto"
          }
        },
        "required": [
          "backgroundTask",
          "editor",
          "faceDetection",
          "integrityCheck",
          "library",
          "metadataExtraction",
          "migration",
          "notifications",
          "ocr",
          "search",
          "sidecar",
          "smartSearch",
          "thumbnailGeneration",
          "videoConversion",
          "workflow"
        ],
        "type": "object"
      },
      "AdminConfigJobSettingsDto": {
        "properties": {
          "concurrency": {
            "description": "Concurrency",
            "maximum": 9007199254740991,
            "minimum": 1,
            "type": "integer"
          }
        },
        "required": [
          "concurrency"
        ],
        "type": "object"
      },
      "AdminConfigLibraryDto": {
        "properties": {
          "scan": {
            "$ref": "#/components/schemas/AdminConfigLibraryScanDto"
          },
          "watch": {
            "$ref": "#/components/schemas/AdminConfigLibraryWatchDto"
          }
        },
        "required": [
          "scan",
          "watch"
        ],
        "type": "object"
      },
      "AdminConfigLibraryScanDto": {
        "properties": {
          "cronExpression": {
            "description": "Cron expression",
            "type": "string"
          },
          "enabled": {
            "description": "Enabled",
            "type": "boolean"
          }
        },
        "required": [
          "cronExpression",
          "enabled"
        ],
        "type": "object"
      },
      "AdminConfigLibraryWatchDto": {
        "properties": {
          "enabled": {
            "description": "Enabled",
            "type": "boolean"
          }
        },
        "required": [
          "enabled"
        ],
        "type": "object"
      },
      "AdminConfigLoggingDto": {
        "properties": {
          "enabled": {
            "description": "Enabled",
            "type": "boolean"
          },
          "level": {
            "$ref": "#/components/schemas/LogLevel"
          }
        },
        "required": [
          "enabled",
          "level"
        ],
        "type": "object"
      },
      "AdminConfigMachineLearningAvailabilityChecksDto": {
        "properties": {
          "enabled": {
            "description": "Enabled",
            "type": "boolean"
          },
          "interval": {
            "maximum": 9007199254740991,
            "minimum": -9007199254740991,
            "type": "integer"
          },
          "timeout": {
            "maximum": 9007199254740991,
            "minimum": -9007199254740991,
            "type": "integer"
          }
        },
        "required": [
          "enabled",
          "interval",
          "timeout"
        ],
        "type": "object"
      },
      "AdminConfigMachineLearningDto": {
        "properties": {
          "availabilityChecks": {
            "$ref": "#/components/schemas/AdminConfigMachineLearningAvailabilityChecksDto"
          },
          "clip": {
            "$ref": "#/components/schemas/AdminConfigClipDto"
          },
          "duplicateDetection": {
            "$ref": "#/components/schemas/AdminConfigDuplicateDetectionDto"
          },
          "enabled": {
            "description": "Enabled",
            "type": "boolean"
          },
          "facialRecognition": {
            "$ref": "#/components/schemas/AdminConfigFacialRecognitionDto"
          },
          "ocr": {
            "$ref": "#/components/schemas/AdminConfigOcrDto"
          },
          "urls": {
            "description": "ML service URLs",
            "items": {
              "type": "string"
            },
            "minItems": 1,
            "type": "array"
          }
        },
        "required": [
          "availabilityChecks",
          "clip",
          "duplicateDetection",
          "enabled",
          "facialRecognition",
          "ocr",
          "urls"
        ],
        "type": "object"
      },
      "AdminConfigMapDto": {
        "properties": {
          "darkStyle": {
            "description": "Dark map style URL",
            "format": "uri",
            "type": "string"
          },
          "enabled": {
            "description": "Enabled",
            "type": "boolean"
          },
          "lightStyle": {
            "description": "Light map style URL",
            "format": "uri",
            "type": "string"
          }
        },
        "required": [
          "darkStyle",
          "enabled",
          "lightStyle"
        ],
        "type": "object"
      },
      "AdminConfigMetadataDto": {
        "properties": {
          "faces": {
            "$ref": "#/components/schemas/AdminConfigFacesDto"
          }
        },
        "required": [
          "faces"
        ],
        "type": "object"
      },
      "AdminConfigNewVersionCheckDto": {
        "properties": {
          "channel": {
            "$ref": "#/components/schemas/ReleaseChannel"
          },
          "enabled": {
            "description": "Enabled",
            "type": "boolean"
          }
        },
        "required": [
          "channel",
          "enabled"
        ],
        "type": "object"
      },
      "AdminConfigNightlyTasksDto": {
        "properties": {
          "clusterNewFaces": {
            "description": "Cluster new faces",
            "type": "boolean"
          },
          "databaseCleanup": {
            "description": "Database cleanup",
            "type": "boolean"
          },
          "generateMemories": {
            "description": "Generate memories",
            "type": "boolean"
          },
          "missingThumbnails": {
            "description": "Missing thumbnails",
            "type": "boolean"
          },
          "startTime": {
            "description": "Start time (HH:MM)",
            "pattern": "^(?:[01]\\d|2[0-3]):[0-5]\\d$",
            "type": "string"
          },
          "syncQuotaUsage": {
            "description": "Sync quota usage",
            "type": "boolean"
          }
        },
        "required": [
          "clusterNewFaces",
          "databaseCleanup",
          "generateMemories",
          "missingThumbnails",
          "startTime",
          "syncQuotaUsage"
        ],
        "type": "object"
      },
      "AdminConfigNotificationsDto": {
        "properties": {
          "smtp": {
            "$ref": "#/components/schemas/AdminConfigSmtpDto"
          }
        },
        "required": [
          "smtp"
        ],
        "type": "object"
      },
      "AdminConfigOAuthDto": {
        "properties": {
          "accountManagementUrl": {
            "default": "",
            "description": "Account management URL",
            "type": "string"
          },
          "allowInsecureRequests": {
            "description": "Allow insecure requests",
            "type": "boolean"
          },
          "autoLaunch": {
            "description": "Auto launch",
            "type": "boolean"
          },
          "autoRegister": {
            "description": "Auto register",
            "type": "boolean"
          },
          "buttonText": {
            "description": "Button text",
            "type": "string"
          },
          "clientId": {
            "description": "Client ID",
            "type": "string"
          },
          "clientSecret": {
            "description": "Client secret",
            "type": "string"
          },
          "defaultStorageQuota": {
            "description": "Default storage quota",
            "maximum": 9007199254740991,
            "minimum": 0,
            "nullable": true,
            "type": "integer"
          },
          "enabled": {
            "description": "Enabled",
            "type": "boolean"
          },
          "endSessionEndpoint": {
            "description": "End session endpoint",
            "type": "string"
          },
          "issuerUrl": {
            "description": "Issuer URL",
            "type": "string"
          },
          "mobileOverrideEnabled": {
            "description": "Mobile override enabled",
            "type": "boolean"
          },
          "mobileRedirectUri": {
            "description": "Mobile redirect URI (set to empty string to disable)",
            "type": "string"
          },
          "profileSigningAlgorithm": {
            "description": "Profile signing algorithm",
            "type": "string"
          },
          "prompt": {
            "description": "OAuth prompt parameter (e.g. select_account, login, consent)",
            "type": "string"
          },
          "roleClaim": {
            "description": "Role claim",
            "type": "string"
          },
          "scope": {
            "description": "Scope",
            "type": "string"
          },
          "signingAlgorithm": {
            "description": "Signing algorithm",
            "type": "string"
          },
          "storageLabelClaim": {
            "description": "Storage label claim",
            "type": "string"
          },
          "storageQuotaClaim": {
            "description": "Storage quota claim",
            "type": "string"
          },
          "timeout": {
            "description": "Timeout",
            "maximum": 9007199254740991,
            "minimum": 1,
            "type": "integer"
          },
          "tokenEndpointAuthMethod": {
            "$ref": "#/components/schemas/OAuthTokenEndpointAuthMethod"
          }
        },
        "required": [
          "allowInsecureRequests",
          "autoLaunch",
          "autoRegister",
          "buttonText",
          "clientId",
          "clientSecret",
          "defaultStorageQuota",
          "enabled",
          "endSessionEndpoint",
          "issuerUrl",
          "mobileOverrideEnabled",
          "mobileRedirectUri",
          "profileSigningAlgorithm",
          "prompt",
          "roleClaim",
          "scope",
          "signingAlgorithm",
          "storageLabelClaim",
          "storageQuotaClaim",
          "timeout",
          "tokenEndpointAuthMethod"
        ],
        "type": "object"
      },
      "AdminConfigOcrDto": {
        "properties": {
          "enabled": {
            "description": "Whether the task is enabled",
            "type": "boolean"
          },
          "maxResolution": {
            "description": "Maximum resolution for OCR processing",
            "maximum": 9007199254740991,
            "minimum": 1,
            "type": "integer"
          },
          "minDetectionScore": {
            "description": "Minimum confidence score for text detection",
            "format": "double",
            "maximum": 1,
            "minimum": 0.1,
            "type": "number"
          },
          "minRecognitionScore": {
            "description": "Minimum confidence score for text recognition",
            "format": "double",
            "maximum": 1,
            "minimum": 0.1,
            "type": "number"
          },
          "modelName": {
            "description": "Name of the model to use",
            "type": "string"
          }
        },
        "required": [
          "enabled",
          "maxResolution",
          "minDetectionScore",
          "minRecognitionScore",
          "modelName"
        ],
        "type": "object"
      },
      "AdminConfigPasskeyDto": {
        "properties": {
          "additionalDomains": {
            "description": "Additional domains",
            "items": {
              "format": "uri",
              "type": "string"
            },
            "type": "array"
          },
          "domain": {
            "description": "Passkey domain",
            "format": "uri",
            "nullable": true,
            "type": "string"
          },
          "enabled": {
            "description": "Enabled",
            "type": "boolean"
          }
        },
        "required": [
          "additionalDomains",
          "domain",
          "enabled"
        ],
        "type": "object"
      },
      "AdminConfigPasswordLoginDto": {
        "properties": {
          "enabled": {
            "description": "Enabled",
            "type": "boolean"
          }
        },
        "required": [
          "enabled"
        ],
        "type": "object"
      },
      "AdminConfigReverseGeocodingDto": {
        "properties": {
          "enabled": {
            "description": "Enabled",
            "type": "boolean"
          }
        },
        "required": [
          "enabled"
        ],
        "type": "object"
      },
      "AdminConfigServerDto": {
        "properties": {
          "externalDomain": {
            "description": "External domain",
            "type": "string"
          },
          "loginPageMessage": {
            "description": "Login page message",
            "type": "string"
          },
          "publicUsers": {
            "description": "Public users",
            "type": "boolean"
          }
        },
        "required": [
          "externalDomain",
          "loginPageMessage",
          "publicUsers"
        ],
        "type": "object"
      },
      "AdminConfigSmtpDto": {
        "properties": {
          "enabled": {
            "description": "Whether SMTP email notifications are enabled",
            "type": "boolean"
          },
          "from": {
            "description": "Email address to send from",
            "type": "string"
          },
          "replyTo": {
            "description": "Email address for replies",
            "type": "string"
          },
          "transport": {
            "$ref": "#/components/schemas/AdminConfigSmtpTransportDto"
          }
        },
        "required": [
          "enabled",
          "from",
          "replyTo",
          "transport"
        ],
        "type": "object"
      },
      "AdminConfigSmtpTransportDto": {
        "properties": {
          "host": {
            "description": "SMTP server hostname",
            "type": "string"
          },
          "ignoreCert": {
            "description": "Whether to ignore SSL certificate errors",
            "type": "boolean"
          },
          "password": {
            "description": "SMTP password",
            "type": "string"
          },
          "port": {
            "description": "SMTP server port",
            "maximum": 65535,
            "minimum": 0,
            "type": "integer"
          },
          "secure": {
            "description": "Whether to use secure connection (TLS/SSL)",
            "type": "boolean"
          },
          "username": {
            "description": "SMTP username",
            "type": "string"
          }
        },
        "required": [
          "host",
          "ignoreCert",
          "password",
          "port",
          "secure",
          "username"
        ],
        "type": "object"
      },
      "AdminConfigStorageTemplateDto": {
        "properties": {
          "enabled": {
            "description": "Enabled",
            "type": "boolean"
          },
          "hashVerificationEnabled": {
            "description": "Hash verification enabled",
            "type": "boolean"
          },
          "template": {
            "description": "Template",
            "type": "string"
          }
        },
        "required": [
          "enabled",
          "hashVerificationEnabled",
          "template"
        ],
        "type": "object"
      },
      "AdminConfigTemplateEmailsDto": {
        "properties": {
          "albumInviteTemplate": {
            "description": "Album invite template",
            "type": "string"
          },
          "albumUpdateTemplate": {
            "description": "Album update template",
            "type": "string"
          },
          "welcomeTemplate": {
            "description": "Welcome template",
            "type": "string"
          }
        },
        "required": [
          "albumInviteTemplate",
          "albumUpdateTemplate",
          "welcomeTemplate"
        ],
        "type": "object"
      },
      "AdminConfigTemplatesDto": {
        "properties": {
          "email": {
            "$ref": "#/components/schemas/AdminConfigTemplateEmailsDto"
          }
        },
        "required": [
          "email"
        ],
        "type": "object"
      },
      "AdminConfigThemeDto": {
        "properties": {
          "customCss": {
            "description": "Custom CSS for theming",
            "type": "string"
          }
        },
        "required": [
          "customCss"
        ],
        "type": "object"
      },
      "AdminConfigTrashDto": {
        "properties": {
          "days": {
            "description": "Days",
            "maximum": 9007199254740991,
            "minimum": 0,
            "type": "integer"
          },
          "enabled": {
            "description": "Enabled",
            "type": "boolean"
          }
        },
        "required": [
          "days",
          "enabled"
        ],
        "type": "object"
      },
      "AdminConfigUserDto": {
        "properties": {
          "deleteDelay": {
            "description": "Delete delay",
            "maximum": 9007199254740991,
            "minimum": 1,
            "type": "integer"
          }
        },
        "required": [
          "deleteDelay"
        ],
        "type": "object"
      },
      "AdminOnboardingUpdateDto": {
        "properties": {
          "isOnboarded": {
            "description": "Is admin onboarded",
            "type": "boolean"
          }
        },
        "required": [
          "isOnboarded"
        ],
        "type": "object"
      },
      "AlbumResponseDto": {
        "properties": {
          "albumName": {
            "description": "Album name",
            "type": "string"
          },
          "albumThumbnailAssetId": {
            "description": "Thumbnail asset ID",
            "format": "uuid",
            "nullable": true,
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          },
          "albumUsers": {
            "description": "First entry is always the album owner. Second entry is the auth user, if it differs from the owner. The rest are ordered alphabetically.",
            "items": {
              "$ref": "#/components/schemas/AlbumUserResponseDto"
            },
            "minItems": 1,
            "type": "array"
          },
          "assetCount": {
            "description": "Number of assets",
            "maximum": 9007199254740991,
            "minimum": 0,
            "type": "integer"
          },
          "contributorCounts": {
            "items": {
              "$ref": "#/components/schemas/ContributorCountResponseDto"
            },
            "type": "array"
          },
          "createdAt": {
            "description": "Creation date",
            "format": "date-time",
            "type": "string"
          },
          "description": {
            "description": "Album description",
            "type": "string",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v3",
                "state": "Updated",
                "description": "An empty string is returned instead of null for backwards compatibility; null will be returned in v4."
              }
            ]
          },
          "endDate": {
            "description": "UTC representation of (local) end date (latest asset)",
            "format": "date-time",
            "type": "string"
          },
          "hasSharedLink": {
            "description": "Has shared link",
            "type": "boolean"
          },
          "id": {
            "description": "Album ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          },
          "isActivityEnabled": {
            "description": "Activity feed enabled",
            "type": "boolean"
          },
          "lastModifiedAssetTimestamp": {
            "description": "Last modified asset timestamp",
            "format": "date-time",
            "type": "string"
          },
          "order": {
            "$ref": "#/components/schemas/AssetOrder"
          },
          "shared": {
            "description": "Is shared album",
            "type": "boolean"
          },
          "startDate": {
            "description": "UTC representation of (local) start date (earliest asset)",
            "format": "date-time",
            "type": "string"
          },
          "updatedAt": {
            "description": "Last update date",
            "format": "date-time",
            "type": "string"
          }
        },
        "required": [
          "albumName",
          "albumThumbnailAssetId",
          "albumUsers",
          "assetCount",
          "createdAt",
          "description",
          "hasSharedLink",
          "id",
          "isActivityEnabled",
          "shared",
          "updatedAt"
        ],
        "type": "object"
      },
      "AlbumStatisticsResponseDto": {
        "properties": {
          "notShared": {
            "description": "Number of non-shared albums",
            "maximum": 9007199254740991,
            "minimum": 0,
            "type": "integer"
          },
          "owned": {
            "description": "Number of owned albums",
            "maximum": 9007199254740991,
            "minimum": 0,
            "type": "integer"
          },
          "shared": {
            "description": "Number of shared albums",
            "maximum": 9007199254740991,
            "minimum": 0,
            "type": "integer"
          }
        },
        "required": [
          "notShared",
          "owned",
          "shared"
        ],
        "type": "object"
      },
      "AlbumUserAddDto": {
        "properties": {
          "role": {
            "$ref": "#/components/schemas/AlbumUserRole",
            "default": "editor",
            "description": "Album user role"
          },
          "userId": {
            "description": "User ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          }
        },
        "required": [
          "userId"
        ],
        "type": "object"
      },
      "AlbumUserCreateDto": {
        "properties": {
          "role": {
            "$ref": "#/components/schemas/AlbumUserRole"
          },
          "userId": {
            "description": "User ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          }
        },
        "required": [
          "role",
          "userId"
        ],
        "type": "object"
      },
      "AlbumUserResponseDto": {
        "properties": {
          "role": {
            "$ref": "#/components/schemas/AlbumUserRole"
          },
          "user": {
            "$ref": "#/components/schemas/UserResponseDto"
          }
        },
        "required": [
          "role",
          "user"
        ],
        "type": "object"
      },
      "AlbumUserRole": {
        "description": "Album user role",
        "enum": [
          "editor",
          "owner",
          "viewer"
        ],
        "type": "string"
      },
      "AlbumsAddAssetsDto": {
        "properties": {
          "albumIds": {
            "description": "Album IDs",
            "items": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            },
            "type": "array"
          },
          "assetIds": {
            "description": "Asset IDs",
            "items": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            },
            "type": "array"
          }
        },
        "required": [
          "albumIds",
          "assetIds"
        ],
        "type": "object"
      },
      "AlbumsAddAssetsResponseDto": {
        "properties": {
          "error": {
            "$ref": "#/components/schemas/BulkIdErrorReason"
          },
          "success": {
            "description": "Operation success",
            "type": "boolean"
          }
        },
        "required": [
          "success"
        ],
        "type": "object"
      },
      "AlbumsResponse": {
        "properties": {
          "defaultAssetOrder": {
            "$ref": "#/components/schemas/AssetOrder"
          }
        },
        "required": [
          "defaultAssetOrder"
        ],
        "type": "object"
      },
      "AlbumsUpdate": {
        "description": "Album preferences",
        "properties": {
          "defaultAssetOrder": {
            "$ref": "#/components/schemas/AssetOrder"
          }
        },
        "type": "object"
      },
      "ApiKeyCreateDto": {
        "properties": {
          "name": {
            "description": "API key name",
            "type": "string"
          },
          "permissions": {
            "description": "List of permissions",
            "items": {
              "$ref": "#/components/schemas/Permission"
            },
            "minItems": 1,
            "type": "array"
          }
        },
        "required": [
          "permissions"
        ],
        "type": "object"
      },
      "ApiKeyCreateResponseDto": {
        "properties": {
          "apiKey": {
            "$ref": "#/components/schemas/ApiKeyResponseDto",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "createdAt": {
            "description": "Creation date",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string"
          },
          "id": {
            "description": "API key ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          },
          "name": {
            "description": "API key name",
            "type": "string"
          },
          "permissions": {
            "description": "List of permissions",
            "items": {
              "$ref": "#/components/schemas/Permission"
            },
            "type": "array"
          },
          "secret": {
            "description": "API key secret (only shown once)",
            "type": "string"
          },
          "updatedAt": {
            "description": "Last update date",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string"
          }
        },
        "required": [
          "apiKey",
          "createdAt",
          "id",
          "name",
          "permissions",
          "secret",
          "updatedAt"
        ],
        "type": "object"
      },
      "ApiKeyResponseDto": {
        "properties": {
          "createdAt": {
            "description": "Creation date",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string"
          },
          "id": {
            "description": "API key ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          },
          "name": {
            "description": "API key name",
            "type": "string"
          },
          "permissions": {
            "description": "List of permissions",
            "items": {
              "$ref": "#/components/schemas/Permission"
            },
            "type": "array"
          },
          "updatedAt": {
            "description": "Last update date",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string"
          }
        },
        "required": [
          "createdAt",
          "id",
          "name",
          "permissions",
          "updatedAt"
        ],
        "type": "object"
      },
      "ApiKeyUpdateDto": {
        "properties": {
          "name": {
            "description": "API key name",
            "type": "string"
          },
          "permissions": {
            "description": "List of permissions",
            "items": {
              "$ref": "#/components/schemas/Permission"
            },
            "minItems": 1,
            "type": "array"
          }
        },
        "type": "object"
      },
      "AssetBulkDeleteDto": {
        "properties": {
          "force": {
            "description": "Force delete even if in use",
            "type": "boolean"
          },
          "ids": {
            "description": "IDs to process",
            "items": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            },
            "type": "array"
          }
        },
        "required": [
          "ids"
        ],
        "type": "object"
      },
      "AssetBulkUpdateDto": {
        "properties": {
          "dateTimeOriginal": {
            "description": "Original date and time",
            "type": "string"
          },
          "dateTimeRelative": {
            "description": "Relative time offset in minutes",
            "maximum": 9007199254740991,
            "minimum": -9007199254740991,
            "type": "integer"
          },
          "description": {
            "description": "Asset description",
            "type": "string"
          },
          "duplicateId": {
            "description": "Duplicate ID",
            "nullable": true,
            "type": "string"
          },
          "ids": {
            "description": "Asset IDs to update",
            "items": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            },
            "type": "array"
          },
          "isFavorite": {
            "description": "Mark as favorite",
            "type": "boolean"
          },
          "latitude": {
            "description": "Latitude coordinate",
            "format": "double",
            "maximum": 90,
            "minimum": -90,
            "type": "number"
          },
          "longitude": {
            "description": "Longitude coordinate",
            "format": "double",
            "maximum": 180,
            "minimum": -180,
            "type": "number"
          },
          "rating": {
            "description": "Rating in range [1-5] (starred), -1 (rejected), or null (unrated)",
            "maximum": 5,
            "minimum": -1,
            "nullable": true,
            "type": "integer",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3",
                "state": "Updated",
                "description": "Using 0 as a rating is no longer valid."
              }
            ],
            "x-immich-state": "Stable"
          },
          "timeZone": {
            "description": "Time zone (IANA timezone)",
            "type": "string"
          },
          "visibility": {
            "$ref": "#/components/schemas/AssetVisibility"
          }
        },
        "required": [
          "ids"
        ],
        "type": "object"
      },
      "AssetBulkUploadCheckDto": {
        "properties": {
          "assets": {
            "description": "Assets to check",
            "items": {
              "$ref": "#/components/schemas/AssetBulkUploadCheckItem"
            },
            "type": "array"
          }
        },
        "required": [
          "assets"
        ],
        "type": "object"
      },
      "AssetBulkUploadCheckItem": {
        "properties": {
          "checksum": {
            "description": "Base64 or hex encoded SHA1 hash",
            "type": "string"
          },
          "id": {
            "description": "Client-side identifier echoed in the response to match results to inputs (e.g. filename)",
            "type": "string"
          }
        },
        "required": [
          "checksum",
          "id"
        ],
        "type": "object"
      },
      "AssetBulkUploadCheckResponseDto": {
        "properties": {
          "results": {
            "description": "Upload check results",
            "items": {
              "$ref": "#/components/schemas/AssetBulkUploadCheckResult"
            },
            "type": "array"
          }
        },
        "required": [
          "results"
        ],
        "type": "object"
      },
      "AssetBulkUploadCheckResult": {
        "properties": {
          "action": {
            "$ref": "#/components/schemas/AssetUploadAction"
          },
          "assetId": {
            "description": "Existing asset ID if duplicate",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          },
          "id": {
            "description": "Client-side identifier echoed from the request to match results to inputs",
            "type": "string"
          },
          "isTrashed": {
            "description": "Whether existing asset is trashed",
            "type": "boolean"
          },
          "reason": {
            "$ref": "#/components/schemas/AssetRejectReason"
          }
        },
        "required": [
          "action",
          "id"
        ],
        "type": "object"
      },
      "AssetCopyDto": {
        "properties": {
          "albums": {
            "default": true,
            "description": "Copy album associations",
            "type": "boolean"
          },
          "favorite": {
            "default": true,
            "description": "Copy favorite status",
            "type": "boolean"
          },
          "sharedLinks": {
            "default": true,
            "description": "Copy shared links",
            "type": "boolean"
          },
          "sidecar": {
            "default": true,
            "description": "Copy sidecar file",
            "type": "boolean"
          },
          "sourceId": {
            "description": "Source asset ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          },
          "stack": {
            "default": true,
            "description": "Copy stack association",
            "type": "boolean"
          },
          "targetId": {
            "description": "Target asset ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          }
        },
        "required": [
          "sourceId",
          "targetId"
        ],
        "type": "object"
      },
      "AssetEditAction": {
        "description": "Type of edit action to perform",
        "enum": [
          "crop",
          "rotate",
          "mirror"
        ],
        "type": "string"
      },
      "AssetEditActionItemDto": {
        "properties": {
          "action": {
            "$ref": "#/components/schemas/AssetEditAction"
          },
          "parameters": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/CropParameters"
              },
              {
                "$ref": "#/components/schemas/RotateParameters"
              },
              {
                "$ref": "#/components/schemas/MirrorParameters"
              }
            ],
            "description": "List of edit actions to apply (crop, rotate, or mirror)"
          }
        },
        "required": [
          "action",
          "parameters"
        ],
        "type": "object"
      },
      "AssetEditActionItemResponseDto": {
        "properties": {
          "action": {
            "$ref": "#/components/schemas/AssetEditAction"
          },
          "id": {
            "description": "Asset edit ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          },
          "parameters": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/CropParameters"
              },
              {
                "$ref": "#/components/schemas/RotateParameters"
              },
              {
                "$ref": "#/components/schemas/MirrorParameters"
              }
            ],
            "description": "List of edit actions to apply (crop, rotate, or mirror)"
          }
        },
        "required": [
          "action",
          "id",
          "parameters"
        ],
        "type": "object"
      },
      "AssetEditsCreateDto": {
        "properties": {
          "edits": {
            "description": "List of edit actions to apply (crop, rotate, or mirror)",
            "items": {
              "$ref": "#/components/schemas/AssetEditActionItemDto"
            },
            "minItems": 1,
            "type": "array"
          }
        },
        "required": [
          "edits"
        ],
        "type": "object"
      },
      "AssetEditsResponseDto": {
        "properties": {
          "assetId": {
            "description": "Asset ID these edits belong to",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          },
          "edits": {
            "description": "List of edit actions applied to the asset",
            "items": {
              "$ref": "#/components/schemas/AssetEditActionItemResponseDto"
            },
            "type": "array"
          }
        },
        "required": [
          "assetId",
          "edits"
        ],
        "type": "object"
      },
      "AssetFaceCreateDto": {
        "properties": {
          "assetId": {
            "description": "Asset ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          },
          "height": {
            "description": "Face bounding box height",
            "maximum": 9007199254740991,
            "minimum": -9007199254740991,
            "type": "integer"
          },
          "imageHeight": {
            "description": "Image height in pixels",
            "maximum": 9007199254740991,
            "minimum": -9007199254740991,
            "type": "integer"
          },
          "imageWidth": {
            "description": "Image width in pixels",
            "maximum": 9007199254740991,
            "minimum": -9007199254740991,
            "type": "integer"
          },
          "personId": {
            "description": "Person ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          },
          "userId": {
            "description": "User ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          },
          "width": {
            "description": "Face bounding box width",
            "maximum": 9007199254740991,
            "minimum": -9007199254740991,
            "type": "integer"
          },
          "x": {
            "description": "Face bounding box X coordinate",
            "maximum": 9007199254740991,
            "minimum": -9007199254740991,
            "type": "integer"
          },
          "y": {
            "description": "Face bounding box Y coordinate",
            "maximum": 9007199254740991,
            "minimum": -9007199254740991,
            "type": "integer"
          }
        },
        "required": [
          "assetId",
          "height",
          "imageHeight",
          "imageWidth",
          "personId",
          "width",
          "x",
          "y"
        ],
        "type": "object"
      },
      "AssetFaceDeleteDto": {
        "properties": {
          "force": {
            "description": "Force delete even if person has other faces",
            "type": "boolean"
          }
        },
        "required": [
          "force"
        ],
        "type": "object"
      },
      "AssetFaceResponseDto": {
        "description": "Asset face with person",
        "properties": {
          "boundingBoxX1": {
            "description": "Bounding box X1 coordinate",
            "maximum": 9007199254740991,
            "minimum": -9007199254740991,
            "type": "integer"
          },
          "boundingBoxX2": {
            "description": "Bounding box X2 coordinate",
            "maximum": 9007199254740991,
            "minimum": -9007199254740991,
            "type": "integer"
          },
          "boundingBoxY1": {
            "description": "Bounding box Y1 coordinate",
            "maximum": 9007199254740991,
            "minimum": -9007199254740991,
            "type": "integer"
          },
          "boundingBoxY2": {
            "description": "Bounding box Y2 coordinate",
            "maximum": 9007199254740991,
            "minimum": -9007199254740991,
            "type": "integer"
          },
          "id": {
            "description": "Face ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          },
          "imageHeight": {
            "description": "Image height in pixels",
            "maximum": 9007199254740991,
            "minimum": 0,
            "type": "integer"
          },
          "imageWidth": {
            "description": "Image width in pixels",
            "maximum": 9007199254740991,
            "minimum": 0,
            "type": "integer"
          },
          "person": {
            "allOf": [
              {
                "$ref": "#/components/schemas/PersonResponseDto"
              }
            ],
            "nullable": true
          },
          "sourceType": {
            "$ref": "#/components/schemas/SourceType"
          }
        },
        "required": [
          "boundingBoxX1",
          "boundingBoxX2",
          "boundingBoxY1",
          "boundingBoxY2",
          "id",
          "imageHeight",
          "imageWidth",
          "person"
        ],
        "type": "object"
      },
      "AssetFaceUpdateDto": {
        "properties": {
          "data": {
            "description": "Face update items",
            "items": {
              "$ref": "#/components/schemas/AssetFaceUpdateItem"
            },
            "type": "array"
          }
        },
        "required": [
          "data"
        ],
        "type": "object"
      },
      "AssetFaceUpdateItem": {
        "properties": {
          "assetId": {
            "description": "Asset ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          },
          "personId": {
            "description": "Person ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          },
          "userId": {
            "description": "User ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          }
        },
        "required": [
          "assetId",
          "personId"
        ],
        "type": "object"
      },
      "AssetFileResponseDto": {
        "properties": {
          "createdAt": {
            "description": "Creation date",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string"
          },
          "id": {
            "description": "Asset file ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          },
          "isEdited": {
            "description": "The file was generated from an edit",
            "type": "boolean"
          },
          "isProgressive": {
            "description": "The file is a progressively encoded JPEG",
            "type": "boolean"
          },
          "isTransparent": {
            "description": "The file is transparent",
            "type": "boolean"
          },
          "path": {
            "description": "File path",
            "type": "string"
          },
          "type": {
            "$ref": "#/components/schemas/AssetFileType"
          },
          "updatedAt": {
            "description": "Update date",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string"
          }
        },
        "required": [
          "createdAt",
          "id",
          "isEdited",
          "isProgressive",
          "isTransparent",
          "path",
          "type",
          "updatedAt"
        ],
        "type": "object"
      },
      "AssetFileType": {
        "description": "Type of file",
        "enum": [
          "fullsize",
          "preview",
          "thumbnail",
          "sidecar",
          "encoded_video"
        ],
        "type": "string"
      },
      "AssetIdErrorReason": {
        "description": "Error reason if failed",
        "enum": [
          "duplicate",
          "no_permission",
          "not_found"
        ],
        "type": "string"
      },
      "AssetIdsDto": {
        "properties": {
          "assetIds": {
            "description": "Asset IDs",
            "items": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            },
            "type": "array"
          }
        },
        "required": [
          "assetIds"
        ],
        "type": "object"
      },
      "AssetIdsResponseDto": {
        "properties": {
          "assetId": {
            "description": "Asset ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          },
          "error": {
            "$ref": "#/components/schemas/AssetIdErrorReason"
          },
          "success": {
            "description": "Whether operation succeeded",
            "type": "boolean"
          }
        },
        "required": [
          "assetId",
          "success"
        ],
        "type": "object"
      },
      "AssetJobName": {
        "description": "Job name",
        "enum": [
          "refresh-faces",
          "refresh-metadata",
          "regenerate-thumbnail",
          "transcode-video"
        ],
        "type": "string"
      },
      "AssetJobsDto": {
        "properties": {
          "assetIds": {
            "description": "Asset IDs",
            "items": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            },
            "type": "array"
          },
          "name": {
            "$ref": "#/components/schemas/AssetJobName"
          }
        },
        "required": [
          "assetIds",
          "name"
        ],
        "type": "object"
      },
      "AssetMediaCreateDto": {
        "properties": {
          "assetData": {
            "description": "Asset file data",
            "format": "binary",
            "type": "string"
          },
          "duration": {
            "description": "Duration in milliseconds (for videos)",
            "maximum": 9007199254740991,
            "minimum": 0,
            "type": "integer"
          },
          "fileCreatedAt": {
            "description": "File creation date",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string"
          },
          "fileModifiedAt": {
            "description": "File modification date",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string"
          },
          "filename": {
            "description": "Filename",
            "type": "string"
          },
          "isFavorite": {
            "description": "Mark as favorite",
            "type": "boolean"
          },
          "livePhotoVideoId": {
            "description": "Live photo video ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          },
          "metadata": {
            "description": "Asset metadata items",
            "items": {
              "$ref": "#/components/schemas/AssetMetadataUpsertItemDto"
            },
            "type": "array"
          },
          "sidecarData": {
            "description": "Sidecar file data",
            "format": "binary",
            "type": "string"
          },
          "visibility": {
            "$ref": "#/components/schemas/AssetVisibility"
          }
        },
        "required": [
          "assetData",
          "fileCreatedAt",
          "fileModifiedAt"
        ],
        "type": "object"
      },
      "AssetMediaResponseDto": {
        "properties": {
          "id": {
            "description": "Asset media ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          },
          "status": {
            "$ref": "#/components/schemas/AssetMediaStatus"
          }
        },
        "required": [
          "id",
          "status"
        ],
        "type": "object"
      },
      "AssetMediaSize": {
        "description": "Asset media size",
        "enum": [
          "original",
          "fullsize",
          "preview",
          "thumbnail"
        ],
        "type": "string"
      },
      "AssetMediaStatus": {
        "description": "Upload status",
        "enum": [
          "created",
          "duplicate"
        ],
        "type": "string"
      },
      "AssetMetadataBulkDeleteDto": {
        "properties": {
          "items": {
            "description": "Metadata items to delete",
            "items": {
              "$ref": "#/components/schemas/AssetMetadataBulkDeleteItemDto"
            },
            "type": "array"
          }
        },
        "required": [
          "items"
        ],
        "type": "object"
      },
      "AssetMetadataBulkDeleteItemDto": {
        "properties": {
          "assetId": {
            "description": "Asset ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          },
          "key": {
            "description": "Metadata key",
            "type": "string"
          }
        },
        "required": [
          "assetId",
          "key"
        ],
        "type": "object"
      },
      "AssetMetadataBulkResponseDto": {
        "properties": {
          "assetId": {
            "description": "Asset ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          },
          "key": {
            "description": "Metadata key",
            "type": "string"
          },
          "updatedAt": {
            "description": "Last update date",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string"
          },
          "value": {
            "additionalProperties": {},
            "description": "Metadata value (object)",
            "type": "object"
          }
        },
        "required": [
          "assetId",
          "key",
          "updatedAt",
          "value"
        ],
        "type": "object"
      },
      "AssetMetadataBulkUpsertDto": {
        "properties": {
          "items": {
            "description": "Metadata items to upsert",
            "items": {
              "$ref": "#/components/schemas/AssetMetadataBulkUpsertItemDto"
            },
            "type": "array"
          }
        },
        "required": [
          "items"
        ],
        "type": "object"
      },
      "AssetMetadataBulkUpsertItemDto": {
        "properties": {
          "assetId": {
            "description": "Asset ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          },
          "key": {
            "description": "Metadata key",
            "type": "string"
          },
          "value": {
            "additionalProperties": {},
            "description": "Metadata value (object)",
            "type": "object"
          }
        },
        "required": [
          "assetId",
          "key",
          "value"
        ],
        "type": "object"
      },
      "AssetMetadataResponseDto": {
        "properties": {
          "key": {
            "description": "Metadata key",
            "type": "string"
          },
          "updatedAt": {
            "description": "Last update date",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string"
          },
          "value": {
            "additionalProperties": {},
            "description": "Metadata value (object)",
            "type": "object"
          }
        },
        "required": [
          "key",
          "updatedAt",
          "value"
        ],
        "type": "object"
      },
      "AssetMetadataUpsertDto": {
        "properties": {
          "items": {
            "description": "Metadata items to upsert",
            "items": {
              "$ref": "#/components/schemas/AssetMetadataUpsertItemDto"
            },
            "type": "array"
          }
        },
        "required": [
          "items"
        ],
        "type": "object"
      },
      "AssetMetadataUpsertItemDto": {
        "properties": {
          "key": {
            "description": "Metadata key",
            "type": "string"
          },
          "value": {
            "additionalProperties": {},
            "description": "Metadata value (object)",
            "type": "object"
          }
        },
        "required": [
          "key",
          "value"
        ],
        "type": "object"
      },
      "AssetOcrResponseDto": {
        "properties": {
          "assetId": {
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          },
          "boxScore": {
            "description": "Confidence score for text detection box",
            "format": "double",
            "type": "number"
          },
          "id": {
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          },
          "text": {
            "description": "Recognized text",
            "type": "string"
          },
          "textScore": {
            "description": "Confidence score for text recognition",
            "format": "double",
            "type": "number"
          },
          "x1": {
            "description": "Normalized x coordinate of box corner 1 (0-1)",
            "format": "double",
            "type": "number"
          },
          "x2": {
            "description": "Normalized x coordinate of box corner 2 (0-1)",
            "format": "double",
            "type": "number"
          },
          "x3": {
            "description": "Normalized x coordinate of box corner 3 (0-1)",
            "format": "double",
            "type": "number"
          },
          "x4": {
            "description": "Normalized x coordinate of box corner 4 (0-1)",
            "format": "double",
            "type": "number"
          },
          "y1": {
            "description": "Normalized y coordinate of box corner 1 (0-1)",
            "format": "double",
            "type": "number"
          },
          "y2": {
            "description": "Normalized y coordinate of box corner 2 (0-1)",
            "format": "double",
            "type": "number"
          },
          "y3": {
            "description": "Normalized y coordinate of box corner 3 (0-1)",
            "format": "double",
            "type": "number"
          },
          "y4": {
            "description": "Normalized y coordinate of box corner 4 (0-1)",
            "format": "double",
            "type": "number"
          }
        },
        "required": [
          "assetId",
          "boxScore",
          "id",
          "text",
          "textScore",
          "x1",
          "x2",
          "x3",
          "x4",
          "y1",
          "y2",
          "y3",
          "y4"
        ],
        "type": "object"
      },
      "AssetOrder": {
        "description": "Asset sort order",
        "enum": [
          "asc",
          "desc"
        ],
        "type": "string"
      },
      "AssetOrderBy": {
        "description": "Asset sorting property",
        "enum": [
          "takenAt",
          "createdAt"
        ],
        "type": "string"
      },
      "AssetRejectReason": {
        "description": "Rejection reason if rejected",
        "enum": [
          "duplicate",
          "unsupported-format"
        ],
        "type": "string"
      },
      "AssetResponseDto": {
        "properties": {
          "checksum": {
            "description": "Base64 encoded SHA1 hash",
            "type": "string"
          },
          "createdAt": {
            "description": "The UTC timestamp when the asset was originally uploaded to Immich.",
            "format": "date-time",
            "type": "string"
          },
          "duplicateId": {
            "description": "Duplicate group ID",
            "format": "uuid",
            "nullable": true,
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          },
          "duration": {
            "description": "Video/gif duration in milliseconds (null for static images)",
            "maximum": 2147483647,
            "minimum": 0,
            "nullable": true,
            "type": "integer"
          },
          "exifInfo": {
            "$ref": "#/components/schemas/ExifResponseDto"
          },
          "fileCreatedAt": {
            "description": "The actual UTC timestamp when the file was created/captured, preserving timezone information. This is the authoritative timestamp for chronological sorting within timeline groups. Combined with timezone data, this can be used to determine the exact moment the photo was taken.",
            "format": "date-time",
            "type": "string"
          },
          "fileModifiedAt": {
            "description": "The UTC timestamp when the file was last modified on the filesystem. This reflects the last time the physical file was changed, which may be different from when the photo was originally taken.",
            "format": "date-time",
            "type": "string"
          },
          "hasMetadata": {
            "description": "Whether asset has metadata",
            "type": "boolean"
          },
          "height": {
            "description": "Asset height",
            "maximum": 9007199254740991,
            "minimum": 0,
            "nullable": true,
            "type": "integer"
          },
          "id": {
            "description": "Asset ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          },
          "isArchived": {
            "description": "Is archived",
            "type": "boolean"
          },
          "isEdited": {
            "description": "Is edited",
            "type": "boolean",
            "x-immich-history": [
              {
                "version": "v2.5.0",
                "state": "Added"
              },
              {
                "version": "v2.5.0",
                "state": "Beta"
              }
            ],
            "x-immich-state": "Beta"
          },
          "isFavorite": {
            "description": "Is favorite",
            "type": "boolean"
          },
          "isOffline": {
            "description": "Is offline",
            "type": "boolean"
          },
          "isTrashed": {
            "description": "Is trashed",
            "type": "boolean"
          },
          "libraryId": {
            "description": "Library ID",
            "format": "uuid",
            "nullable": true,
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v1",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "livePhotoVideoId": {
            "description": "Live photo video ID",
            "nullable": true,
            "type": "string"
          },
          "localDateTime": {
            "description": "The local date and time when the photo/video was taken, derived from EXIF metadata. This represents the photographer's local time regardless of timezone, stored as a timezone-agnostic timestamp. Used for timeline grouping by \"local\" days and months.",
            "format": "date-time",
            "type": "string"
          },
          "originalFileName": {
            "description": "Original file name",
            "type": "string"
          },
          "originalMimeType": {
            "description": "Original MIME type",
            "type": "string"
          },
          "originalPath": {
            "description": "Original file path",
            "type": "string"
          },
          "owner": {
            "$ref": "#/components/schemas/UserResponseDto"
          },
          "ownerId": {
            "description": "Owner user ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          },
          "people": {
            "items": {
              "$ref": "#/components/schemas/PersonResponseDto"
            },
            "type": "array"
          },
          "resized": {
            "description": "Is resized",
            "type": "boolean",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v1.113.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "stack": {
            "allOf": [
              {
                "$ref": "#/components/schemas/AssetStackResponseDto"
              }
            ],
            "nullable": true
          },
          "tags": {
            "items": {
              "$ref": "#/components/schemas/TagResponseDto"
            },
            "type": "array"
          },
          "thumbhash": {
            "description": "Thumbhash for thumbnail generation (base64) also used as the c query param for thumbnail cache busting.",
            "nullable": true,
            "type": "string"
          },
          "type": {
            "$ref": "#/components/schemas/AssetTypeEnum"
          },
          "updatedAt": {
            "description": "The UTC timestamp when the asset record was last updated in the database. This is automatically maintained by the database and reflects when any field in the asset was last modified.",
            "format": "date-time",
            "type": "string"
          },
          "visibility": {
            "$ref": "#/components/schemas/AssetVisibility"
          },
          "width": {
            "description": "Asset width",
            "maximum": 9007199254740991,
            "minimum": 0,
            "nullable": true,
            "type": "integer"
          }
        },
        "required": [
          "checksum",
          "createdAt",
          "duration",
          "fileCreatedAt",
          "fileModifiedAt",
          "hasMetadata",
          "height",
          "id",
          "isArchived",
          "isEdited",
          "isFavorite",
          "isOffline",
          "isTrashed",
          "localDateTime",
          "originalFileName",
          "originalPath",
          "ownerId",
          "thumbhash",
          "type",
          "updatedAt",
          "visibility",
          "width"
        ],
        "type": "object"
      },
      "AssetStackResponseDto": {
        "properties": {
          "assetCount": {
            "description": "Number of assets in stack",
            "maximum": 9007199254740991,
            "minimum": 0,
            "type": "integer"
          },
          "id": {
            "description": "Stack ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          },
          "primaryAssetId": {
            "description": "Primary asset ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          }
        },
        "required": [
          "assetCount",
          "id",
          "primaryAssetId"
        ],
        "type": "object"
      },
      "AssetStatsResponseDto": {
        "properties": {
          "images": {
            "description": "Number of images",
            "maximum": 9007199254740991,
            "minimum": -9007199254740991,
            "type": "integer"
          },
          "total": {
            "description": "Total number of assets",
            "maximum": 9007199254740991,
            "minimum": -9007199254740991,
            "type": "integer"
          },
          "videos": {
            "description": "Number of videos",
            "maximum": 9007199254740991,
            "minimum": -9007199254740991,
            "type": "integer"
          }
        },
        "required": [
          "images",
          "total",
          "videos"
        ],
        "type": "object"
      },
      "AssetTypeEnum": {
        "description": "Asset type",
        "enum": [
          "IMAGE",
          "VIDEO",
          "AUDIO",
          "OTHER"
        ],
        "type": "string"
      },
      "AssetUploadAction": {
        "description": "Upload action",
        "enum": [
          "accept",
          "reject"
        ],
        "type": "string"
      },
      "AssetVisibility": {
        "description": "Asset visibility",
        "enum": [
          "archive",
          "timeline",
          "hidden",
          "locked"
        ],
        "type": "string"
      },
      "AudioCodec": {
        "description": "Target audio codec",
        "enum": [
          "mp3",
          "aac",
          "opus",
          "pcm_s16le"
        ],
        "type": "string"
      },
      "AuthStatusResponseDto": {
        "properties": {
          "expiresAt": {
            "description": "Session expiration date",
            "type": "string"
          },
          "isElevated": {
            "description": "Is elevated session",
            "type": "boolean"
          },
          "password": {
            "description": "Has password set",
            "type": "boolean"
          },
          "pinCode": {
            "description": "Has PIN code set",
            "type": "boolean"
          },
          "pinExpiresAt": {
            "description": "PIN expiration date",
            "type": "string"
          }
        },
        "required": [
          "isElevated",
          "password",
          "pinCode"
        ],
        "type": "object"
      },
      "AvatarUpdate": {
        "properties": {
          "color": {
            "$ref": "#/components/schemas/UserAvatarColor"
          }
        },
        "type": "object"
      },
      "BackendDto": {
        "properties": {
          "description": {
            "type": "string"
          },
          "error": {
            "type": "string"
          },
          "id": {
            "type": "string"
          },
          "isOnline": {
            "type": "boolean"
          },
          "type": {
            "$ref": "#/components/schemas/BackendType"
          }
        },
        "required": [
          "description",
          "id",
          "isOnline",
          "type"
        ],
        "type": "object"
      },
      "BackendResponseDto": {
        "properties": {
          "backend": {
            "$ref": "#/components/schemas/BackendDto"
          }
        },
        "required": [
          "backend"
        ],
        "type": "object"
      },
      "BackendType": {
        "enum": [
          "yucca",
          "local",
          "s3"
        ],
        "type": "string"
      },
      "BackendsResponseDto": {
        "properties": {
          "backends": {
            "items": {
              "$ref": "#/components/schemas/BackendDto"
            },
            "type": "array"
          }
        },
        "required": [
          "backends"
        ],
        "type": "object"
      },
      "BackupStatus": {
        "enum": [
          "incomplete",
          "complete",
          "warn",
          "failed",
          "cancelled"
        ],
        "type": "string"
      },
      "BandwidthDto": {
        "properties": {
          "bytesPerSec": {
            "maximum": 9007199254740991,
            "minimum": 0,
            "type": "integer"
          },
          "quietHours": {
            "pattern": "^([01]\\d|2[0-3]):[0-5]\\d-([01]\\d|2[0-3]):[0-5]\\d$",
            "type": "string"
          }
        },
        "required": [
          "bytesPerSec"
        ],
        "type": "object"
      },
      "BoolFilter": {
        "properties": {
          "eq": {
            "type": "boolean"
          }
        },
        "required": [
          "eq"
        ],
        "type": "object"
      },
      "BootstrapStatus": {
        "enum": [
          "not-ready",
          "ready",
          "error"
        ],
        "type": "string"
      },
      "BulkIdErrorReason": {
        "description": "Error reason",
        "enum": [
          "duplicate",
          "no_permission",
          "not_found",
          "unknown",
          "validation"
        ],
        "type": "string"
      },
      "BulkIdResponseDto": {
        "properties": {
          "error": {
            "$ref": "#/components/schemas/BulkIdErrorReason"
          },
          "errorMessage": {
            "type": "string"
          },
          "id": {
            "description": "ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          },
          "success": {
            "description": "Whether operation succeeded",
            "type": "boolean"
          }
        },
        "required": [
          "id",
          "success"
        ],
        "type": "object"
      },
      "BulkIdsDto": {
        "properties": {
          "ids": {
            "description": "IDs to process",
            "items": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            },
            "type": "array"
          }
        },
        "required": [
          "ids"
        ],
        "type": "object"
      },
      "CQMode": {
        "description": "CQ mode",
        "enum": [
          "auto",
          "cqp",
          "icq"
        ],
        "type": "string"
      },
      "CalendarHeatmapResponseDto": {
        "properties": {
          "from": {
            "description": "Start date in UTC",
            "example": "2024-01-01",
            "type": "string"
          },
          "series": {
            "items": {
              "properties": {
                "count": {
                  "description": "Activity count",
                  "maximum": 9007199254740991,
                  "minimum": 0,
                  "type": "integer"
                },
                "date": {
                  "description": "Date in UTC",
                  "example": "2024-01-01",
                  "type": "string"
                }
              },
              "required": [
                "date",
                "count"
              ],
              "type": "object"
            },
            "type": "array"
          },
          "to": {
            "description": "End date in UTC",
            "example": "2024-12-31",
            "type": "string"
          },
          "totalCount": {
            "description": "Total activity count over the period",
            "maximum": 9007199254740991,
            "minimum": 0,
            "type": "integer"
          }
        },
        "required": [
          "from",
          "series",
          "to",
          "totalCount"
        ],
        "type": "object"
      },
      "CalendarHeatmapType": {
        "description": "Type of calendar heatmap",
        "enum": [
          "Upload",
          "Taken"
        ],
        "type": "string"
      },
      "CastResponse": {
        "properties": {
          "gCastEnabled": {
            "description": "Whether Google Cast is enabled",
            "type": "boolean"
          }
        },
        "required": [
          "gCastEnabled"
        ],
        "type": "object"
      },
      "CastUpdate": {
        "properties": {
          "gCastEnabled": {
            "description": "Whether Google Cast is enabled",
            "type": "boolean"
          }
        },
        "type": "object"
      },
      "ChangePasswordDto": {
        "properties": {
          "invalidateSessions": {
            "default": false,
            "description": "Invalidate all other sessions",
            "type": "boolean"
          },
          "newPassword": {
            "description": "New password (min 8 characters)",
            "example": "password",
            "minLength": 8,
            "type": "string"
          },
          "password": {
            "description": "Current password",
            "example": "password",
            "type": "string"
          }
        },
        "required": [
          "newPassword",
          "password"
        ],
        "type": "object"
      },
      "ClusterGroupRequestCreateDto": {
        "properties": {
          "userId": {
            "description": "User to invite into the cluster group",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          }
        },
        "required": [
          "userId"
        ],
        "type": "object"
      },
      "ClusterGroupRequestResponseDto": {
        "properties": {
          "clusterGroupId": {
            "description": "Cluster group the user is invited to join",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          },
          "createdAt": {
            "description": "Creation date",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string"
          },
          "id": {
            "description": "Request ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          },
          "userId": {
            "description": "User the request was created for",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          }
        },
        "required": [
          "clusterGroupId",
          "createdAt",
          "id",
          "userId"
        ],
        "type": "object"
      },
      "Colorspace": {
        "description": "Colorspace",
        "enum": [
          "srgb",
          "p3"
        ],
        "type": "string"
      },
      "ConfigResponseDto": {
        "properties": {
          "bandwidth": {
            "$ref": "#/components/schemas/BandwidthDto"
          }
        },
        "required": [
          "bandwidth"
        ],
        "type": "object"
      },
      "ConfigUpdateRequestDto": {
        "properties": {
          "bandwidth": {
            "$ref": "#/components/schemas/BandwidthDto"
          }
        },
        "required": [
          "bandwidth"
        ],
        "type": "object"
      },
      "ConfigureImmichDatabaseDumpRequestDto": {
        "properties": {
          "enabled": {
            "type": "boolean"
          },
          "keepLastAmount": {
            "maximum": 9007199254740991,
            "minimum": 1,
            "type": "integer"
          }
        },
        "type": "object"
      },
      "ConfigureImmichIntegrationRequestDto": {
        "properties": {
          "backupConfiguration": {
            "type": "boolean"
          },
          "cron": {
            "type": "string"
          },
          "dataFolders": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "libraries": {
            "description": "IDs of the external libraries to back up. Use [\"all\"] to back up every library, including ones added later.",
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "name": {
            "type": "string"
          },
          "paused": {
            "type": "boolean"
          },
          "repositoryId": {
            "type": "string"
          },
          "retentionPolicy": {
            "allOf": [
              {
                "$ref": "#/components/schemas/RetentionPolicyDto"
              }
            ],
            "nullable": true
          },
          "worm": {
            "type": "boolean"
          }
        },
        "required": [
          "backupConfiguration",
          "cron",
          "dataFolders",
          "libraries",
          "name",
          "worm"
        ],
        "type": "object"
      },
      "ConfigureImmichIntegrationResponseDto": {
        "properties": {
          "repositoryId": {
            "type": "string"
          }
        },
        "required": [
          "repositoryId"
        ],
        "type": "object"
      },
      "ContributorCountResponseDto": {
        "properties": {
          "assetCount": {
            "description": "Number of assets contributed",
            "maximum": 9007199254740991,
            "minimum": 0,
            "type": "integer"
          },
          "userId": {
            "description": "User ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          }
        },
        "required": [
          "assetCount",
          "userId"
        ],
        "type": "object"
      },
      "CreateAlbumDto": {
        "properties": {
          "albumName": {
            "description": "Album name",
            "type": "string"
          },
          "albumUsers": {
            "description": "Album users",
            "items": {
              "$ref": "#/components/schemas/AlbumUserCreateDto"
            },
            "type": "array"
          },
          "assetIds": {
            "description": "Initial asset IDs",
            "items": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            },
            "type": "array"
          },
          "description": {
            "description": "Album description",
            "nullable": true,
            "type": "string",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v3",
                "state": "Updated",
                "description": "Sending an empty string is deprecated; send null instead. Empty strings will no longer be coerced to null in v4."
              }
            ]
          }
        },
        "required": [
          "albumName"
        ],
        "type": "object"
      },
      "CreateLibraryDto": {
        "properties": {
          "exclusionPatterns": {
            "description": "Exclusion patterns (max 128)",
            "items": {
              "type": "string"
            },
            "maxItems": 128,
            "type": "array"
          },
          "importPaths": {
            "description": "Import paths (max 128)",
            "items": {
              "type": "string"
            },
            "maxItems": 128,
            "type": "array"
          },
          "name": {
            "description": "Library name",
            "minLength": 1,
            "type": "string"
          },
          "ownerId": {
            "description": "Owner user ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          }
        },
        "required": [
          "ownerId"
        ],
        "type": "object"
      },
      "CreateLocalBackendRequestDto": {
        "properties": {
          "path": {
            "type": "string"
          }
        },
        "required": [
          "path"
        ],
        "type": "object"
      },
      "CreateProfileImageDto": {
        "properties": {
          "file": {
            "description": "Profile image file",
            "format": "binary",
            "type": "string"
          }
        },
        "required": [
          "file"
        ],
        "type": "object"
      },
      "CreateProfileImageResponseDto": {
        "properties": {
          "profileChangedAt": {
            "description": "Profile image change date",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string"
          },
          "profileImagePath": {
            "description": "Profile image file path",
            "type": "string"
          },
          "userId": {
            "description": "User ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          }
        },
        "required": [
          "profileChangedAt",
          "profileImagePath",
          "userId"
        ],
        "type": "object"
      },
      "CreateSessionRequestDto": {
        "properties": {
          "token": {
            "type": "string"
          }
        },
        "required": [
          "token"
        ],
        "type": "object"
      },
      "CropParameters": {
        "properties": {
          "height": {
            "description": "Height of the crop",
            "maximum": 9007199254740991,
            "minimum": 1,
            "type": "integer"
          },
          "width": {
            "description": "Width of the crop",
            "maximum": 9007199254740991,
            "minimum": 1,
            "type": "integer"
          },
          "x": {
            "description": "Top-Left X coordinate of crop",
            "maximum": 9007199254740991,
            "minimum": 0,
            "type": "integer"
          },
          "y": {
            "description": "Top-Left Y coordinate of crop",
            "maximum": 9007199254740991,
            "minimum": 0,
            "type": "integer"
          }
        },
        "required": [
          "height",
          "width",
          "x",
          "y"
        ],
        "type": "object"
      },
      "CurrentRecoveryKeyResponse": {
        "properties": {
          "recoveryKey": {
            "type": "string"
          }
        },
        "required": [
          "recoveryKey"
        ],
        "type": "object"
      },
      "DatabaseBackupDeleteDto": {
        "properties": {
          "backups": {
            "description": "Backup filenames to delete",
            "items": {
              "type": "string"
            },
            "type": "array"
          }
        },
        "required": [
          "backups"
        ],
        "type": "object"
      },
      "DatabaseBackupDto": {
        "properties": {
          "filename": {
            "description": "Backup filename",
            "type": "string"
          },
          "filesize": {
            "description": "Backup file size",
            "maximum": 9007199254740991,
            "minimum": -9007199254740991,
            "type": "integer"
          },
          "timezone": {
            "description": "Backup timezone",
            "type": "string"
          }
        },
        "required": [
          "filename",
          "filesize",
          "timezone"
        ],
        "type": "object"
      },
      "DatabaseBackupListResponseDto": {
        "properties": {
          "backups": {
            "description": "List of backups",
            "items": {
              "$ref": "#/components/schemas/DatabaseBackupDto"
            },
            "type": "array"
          }
        },
        "required": [
          "backups"
        ],
        "type": "object"
      },
      "DatabaseBackupUploadDto": {
        "properties": {
          "file": {
            "description": "Database backup file",
            "format": "binary",
            "type": "string"
          }
        },
        "type": "object"
      },
      "DateFilter": {
        "properties": {
          "eq": {
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string"
          },
          "gt": {
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string"
          },
          "gte": {
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string"
          },
          "lt": {
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string"
          },
          "lte": {
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string"
          },
          "ne": {
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string"
          }
        },
        "type": "object"
      },
      "DateFilterNullable": {
        "properties": {
          "eq": {
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "nullable": true,
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string"
          },
          "gt": {
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string"
          },
          "gte": {
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string"
          },
          "lt": {
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string"
          },
          "lte": {
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string"
          },
          "ne": {
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "nullable": true,
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string"
          }
        },
        "type": "object"
      },
      "DeviceFlowEventDto": {
        "properties": {
          "backendId": {
            "type": "string"
          },
          "reason": {
            "$ref": "#/components/schemas/DeviceFlowFailureReason"
          },
          "token": {
            "type": "string"
          },
          "type": {
            "$ref": "#/components/schemas/DeviceFlowEventType"
          },
          "userCode": {
            "type": "string"
          },
          "verificationUri": {
            "type": "string"
          }
        },
        "required": [
          "type"
        ],
        "type": "object"
      },
      "DeviceFlowEventType": {
        "enum": [
          "START",
          "SUCCESS",
          "FAILURE"
        ],
        "type": "string"
      },
      "DeviceFlowFailureReason": {
        "enum": [
          "NOT_CONNECTED",
          "DEVICE_FLOW_FAILED",
          "WRONG_ACCOUNT",
          "UNKNOWN"
        ],
        "type": "string"
      },
      "DownloadArchiveDto": {
        "properties": {
          "archiveName": {
            "description": "The name of the archive to download, without extension",
            "type": "string"
          },
          "assetIds": {
            "description": "Asset IDs",
            "items": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            },
            "type": "array"
          },
          "edited": {
            "description": "Download edited asset if available",
            "type": "boolean"
          }
        },
        "required": [
          "assetIds"
        ],
        "type": "object"
      },
      "DownloadArchiveInfo": {
        "properties": {
          "assetIds": {
            "description": "Asset IDs in this archive",
            "items": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            },
            "type": "array"
          },
          "size": {
            "description": "Archive size in bytes",
            "maximum": 9007199254740991,
            "minimum": -9007199254740991,
            "type": "integer"
          }
        },
        "required": [
          "assetIds",
          "size"
        ],
        "type": "object"
      },
      "DownloadInfoDto": {
        "properties": {
          "albumId": {
            "description": "Album ID to download",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          },
          "archiveSize": {
            "description": "Archive size limit in bytes",
            "maximum": 9007199254740991,
            "minimum": 1,
            "type": "integer"
          },
          "assetIds": {
            "description": "Asset IDs to download",
            "items": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            },
            "type": "array"
          },
          "userId": {
            "description": "User ID to download assets from",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          }
        },
        "type": "object"
      },
      "DownloadResponse": {
        "properties": {
          "archiveSize": {
            "description": "Maximum archive size in bytes",
            "maximum": 9007199254740991,
            "minimum": -9007199254740991,
            "type": "integer"
          },
          "includeEmbeddedVideos": {
            "description": "Whether to include embedded videos in downloads",
            "type": "boolean"
          }
        },
        "required": [
          "archiveSize",
          "includeEmbeddedVideos"
        ],
        "type": "object"
      },
      "DownloadResponseDto": {
        "properties": {
          "archives": {
            "description": "Archive information",
            "items": {
              "$ref": "#/components/schemas/DownloadArchiveInfo"
            },
            "type": "array"
          },
          "totalSize": {
            "description": "Total size in bytes",
            "maximum": 9007199254740991,
            "minimum": -9007199254740991,
            "type": "integer"
          }
        },
        "required": [
          "archives",
          "totalSize"
        ],
        "type": "object"
      },
      "DownloadUpdate": {
        "properties": {
          "archiveSize": {
            "description": "Maximum archive size in bytes",
            "maximum": 9007199254740991,
            "minimum": 1,
            "type": "integer"
          },
          "includeEmbeddedVideos": {
            "description": "Whether to include embedded videos in downloads",
            "type": "boolean"
          }
        },
        "type": "object"
      },
      "DuplicateResolveDto": {
        "properties": {
          "groups": {
            "description": "List of duplicate groups to resolve",
            "items": {
              "$ref": "#/components/schemas/DuplicateResolveGroupDto"
            },
            "minItems": 1,
            "type": "array"
          }
        },
        "required": [
          "groups"
        ],
        "type": "object"
      },
      "DuplicateResolveGroupDto": {
        "properties": {
          "duplicateId": {
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          },
          "keepAssetIds": {
            "description": "Asset IDs to keep",
            "items": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            },
            "type": "array"
          },
          "trashAssetIds": {
            "description": "Asset IDs to trash or delete",
            "items": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            },
            "type": "array"
          }
        },
        "required": [
          "duplicateId",
          "keepAssetIds",
          "trashAssetIds"
        ],
        "type": "object"
      },
      "DuplicateResponseDto": {
        "properties": {
          "assets": {
            "description": "Duplicate assets",
            "items": {
              "$ref": "#/components/schemas/AssetResponseDto"
            },
            "type": "array"
          },
          "duplicateId": {
            "description": "Duplicate group ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          },
          "suggestedKeepAssetIds": {
            "description": "Suggested asset IDs to keep based on file size and EXIF data",
            "items": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            },
            "type": "array"
          }
        },
        "required": [
          "assets",
          "duplicateId",
          "suggestedKeepAssetIds"
        ],
        "type": "object"
      },
      "EmailNotificationsResponse": {
        "properties": {
          "albumInvite": {
            "description": "Whether to receive email notifications for album invites",
            "type": "boolean"
          },
          "albumUpdate": {
            "description": "Whether to receive email notifications for album updates",
            "type": "boolean"
          },
          "enabled": {
            "description": "Whether email notifications are enabled",
            "type": "boolean"
          }
        },
        "required": [
          "albumInvite",
          "albumUpdate",
          "enabled"
        ],
        "type": "object"
      },
      "EmailNotificationsUpdate": {
        "properties": {
          "albumInvite": {
            "description": "Whether to receive email notifications for album invites",
            "type": "boolean"
          },
          "albumUpdate": {
            "description": "Whether to receive email notifications for album updates",
            "type": "boolean"
          },
          "enabled": {
            "description": "Whether email notifications are enabled",
            "type": "boolean"
          }
        },
        "type": "object"
      },
      "EnumFilterAssetType": {
        "properties": {
          "eq": {
            "$ref": "#/components/schemas/AssetTypeEnum"
          },
          "in": {
            "items": {
              "$ref": "#/components/schemas/AssetTypeEnum"
            },
            "minItems": 1,
            "type": "array"
          },
          "ne": {
            "$ref": "#/components/schemas/AssetTypeEnum"
          },
          "notIn": {
            "items": {
              "$ref": "#/components/schemas/AssetTypeEnum"
            },
            "minItems": 1,
            "type": "array"
          }
        },
        "type": "object"
      },
      "EnumFilterAssetVisibility": {
        "properties": {
          "eq": {
            "$ref": "#/components/schemas/AssetVisibility"
          },
          "in": {
            "items": {
              "$ref": "#/components/schemas/AssetVisibility"
            },
            "minItems": 1,
            "type": "array"
          },
          "ne": {
            "$ref": "#/components/schemas/AssetVisibility"
          },
          "notIn": {
            "items": {
              "$ref": "#/components/schemas/AssetVisibility"
            },
            "minItems": 1,
            "type": "array"
          }
        },
        "type": "object"
      },
      "ExifResponseDto": {
        "description": "EXIF response",
        "properties": {
          "city": {
            "default": null,
            "description": "City name",
            "nullable": true,
            "type": "string"
          },
          "country": {
            "default": null,
            "description": "Country name",
            "nullable": true,
            "type": "string"
          },
          "dateTimeOriginal": {
            "default": null,
            "description": "Original date/time",
            "format": "date-time",
            "nullable": true,
            "type": "string"
          },
          "description": {
            "default": null,
            "description": "Image description",
            "nullable": true,
            "type": "string"
          },
          "exifImageHeight": {
            "default": null,
            "description": "Image height in pixels",
            "maximum": 9007199254740991,
            "minimum": 0,
            "nullable": true,
            "type": "integer"
          },
          "exifImageWidth": {
            "default": null,
            "description": "Image width in pixels",
            "maximum": 9007199254740991,
            "minimum": 0,
            "nullable": true,
            "type": "integer"
          },
          "exposureTime": {
            "default": null,
            "description": "Exposure time",
            "nullable": true,
            "type": "string"
          },
          "fNumber": {
            "default": null,
            "description": "F-number (aperture)",
            "format": "double",
            "nullable": true,
            "type": "number"
          },
          "fileSizeInByte": {
            "default": null,
            "description": "File size in bytes",
            "maximum": 9007199254740991,
            "minimum": 0,
            "nullable": true,
            "type": "integer"
          },
          "focalLength": {
            "default": null,
            "description": "Focal length in mm",
            "format": "double",
            "nullable": true,
            "type": "number"
          },
          "iso": {
            "default": null,
            "description": "ISO sensitivity",
            "maximum": 9007199254740991,
            "minimum": -9007199254740991,
            "nullable": true,
            "type": "integer"
          },
          "latitude": {
            "default": null,
            "description": "GPS latitude",
            "format": "double",
            "nullable": true,
            "type": "number"
          },
          "lensModel": {
            "default": null,
            "description": "Lens model",
            "nullable": true,
            "type": "string"
          },
          "longitude": {
            "default": null,
            "description": "GPS longitude",
            "format": "double",
            "nullable": true,
            "type": "number"
          },
          "make": {
            "default": null,
            "description": "Camera make",
            "nullable": true,
            "type": "string"
          },
          "model": {
            "default": null,
            "description": "Camera model",
            "nullable": true,
            "type": "string"
          },
          "modifyDate": {
            "default": null,
            "description": "Modification date/time",
            "format": "date-time",
            "nullable": true,
            "type": "string"
          },
          "orientation": {
            "default": null,
            "description": "Image orientation",
            "nullable": true,
            "type": "string"
          },
          "projectionType": {
            "default": null,
            "description": "Projection type",
            "nullable": true,
            "type": "string"
          },
          "rating": {
            "default": null,
            "description": "Rating",
            "maximum": 5,
            "minimum": 1,
            "nullable": true,
            "type": "integer"
          },
          "state": {
            "default": null,
            "description": "State/province name",
            "nullable": true,
            "type": "string"
          },
          "timeZone": {
            "default": null,
            "description": "Time zone",
            "nullable": true,
            "type": "string"
          }
        },
        "type": "object"
      },
      "FaceDto": {
        "properties": {
          "id": {
            "description": "Face ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          }
        },
        "required": [
          "id"
        ],
        "type": "object"
      },
      "FilesystemListingItemDto": {
        "properties": {
          "isDirectory": {
            "type": "boolean"
          },
          "path": {
            "type": "string"
          }
        },
        "required": [
          "isDirectory",
          "path"
        ],
        "type": "object"
      },
      "FilesystemListingResponseDto": {
        "properties": {
          "items": {
            "items": {
              "$ref": "#/components/schemas/FilesystemListingItemDto"
            },
            "type": "array"
          },
          "parent": {
            "type": "string"
          },
          "path": {
            "type": "string"
          }
        },
        "required": [
          "items",
          "parent",
          "path"
        ],
        "type": "object"
      },
      "FoldersResponse": {
        "properties": {
          "enabled": {
            "description": "Whether folders are enabled",
            "type": "boolean"
          },
          "sidebarWeb": {
            "description": "Whether folders appear in web sidebar",
            "type": "boolean"
          }
        },
        "required": [
          "enabled",
          "sidebarWeb"
        ],
        "type": "object"
      },
      "FoldersUpdate": {
        "properties": {
          "enabled": {
            "description": "Whether folders are enabled",
            "type": "boolean"
          },
          "sidebarWeb": {
            "description": "Whether folders appear in web sidebar",
            "type": "boolean"
          }
        },
        "type": "object"
      },
      "HlsVideoResolution": {
        "description": "HLS video resolution",
        "enum": [
          480,
          720,
          1080,
          1440,
          2160
        ],
        "type": "integer"
      },
      "IdFilter": {
        "properties": {
          "eq": {
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          },
          "ne": {
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          }
        },
        "type": "object"
      },
      "IdFilterNullable": {
        "properties": {
          "eq": {
            "format": "uuid",
            "nullable": true,
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          },
          "ne": {
            "format": "uuid",
            "nullable": true,
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          }
        },
        "type": "object"
      },
      "IdsFilter": {
        "properties": {
          "all": {
            "items": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            },
            "minItems": 1,
            "type": "array"
          },
          "any": {
            "items": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            },
            "minItems": 1,
            "type": "array"
          },
          "none": {
            "items": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            },
            "minItems": 1,
            "type": "array"
          }
        },
        "type": "object"
      },
      "ImageFormat": {
        "description": "Image format",
        "enum": [
          "jpeg",
          "jxl",
          "webp"
        ],
        "type": "string"
      },
      "ImmichBackupStatusDto": {
        "properties": {
          "backend": {
            "$ref": "#/components/schemas/BackendDto"
          },
          "databaseDump": {
            "$ref": "#/components/schemas/ImmichDatabaseDumpConfigDto"
          },
          "databaseDumpWarningIgnored": {
            "type": "boolean"
          },
          "integration": {
            "$ref": "#/components/schemas/ImmichIntegrationDto"
          },
          "latestBackupJob": {
            "$ref": "#/components/schemas/JobDto"
          },
          "repository": {
            "$ref": "#/components/schemas/LocalRepositoryDto"
          },
          "schedule": {
            "$ref": "#/components/schemas/ScheduleDto"
          }
        },
        "type": "object"
      },
      "ImmichDatabaseDumpConfigDto": {
        "properties": {
          "enabled": {
            "type": "boolean"
          },
          "keepLastAmount": {
            "maximum": 9007199254740991,
            "minimum": 1,
            "type": "integer"
          }
        },
        "required": [
          "enabled",
          "keepLastAmount"
        ],
        "type": "object"
      },
      "ImmichIntegrationConfigurationDto": {
        "properties": {
          "backupConfiguration": {
            "type": "boolean"
          },
          "dataFolders": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "libraries": {
            "description": "IDs of the external libraries to back up. Use [\"all\"] to back up every library, including ones added later.",
            "items": {
              "type": "string"
            },
            "type": "array"
          }
        },
        "required": [
          "backupConfiguration",
          "dataFolders",
          "libraries"
        ],
        "type": "object"
      },
      "ImmichIntegrationDto": {
        "properties": {
          "configuration": {
            "$ref": "#/components/schemas/ImmichIntegrationConfigurationDto"
          },
          "id": {
            "type": "string"
          },
          "scheduleId": {
            "type": "string"
          }
        },
        "required": [
          "configuration",
          "id",
          "scheduleId"
        ],
        "type": "object"
      },
      "ImmichLibraryDto": {
        "properties": {
          "exclusionPatterns": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "id": {
            "type": "string"
          },
          "importPaths": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "name": {
            "type": "string"
          }
        },
        "required": [
          "exclusionPatterns",
          "id",
          "importPaths",
          "name"
        ],
        "type": "object"
      },
      "ImmichRollbackRequestDto": {
        "properties": {
          "backupFileName": {
            "type": "string"
          },
          "repositoryId": {
            "type": "string"
          },
          "snapshotId": {
            "type": "string"
          }
        },
        "required": [
          "repositoryId",
          "snapshotId"
        ],
        "type": "object"
      },
      "ImmichStateDto": {
        "properties": {
          "dataFolders": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "dataPath": {
            "type": "string"
          },
          "libraries": {
            "items": {
              "$ref": "#/components/schemas/ImmichLibraryDto"
            },
            "type": "array"
          }
        },
        "required": [
          "dataFolders",
          "dataPath",
          "libraries"
        ],
        "type": "object"
      },
      "ImportRecoveryKeyRequest": {
        "properties": {
          "recoveryKey": {
            "type": "string"
          }
        },
        "required": [
          "recoveryKey"
        ],
        "type": "object"
      },
      "InspectedLocalRepositoryDto": {
        "properties": {
          "backends": {
            "$ref": "#/components/schemas/RepositoryBackendsDto"
          },
          "configuration": {
            "$ref": "#/components/schemas/RepositoryConfigurationDto"
          },
          "id": {
            "type": "string"
          },
          "meter": {
            "$ref": "#/components/schemas/RepositoryMeterDto"
          },
          "metrics": {
            "$ref": "#/components/schemas/RepositoryMetricsDto"
          },
          "name": {
            "type": "string"
          },
          "siteCode": {
            "nullable": true,
            "type": "string"
          },
          "snapshots": {
            "items": {
              "$ref": "#/components/schemas/SnapshotDto"
            },
            "type": "array"
          },
          "storageClusterCode": {
            "nullable": true,
            "type": "string"
          },
          "worm": {
            "type": "boolean"
          }
        },
        "required": [
          "id",
          "metrics",
          "name",
          "siteCode",
          "storageClusterCode",
          "worm"
        ],
        "type": "object"
      },
      "IntegrationsResponseDto": {
        "properties": {
          "immichIntegration": {
            "$ref": "#/components/schemas/ImmichIntegrationDto"
          },
          "immichState": {
            "$ref": "#/components/schemas/ImmichStateDto"
          }
        },
        "type": "object"
      },
      "IntegrityReport": {
        "description": "Integrity report type",
        "enum": [
          "untracked_file",
          "missing_file",
          "checksum_mismatch"
        ],
        "type": "string"
      },
      "IntegrityReportResponseDto": {
        "properties": {
          "items": {
            "items": {
              "properties": {
                "id": {
                  "description": "Integrity report item id",
                  "format": "uuid",
                  "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
                  "type": "string"
                },
                "path": {
                  "description": "Integrity report item path",
                  "type": "string"
                },
                "type": {
                  "$ref": "#/components/schemas/IntegrityReport"
                }
              },
              "required": [
                "id",
                "type",
                "path"
              ],
              "type": "object"
            },
            "type": "array"
          },
          "nextCursor": {
            "type": "string"
          }
        },
        "required": [
          "items"
        ],
        "type": "object"
      },
      "IntegrityReportSummaryResponseDto": {
        "properties": {
          "checksum_mismatch": {
            "maximum": 9007199254740991,
            "minimum": 0,
            "type": "integer"
          },
          "missing_file": {
            "maximum": 9007199254740991,
            "minimum": 0,
            "type": "integer"
          },
          "untracked_file": {
            "maximum": 9007199254740991,
            "minimum": 0,
            "type": "integer"
          }
        },
        "required": [
          "checksum_mismatch",
          "missing_file",
          "untracked_file"
        ],
        "type": "object"
      },
      "JobCreateDto": {
        "properties": {
          "name": {
            "$ref": "#/components/schemas/ManualJobName"
          }
        },
        "required": [
          "name"
        ],
        "type": "object"
      },
      "JobDto": {
        "properties": {
          "end": {
            "type": "string"
          },
          "id": {
            "type": "string"
          },
          "name": {
            "$ref": "#/components/schemas/YuccaJobName"
          },
          "outcome": {
            "$ref": "#/components/schemas/JobOutcomeDto"
          },
          "progress": {
            "$ref": "#/components/schemas/JobProgressDto"
          },
          "queuedAt": {
            "type": "string"
          },
          "repositoryId": {
            "type": "string"
          },
          "start": {
            "type": "string"
          },
          "status": {
            "$ref": "#/components/schemas/YuccaJobStatus"
          }
        },
        "required": [
          "id",
          "name",
          "queuedAt",
          "repositoryId",
          "status"
        ],
        "type": "object"
      },
      "JobListResponseDto": {
        "properties": {
          "jobs": {
            "items": {
              "$ref": "#/components/schemas/JobDto"
            },
            "type": "array"
          }
        },
        "required": [
          "jobs"
        ],
        "type": "object"
      },
      "JobName": {
        "description": "Job name",
        "enum": [
          "AssetDelete",
          "AssetDeleteCheck",
          "AssetDetectFacesQueueAll",
          "AssetDetectFaces",
          "AssetDetectDuplicatesQueueAll",
          "AssetDetectDuplicates",
          "AssetEditThumbnailGeneration",
          "AssetEncodeVideoQueueAll",
          "AssetEncodeVideo",
          "AssetEmptyTrash",
          "AssetExtractMetadataQueueAll",
          "AssetExtractMetadata",
          "AssetFileMigration",
          "AssetGenerateThumbnailsQueueAll",
          "AssetGenerateThumbnails",
          "AuditTableCleanup",
          "AuthChallengeCleanup",
          "DatabaseBackup",
          "FacialRecognitionQueueAll",
          "FacialRecognition",
          "FileDelete",
          "FileMigrationQueueAll",
          "LibraryDeleteCheck",
          "LibraryDelete",
          "LibraryRemoveAsset",
          "LibraryScanAssetsQueueAll",
          "LibrarySyncAssets",
          "LibrarySyncFilesQueueAll",
          "LibrarySyncFiles",
          "LibraryScanQueueAll",
          "HlsSessionCleanup",
          "MemoryCleanup",
          "MemoryGenerate",
          "NotificationsCleanup",
          "NotifyUserSignup",
          "NotifyAlbumInvite",
          "NotifyAlbumUpdate",
          "UserDelete",
          "UserDeleteCheck",
          "UserSyncUsage",
          "PersonCleanup",
          "PersonFileMigration",
          "PersonGenerateThumbnail",
          "SessionCleanup",
          "SendMail",
          "SidecarQueueAll",
          "SidecarCheck",
          "SidecarWrite",
          "SmartSearchQueueAll",
          "SmartSearch",
          "StorageTemplateMigration",
          "StorageTemplateMigrationSingle",
          "TagCleanup",
          "VersionCheck",
          "OcrQueueAll",
          "Ocr",
          "WorkflowAssetTrigger",
          "IntegrityUntrackedFilesQueueAll",
          "IntegrityUntrackedFiles",
          "IntegrityUntrackedRefresh",
          "IntegrityMissingFilesQueueAll",
          "IntegrityMissingFiles",
          "IntegrityMissingFilesRefresh",
          "IntegrityChecksumFiles",
          "IntegrityChecksumFilesRefresh",
          "IntegrityDeleteReportType",
          "IntegrityDeleteReports"
        ],
        "type": "string"
      },
      "JobOutcomeDto": {
        "properties": {
          "errors": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "summary": {
            "$ref": "#/components/schemas/JobSummaryDto"
          },
          "support": {
            "$ref": "#/components/schemas/JobSupportDto"
          }
        },
        "required": [
          "errors"
        ],
        "type": "object"
      },
      "JobProgressDto": {
        "properties": {
          "bytesDone": {
            "maximum": 9007199254740991,
            "minimum": -9007199254740991,
            "type": "integer"
          },
          "currentFiles": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "estimatedEndAt": {
            "type": "string"
          },
          "percentDone": {
            "format": "double",
            "type": "number"
          },
          "scanning": {
            "type": "boolean"
          },
          "totalBytes": {
            "maximum": 9007199254740991,
            "minimum": -9007199254740991,
            "type": "integer"
          }
        },
        "required": [
          "currentFiles",
          "percentDone",
          "scanning"
        ],
        "type": "object"
      },
      "JobResponseDto": {
        "properties": {
          "jobId": {
            "type": "string"
          }
        },
        "required": [
          "jobId"
        ],
        "type": "object"
      },
      "JobSummaryDto": {
        "oneOf": [
          {
            "type": "object",
            "properties": {
              "type": {
                "type": "string",
                "enum": [
                  "backup"
                ]
              },
              "filesNew": {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991
              },
              "filesChanged": {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991
              },
              "totalFilesProcessed": {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991
              },
              "totalBytesProcessed": {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991
              },
              "snapshotId": {
                "type": "string"
              }
            },
            "required": [
              "type",
              "filesNew",
              "filesChanged",
              "totalFilesProcessed",
              "totalBytesProcessed"
            ]
          },
          {
            "type": "object",
            "properties": {
              "type": {
                "type": "string",
                "enum": [
                  "restore"
                ]
              },
              "filesRestored": {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991
              },
              "filesSkipped": {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991
              },
              "bytesRestored": {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991
              }
            },
            "required": [
              "type",
              "filesRestored",
              "filesSkipped",
              "bytesRestored"
            ]
          },
          {
            "type": "object",
            "properties": {
              "type": {
                "type": "string",
                "enum": [
                  "prune"
                ]
              },
              "kept": {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991
              },
              "removed": {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991
              }
            },
            "required": [
              "type",
              "kept",
              "removed"
            ]
          }
        ]
      },
      "JobSupportDto": {
        "properties": {
          "droppedLines": {
            "description": "Log lines that could not be streamed in time",
            "maximum": 9007199254740991,
            "minimum": -9007199254740991,
            "type": "integer"
          },
          "localDroppedLines": {
            "description": "Log lines that could not be written to the local support log",
            "maximum": 9007199254740991,
            "minimum": -9007199254740991,
            "type": "integer"
          },
          "sessionId": {
            "description": "Support code to share with FUTO when the logs were streamed",
            "type": "string"
          }
        },
        "required": [
          "droppedLines",
          "localDroppedLines"
        ],
        "type": "object"
      },
      "LibraryResponseDto": {
        "properties": {
          "assetCount": {
            "description": "Number of assets",
            "maximum": 9007199254740991,
            "minimum": -9007199254740991,
            "type": "integer"
          },
          "createdAt": {
            "description": "Creation date",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string"
          },
          "exclusionPatterns": {
            "description": "Exclusion patterns",
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "id": {
            "description": "Library ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          },
          "importPaths": {
            "description": "Import paths",
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "name": {
            "description": "Library name",
            "type": "string"
          },
          "ownerId": {
            "description": "Owner user ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          },
          "refreshedAt": {
            "description": "Last refresh date",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "nullable": true,
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string"
          },
          "updatedAt": {
            "description": "Last update date",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string"
          }
        },
        "required": [
          "assetCount",
          "createdAt",
          "exclusionPatterns",
          "id",
          "importPaths",
          "name",
          "ownerId",
          "refreshedAt",
          "updatedAt"
        ],
        "type": "object"
      },
      "LibraryStatsResponseDto": {
        "properties": {
          "photos": {
            "description": "Number of photos",
            "maximum": 9007199254740991,
            "minimum": -9007199254740991,
            "type": "integer"
          },
          "total": {
            "description": "Total number of assets",
            "maximum": 9007199254740991,
            "minimum": -9007199254740991,
            "type": "integer"
          },
          "usage": {
            "description": "Storage usage in bytes",
            "maximum": 9007199254740991,
            "minimum": -9007199254740991,
            "type": "integer"
          },
          "videos": {
            "description": "Number of videos",
            "maximum": 9007199254740991,
            "minimum": -9007199254740991,
            "type": "integer"
          }
        },
        "required": [
          "photos",
          "total",
          "usage",
          "videos"
        ],
        "type": "object"
      },
      "LicenseKeyDto": {
        "properties": {
          "activationKey": {
            "description": "Activation key",
            "type": "string"
          },
          "licenseKey": {
            "description": "License key (format: /^IM(SV|CL)(-[\\dA-Za-z]{4}){8}$/)",
            "pattern": "^IM(SV|CL)(-[\\dA-Za-z]{4}){8}$",
            "type": "string"
          }
        },
        "required": [
          "activationKey",
          "licenseKey"
        ],
        "type": "object"
      },
      "LicenseResponseDto": {
        "$ref": "#/components/schemas/UserLicense"
      },
      "ListSnapshotsResponseDto": {
        "properties": {
          "snapshots": {
            "items": {
              "$ref": "#/components/schemas/SnapshotDto"
            },
            "type": "array"
          }
        },
        "required": [
          "snapshots"
        ],
        "type": "object"
      },
      "LocalRepositoryDto": {
        "properties": {
          "backends": {
            "$ref": "#/components/schemas/RepositoryBackendsDto"
          },
          "configuration": {
            "$ref": "#/components/schemas/RepositoryConfigurationDto"
          },
          "id": {
            "type": "string"
          },
          "meter": {
            "$ref": "#/components/schemas/RepositoryMeterDto"
          },
          "metrics": {
            "$ref": "#/components/schemas/RepositoryMetricsDto"
          },
          "name": {
            "type": "string"
          },
          "siteCode": {
            "nullable": true,
            "type": "string"
          },
          "storageClusterCode": {
            "nullable": true,
            "type": "string"
          },
          "worm": {
            "type": "boolean"
          }
        },
        "required": [
          "id",
          "metrics",
          "name",
          "siteCode",
          "storageClusterCode",
          "worm"
        ],
        "type": "object"
      },
      "LogLevel": {
        "description": "Log level",
        "enum": [
          "verbose",
          "debug",
          "log",
          "warn",
          "error",
          "fatal"
        ],
        "type": "string"
      },
      "LoginCredentialDto": {
        "properties": {
          "email": {
            "description": "User email",
            "example": "[email protected]",
            "format": "email",
            "pattern": "^[\\p{L}\\p{M}\\p{N}.!#$%&'*+/=?^_`{|}~-]+@[\\p{L}\\p{N}](?:[\\p{L}\\p{M}\\p{N}-]{0,61}[\\p{L}\\p{M}\\p{N}])?(?:\\.[\\p{L}\\p{N}](?:[\\p{L}\\p{M}\\p{N}-]{0,61}[\\p{L}\\p{M}\\p{N}])?)*$",
            "type": "string"
          },
          "password": {
            "description": "User password",
            "example": "password",
            "type": "string"
          }
        },
        "required": [
          "email",
          "password"
        ],
        "type": "object"
      },
      "LoginResponseDto": {
        "properties": {
          "accessToken": {
            "description": "Access token",
            "type": "string"
          },
          "isAdmin": {
            "description": "Is admin user",
            "type": "boolean"
          },
          "isOnboarded": {
            "description": "Is onboarded",
            "type": "boolean"
          },
          "name": {
            "description": "User name",
            "type": "string"
          },
          "profileImagePath": {
            "description": "Profile image path",
            "type": "string"
          },
          "shouldChangePassword": {
            "description": "Should change password",
            "type": "boolean"
          },
          "userEmail": {
            "description": "User email",
            "format": "email",
            "pattern": "^[\\p{L}\\p{M}\\p{N}.!#$%&'*+/=?^_`{|}~-]+@[\\p{L}\\p{N}](?:[\\p{L}\\p{M}\\p{N}-]{0,61}[\\p{L}\\p{M}\\p{N}])?(?:\\.[\\p{L}\\p{N}](?:[\\p{L}\\p{M}\\p{N}-]{0,61}[\\p{L}\\p{M}\\p{N}])?)*$",
            "type": "string"
          },
          "userId": {
            "description": "User ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          }
        },
        "required": [
          "accessToken",
          "isAdmin",
          "isOnboarded",
          "name",
          "profileImagePath",
          "shouldChangePassword",
          "userEmail",
          "userId"
        ],
        "type": "object"
      },
      "LogoutResponseDto": {
        "properties": {
          "redirectUri": {
            "description": "Redirect URI",
            "type": "string"
          },
          "successful": {
            "description": "Logout successful",
            "type": "boolean"
          }
        },
        "required": [
          "redirectUri",
          "successful"
        ],
        "type": "object"
      },
      "MaintenanceAction": {
        "description": "Maintenance action",
        "enum": [
          "start",
          "end",
          "select_database_restore",
          "restore_database",
          "rollback"
        ],
        "type": "string"
      },
      "MaintenanceAuthDto": {
        "properties": {
          "username": {
            "description": "Maintenance username",
            "type": "string"
          }
        },
        "required": [
          "username"
        ],
        "type": "object"
      },
      "MaintenanceDetectInstallResponseDto": {
        "properties": {
          "storage": {
            "items": {
              "$ref": "#/components/schemas/MaintenanceDetectInstallStorageFolderDto"
            },
            "type": "array"
          }
        },
        "required": [
          "storage"
        ],
        "type": "object"
      },
      "MaintenanceDetectInstallStorageFolderDto": {
        "properties": {
          "files": {
            "description": "Number of files in the folder",
            "maximum": 9007199254740991,
            "minimum": -9007199254740991,
            "type": "integer"
          },
          "folder": {
            "$ref": "#/components/schemas/StorageFolder"
          },
          "readable": {
            "description": "Whether the folder is readable",
            "type": "boolean"
          },
          "writable": {
            "description": "Whether the folder is writable",
            "type": "boolean"
          }
        },
        "required": [
          "files",
          "folder",
          "readable",
          "writable"
        ],
        "type": "object"
      },
      "MaintenanceLoginDto": {
        "properties": {
          "token": {
            "description": "Maintenance token",
            "type": "string"
          }
        },
        "type": "object"
      },
      "MaintenanceStatusResponseDto": {
        "properties": {
          "action": {
            "$ref": "#/components/schemas/MaintenanceAction"
          },
          "active": {
            "type": "boolean"
          },
          "error": {
            "type": "string"
          },
          "futoBackupsJobId": {
            "description": "FUTO Backups job ID",
            "type": "string"
          },
          "progress": {
            "maximum": 9007199254740991,
            "minimum": -9007199254740991,
            "type": "integer"
          },
          "task": {
            "type": "string"
          }
        },
        "required": [
          "action",
          "active"
        ],
        "type": "object"
      },
      "ManualJobName": {
        "description": "Manual job name",
        "enum": [
          "person-cleanup",
          "tag-cleanup",
          "user-cleanup",
          "memory-cleanup",
          "memory-create",
          "backup-database",
          "integrity-missing-files",
          "integrity-untracked-files",
          "integrity-checksum-mismatch",
          "integrity-missing-files-refresh",
          "integrity-untracked-files-refresh",
          "integrity-checksum-mismatch-refresh",
          "integrity-missing-files-delete-all",
          "integrity-untracked-files-delete-all",
          "integrity-checksum-mismatch-delete-all"
        ],
        "type": "string"
      },
      "MapMarkerResponseDto": {
        "properties": {
          "city": {
            "description": "City name",
            "nullable": true,
            "type": "string"
          },
          "country": {
            "description": "Country name",
            "nullable": true,
            "type": "string"
          },
          "id": {
            "description": "Asset ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          },
          "lat": {
            "description": "Latitude",
            "format": "double",
            "type": "number"
          },
          "lon": {
            "description": "Longitude",
            "format": "double",
            "type": "number"
          },
          "state": {
            "description": "State/Province name",
            "nullable": true,
            "type": "string"
          }
        },
        "required": [
          "city",
          "country",
          "id",
          "lat",
          "lon",
          "state"
        ],
        "type": "object"
      },
      "MapReverseGeocodeResponseDto": {
        "properties": {
          "city": {
            "description": "City name",
            "nullable": true,
            "type": "string"
          },
          "country": {
            "description": "Country name",
            "nullable": true,
            "type": "string"
          },
          "state": {
            "description": "State/Province name",
            "nullable": true,
            "type": "string"
          }
        },
        "required": [
          "city",
          "country",
          "state"
        ],
        "type": "object"
      },
      "MemoriesResponse": {
        "properties": {
          "duration": {
            "description": "Memory duration in seconds",
            "maximum": 9007199254740991,
            "minimum": -9007199254740991,
            "type": "integer"
          },
          "enabled": {
            "description": "Whether memories are enabled",
            "type": "boolean"
          },
          "sidebarWeb": {
            "description": "Whether memories appear in web sidebar",
            "type": "boolean"
          }
        },
        "required": [
          "duration",
          "enabled",
          "sidebarWeb"
        ],
        "type": "object"
      },
      "MemoriesUpdate": {
        "properties": {
          "duration": {
            "description": "Memory duration in seconds",
            "maximum": 9007199254740991,
            "minimum": 1,
            "type": "integer"
          },
          "enabled": {
            "description": "Whether memories are enabled",
            "type": "boolean"
          },
          "sidebarWeb": {
            "description": "Whether memories appear in web sidebar",
            "type": "boolean"
          }
        },
        "type": "object"
      },
      "MemoryCreateDto": {
        "properties": {
          "assetIds": {
            "description": "Asset IDs to associate with memory",
            "items": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            },
            "type": "array"
          },
          "data": {
            "$ref": "#/components/schemas/MemoryDataDto"
          },
          "hideAt": {
            "description": "Date when memory should be hidden",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string",
            "x-immich-history": [
              {
                "version": "v2.6.0",
                "state": "Added"
              },
              {
                "version": "v2.6.0",
                "state": "Stable"
              }
            ],
            "x-immich-state": "Stable"
          },
          "isSaved": {
            "description": "Is memory saved",
            "type": "boolean"
          },
          "memoryAt": {
            "description": "Memory date",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string"
          },
          "seenAt": {
            "description": "Date when memory was seen",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string"
          },
          "showAt": {
            "description": "Date when memory should be shown",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string",
            "x-immich-history": [
              {
                "version": "v2.6.0",
                "state": "Added"
              },
              {
                "version": "v2.6.0",
                "state": "Stable"
              }
            ],
            "x-immich-state": "Stable"
          },
          "type": {
            "$ref": "#/components/schemas/MemoryType"
          }
        },
        "required": [
          "data",
          "memoryAt",
          "type"
        ],
        "type": "object"
      },
      "MemoryDataDto": {
        "properties": {
          "personId": {
            "description": "Person ID (birthday memories)",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          },
          "personName": {
            "description": "Name of the person when the memory was created (birthday memories)",
            "type": "string"
          },
          "year": {
            "description": "Year of the memory",
            "maximum": 9999,
            "minimum": 1000,
            "type": "integer"
          }
        },
        "required": [
          "year"
        ],
        "type": "object"
      },
      "MemoryResponseDto": {
        "properties": {
          "assets": {
            "items": {
              "$ref": "#/components/schemas/AssetResponseDto"
            },
            "type": "array"
          },
          "createdAt": {
            "description": "Creation date",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string"
          },
          "data": {
            "$ref": "#/components/schemas/MemoryDataDto"
          },
          "deletedAt": {
            "description": "Deletion date",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string"
          },
          "hideAt": {
            "description": "Date when memory should be hidden",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string"
          },
          "id": {
            "description": "Memory ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          },
          "isSaved": {
            "description": "Is memory saved",
            "type": "boolean"
          },
          "memoryAt": {
            "description": "Memory date",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string"
          },
          "ownerId": {
            "description": "Owner user ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          },
          "seenAt": {
            "description": "Date when memory was seen",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string"
          },
          "showAt": {
            "description": "Date when memory should be shown",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string"
          },
          "type": {
            "$ref": "#/components/schemas/MemoryType"
          },
          "updatedAt": {
            "description": "Last update date",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string"
          }
        },
        "required": [
          "assets",
          "createdAt",
          "data",
          "id",
          "isSaved",
          "memoryAt",
          "ownerId",
          "type",
          "updatedAt"
        ],
        "type": "object"
      },
      "MemorySearchOrder": {
        "description": "Sort order",
        "enum": [
          "asc",
          "desc",
          "random"
        ],
        "type": "string"
      },
      "MemoryStatisticsResponseDto": {
        "properties": {
          "total": {
            "description": "Total number of memories",
            "maximum": 9007199254740991,
            "minimum": -9007199254740991,
            "type": "integer"
          }
        },
        "required": [
          "total"
        ],
        "type": "object"
      },
      "MemoryType": {
        "description": "Memory type",
        "enum": [
          "on_this_day",
          "birthday"
        ],
        "type": "string"
      },
      "MemoryTypeV1": {
        "enum": [
          "on_this_day"
        ],
        "type": "string"
      },
      "MemoryUpdateDto": {
        "properties": {
          "isSaved": {
            "description": "Is memory saved",
            "type": "boolean"
          },
          "memoryAt": {
            "description": "Memory date",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string"
          },
          "seenAt": {
            "description": "Date when memory was seen",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string"
          }
        },
        "type": "object"
      },
      "MergePersonDto": {
        "properties": {
          "ids": {
            "description": "Person IDs to merge",
            "items": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            },
            "type": "array"
          }
        },
        "required": [
          "ids"
        ],
        "type": "object"
      },
      "MetadataSearchDto": {
        "properties": {
          "albumIds": {
            "deprecated": true,
            "description": "Filter by album IDs",
            "items": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            },
            "type": "array",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "checksum": {
            "deprecated": true,
            "description": "Filter by file checksum",
            "type": "string",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "city": {
            "deprecated": true,
            "description": "Filter by city name",
            "nullable": true,
            "type": "string",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "country": {
            "deprecated": true,
            "description": "Filter by country name",
            "nullable": true,
            "type": "string",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "createdAfter": {
            "deprecated": true,
            "description": "Filter by creation date (after)",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "createdBefore": {
            "deprecated": true,
            "description": "Filter by creation date (before)",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "cursor": {
            "description": "Cursor for the next page of results",
            "minLength": 1,
            "type": "string",
            "x-immich-history": [
              {
                "version": "v3.2.0",
                "state": "Added"
              }
            ]
          },
          "description": {
            "deprecated": true,
            "description": "Filter by description text",
            "type": "string",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "encodedVideoPath": {
            "deprecated": true,
            "description": "Filter by encoded video file path",
            "type": "string",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "filter": {
            "$ref": "#/components/schemas/SearchFilter",
            "x-immich-history": [
              {
                "version": "v3.2.0",
                "state": "Added"
              }
            ]
          },
          "id": {
            "deprecated": true,
            "description": "Filter by asset ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "isEncoded": {
            "deprecated": true,
            "description": "Filter by encoded status",
            "type": "boolean",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "isFavorite": {
            "deprecated": true,
            "description": "Filter by favorite status",
            "type": "boolean",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "isMotion": {
            "deprecated": true,
            "description": "Filter by motion photo status",
            "type": "boolean",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "isNotInAlbum": {
            "deprecated": true,
            "description": "Filter assets not in any album",
            "type": "boolean",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "isOffline": {
            "deprecated": true,
            "description": "Filter by offline status",
            "type": "boolean",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "lensModel": {
            "deprecated": true,
            "description": "Filter by lens model",
            "nullable": true,
            "type": "string",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "libraryId": {
            "deprecated": true,
            "description": "Library ID to filter by",
            "format": "uuid",
            "nullable": true,
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "make": {
            "deprecated": true,
            "description": "Filter by camera make",
            "nullable": true,
            "type": "string",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "model": {
            "deprecated": true,
            "description": "Filter by camera model",
            "nullable": true,
            "type": "string",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "ocr": {
            "deprecated": true,
            "description": "Filter by OCR text content",
            "type": "string",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "order": {
            "$ref": "#/components/schemas/AssetOrder",
            "deprecated": true,
            "description": "Sort order",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "orderBy": {
            "$ref": "#/components/schemas/SearchOrder",
            "x-immich-history": [
              {
                "version": "v3.2.0",
                "state": "Added"
              }
            ]
          },
          "originalFileName": {
            "deprecated": true,
            "description": "Filter by original file name",
            "type": "string",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "originalPath": {
            "deprecated": true,
            "description": "Filter by original file path",
            "type": "string",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "page": {
            "deprecated": true,
            "description": "Page number",
            "maximum": 9007199254740991,
            "minimum": 1,
            "type": "integer",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "personIds": {
            "deprecated": true,
            "description": "Filter by person IDs",
            "items": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            },
            "type": "array",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "previewPath": {
            "deprecated": true,
            "description": "Filter by preview file path",
            "type": "string",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "rating": {
            "deprecated": true,
            "description": "Filter by rating [1-5], or null for unrated",
            "maximum": 5,
            "minimum": 1,
            "nullable": true,
            "type": "integer",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v2.6.0",
                "state": "Updated",
                "description": "Using -1 as a rating is deprecated and will be removed in the next major version."
              },
              {
                "version": "v3",
                "state": "Updated",
                "description": "Using -1 as a rating is no longer valid."
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "size": {
            "default": 250,
            "description": "Number of results to return",
            "maximum": 1000,
            "minimum": 1,
            "type": "integer"
          },
          "state": {
            "deprecated": true,
            "description": "Filter by state/province name",
            "nullable": true,
            "type": "string",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "tagIds": {
            "deprecated": true,
            "description": "Filter by tag IDs",
            "items": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            },
            "nullable": true,
            "type": "array",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "takenAfter": {
            "deprecated": true,
            "description": "Filter by taken date (after)",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "takenBefore": {
            "deprecated": true,
            "description": "Filter by taken date (before)",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "thumbnailPath": {
            "deprecated": true,
            "description": "Filter by thumbnail file path",
            "type": "string",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "trashedAfter": {
            "deprecated": true,
            "description": "Filter by trash date (after)",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "trashedBefore": {
            "deprecated": true,
            "description": "Filter by trash date (before)",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "type": {
            "$ref": "#/components/schemas/AssetTypeEnum",
            "deprecated": true,
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "updatedAfter": {
            "deprecated": true,
            "description": "Filter by update date (after)",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "updatedBefore": {
            "deprecated": true,
            "description": "Filter by update date (before)",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "visibility": {
            "$ref": "#/components/schemas/AssetVisibility",
            "deprecated": true,
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "withDeleted": {
            "deprecated": true,
            "description": "Include deleted assets",
            "type": "boolean",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "withExif": {
            "description": "Include EXIF data in response",
            "type": "boolean"
          },
          "withPeople": {
            "description": "Include people data in response",
            "type": "boolean"
          },
          "withStacked": {
            "description": "Include stacked assets",
            "type": "boolean"
          }
        },
        "type": "object"
      },
      "MirrorAxis": {
        "description": "Axis to mirror along",
        "enum": [
          "horizontal",
          "vertical"
        ],
        "type": "string"
      },
      "MirrorParameters": {
        "properties": {
          "axis": {
            "$ref": "#/components/schemas/MirrorAxis"
          }
        },
        "required": [
          "axis"
        ],
        "type": "object"
      },
      "NotificationCreateDto": {
        "properties": {
          "data": {
            "additionalProperties": {},
            "description": "Additional notification data",
            "type": "object"
          },
          "description": {
            "description": "Notification description",
            "nullable": true,
            "type": "string"
          },
          "level": {
            "$ref": "#/components/schemas/NotificationLevel"
          },
          "readAt": {
            "description": "Date when notification was read",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "nullable": true,
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string"
          },
          "title": {
            "description": "Notification title",
            "type": "string"
          },
          "type": {
            "$ref": "#/components/schemas/NotificationType"
          },
          "userId": {
            "description": "User ID to send notification to",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          }
        },
        "required": [
          "title",
          "userId"
        ],
        "type": "object"
      },
      "NotificationDeleteAllDto": {
        "properties": {
          "ids": {
            "description": "Notification IDs to delete",
            "items": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            },
            "minItems": 1,
            "type": "array"
          }
        },
        "required": [
          "ids"
        ],
        "type": "object"
      },
      "NotificationDto": {
        "properties": {
          "createdAt": {
            "description": "Creation date",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string"
          },
          "data": {
            "additionalProperties": {},
            "description": "Additional notification data",
            "type": "object"
          },
          "description": {
            "description": "Notification description",
            "type": "string"
          },
          "id": {
            "description": "Notification ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          },
          "level": {
            "$ref": "#/components/schemas/NotificationLevel"
          },
          "readAt": {
            "description": "Date when notification was read",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string"
          },
          "title": {
            "description": "Notification title",
            "type": "string"
          },
          "type": {
            "$ref": "#/components/schemas/NotificationType"
          }
        },
        "required": [
          "createdAt",
          "id",
          "level",
          "title",
          "type"
        ],
        "type": "object"
      },
      "NotificationLevel": {
        "description": "Notification level",
        "enum": [
          "success",
          "error",
          "warning",
          "info"
        ],
        "type": "string"
      },
      "NotificationType": {
        "description": "Notification type",
        "enum": [
          "JobFailed",
          "BackupFailed",
          "SystemMessage",
          "AlbumInvite",
          "AlbumUpdate",
          "ClusterGroupRequest",
          "Custom"
        ],
        "type": "string"
      },
      "NotificationUpdateAllDto": {
        "properties": {
          "ids": {
            "description": "Notification IDs to update",
            "items": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            },
            "minItems": 1,
            "type": "array"
          },
          "readAt": {
            "description": "Date when notifications were read",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "nullable": true,
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string"
          }
        },
        "required": [
          "ids"
        ],
        "type": "object"
      },
      "NotificationUpdateDto": {
        "properties": {
          "readAt": {
            "description": "Date when notification was read",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "nullable": true,
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string"
          }
        },
        "type": "object"
      },
      "NumberFilter": {
        "properties": {
          "eq": {
            "format": "double",
            "type": "number"
          },
          "gt": {
            "format": "double",
            "type": "number"
          },
          "gte": {
            "format": "double",
            "type": "number"
          },
          "in": {
            "items": {
              "format": "double",
              "type": "number"
            },
            "minItems": 1,
            "type": "array"
          },
          "lt": {
            "format": "double",
            "type": "number"
          },
          "lte": {
            "format": "double",
            "type": "number"
          },
          "ne": {
            "format": "double",
            "type": "number"
          },
          "notIn": {
            "items": {
              "format": "double",
              "type": "number"
            },
            "minItems": 1,
            "type": "array"
          }
        },
        "type": "object"
      },
      "NumberFilterNullable": {
        "properties": {
          "eq": {
            "format": "double",
            "nullable": true,
            "type": "number"
          },
          "gt": {
            "format": "double",
            "type": "number"
          },
          "gte": {
            "format": "double",
            "type": "number"
          },
          "in": {
            "items": {
              "format": "double",
              "type": "number"
            },
            "minItems": 1,
            "type": "array"
          },
          "lt": {
            "format": "double",
            "type": "number"
          },
          "lte": {
            "format": "double",
            "type": "number"
          },
          "ne": {
            "format": "double",
            "nullable": true,
            "type": "number"
          },
          "notIn": {
            "items": {
              "format": "double",
              "type": "number"
            },
            "minItems": 1,
            "type": "array"
          }
        },
        "type": "object"
      },
      "OAuthAuthorizeResponseDto": {
        "properties": {
          "url": {
            "description": "OAuth authorization URL",
            "type": "string"
          }
        },
        "required": [
          "url"
        ],
        "type": "object"
      },
      "OAuthBackchannelLogoutDto": {
        "properties": {
          "logout_token": {
            "description": "OAuth logout token",
            "type": "string"
          }
        },
        "required": [
          "logout_token"
        ],
        "type": "object"
      },
      "OAuthCallbackDto": {
        "properties": {
          "codeVerifier": {
            "description": "OAuth code verifier (PKCE)",
            "type": "string"
          },
          "state": {
            "description": "OAuth state parameter",
            "type": "string"
          },
          "url": {
            "description": "OAuth callback URL",
            "minLength": 1,
            "type": "string"
          }
        },
        "required": [
          "url"
        ],
        "type": "object"
      },
      "OAuthConfigDto": {
        "properties": {
          "codeChallenge": {
            "description": "OAuth code challenge (PKCE)",
            "type": "string"
          },
          "redirectUri": {
            "description": "OAuth redirect URI",
            "type": "string"
          },
          "state": {
            "description": "OAuth state parameter",
            "type": "string"
          }
        },
        "required": [
          "redirectUri"
        ],
        "type": "object"
      },
      "OAuthTokenEndpointAuthMethod": {
        "description": "OAuth token endpoint auth method",
        "enum": [
          "client_secret_post",
          "client_secret_basic"
        ],
        "type": "string"
      },
      "OnboardingDto": {
        "properties": {
          "isOnboarded": {
            "description": "Is user onboarded",
            "type": "boolean"
          }
        },
        "required": [
          "isOnboarded"
        ],
        "type": "object"
      },
      "OnboardingResponseDto": {
        "properties": {
          "isOnboarded": {
            "description": "Is user onboarded",
            "type": "boolean"
          }
        },
        "required": [
          "isOnboarded"
        ],
        "type": "object"
      },
      "OnboardingStatusResponseDto": {
        "properties": {
          "error": {
            "type": "string"
          },
          "hasBackend": {
            "type": "boolean"
          },
          "hasBackup": {
            "type": "boolean"
          },
          "hasOnboardedKey": {
            "type": "boolean"
          },
          "hasSchedule": {
            "type": "boolean"
          },
          "hasSkippedExtraConfig": {
            "type": "boolean"
          },
          "hasTelemetry": {
            "$ref": "#/components/schemas/TelemetryLevel"
          },
          "isAuthenticated": {
            "type": "boolean"
          },
          "requiresAuthentication": {
            "type": "boolean"
          },
          "status": {
            "$ref": "#/components/schemas/BootstrapStatus"
          }
        },
        "required": [
          "hasBackend",
          "hasBackup",
          "hasOnboardedKey",
          "hasSchedule",
          "hasSkippedExtraConfig",
          "hasTelemetry",
          "isAuthenticated",
          "requiresAuthentication",
          "status"
        ],
        "type": "object"
      },
      "PartnerCreateDto": {
        "properties": {
          "sharedWithId": {
            "description": "User ID to share with",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          }
        },
        "required": [
          "sharedWithId"
        ],
        "type": "object"
      },
      "PartnerDirection": {
        "description": "Partner direction",
        "enum": [
          "shared-by",
          "shared-with"
        ],
        "type": "string"
      },
      "PartnerResponseDto": {
        "description": "Partner response",
        "properties": {
          "avatarColor": {
            "$ref": "#/components/schemas/UserAvatarColor"
          },
          "email": {
            "description": "User email",
            "format": "email",
            "pattern": "^[\\p{L}\\p{M}\\p{N}.!#$%&'*+/=?^_`{|}~-]+@[\\p{L}\\p{N}](?:[\\p{L}\\p{M}\\p{N}-]{0,61}[\\p{L}\\p{M}\\p{N}])?(?:\\.[\\p{L}\\p{N}](?:[\\p{L}\\p{M}\\p{N}-]{0,61}[\\p{L}\\p{M}\\p{N}])?)*$",
            "type": "string"
          },
          "id": {
            "description": "User ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          },
          "inTimeline": {
            "description": "Show in timeline",
            "type": "boolean"
          },
          "name": {
            "description": "User name",
            "type": "string"
          },
          "profileChangedAt": {
            "description": "Profile change date",
            "format": "date-time",
            "type": "string"
          },
          "profileImagePath": {
            "description": "Profile image path",
            "type": "string"
          }
        },
        "required": [
          "avatarColor",
          "email",
          "id",
          "name",
          "profileChangedAt",
          "profileImagePath"
        ],
        "type": "object"
      },
      "PartnerUpdateDto": {
        "properties": {
          "inTimeline": {
            "description": "Show partner assets in timeline",
            "type": "boolean"
          }
        },
        "required": [
          "inTimeline"
        ],
        "type": "object"
      },
      "PasskeyAuthenticationFinishDto": {
        "properties": {
          "response": {
            "additionalProperties": {},
            "description": "Response returned by @simplewebauthn/browser's `startAuthentication()`",
            "properties": {
              "id": {
                "description": "Credential ID",
                "format": "base64url",
                "pattern": "^[A-Za-z0-9_-]*$",
                "type": "string"
              },
              "response": {
                "additionalProperties": {},
                "properties": {
                  "userHandle": {
                    "description": "User handle",
                    "format": "base64url",
                    "pattern": "^[A-Za-z0-9_-]*$",
                    "type": "string"
                  }
                },
                "type": "object"
              }
            },
            "required": [
              "id",
              "response"
            ],
            "type": "object"
          }
        },
        "required": [
          "response"
        ],
        "type": "object"
      },
      "PasskeyAuthenticationOptionsDto": {
        "additionalProperties": {},
        "description": "Response returned by @simplewebauthn/server's `generateAuthenticationOptions`",
        "type": "object"
      },
      "PasskeyRegistrationFinishDto": {
        "properties": {
          "name": {
            "description": "Passkey name",
            "type": "string"
          },
          "response": {
            "description": "Response returned by @simplewebauthn/browser's `startAuthentication()`"
          }
        },
        "required": [
          "response"
        ],
        "type": "object"
      },
      "PasskeyRegistrationOptionsDto": {
        "additionalProperties": {},
        "description": "Response returned by @simplewebauthn/server's `generateRegistrationOptions`",
        "type": "object"
      },
      "PasskeyResponseDto": {
        "properties": {
          "createdAt": {
            "description": "Creation date",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string"
          },
          "id": {
            "description": "Passkey ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          },
          "name": {
            "description": "Passkey name",
            "nullable": true,
            "type": "string"
          },
          "updatedAt": {
            "description": "Last update date",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string"
          },
          "usedAt": {
            "description": "Last used date",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "nullable": true,
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string"
          }
        },
        "required": [
          "createdAt",
          "id",
          "name",
          "updatedAt",
          "usedAt"
        ],
        "type": "object"
      },
      "PasskeyUpdateDto": {
        "properties": {
          "name": {
            "description": "Passkey name",
            "minLength": 1,
            "nullable": true,
            "type": "string"
          }
        },
        "required": [
          "name"
        ],
        "type": "object"
      },
      "PeopleDeleteDto": {
        "properties": {
          "ids": {
            "description": "IDs to process",
            "items": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            },
            "type": "array"
          },
          "userId": {
            "type": "string"
          }
        },
        "required": [
          "ids"
        ],
        "type": "object",
        "x-immich-history": [
          {
            "version": "v3.3",
            "state": "Added"
          }
        ]
      },
      "PeopleResponse": {
        "properties": {
          "enabled": {
            "description": "Whether people are enabled",
            "type": "boolean"
          },
          "minimumFaces": {
            "description": "People face threshold",
            "maximum": 9007199254740991,
            "minimum": 1,
            "type": "integer"
          },
          "sidebarWeb": {
            "description": "Whether people appear in web sidebar",
            "type": "boolean"
          },
          "updateStrategy": {
            "$ref": "#/components/schemas/PersonUpdateStrategy"
          }
        },
        "required": [
          "enabled",
          "sidebarWeb",
          "updateStrategy"
        ],
        "type": "object"
      },
      "PeopleResponseDto": {
        "description": "People response",
        "properties": {
          "hasNextPage": {
            "description": "Whether there are more pages",
            "type": "boolean",
            "x-immich-history": [
              {
                "version": "v1.110.0",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              }
            ],
            "x-immich-state": "Stable"
          },
          "hidden": {
            "description": "Number of hidden people",
            "maximum": 9007199254740991,
            "minimum": 0,
            "type": "integer"
          },
          "people": {
            "items": {
              "$ref": "#/components/schemas/PersonResponseDto"
            },
            "type": "array"
          },
          "total": {
            "description": "Total number of people",
            "maximum": 9007199254740991,
            "minimum": 0,
            "type": "integer"
          }
        },
        "required": [
          "hidden",
          "people",
          "total"
        ],
        "type": "object"
      },
      "PeopleUpdate": {
        "properties": {
          "enabled": {
            "description": "Whether people are enabled",
            "type": "boolean"
          },
          "minimumFaces": {
            "description": "People face threshold",
            "maximum": 9007199254740991,
            "minimum": 1,
            "type": "integer"
          },
          "sidebarWeb": {
            "description": "Whether people appear in web sidebar",
            "type": "boolean"
          },
          "updateStrategy": {
            "$ref": "#/components/schemas/PersonUpdateStrategy"
          }
        },
        "type": "object"
      },
      "PeopleUpdateDto": {
        "properties": {
          "people": {
            "description": "People to update",
            "items": {
              "$ref": "#/components/schemas/PeopleUpdateItem"
            },
            "type": "array"
          }
        },
        "required": [
          "people"
        ],
        "type": "object"
      },
      "PeopleUpdateItem": {
        "properties": {
          "birthDate": {
            "description": "Person date of birth",
            "format": "date",
            "nullable": true,
            "type": "string"
          },
          "color": {
            "description": "Person color (hex)",
            "nullable": true,
            "pattern": "^#?([0-9A-Fa-f]{3}|[0-9A-Fa-f]{4}|[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$",
            "type": "string"
          },
          "featureFaceAssetId": {
            "description": "Asset ID used for feature face thumbnail",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          },
          "id": {
            "description": "Person ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          },
          "isFavorite": {
            "description": "Mark as favorite",
            "type": "boolean"
          },
          "isHidden": {
            "description": "Person visibility (hidden)",
            "type": "boolean"
          },
          "name": {
            "description": "Person name",
            "type": "string"
          },
          "userId": {
            "description": "Restrict the update to the person record of this User ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
            "type": "string"
          }
        },
        "required": [
          "id"
        ],
        "type": "object"
      },
      "PeopleUserResponseDto": {
        "properties": {
          "avatarColor": {
            "$ref": "#/components/schemas/UserAvatarColor"
          },
          "email": {
            "description": "User email",
            "format": "email",
            "pattern": "^[\\p{L}\\p{M}\\p{N}.!#$%&'*+/=?^_`{|}~-]+@[\\p{L}\\p{N}](?:[\\p{L}\\p{M}\\p{N}-]{0,61}[\\p{L}\\p{M}\\p{N}])?(?:\\.[\\p{L}\\p{N}](?:[\\p{L}\\p{M}\\p{N}-]{0,61}[\\p{L}\\p{M}\\p{N}])?)*$",
            "type": "string"
          },
          "id": {
            "description": "User ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          },
          "name": {
            "description": "User name",
            "type": "string"
          },
          "profileChangedAt": {
            "description": "Profile change date",
            "format": "date-time",
            "type": "string"
          },
          "profileImagePath": {
            "description": "Profile image path",
            "type": "string"
          },
          "role": {
            "$ref": "#/components/schemas/PersonUserRole",
            "description": "Access role"
          }
        },
        "required": [
          "avatarColor",
          "email",
          "id",
          "name",
          "profileChangedAt",
          "profileImagePath",
          "role"
        ],
        "type": "object"
      },
      "PeopleUsersUpsertDto": {
        "properties": {
          "personIds": {
            "description": "Person IDs, required when type is omitted",
            "items": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
              "type": "string"
            },
            "type": "array"
          },
          "role": {
            "$ref": "#/components/schemas/PersonUserRole",
            "description": "Role that should be applied"
          },
          "sharedWithIds": {
            "description": "User IDs that should be given access to the person",
            "items": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
              "type": "string"
            },
            "type": "array"
          },
          "type": {
            "$ref": "#/components/schemas/PeopleUsersUpsertType"
          }
        },
        "required": [
          "role",
          "sharedWithIds"
        ],
        "type": "object"
      },
      "PeopleUsersUpsertType": {
        "description": "Which people to update when personIds is omitted",
        "enum": [
          "everyone"
        ],
        "type": "string"
      },
      "Permission": {
        "description": "List of permissions",
        "enum": [
          "all",
          "activity.create",
          "activity.read",
          "activity.update",
          "activity.delete",
          "activity.statistics",
          "apiKey.create",
          "apiKey.read",
          "apiKey.update",
          "apiKey.delete",
          "apiKey.rotate",
          "asset.read",
          "asset.update",
          "asset.delete",
          "asset.statistics",
          "asset.share",
          "asset.view",
          "asset.download",
          "asset.upload",
          "asset.copy",
          "asset.derive",
          "assetFile.read",
          "assetFile.delete",
          "assetFile.download",
          "asset.edit.get",
          "asset.edit.create",
          "asset.edit.delete",
          "album.create",
          "album.read",
          "album.update",
          "album.delete",
          "album.statistics",
          "album.share",
          "album.download",
          "albumAsset.create",
          "albumAsset.delete",
          "albumUser.create",
          "albumUser.update",
          "albumUser.delete",
          "auth.changePassword",
          "authDevice.delete",
          "archive.read",
          "backup.list",
          "backup.download",
          "backup.upload",
          "backup.delete",
          "clusterGroup.read",
          "clusterGroup.leave",
          "clusterGroup.admin",
          "clusterGroupRequest.create",
          "clusterGroupRequest.read",
          "clusterGroupRequest.delete",
          "adminConfig.read",
          "adminConfig.update",
          "userConfig.read",
          "duplicate.read",
          "duplicate.delete",
          "face.create",
          "face.read",
          "face.update",
          "face.delete",
          "folder.read",
          "job.create",
          "job.read",
          "library.create",
          "library.read",
          "library.update",
          "library.delete",
          "library.statistics",
          "timeline.read",
          "timeline.download",
          "maintenance",
          "map.read",
          "map.search",
          "memory.create",
          "memory.read",
          "memory.update",
          "memory.delete",
          "memory.statistics",
          "memoryAsset.create",
          "memoryAsset.delete",
          "notification.create",
          "notification.read",
          "notification.update",
          "notification.delete",
          "partner.create",
          "partner.read",
          "partner.update",
          "partner.delete",
          "passkey.read",
          "passkey.update",
          "passkey.delete",
          "person.create",
          "person.read",
          "person.update",
          "person.delete",
          "person.statistics",
          "person.merge",
          "person.reassign",
          "pinCode.create",
          "pinCode.update",
          "pinCode.delete",
          "plugin.create",
          "plugin.read",
          "plugin.update",
          "plugin.delete",
          "server.about",
          "server.apkLinks",
          "server.storage",
          "server.statistics",
          "server.versionCheck",
          "serverLicense.read",
          "serverLicense.update",
          "serverLicense.delete",
          "session.create",
          "session.read",
          "session.update",
          "session.delete",
          "session.lock",
          "sharedLink.create",
          "sharedLink.read",
          "sharedLink.update",
          "sharedLink.delete",
          "stack.create",
          "stack.read",
          "stack.update",
          "stack.delete",
          "sync.stream",
          "syncCheckpoint.read",
          "syncCheckpoint.update",
          "syncCheckpoint.delete",
          "systemConfig.read",
          "systemConfig.update",
          "systemMetadata.read",
          "systemMetadata.update",
          "tag.create",
          "tag.read",
          "tag.update",
          "tag.delete",
          "tag.asset",
          "user.read",
          "user.update",
          "userLicense.create",
          "userLicense.read",
          "userLicense.update",
          "userLicense.delete",
          "userOnboarding.read",
          "userOnboarding.update",
          "userOnboarding.delete",
          "userPreference.read",
          "userPreference.update",
          "userProfileImage.create",
          "userProfileImage.read",
          "userProfileImage.update",
          "userProfileImage.delete",
          "queue.read",
          "queue.update",
          "queueJob.create",
          "queueJob.read",
          "queueJob.update",
          "queueJob.delete",
          "workflow.create",
          "workflow.read",
          "workflow.update",
          "workflow.delete",
          "workflow.logs",
          "adminUser.create",
          "adminUser.read",
          "adminUser.update",
          "adminUser.delete",
          "adminSession.read",
          "adminAuth.unlinkAll"
        ],
        "type": "string"
      },
      "PersonCreateDto": {
        "properties": {
          "birthDate": {
            "description": "Person date of birth",
            "format": "date",
            "nullable": true,
            "type": "string"
          },
          "color": {
            "description": "Person color (hex)",
            "nullable": true,
            "pattern": "^#?([0-9A-Fa-f]{3}|[0-9A-Fa-f]{4}|[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$",
            "type": "string"
          },
          "isFavorite": {
            "description": "Mark as favorite",
            "type": "boolean"
          },
          "isHidden": {
            "description": "Person visibility (hidden)",
            "type": "boolean"
          },
          "name": {
            "description": "Person name",
            "type": "string"
          }
        },
        "type": "object"
      },
      "PersonDeleteDto": {
        "default": {},
        "properties": {
          "userId": {
            "type": "string"
          }
        },
        "type": "object",
        "x-immich-history": [
          {
            "version": "v3.3",
            "state": "Added"
          },
          {
            "version": "v3.3",
            "state": "Stable"
          }
        ],
        "x-immich-state": "Stable"
      },
      "PersonOtherResponseDto": {
        "properties": {
          "birthDate": {
            "nullable": true,
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "role": {
            "$ref": "#/components/schemas/PersonUserRole"
          },
          "sharedById": {
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
            "type": "string"
          }
        },
        "required": [
          "birthDate",
          "name",
          "role",
          "sharedById"
        ],
        "type": "object"
      },
      "PersonResponseDto": {
        "properties": {
          "birthDate": {
            "description": "Person date of birth",
            "format": "date",
            "nullable": true,
            "type": "string"
          },
          "color": {
            "description": "Person color (hex)",
            "type": "string",
            "x-immich-history": [
              {
                "version": "v1.126.0",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              }
            ],
            "x-immich-state": "Stable"
          },
          "id": {
            "description": "Person ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          },
          "isFavorite": {
            "description": "Is favorite",
            "type": "boolean",
            "x-immich-history": [
              {
                "version": "v1.126.0",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              }
            ],
            "x-immich-state": "Stable"
          },
          "isHidden": {
            "description": "Is hidden",
            "type": "boolean"
          },
          "name": {
            "description": "Person name",
            "type": "string"
          },
          "otherPeople": {
            "items": {
              "$ref": "#/components/schemas/PersonOtherResponseDto"
            },
            "type": "array"
          },
          "sharedBy": {
            "description": "Users that gave the current user access to this person",
            "items": {
              "$ref": "#/components/schemas/PeopleUserResponseDto"
            },
            "type": "array"
          },
          "sharedWith": {
            "description": "Users the current user gave access to this person",
            "items": {
              "$ref": "#/components/schemas/PeopleUserResponseDto"
            },
            "type": "array"
          },
          "thumbnailPath": {
            "description": "Thumbnail path",
            "type": "string"
          },
          "updatedAt": {
            "description": "Last update date",
            "format": "date-time",
            "type": "string",
            "x-immich-history": [
              {
                "version": "v1.107.0",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              }
            ],
            "x-immich-state": "Stable"
          }
        },
        "required": [
          "birthDate",
          "id",
          "isHidden",
          "name",
          "otherPeople",
          "sharedBy",
          "sharedWith",
          "thumbnailPath"
        ],
        "type": "object"
      },
      "PersonStatisticsResponseDto": {
        "properties": {
          "assets": {
            "description": "Number of assets",
            "maximum": 9007199254740991,
            "minimum": -9007199254740991,
            "type": "integer"
          }
        },
        "required": [
          "assets"
        ],
        "type": "object"
      },
      "PersonUpdateDto": {
        "properties": {
          "birthDate": {
            "description": "Person date of birth",
            "format": "date",
            "nullable": true,
            "type": "string"
          },
          "color": {
            "description": "Person color (hex)",
            "nullable": true,
            "pattern": "^#?([0-9A-Fa-f]{3}|[0-9A-Fa-f]{4}|[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$",
            "type": "string"
          },
          "featureFaceAssetId": {
            "description": "Asset ID used for feature face thumbnail",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          },
          "isFavorite": {
            "description": "Mark as favorite",
            "type": "boolean"
          },
          "isHidden": {
            "description": "Person visibility (hidden)",
            "type": "boolean"
          },
          "name": {
            "description": "Person name",
            "type": "string"
          },
          "userId": {
            "description": "Restrict the update to the person record of this User ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
            "type": "string"
          }
        },
        "type": "object"
      },
      "PersonUpdateStrategy": {
        "description": "Which person records to update when editing a person",
        "enum": [
          "self",
          "everyone"
        ],
        "type": "string"
      },
      "PersonUserRole": {
        "description": "Levels of access for managing people resources on behalf of another user.",
        "enum": [
          "read",
          "write",
          "admin"
        ],
        "type": "string"
      },
      "PersonUsersDeleteDto": {
        "items": {
          "properties": {
            "personId": {
              "description": "Person ID",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
              "type": "string"
            },
            "sharedById": {
              "description": "User ID of the user that gave access to the person",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
              "type": "string"
            },
            "sharedWithId": {
              "description": "User ID of the user that was given access to the person",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
              "type": "string"
            }
          },
          "required": [
            "personId",
            "sharedWithId"
          ],
          "type": "object"
        },
        "type": "array"
      },
      "PersonUsersResponseDto": {
        "items": {
          "properties": {
            "personId": {
              "description": "Person ID",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
              "type": "string"
            },
            "role": {
              "$ref": "#/components/schemas/PersonUserRole",
              "description": "Access role"
            },
            "sharedBy": {
              "$ref": "#/components/schemas/UserResponseDto",
              "description": "The user that gave access to this person"
            },
            "sharedById": {
              "description": "User ID of the user that gave access to this person",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
              "type": "string"
            },
            "sharedWith": {
              "$ref": "#/components/schemas/UserResponseDto",
              "description": "The user that was given access to this person"
            },
            "sharedWithId": {
              "description": "User ID of the user that was given access to this person",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
              "type": "string"
            }
          },
          "required": [
            "personId",
            "sharedById",
            "sharedWithId",
            "sharedBy",
            "sharedWith",
            "role"
          ],
          "type": "object"
        },
        "type": "array"
      },
      "PinCodeChangeDto": {
        "properties": {
          "newPinCode": {
            "description": "New PIN code (4-6 digits)",
            "pattern": "^\\d{6}$",
            "type": "string"
          },
          "password": {
            "description": "User password (required if PIN code is not provided)",
            "example": "password",
            "type": "string"
          },
          "pinCode": {
            "description": "New PIN code (4-6 digits)",
            "example": "123456",
            "pattern": "^\\d{6}$",
            "type": "string"
          }
        },
        "required": [
          "newPinCode"
        ],
        "type": "object"
      },
      "PinCodeResetDto": {
        "properties": {
          "password": {
            "description": "User password (required if PIN code is not provided)",
            "example": "password",
            "type": "string"
          },
          "pinCode": {
            "description": "New PIN code (4-6 digits)",
            "example": "123456",
            "pattern": "^\\d{6}$",
            "type": "string"
          }
        },
        "type": "object"
      },
      "PinCodeSetupDto": {
        "properties": {
          "pinCode": {
            "description": "PIN code (4-6 digits)",
            "example": "123456",
            "pattern": "^\\d{6}$",
            "type": "string"
          }
        },
        "required": [
          "pinCode"
        ],
        "type": "object"
      },
      "PlacesResponseDto": {
        "properties": {
          "admin1name": {
            "description": "Administrative level 1 name (state/province)",
            "type": "string"
          },
          "admin2name": {
            "description": "Administrative level 2 name (county/district)",
            "type": "string"
          },
          "latitude": {
            "description": "Latitude coordinate",
            "format": "double",
            "type": "number"
          },
          "longitude": {
            "description": "Longitude coordinate",
            "format": "double",
            "type": "number"
          },
          "name": {
            "description": "Place name",
            "type": "string"
          }
        },
        "required": [
          "latitude",
          "longitude",
          "name"
        ],
        "type": "object"
      },
      "PluginMethodResponseDto": {
        "properties": {
          "description": {
            "description": "Description",
            "type": "string"
          },
          "hostFunctions": {
            "type": "boolean"
          },
          "key": {
            "description": "Key",
            "type": "string"
          },
          "name": {
            "description": "Name",
            "type": "string"
          },
          "schema": {
            "properties": {},
            "type": "object"
          },
          "title": {
            "description": "Title",
            "type": "string"
          },
          "types": {
            "description": "Workflow types",
            "items": {
              "$ref": "#/components/schemas/WorkflowType"
            },
            "type": "array"
          },
          "uiHints": {
            "description": "Ui hints",
            "items": {
              "type": "string"
            },
            "type": "array"
          }
        },
        "required": [
          "description",
          "hostFunctions",
          "key",
          "name",
          "title",
          "types",
          "uiHints"
        ],
        "type": "object"
      },
      "PluginResponseDto": {
        "properties": {
          "author": {
            "description": "Plugin author",
            "type": "string"
          },
          "createdAt": {
            "description": "Creation date",
            "type": "string"
          },
          "description": {
            "description": "Plugin description",
            "type": "string"
          },
          "id": {
            "description": "Plugin ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          },
          "methods": {
            "description": "Plugin methods",
            "items": {
              "$ref": "#/components/schemas/PluginMethodResponseDto"
            },
            "type": "array"
          },
          "name": {
            "description": "Plugin name",
            "type": "string"
          },
          "title": {
            "description": "Plugin title",
            "type": "string"
          },
          "updatedAt": {
            "description": "Last update date",
            "type": "string"
          },
          "version": {
            "description": "Plugin version",
            "type": "string"
          }
        },
        "required": [
          "author",
          "createdAt",
          "description",
          "id",
          "methods",
          "name",
          "title",
          "updatedAt",
          "version"
        ],
        "type": "object"
      },
      "PluginTemplateResponseDto": {
        "properties": {
          "description": {
            "description": "Template description",
            "type": "string"
          },
          "key": {
            "description": "Template key (unique across all templates)",
            "type": "string"
          },
          "steps": {
            "description": "Workflow steps",
            "items": {
              "$ref": "#/components/schemas/PluginTemplateStepResponseDto"
            },
            "type": "array"
          },
          "title": {
            "description": "Template title",
            "type": "string"
          },
          "trigger": {
            "$ref": "#/components/schemas/WorkflowTrigger",
            "description": "Workflow trigger"
          },
          "uiHints": {
            "description": "Ui hints, for example \"smart-album\"",
            "items": {
              "type": "string"
            },
            "type": "array"
          }
        },
        "required": [
          "description",
          "key",
          "steps",
          "title",
          "trigger",
          "uiHints"
        ],
        "type": "object"
      },
      "PluginTemplateStepResponseDto": {
        "properties": {
          "config": {
            "additionalProperties": {},
            "description": "Step configuration",
            "nullable": true,
            "type": "object"
          },
          "enabled": {
            "description": "Whether the step is enabled",
            "type": "boolean"
          },
          "method": {
            "description": "Step plugin method",
            "type": "string"
          }
        },
        "required": [
          "config",
          "method"
        ],
        "type": "object"
      },
      "PublicConfigDto": {
        "description": "Configuration properties that are visible to everyone",
        "properties": {
          "ffmpeg": {
            "$ref": "#/components/schemas/PublicConfigFFmpegDto"
          },
          "map": {
            "$ref": "#/components/schemas/PublicConfigMapDto"
          },
          "oauth": {
            "$ref": "#/components/schemas/PublicConfigOAuthDto"
          },
          "passkey": {
            "$ref": "#/components/schemas/PublicConfigPasskeyDto"
          },
          "passwordLogin": {
            "$ref": "#/components/schemas/PublicConfigPasswordLoginDto"
          },
          "server": {
            "$ref": "#/components/schemas/PublicConfigServerDto"
          }
        },
        "required": [
          "ffmpeg",
          "map",
          "oauth",
          "passkey",
          "passwordLogin",
          "server"
        ],
        "type": "object"
      },
      "PublicConfigFFmpegDto": {
        "properties": {
          "realtime": {
            "$ref": "#/components/schemas/PublicConfigFFmpegRealtimeDto"
          }
        },
        "required": [
          "realtime"
        ],
        "type": "object"
      },
      "PublicConfigFFmpegRealtimeDto": {
        "properties": {
          "enabled": {
            "description": "Enable real-time HLS transcoding (alpha)",
            "type": "boolean"
          }
        },
        "required": [
          "enabled"
        ],
        "type": "object"
      },
      "PublicConfigMapDto": {
        "properties": {
          "darkStyle": {
            "description": "Dark map style URL",
            "format": "uri",
            "type": "string"
          },
          "enabled": {
            "description": "Enabled",
            "type": "boolean"
          },
          "lightStyle": {
            "description": "Light map style URL",
            "format": "uri",
            "type": "string"
          }
        },
        "required": [
          "darkStyle",
          "enabled",
          "lightStyle"
        ],
        "type": "object"
      },
      "PublicConfigOAuthDto": {
        "properties": {
          "autoLaunch": {
            "description": "Auto launch",
            "type": "boolean"
          },
          "buttonText": {
            "description": "Button text",
            "type": "string"
          },
          "enabled": {
            "description": "Enabled",
            "type": "boolean"
          }
        },
        "required": [
          "autoLaunch",
          "buttonText",
          "enabled"
        ],
        "type": "object"
      },
      "PublicConfigPasskeyDto": {
        "properties": {
          "enabled": {
            "description": "Enabled",
            "type": "boolean"
          }
        },
        "required": [
          "enabled"
        ],
        "type": "object"
      },
      "PublicConfigPasswordLoginDto": {
        "properties": {
          "enabled": {
            "description": "Enabled",
            "type": "boolean"
          }
        },
        "required": [
          "enabled"
        ],
        "type": "object"
      },
      "PublicConfigServerDto": {
        "properties": {
          "loginPageMessage": {
            "description": "Login page message",
            "type": "string"
          }
        },
        "required": [
          "loginPageMessage"
        ],
        "type": "object"
      },
      "PurchaseResponse": {
        "properties": {
          "hideBuyButtonUntil": {
            "description": "Date until which to hide buy button",
            "type": "string"
          },
          "showSupportBadge": {
            "description": "Whether to show support badge",
            "type": "boolean"
          }
        },
        "required": [
          "hideBuyButtonUntil",
          "showSupportBadge"
        ],
        "type": "object"
      },
      "PurchaseUpdate": {
        "properties": {
          "hideBuyButtonUntil": {
            "description": "Date until which to hide buy button",
            "type": "string"
          },
          "showSupportBadge": {
            "description": "Whether to show support badge",
            "type": "boolean"
          }
        },
        "type": "object"
      },
      "QueueCommand": {
        "description": "Queue command to execute",
        "enum": [
          "start",
          "pause",
          "resume",
          "empty",
          "clear-failed"
        ],
        "type": "string"
      },
      "QueueCommandDto": {
        "properties": {
          "command": {
            "$ref": "#/components/schemas/QueueCommand"
          },
          "force": {
            "description": "Force the command execution (if applicable)",
            "type": "boolean"
          }
        },
        "required": [
          "command"
        ],
        "type": "object"
      },
      "QueueDeleteDto": {
        "properties": {
          "failed": {
            "description": "If true, will also remove failed jobs from the queue.",
            "type": "boolean",
            "x-immich-history": [
              {
                "version": "v2.4.0",
                "state": "Added"
              },
              {
                "version": "v2.4.0",
                "state": "Alpha"
              }
            ],
            "x-immich-state": "Alpha"
          }
        },
        "type": "object"
      },
      "QueueJobResponseDto": {
        "properties": {
          "data": {
            "additionalProperties": {},
            "description": "Job data payload",
            "type": "object"
          },
          "id": {
            "description": "Job ID",
            "type": "string"
          },
          "name": {
            "$ref": "#/components/schemas/JobName"
          },
          "timestamp": {
            "description": "Job creation timestamp",
            "maximum": 9007199254740991,
            "minimum": -9007199254740991,
            "type": "integer"
          }
        },
        "required": [
          "data",
          "name",
          "timestamp"
        ],
        "type": "object"
      },
      "QueueJobStatus": {
        "description": "Queue job status",
        "enum": [
          "active",
          "failed",
          "completed",
          "delayed",
          "waiting"
        ],
        "type": "string"
      },
      "QueueName": {
        "description": "Queue name",
        "enum": [
          "thumbnailGeneration",
          "metadataExtraction",
          "videoConversion",
          "faceDetection",
          "facialRecognition",
          "smartSearch",
          "duplicateDetection",
          "backgroundTask",
          "storageTemplateMigration",
          "migration",
          "search",
          "sidecar",
          "library",
          "notifications",
          "backupDatabase",
          "ocr",
          "workflow",
          "integrityCheck",
          "editor"
        ],
        "type": "string"
      },
      "QueueResponseDto": {
        "properties": {
          "isPaused": {
            "description": "Whether the queue is paused",
            "type": "boolean"
          },
          "name": {
            "$ref": "#/components/schemas/QueueName"
          },
          "statistics": {
            "$ref": "#/components/schemas/QueueStatisticsDto"
          }
        },
        "required": [
          "isPaused",
          "name",
          "statistics"
        ],
        "type": "object"
      },
      "QueueResponseLegacyDto": {
        "properties": {
          "jobCounts": {
            "$ref": "#/components/schemas/QueueStatisticsDto"
          },
          "queueStatus": {
            "$ref": "#/components/schemas/QueueStatusLegacyDto"
          }
        },
        "required": [
          "jobCounts",
          "queueStatus"
        ],
        "type": "object"
      },
      "QueueStatisticsDto": {
        "properties": {
          "active": {
            "description": "Number of active jobs",
            "maximum": 9007199254740991,
            "minimum": -9007199254740991,
            "type": "integer"
          },
          "completed": {
            "description": "Number of completed jobs",
            "maximum": 9007199254740991,
            "minimum": -9007199254740991,
            "type": "integer"
          },
          "delayed": {
            "description": "Number of delayed jobs",
            "maximum": 9007199254740991,
            "minimum": -9007199254740991,
            "type": "integer"
          },
          "failed": {
            "description": "Number of failed jobs",
            "maximum": 9007199254740991,
            "minimum": -9007199254740991,
            "type": "integer"
          },
          "paused": {
            "description": "Number of paused jobs",
            "maximum": 9007199254740991,
            "minimum": -9007199254740991,
            "type": "integer",
            "x-immich-history": [
              {
                "version": "v2.0.0",
                "state": "Added"
              },
              {
                "version": "v4.0.0",
                "state": "Updated",
                "description": "A paused queue will now also shows its job as `waiting`"
              },
              {
                "version": "v4.0.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "waiting": {
            "description": "Number of waiting jobs",
            "maximum": 9007199254740991,
            "minimum": -9007199254740991,
            "type": "integer"
          }
        },
        "required": [
          "active",
          "completed",
          "delayed",
          "failed",
          "paused",
          "waiting"
        ],
        "type": "object"
      },
      "QueueStatusLegacyDto": {
        "properties": {
          "isActive": {
            "description": "Whether the queue is currently active (has running jobs)",
            "type": "boolean"
          },
          "isPaused": {
            "description": "Whether the queue is paused",
            "type": "boolean"
          }
        },
        "required": [
          "isActive",
          "isPaused"
        ],
        "type": "object"
      },
      "QueueUpdateDto": {
        "properties": {
          "isPaused": {
            "description": "Whether to pause the queue",
            "type": "boolean"
          }
        },
        "type": "object"
      },
      "QueuesResponseLegacyDto": {
        "properties": {
          "backgroundTask": {
            "$ref": "#/components/schemas/QueueResponseLegacyDto"
          },
          "backupDatabase": {
            "$ref": "#/components/schemas/QueueResponseLegacyDto"
          },
          "duplicateDetection": {
            "$ref": "#/components/schemas/QueueResponseLegacyDto"
          },
          "editor": {
            "$ref": "#/components/schemas/QueueResponseLegacyDto"
          },
          "faceDetection": {
            "$ref": "#/components/schemas/QueueResponseLegacyDto"
          },
          "facialRecognition": {
            "$ref": "#/components/schemas/QueueResponseLegacyDto"
          },
          "integrityCheck": {
            "$ref": "#/components/schemas/QueueResponseLegacyDto"
          },
          "library": {
            "$ref": "#/components/schemas/QueueResponseLegacyDto"
          },
          "metadataExtraction": {
            "$ref": "#/components/schemas/QueueResponseLegacyDto"
          },
          "migration": {
            "$ref": "#/components/schemas/QueueResponseLegacyDto"
          },
          "notifications": {
            "$ref": "#/components/schemas/QueueResponseLegacyDto"
          },
          "ocr": {
            "$ref": "#/components/schemas/QueueResponseLegacyDto"
          },
          "search": {
            "$ref": "#/components/schemas/QueueResponseLegacyDto"
          },
          "sidecar": {
            "$ref": "#/components/schemas/QueueResponseLegacyDto"
          },
          "smartSearch": {
            "$ref": "#/components/schemas/QueueResponseLegacyDto"
          },
          "storageTemplateMigration": {
            "$ref": "#/components/schemas/QueueResponseLegacyDto"
          },
          "thumbnailGeneration": {
            "$ref": "#/components/schemas/QueueResponseLegacyDto"
          },
          "videoConversion": {
            "$ref": "#/components/schemas/QueueResponseLegacyDto"
          },
          "workflow": {
            "$ref": "#/components/schemas/QueueResponseLegacyDto"
          }
        },
        "required": [
          "backgroundTask",
          "backupDatabase",
          "duplicateDetection",
          "editor",
          "faceDetection",
          "facialRecognition",
          "integrityCheck",
          "library",
          "metadataExtraction",
          "migration",
          "notifications",
          "ocr",
          "search",
          "sidecar",
          "smartSearch",
          "storageTemplateMigration",
          "thumbnailGeneration",
          "videoConversion",
          "workflow"
        ],
        "type": "object"
      },
      "RandomSearchDto": {
        "properties": {
          "albumIds": {
            "deprecated": true,
            "description": "Filter by album IDs",
            "items": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            },
            "type": "array",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "city": {
            "deprecated": true,
            "description": "Filter by city name",
            "nullable": true,
            "type": "string",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "country": {
            "deprecated": true,
            "description": "Filter by country name",
            "nullable": true,
            "type": "string",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "createdAfter": {
            "deprecated": true,
            "description": "Filter by creation date (after)",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "createdBefore": {
            "deprecated": true,
            "description": "Filter by creation date (before)",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "filter": {
            "$ref": "#/components/schemas/SearchFilter",
            "x-immich-history": [
              {
                "version": "v3.2.0",
                "state": "Added"
              }
            ]
          },
          "isEncoded": {
            "deprecated": true,
            "description": "Filter by encoded status",
            "type": "boolean",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "isFavorite": {
            "deprecated": true,
            "description": "Filter by favorite status",
            "type": "boolean",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "isMotion": {
            "deprecated": true,
            "description": "Filter by motion photo status",
            "type": "boolean",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "isNotInAlbum": {
            "deprecated": true,
            "description": "Filter assets not in any album",
            "type": "boolean",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "isOffline": {
            "deprecated": true,
            "description": "Filter by offline status",
            "type": "boolean",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "lensModel": {
            "deprecated": true,
            "description": "Filter by lens model",
            "nullable": true,
            "type": "string",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "libraryId": {
            "deprecated": true,
            "description": "Library ID to filter by",
            "format": "uuid",
            "nullable": true,
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "make": {
            "deprecated": true,
            "description": "Filter by camera make",
            "nullable": true,
            "type": "string",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "model": {
            "deprecated": true,
            "description": "Filter by camera model",
            "nullable": true,
            "type": "string",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "ocr": {
            "deprecated": true,
            "description": "Filter by OCR text content",
            "type": "string",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "personIds": {
            "deprecated": true,
            "description": "Filter by person IDs",
            "items": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            },
            "type": "array",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "rating": {
            "deprecated": true,
            "description": "Filter by rating [1-5], or null for unrated",
            "maximum": 5,
            "minimum": 1,
            "nullable": true,
            "type": "integer",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v2.6.0",
                "state": "Updated",
                "description": "Using -1 as a rating is deprecated and will be removed in the next major version."
              },
              {
                "version": "v3",
                "state": "Updated",
                "description": "Using -1 as a rating is no longer valid."
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "size": {
            "default": 250,
            "description": "Number of results to return",
            "maximum": 1000,
            "minimum": 1,
            "type": "integer"
          },
          "state": {
            "deprecated": true,
            "description": "Filter by state/province name",
            "nullable": true,
            "type": "string",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "tagIds": {
            "deprecated": true,
            "description": "Filter by tag IDs",
            "items": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            },
            "nullable": true,
            "type": "array",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "takenAfter": {
            "deprecated": true,
            "description": "Filter by taken date (after)",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "takenBefore": {
            "deprecated": true,
            "description": "Filter by taken date (before)",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "trashedAfter": {
            "deprecated": true,
            "description": "Filter by trash date (after)",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "trashedBefore": {
            "deprecated": true,
            "description": "Filter by trash date (before)",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "type": {
            "$ref": "#/components/schemas/AssetTypeEnum",
            "deprecated": true,
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "updatedAfter": {
            "deprecated": true,
            "description": "Filter by update date (after)",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "updatedBefore": {
            "deprecated": true,
            "description": "Filter by update date (before)",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "visibility": {
            "$ref": "#/components/schemas/AssetVisibility",
            "deprecated": true,
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "withDeleted": {
            "deprecated": true,
            "description": "Include deleted assets",
            "type": "boolean",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "withExif": {
            "description": "Include EXIF data in response",
            "type": "boolean"
          },
          "withPeople": {
            "description": "Include people data in response",
            "type": "boolean"
          },
          "withStacked": {
            "description": "Include stacked assets",
            "type": "boolean"
          }
        },
        "type": "object"
      },
      "RatingsResponse": {
        "properties": {
          "enabled": {
            "description": "Whether ratings are enabled",
            "type": "boolean"
          }
        },
        "required": [
          "enabled"
        ],
        "type": "object"
      },
      "RatingsUpdate": {
        "properties": {
          "enabled": {
            "description": "Whether ratings are enabled",
            "type": "boolean"
          }
        },
        "type": "object"
      },
      "ReactionLevel": {
        "description": "Reaction level",
        "enum": [
          "album",
          "asset"
        ],
        "type": "string"
      },
      "ReactionType": {
        "description": "Reaction type",
        "enum": [
          "comment",
          "like"
        ],
        "type": "string"
      },
      "RecentlyAddedResponse": {
        "properties": {
          "sidebarWeb": {
            "description": "Whether the recently added page appears in the web sidebar",
            "type": "boolean"
          }
        },
        "required": [
          "sidebarWeb"
        ],
        "type": "object"
      },
      "RecentlyAddedUpdate": {
        "properties": {
          "sidebarWeb": {
            "description": "Whether the recently added page appears in the web sidebar",
            "type": "boolean"
          }
        },
        "type": "object"
      },
      "ReleaseChannel": {
        "description": "Release channel",
        "enum": [
          "stable",
          "releaseCandidate"
        ],
        "type": "string"
      },
      "ReleaseEventV1": {
        "properties": {
          "checkedAt": {
            "description": "When the server last checked for a latest version. As an ISO timestamp",
            "type": "string"
          },
          "isAvailable": {
            "description": "Whether a new version is available",
            "type": "boolean"
          },
          "releaseVersion": {
            "$ref": "#/components/schemas/ServerVersionResponseDto"
          },
          "serverVersion": {
            "$ref": "#/components/schemas/ServerVersionResponseDto"
          },
          "type": {
            "$ref": "#/components/schemas/ReleaseType",
            "description": "Release type",
            "nullable": true
          }
        },
        "required": [
          "checkedAt",
          "isAvailable",
          "releaseVersion",
          "serverVersion",
          "type"
        ],
        "type": "object"
      },
      "ReleaseType": {
        "enum": [
          "major",
          "premajor",
          "minor",
          "preminor",
          "patch",
          "prepatch",
          "prerelease"
        ],
        "type": "string"
      },
      "RepositoryBackendDto": {
        "properties": {
          "id": {
            "type": "string"
          },
          "online": {
            "type": "boolean"
          },
          "type": {
            "$ref": "#/components/schemas/BackendType"
          }
        },
        "required": [
          "id",
          "online",
          "type"
        ],
        "type": "object"
      },
      "RepositoryBackendsDto": {
        "properties": {
          "primary": {
            "$ref": "#/components/schemas/RepositoryBackendDto"
          },
          "secondary": {
            "items": {
              "$ref": "#/components/schemas/RepositoryBackendDto"
            },
            "type": "array"
          }
        },
        "required": [
          "primary",
          "secondary"
        ],
        "type": "object"
      },
      "RepositoryCheckImportResponseDto": {
        "properties": {
          "readable": {
            "type": "boolean"
          }
        },
        "required": [
          "readable"
        ],
        "type": "object"
      },
      "RepositoryConfigurationDto": {
        "properties": {
          "paths": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "retentionPolicy": {
            "allOf": [
              {
                "$ref": "#/components/schemas/RetentionPolicyDto"
              }
            ],
            "nullable": true
          }
        },
        "required": [
          "paths"
        ],
        "type": "object"
      },
      "RepositoryCreateRequestDto": {
        "properties": {
          "name": {
            "type": "string"
          },
          "paths": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "retentionPolicy": {
            "allOf": [
              {
                "$ref": "#/components/schemas/RetentionPolicyDto"
              }
            ],
            "nullable": true
          },
          "site": {
            "description": "Internal site code from environment metadata",
            "type": "string"
          },
          "worm": {
            "type": "boolean"
          }
        },
        "required": [
          "name",
          "worm"
        ],
        "type": "object"
      },
      "RepositoryCreateResponseDto": {
        "properties": {
          "repository": {
            "$ref": "#/components/schemas/LocalRepositoryDto"
          }
        },
        "required": [
          "repository"
        ],
        "type": "object"
      },
      "RepositoryInspectResponseDto": {
        "properties": {
          "repositories": {
            "items": {
              "$ref": "#/components/schemas/InspectedLocalRepositoryDto"
            },
            "type": "array"
          }
        },
        "required": [
          "repositories"
        ],
        "type": "object"
      },
      "RepositoryListResponseDto": {
        "properties": {
          "repositories": {
            "items": {
              "$ref": "#/components/schemas/LocalRepositoryDto"
            },
            "type": "array"
          }
        },
        "required": [
          "repositories"
        ],
        "type": "object"
      },
      "RepositoryMeterDto": {
        "properties": {
          "lastUpdated": {
            "nullable": true,
            "type": "string"
          },
          "objectCount": {
            "maximum": 9007199254740991,
            "minimum": -9007199254740991,
            "type": "integer"
          },
          "sizeBytes": {
            "maximum": 9007199254740991,
            "minimum": -9007199254740991,
            "type": "integer"
          }
        },
        "required": [
          "objectCount",
          "sizeBytes"
        ],
        "type": "object"
      },
      "RepositoryMetricsDto": {
        "properties": {
          "lastBackup": {
            "nullable": true,
            "type": "string"
          },
          "lastBackupDuration": {
            "maximum": 9007199254740991,
            "minimum": -9007199254740991,
            "nullable": true,
            "type": "integer"
          },
          "lastBackupStatus": {
            "allOf": [
              {
                "$ref": "#/components/schemas/BackupStatus"
              }
            ],
            "nullable": true
          },
          "lastStarted": {
            "nullable": true,
            "type": "string"
          },
          "sizeBytes": {
            "maximum": 9007199254740991,
            "minimum": -9007199254740991,
            "type": "integer"
          }
        },
        "required": [
          "sizeBytes"
        ],
        "type": "object"
      },
      "RepositoryPrimaryBackendReconfigureRequestDto": {
        "properties": {
          "backendId": {
            "type": "string"
          }
        },
        "required": [
          "backendId"
        ],
        "type": "object"
      },
      "RepositorySnapshotRestoreFromPointRequestDto": {
        "properties": {
          "include": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "yuccaConfig": {
            "type": "string"
          }
        },
        "type": "object"
      },
      "RepositorySnapshotRestoreRequestDto": {
        "properties": {
          "include": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "target": {
            "type": "string"
          }
        },
        "type": "object"
      },
      "RepositorySyncDeletionResponseDto": {
        "properties": {
          "deleted": {
            "description": "Whether the repository was deleted remotely and removed from this server",
            "type": "boolean"
          }
        },
        "required": [
          "deleted"
        ],
        "type": "object"
      },
      "RepositoryUpdateRequestDto": {
        "properties": {
          "name": {
            "type": "string"
          },
          "paths": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "retentionPolicy": {
            "allOf": [
              {
                "$ref": "#/components/schemas/RetentionPolicyDto"
              }
            ],
            "nullable": true
          },
          "worm": {
            "type": "boolean"
          }
        },
        "type": "object"
      },
      "RepositoryUpdateResponseDto": {
        "properties": {
          "repository": {
            "$ref": "#/components/schemas/LocalRepositoryDto"
          }
        },
        "required": [
          "repository"
        ],
        "type": "object"
      },
      "RetentionPolicyDto": {
        "properties": {
          "keepLast": {
            "maximum": 9007199254740991,
            "minimum": -9007199254740991,
            "type": "integer"
          },
          "keepWithin": {
            "type": "string"
          },
          "keepWithinDaily": {
            "type": "string"
          },
          "keepWithinHourly": {
            "type": "string"
          },
          "keepWithinMonthly": {
            "type": "string"
          },
          "keepWithinWeekly": {
            "type": "string"
          },
          "keepWithinYearly": {
            "type": "string"
          }
        },
        "type": "object"
      },
      "ReverseGeocodingStateResponseDto": {
        "properties": {
          "lastImportFileName": {
            "description": "Last import file name",
            "nullable": true,
            "type": "string"
          },
          "lastUpdate": {
            "description": "Last update timestamp",
            "nullable": true,
            "type": "string"
          }
        },
        "required": [
          "lastImportFileName",
          "lastUpdate"
        ],
        "type": "object"
      },
      "RotateParameters": {
        "properties": {
          "angle": {
            "description": "Rotation angle in degrees",
            "maximum": 270,
            "minimum": 0,
            "type": "integer"
          }
        },
        "required": [
          "angle"
        ],
        "type": "object"
      },
      "ScheduleCreateRequestDto": {
        "properties": {
          "cron": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "paused": {
            "default": false,
            "type": "boolean"
          },
          "repositories": {
            "items": {
              "type": "string"
            },
            "type": "array"
          }
        },
        "required": [
          "cron",
          "name",
          "repositories"
        ],
        "type": "object"
      },
      "ScheduleCreateResponseDto": {
        "properties": {
          "schedule": {
            "$ref": "#/components/schemas/ScheduleDto"
          }
        },
        "required": [
          "schedule"
        ],
        "type": "object"
      },
      "ScheduleDto": {
        "properties": {
          "cron": {
            "type": "string"
          },
          "id": {
            "type": "string"
          },
          "lastFinished": {
            "type": "string"
          },
          "lastRun": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "paused": {
            "type": "boolean"
          },
          "repositories": {
            "items": {
              "type": "string"
            },
            "type": "array"
          }
        },
        "required": [
          "cron",
          "id",
          "name",
          "paused",
          "repositories"
        ],
        "type": "object"
      },
      "ScheduleListResponseDto": {
        "properties": {
          "schedules": {
            "items": {
              "$ref": "#/components/schemas/ScheduleDto"
            },
            "type": "array"
          }
        },
        "required": [
          "schedules"
        ],
        "type": "object"
      },
      "ScheduleUpdateRequestDto": {
        "properties": {
          "cron": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "paused": {
            "type": "boolean"
          },
          "repositories": {
            "items": {
              "type": "string"
            },
            "type": "array"
          }
        },
        "type": "object"
      },
      "ScheduleUpdateResponseDto": {
        "properties": {
          "schedule": {
            "$ref": "#/components/schemas/ScheduleDto"
          }
        },
        "required": [
          "schedule"
        ],
        "type": "object"
      },
      "SearchAlbumResponseDto": {
        "properties": {
          "count": {
            "description": "Number of albums in this page",
            "maximum": 9007199254740991,
            "minimum": 0,
            "type": "integer"
          },
          "facets": {
            "items": {
              "$ref": "#/components/schemas/SearchFacetResponseDto"
            },
            "type": "array"
          },
          "items": {
            "items": {
              "$ref": "#/components/schemas/AlbumResponseDto"
            },
            "type": "array"
          },
          "total": {
            "description": "Total number of matching albums",
            "maximum": 9007199254740991,
            "minimum": 0,
            "type": "integer"
          }
        },
        "required": [
          "count",
          "facets",
          "items",
          "total"
        ],
        "type": "object"
      },
      "SearchAssetResponseDto": {
        "properties": {
          "count": {
            "description": "Number of assets in this page",
            "maximum": 9007199254740991,
            "minimum": 0,
            "type": "integer"
          },
          "facets": {
            "items": {
              "$ref": "#/components/schemas/SearchFacetResponseDto"
            },
            "type": "array"
          },
          "items": {
            "items": {
              "$ref": "#/components/schemas/AssetResponseDto"
            },
            "type": "array"
          },
          "nextCursor": {
            "description": "Cursor for the next page of results",
            "nullable": true,
            "type": "string",
            "x-immich-history": [
              {
                "version": "v3.2.0",
                "state": "Added"
              }
            ]
          },
          "nextPage": {
            "deprecated": true,
            "description": "Next page token",
            "nullable": true,
            "type": "string",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "total": {
            "description": "Total number of matching assets",
            "maximum": 9007199254740991,
            "minimum": 0,
            "type": "integer",
            "x-immich-history": [
              {
                "version": "v3.0.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          }
        },
        "required": [
          "count",
          "facets",
          "items",
          "nextCursor",
          "nextPage",
          "total"
        ],
        "type": "object"
      },
      "SearchExploreItem": {
        "properties": {
          "data": {
            "$ref": "#/components/schemas/AssetResponseDto"
          },
          "value": {
            "description": "Explore value",
            "type": "string"
          }
        },
        "required": [
          "data",
          "value"
        ],
        "type": "object"
      },
      "SearchExploreResponseDto": {
        "properties": {
          "fieldName": {
            "description": "Explore field name",
            "type": "string"
          },
          "items": {
            "items": {
              "$ref": "#/components/schemas/SearchExploreItem"
            },
            "type": "array"
          }
        },
        "required": [
          "fieldName",
          "items"
        ],
        "type": "object"
      },
      "SearchFacetCountResponseDto": {
        "properties": {
          "count": {
            "description": "Number of assets with this facet value",
            "maximum": 9007199254740991,
            "minimum": 0,
            "type": "integer"
          },
          "value": {
            "description": "Facet value",
            "type": "string"
          }
        },
        "required": [
          "count",
          "value"
        ],
        "type": "object"
      },
      "SearchFacetResponseDto": {
        "properties": {
          "counts": {
            "items": {
              "$ref": "#/components/schemas/SearchFacetCountResponseDto"
            },
            "type": "array"
          },
          "fieldName": {
            "description": "Facet field name",
            "type": "string"
          }
        },
        "required": [
          "counts",
          "fieldName"
        ],
        "type": "object"
      },
      "SearchFilter": {
        "additionalProperties": false,
        "properties": {
          "albumIds": {
            "$ref": "#/components/schemas/IdsFilter"
          },
          "checksum": {
            "$ref": "#/components/schemas/StringFilter"
          },
          "city": {
            "$ref": "#/components/schemas/StringFilterNullable"
          },
          "country": {
            "$ref": "#/components/schemas/StringFilterNullable"
          },
          "createdAt": {
            "$ref": "#/components/schemas/DateFilter"
          },
          "description": {
            "$ref": "#/components/schemas/StringPatternFilter"
          },
          "encodedVideoPath": {
            "$ref": "#/components/schemas/StringFilter"
          },
          "fileSizeInBytes": {
            "$ref": "#/components/schemas/NumberFilter"
          },
          "hasAlbums": {
            "$ref": "#/components/schemas/BoolFilter"
          },
          "hasPeople": {
            "$ref": "#/components/schemas/BoolFilter"
          },
          "hasTags": {
            "$ref": "#/components/schemas/BoolFilter"
          },
          "id": {
            "$ref": "#/components/schemas/IdFilter"
          },
          "isEncoded": {
            "$ref": "#/components/schemas/BoolFilter"
          },
          "isFavorite": {
            "$ref": "#/components/schemas/BoolFilter"
          },
          "isMotion": {
            "$ref": "#/components/schemas/BoolFilter"
          },
          "isOffline": {
            "$ref": "#/components/schemas/BoolFilter"
          },
          "lensModel": {
            "$ref": "#/components/schemas/StringFilterNullable"
          },
          "libraryId": {
            "$ref": "#/components/schemas/IdFilterNullable"
          },
          "make": {
            "$ref": "#/components/schemas/StringFilterNullable"
          },
          "model": {
            "$ref": "#/components/schemas/StringFilterNullable"
          },
          "ocr": {
            "$ref": "#/components/schemas/StringSimilarityFilter"
          },
          "or": {
            "items": {
              "$ref": "#/components/schemas/SearchFilterBranch"
            },
            "minItems": 1,
            "type": "array"
          },
          "originalFileName": {
            "$ref": "#/components/schemas/StringPatternFilter"
          },
          "originalPath": {
            "$ref": "#/components/schemas/StringPatternFilter"
          },
          "personIds": {
            "$ref": "#/components/schemas/IdsFilter"
          },
          "rating": {
            "$ref": "#/components/schemas/NumberFilterNullable"
          },
          "state": {
            "$ref": "#/components/schemas/StringFilterNullable"
          },
          "tagIds": {
            "$ref": "#/components/schemas/IdsFilter"
          },
          "takenAt": {
            "$ref": "#/components/schemas/DateFilter"
          },
          "trashedAt": {
            "$ref": "#/components/schemas/DateFilterNullable"
          },
          "type": {
            "$ref": "#/components/schemas/EnumFilterAssetType"
          },
          "updatedAt": {
            "$ref": "#/components/schemas/DateFilter"
          },
          "visibility": {
            "$ref": "#/components/schemas/EnumFilterAssetVisibility"
          }
        },
        "type": "object"
      },
      "SearchFilterBranch": {
        "additionalProperties": false,
        "properties": {
          "albumIds": {
            "$ref": "#/components/schemas/IdsFilter"
          },
          "checksum": {
            "$ref": "#/components/schemas/StringFilter"
          },
          "city": {
            "$ref": "#/components/schemas/StringFilterNullable"
          },
          "country": {
            "$ref": "#/components/schemas/StringFilterNullable"
          },
          "createdAt": {
            "$ref": "#/components/schemas/DateFilter"
          },
          "description": {
            "$ref": "#/components/schemas/StringPatternFilter"
          },
          "encodedVideoPath": {
            "$ref": "#/components/schemas/StringFilter"
          },
          "fileSizeInBytes": {
            "$ref": "#/components/schemas/NumberFilter"
          },
          "hasAlbums": {
            "$ref": "#/components/schemas/BoolFilter"
          },
          "hasPeople": {
            "$ref": "#/components/schemas/BoolFilter"
          },
          "hasTags": {
            "$ref": "#/components/schemas/BoolFilter"
          },
          "id": {
            "$ref": "#/components/schemas/IdFilter"
          },
          "isEncoded": {
            "$ref": "#/components/schemas/BoolFilter"
          },
          "isFavorite": {
            "$ref": "#/components/schemas/BoolFilter"
          },
          "isMotion": {
            "$ref": "#/components/schemas/BoolFilter"
          },
          "isOffline": {
            "$ref": "#/components/schemas/BoolFilter"
          },
          "lensModel": {
            "$ref": "#/components/schemas/StringFilterNullable"
          },
          "libraryId": {
            "$ref": "#/components/schemas/IdFilterNullable"
          },
          "make": {
            "$ref": "#/components/schemas/StringFilterNullable"
          },
          "model": {
            "$ref": "#/components/schemas/StringFilterNullable"
          },
          "ocr": {
            "$ref": "#/components/schemas/StringSimilarityFilter"
          },
          "originalFileName": {
            "$ref": "#/components/schemas/StringPatternFilter"
          },
          "originalPath": {
            "$ref": "#/components/schemas/StringPatternFilter"
          },
          "personIds": {
            "$ref": "#/components/schemas/IdsFilter"
          },
          "rating": {
            "$ref": "#/components/schemas/NumberFilterNullable"
          },
          "state": {
            "$ref": "#/components/schemas/StringFilterNullable"
          },
          "tagIds": {
            "$ref": "#/components/schemas/IdsFilter"
          },
          "takenAt": {
            "$ref": "#/components/schemas/DateFilter"
          },
          "trashedAt": {
            "$ref": "#/components/schemas/DateFilterNullable"
          },
          "type": {
            "$ref": "#/components/schemas/EnumFilterAssetType"
          },
          "updatedAt": {
            "$ref": "#/components/schemas/DateFilter"
          },
          "visibility": {
            "$ref": "#/components/schemas/EnumFilterAssetVisibility"
          }
        },
        "type": "object"
      },
      "SearchOrder": {
        "properties": {
          "direction": {
            "$ref": "#/components/schemas/AssetOrder",
            "default": "desc"
          },
          "field": {
            "$ref": "#/components/schemas/SearchOrderField",
            "default": "fileCreatedAt"
          }
        },
        "type": "object"
      },
      "SearchOrderField": {
        "enum": [
          "fileCreatedAt",
          "localDateTime",
          "fileSizeInBytes",
          "rating"
        ],
        "type": "string"
      },
      "SearchResponseDto": {
        "properties": {
          "albums": {
            "$ref": "#/components/schemas/SearchAlbumResponseDto"
          },
          "assets": {
            "$ref": "#/components/schemas/SearchAssetResponseDto"
          }
        },
        "required": [
          "albums",
          "assets"
        ],
        "type": "object"
      },
      "SearchStatisticsResponseDto": {
        "properties": {
          "total": {
            "description": "Total number of matching assets",
            "maximum": 9007199254740991,
            "minimum": -9007199254740991,
            "type": "integer"
          }
        },
        "required": [
          "total"
        ],
        "type": "object"
      },
      "SearchSuggestionType": {
        "description": "Suggestion type",
        "enum": [
          "country",
          "state",
          "city",
          "camera-make",
          "camera-model",
          "camera-lens-model"
        ],
        "type": "string"
      },
      "ServerAboutResponseDto": {
        "properties": {
          "build": {
            "description": "Build identifier",
            "type": "string"
          },
          "buildImage": {
            "description": "Build image name",
            "type": "string"
          },
          "buildImageUrl": {
            "description": "Build image URL",
            "type": "string"
          },
          "buildUrl": {
            "description": "Build URL",
            "type": "string"
          },
          "exiftool": {
            "description": "ExifTool version",
            "type": "string"
          },
          "ffmpeg": {
            "description": "FFmpeg version",
            "type": "string"
          },
          "imagemagick": {
            "description": "ImageMagick version",
            "type": "string"
          },
          "libvips": {
            "description": "libvips version",
            "type": "string"
          },
          "licensed": {
            "description": "Whether the server is licensed",
            "type": "boolean"
          },
          "nodejs": {
            "description": "Node.js version",
            "type": "string"
          },
          "repository": {
            "description": "Repository name",
            "type": "string"
          },
          "repositoryUrl": {
            "description": "Repository URL",
            "type": "string"
          },
          "sourceCommit": {
            "description": "Source commit hash",
            "type": "string"
          },
          "sourceRef": {
            "description": "Source reference (branch/tag)",
            "type": "string"
          },
          "sourceUrl": {
            "description": "Source URL",
            "type": "string"
          },
          "thirdPartyBugFeatureUrl": {
            "description": "Third-party bug/feature URL",
            "type": "string"
          },
          "thirdPartyDocumentationUrl": {
            "description": "Third-party documentation URL",
            "type": "string"
          },
          "thirdPartySourceUrl": {
            "description": "Third-party source URL",
            "type": "string"
          },
          "thirdPartySupportUrl": {
            "description": "Third-party support URL",
            "type": "string"
          },
          "version": {
            "description": "Server version",
            "type": "string"
          },
          "versionUrl": {
            "description": "URL to version information",
            "type": "string"
          }
        },
        "required": [
          "licensed",
          "version",
          "versionUrl"
        ],
        "type": "object"
      },
      "ServerApkLinksDto": {
        "properties": {
          "arm64v8a": {
            "description": "APK download link for ARM64 v8a architecture",
            "type": "string"
          },
          "armeabiv7a": {
            "description": "APK download link for ARM EABI v7a architecture",
            "type": "string"
          },
          "universal": {
            "description": "APK download link for universal architecture",
            "type": "string"
          },
          "x86_64": {
            "description": "APK download link for x86_64 architecture",
            "type": "string"
          }
        },
        "required": [
          "arm64v8a",
          "armeabiv7a",
          "universal",
          "x86_64"
        ],
        "type": "object"
      },
      "ServerConfigDto": {
        "properties": {
          "externalDomain": {
            "description": "External domain URL",
            "type": "string"
          },
          "isInitialized": {
            "description": "Whether the server has been initialized",
            "type": "boolean"
          },
          "isOnboarded": {
            "description": "Whether the admin has completed onboarding",
            "type": "boolean"
          },
          "loginPageMessage": {
            "description": "Login page message",
            "type": "string"
          },
          "maintenanceMode": {
            "description": "Whether maintenance mode is active",
            "type": "boolean"
          },
          "mapDarkStyleUrl": {
            "description": "Map dark style URL",
            "type": "string"
          },
          "mapLightStyleUrl": {
            "description": "Map light style URL",
            "type": "string"
          },
          "minFaces": {
            "description": "People min faces server default",
            "maximum": 9007199254740991,
            "minimum": -9007199254740991,
            "type": "integer"
          },
          "oauthAccountManagementUrl": {
            "default": "",
            "description": "OAuth account management URL",
            "type": "string"
          },
          "oauthButtonText": {
            "description": "OAuth button text",
            "type": "string"
          },
          "publicUsers": {
            "description": "Whether public user registration is enabled",
            "type": "boolean"
          },
          "trashDays": {
            "description": "Number of days before trashed assets are permanently deleted",
            "maximum": 9007199254740991,
            "minimum": -9007199254740991,
            "type": "integer"
          },
          "userDeleteDelay": {
            "description": "Delay in days before deleted users are permanently removed",
            "maximum": 9007199254740991,
            "minimum": -9007199254740991,
            "type": "integer"
          }
        },
        "required": [
          "externalDomain",
          "isInitialized",
          "isOnboarded",
          "loginPageMessage",
          "maintenanceMode",
          "mapDarkStyleUrl",
          "mapLightStyleUrl",
          "minFaces",
          "oauthButtonText",
          "publicUsers",
          "trashDays",
          "userDeleteDelay"
        ],
        "type": "object"
      },
      "ServerFeatureLevel": {
        "description": "Server feature level",
        "enum": [
          1,
          2
        ],
        "type": "integer",
        "x-enum-varnames": [
          "FeatureLevel",
          "Passkeys"
        ]
      },
      "ServerFeaturesDto": {
        "properties": {
          "backups": {
            "description": "Whether the backups feature is enabled",
            "type": "boolean"
          },
          "configFile": {
            "description": "Whether config file is available",
            "type": "boolean"
          },
          "duplicateDetection": {
            "description": "Whether duplicate detection is enabled",
            "type": "boolean"
          },
          "email": {
            "description": "Whether email notifications are enabled",
            "type": "boolean"
          },
          "facialRecognition": {
            "description": "Whether facial recognition is enabled",
            "type": "boolean"
          },
          "importFaces": {
            "description": "Whether face import is enabled",
            "type": "boolean"
          },
          "map": {
            "description": "Whether map feature is enabled",
            "type": "boolean"
          },
          "oauth": {
            "description": "Whether OAuth is enabled",
            "type": "boolean"
          },
          "oauthAutoLaunch": {
            "description": "Whether OAuth auto-launch is enabled",
            "type": "boolean"
          },
          "ocr": {
            "description": "Whether OCR is enabled",
            "type": "boolean"
          },
          "passwordLogin": {
            "description": "Whether password login is enabled",
            "type": "boolean"
          },
          "realtimeTranscoding": {
            "description": "Whether real-time transcoding is enabled",
            "type": "boolean"
          },
          "reverseGeocoding": {
            "description": "Whether reverse geocoding is enabled",
            "type": "boolean"
          },
          "search": {
            "description": "Whether search is enabled",
            "type": "boolean"
          },
          "sidecar": {
            "description": "Whether sidecar files are supported",
            "type": "boolean"
          },
          "smartSearch": {
            "description": "Whether smart search is enabled",
            "type": "boolean"
          },
          "trash": {
            "description": "Whether trash feature is enabled",
            "type": "boolean"
          }
        },
        "required": [
          "backups",
          "configFile",
          "duplicateDetection",
          "email",
          "facialRecognition",
          "importFaces",
          "map",
          "oauth",
          "oauthAutoLaunch",
          "ocr",
          "passwordLogin",
          "realtimeTranscoding",
          "reverseGeocoding",
          "search",
          "sidecar",
          "smartSearch",
          "trash"
        ],
        "type": "object"
      },
      "ServerMediaTypesResponseDto": {
        "properties": {
          "image": {
            "description": "Supported image MIME types",
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "sidecar": {
            "description": "Supported sidecar MIME types",
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "video": {
            "description": "Supported video MIME types",
            "items": {
              "type": "string"
            },
            "type": "array"
          }
        },
        "required": [
          "image",
          "sidecar",
          "video"
        ],
        "type": "object"
      },
      "ServerPingResponse": {
        "properties": {
          "res": {
            "example": "pong",
            "type": "string"
          }
        },
        "required": [
          "res"
        ],
        "type": "object"
      },
      "ServerStatsResponseDto": {
        "properties": {
          "photos": {
            "description": "Total number of photos",
            "maximum": 9007199254740991,
            "minimum": -9007199254740991,
            "type": "integer"
          },
          "usage": {
            "description": "Total storage usage in bytes",
            "maximum": 9007199254740991,
            "minimum": -9007199254740991,
            "type": "integer"
          },
          "usageByUser": {
            "description": "Array of usage for each user",
            "items": {
              "$ref": "#/components/schemas/UsageByUserDto"
            },
            "type": "array"
          },
          "usagePhotos": {
            "description": "Storage usage for photos in bytes",
            "maximum": 9007199254740991,
            "minimum": -9007199254740991,
            "type": "integer"
          },
          "usageVideos": {
            "description": "Storage usage for videos in bytes",
            "maximum": 9007199254740991,
            "minimum": -9007199254740991,
            "type": "integer"
          },
          "videos": {
            "description": "Total number of videos",
            "maximum": 9007199254740991,
            "minimum": -9007199254740991,
            "type": "integer"
          }
        },
        "required": [
          "photos",
          "usage",
          "usageByUser",
          "usagePhotos",
          "usageVideos",
          "videos"
        ],
        "type": "object"
      },
      "ServerStorageResponseDto": {
        "properties": {
          "diskAvailable": {
            "description": "Available disk space (human-readable format)",
            "type": "string"
          },
          "diskAvailableRaw": {
            "description": "Available disk space in bytes",
            "maximum": 9007199254740991,
            "minimum": -9007199254740991,
            "type": "integer"
          },
          "diskSize": {
            "description": "Total disk size (human-readable format)",
            "type": "string"
          },
          "diskSizeRaw": {
            "description": "Total disk size in bytes",
            "maximum": 9007199254740991,
            "minimum": -9007199254740991,
            "type": "integer"
          },
          "diskUsagePercentage": {
            "description": "Disk usage percentage (0-100)",
            "format": "double",
            "type": "number"
          },
          "diskUse": {
            "description": "Used disk space (human-readable format)",
            "type": "string"
          },
          "diskUseRaw": {
            "description": "Used disk space in bytes",
            "maximum": 9007199254740991,
            "minimum": -9007199254740991,
            "type": "integer"
          }
        },
        "required": [
          "diskAvailable",
          "diskAvailableRaw",
          "diskSize",
          "diskSizeRaw",
          "diskUsagePercentage",
          "diskUse",
          "diskUseRaw"
        ],
        "type": "object"
      },
      "ServerVersionHistoryResponseDto": {
        "properties": {
          "createdAt": {
            "description": "When this version was first seen",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string"
          },
          "id": {
            "description": "Version history entry ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          },
          "version": {
            "description": "Version string",
            "type": "string"
          }
        },
        "required": [
          "createdAt",
          "id",
          "version"
        ],
        "type": "object"
      },
      "ServerVersionResponseDto": {
        "properties": {
          "featureLevel": {
            "description": "Highest feature level supported by the server, which increments independently of the release version",
            "maximum": 9007199254740991,
            "minimum": 0,
            "type": "integer",
            "x-immich-history": [
              {
                "version": "v4.0.0",
                "state": "Added"
              }
            ]
          },
          "major": {
            "description": "Major version number",
            "maximum": 9007199254740991,
            "minimum": 0,
            "type": "integer"
          },
          "minor": {
            "description": "Minor version number",
            "maximum": 9007199254740991,
            "minimum": 0,
            "type": "integer"
          },
          "patch": {
            "description": "Patch version number",
            "maximum": 9007199254740991,
            "minimum": 0,
            "type": "integer"
          },
          "prerelease": {
            "description": "Pre-release version number",
            "maximum": 9007199254740991,
            "minimum": 0,
            "nullable": true,
            "type": "integer",
            "x-immich-history": [
              {
                "version": "v3.0.0",
                "state": "Added"
              }
            ]
          }
        },
        "required": [
          "featureLevel",
          "major",
          "minor",
          "patch",
          "prerelease"
        ],
        "type": "object"
      },
      "SessionCreateDto": {
        "properties": {
          "deviceOS": {
            "description": "Device OS",
            "type": "string"
          },
          "deviceType": {
            "description": "Device type",
            "type": "string"
          },
          "duration": {
            "description": "Session duration in seconds",
            "maximum": 9007199254740991,
            "minimum": 1,
            "type": "integer"
          }
        },
        "type": "object"
      },
      "SessionCreateResponseDto": {
        "properties": {
          "appVersion": {
            "description": "App version",
            "nullable": true,
            "type": "string"
          },
          "createdAt": {
            "description": "Creation date",
            "type": "string"
          },
          "current": {
            "description": "Is current session",
            "type": "boolean"
          },
          "deviceOS": {
            "description": "Device OS",
            "type": "string"
          },
          "deviceType": {
            "description": "Device type",
            "type": "string"
          },
          "expiresAt": {
            "description": "Expiration date",
            "type": "string"
          },
          "id": {
            "description": "Session ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          },
          "isPendingSyncReset": {
            "description": "Is pending sync reset",
            "type": "boolean"
          },
          "token": {
            "description": "Session token",
            "type": "string"
          },
          "updatedAt": {
            "description": "Last update date",
            "type": "string"
          }
        },
        "required": [
          "appVersion",
          "createdAt",
          "current",
          "deviceOS",
          "deviceType",
          "id",
          "isPendingSyncReset",
          "token",
          "updatedAt"
        ],
        "type": "object"
      },
      "SessionResponseDto": {
        "properties": {
          "appVersion": {
            "description": "App version",
            "nullable": true,
            "type": "string"
          },
          "createdAt": {
            "description": "Creation date",
            "type": "string"
          },
          "current": {
            "description": "Is current session",
            "type": "boolean"
          },
          "deviceOS": {
            "description": "Device OS",
            "type": "string"
          },
          "deviceType": {
            "description": "Device type",
            "type": "string"
          },
          "expiresAt": {
            "description": "Expiration date",
            "type": "string"
          },
          "id": {
            "description": "Session ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          },
          "isPendingSyncReset": {
            "description": "Is pending sync reset",
            "type": "boolean"
          },
          "updatedAt": {
            "description": "Last update date",
            "type": "string"
          }
        },
        "required": [
          "appVersion",
          "createdAt",
          "current",
          "deviceOS",
          "deviceType",
          "id",
          "isPendingSyncReset",
          "updatedAt"
        ],
        "type": "object"
      },
      "SessionUnlockDto": {
        "properties": {
          "password": {
            "description": "User password (required if PIN code is not provided)",
            "example": "password",
            "type": "string"
          },
          "pinCode": {
            "description": "New PIN code (4-6 digits)",
            "example": "123456",
            "pattern": "^\\d{6}$",
            "type": "string"
          }
        },
        "type": "object"
      },
      "SessionUpdateDto": {
        "properties": {
          "isPendingSyncReset": {
            "description": "Reset pending sync state",
            "type": "boolean"
          }
        },
        "type": "object"
      },
      "SetMaintenanceModeDto": {
        "properties": {
          "action": {
            "$ref": "#/components/schemas/MaintenanceAction"
          },
          "restoreBackupFilename": {
            "description": "Restore backup filename",
            "type": "string"
          },
          "rollbackRepositoryId": {
            "description": "Rollback repository ID",
            "type": "string"
          },
          "rollbackSnapshotId": {
            "description": "Rollback snapshot ID",
            "type": "string"
          }
        },
        "required": [
          "action"
        ],
        "type": "object"
      },
      "SharedLinkCreateDto": {
        "properties": {
          "albumId": {
            "description": "Album ID (for album sharing)",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          },
          "allowDownload": {
            "default": true,
            "description": "Allow downloads",
            "type": "boolean"
          },
          "allowUpload": {
            "description": "Allow uploads",
            "type": "boolean"
          },
          "assetIds": {
            "description": "Asset IDs (for individual assets)",
            "items": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            },
            "type": "array"
          },
          "description": {
            "description": "Link description",
            "nullable": true,
            "type": "string"
          },
          "expiresAt": {
            "description": "Expiration date",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "nullable": true,
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string"
          },
          "password": {
            "description": "Link password",
            "nullable": true,
            "type": "string"
          },
          "showMetadata": {
            "default": true,
            "description": "Show metadata",
            "type": "boolean"
          },
          "slug": {
            "description": "Custom URL slug",
            "nullable": true,
            "type": "string"
          },
          "type": {
            "$ref": "#/components/schemas/SharedLinkType"
          }
        },
        "required": [
          "type"
        ],
        "type": "object"
      },
      "SharedLinkEditDto": {
        "properties": {
          "allowDownload": {
            "description": "Allow downloads",
            "type": "boolean"
          },
          "allowUpload": {
            "description": "Allow uploads",
            "type": "boolean"
          },
          "description": {
            "description": "Link description",
            "nullable": true,
            "type": "string"
          },
          "expiresAt": {
            "description": "Expiration date",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "nullable": true,
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string"
          },
          "password": {
            "description": "Link password",
            "nullable": true,
            "type": "string"
          },
          "showMetadata": {
            "description": "Show metadata",
            "type": "boolean"
          },
          "slug": {
            "description": "Custom URL slug",
            "nullable": true,
            "type": "string"
          }
        },
        "type": "object"
      },
      "SharedLinkLoginDto": {
        "properties": {
          "password": {
            "description": "Shared link password",
            "example": "password",
            "type": "string"
          }
        },
        "required": [
          "password"
        ],
        "type": "object"
      },
      "SharedLinkResponseDto": {
        "description": "Shared link response",
        "properties": {
          "album": {
            "$ref": "#/components/schemas/AlbumResponseDto"
          },
          "allowDownload": {
            "description": "Allow downloads",
            "type": "boolean"
          },
          "allowUpload": {
            "description": "Allow uploads",
            "type": "boolean"
          },
          "assets": {
            "items": {
              "$ref": "#/components/schemas/AssetResponseDto"
            },
            "type": "array"
          },
          "createdAt": {
            "description": "Creation date",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string"
          },
          "description": {
            "description": "Link description",
            "nullable": true,
            "type": "string"
          },
          "expiresAt": {
            "description": "Expiration date",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "nullable": true,
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string"
          },
          "id": {
            "description": "Shared link ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          },
          "key": {
            "description": "Encryption key (base64url)",
            "type": "string"
          },
          "password": {
            "description": "Has password",
            "nullable": true,
            "type": "string"
          },
          "showMetadata": {
            "description": "Show metadata",
            "type": "boolean"
          },
          "slug": {
            "description": "Custom URL slug",
            "nullable": true,
            "type": "string"
          },
          "type": {
            "$ref": "#/components/schemas/SharedLinkType"
          },
          "userId": {
            "description": "Owner user ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          }
        },
        "required": [
          "allowDownload",
          "allowUpload",
          "assets",
          "createdAt",
          "description",
          "expiresAt",
          "id",
          "key",
          "password",
          "showMetadata",
          "slug",
          "type",
          "userId"
        ],
        "type": "object"
      },
      "SharedLinkType": {
        "description": "Shared link type",
        "enum": [
          "ALBUM",
          "INDIVIDUAL"
        ],
        "type": "string"
      },
      "SharedLinksResponse": {
        "properties": {
          "enabled": {
            "description": "Whether shared links are enabled",
            "type": "boolean"
          },
          "sidebarWeb": {
            "description": "Whether shared links appear in web sidebar",
            "type": "boolean"
          }
        },
        "required": [
          "enabled",
          "sidebarWeb"
        ],
        "type": "object"
      },
      "SharedLinksUpdate": {
        "properties": {
          "enabled": {
            "description": "Whether shared links are enabled",
            "type": "boolean"
          },
          "sidebarWeb": {
            "description": "Whether shared links appear in web sidebar",
            "type": "boolean"
          }
        },
        "type": "object"
      },
      "SharingDirection": {
        "description": "Sharing direction",
        "enum": [
          "shared-by",
          "shared-with"
        ],
        "type": "string"
      },
      "SignUpDto": {
        "properties": {
          "email": {
            "description": "User email",
            "example": "[email protected]",
            "format": "email",
            "pattern": "^[\\p{L}\\p{M}\\p{N}.!#$%&'*+/=?^_`{|}~-]+@[\\p{L}\\p{N}](?:[\\p{L}\\p{M}\\p{N}-]{0,61}[\\p{L}\\p{M}\\p{N}])?(?:\\.[\\p{L}\\p{N}](?:[\\p{L}\\p{M}\\p{N}-]{0,61}[\\p{L}\\p{M}\\p{N}])?)*$",
            "type": "string"
          },
          "name": {
            "description": "User name",
            "example": "Admin",
            "type": "string"
          },
          "password": {
            "description": "User password",
            "example": "password",
            "type": "string"
          }
        },
        "required": [
          "email",
          "name",
          "password"
        ],
        "type": "object"
      },
      "SmartSearchDto": {
        "properties": {
          "albumIds": {
            "deprecated": true,
            "description": "Filter by album IDs",
            "items": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            },
            "type": "array",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "city": {
            "deprecated": true,
            "description": "Filter by city name",
            "nullable": true,
            "type": "string",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "country": {
            "deprecated": true,
            "description": "Filter by country name",
            "nullable": true,
            "type": "string",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "createdAfter": {
            "deprecated": true,
            "description": "Filter by creation date (after)",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "createdBefore": {
            "deprecated": true,
            "description": "Filter by creation date (before)",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "filter": {
            "$ref": "#/components/schemas/SearchFilter",
            "x-immich-history": [
              {
                "version": "v3.2.0",
                "state": "Added"
              }
            ]
          },
          "isEncoded": {
            "deprecated": true,
            "description": "Filter by encoded status",
            "type": "boolean",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "isFavorite": {
            "deprecated": true,
            "description": "Filter by favorite status",
            "type": "boolean",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "isMotion": {
            "deprecated": true,
            "description": "Filter by motion photo status",
            "type": "boolean",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "isNotInAlbum": {
            "deprecated": true,
            "description": "Filter assets not in any album",
            "type": "boolean",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "isOffline": {
            "deprecated": true,
            "description": "Filter by offline status",
            "type": "boolean",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "language": {
            "description": "Search language code",
            "type": "string"
          },
          "lensModel": {
            "deprecated": true,
            "description": "Filter by lens model",
            "nullable": true,
            "type": "string",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "libraryId": {
            "deprecated": true,
            "description": "Library ID to filter by",
            "format": "uuid",
            "nullable": true,
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "make": {
            "deprecated": true,
            "description": "Filter by camera make",
            "nullable": true,
            "type": "string",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "model": {
            "deprecated": true,
            "description": "Filter by camera model",
            "nullable": true,
            "type": "string",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "ocr": {
            "deprecated": true,
            "description": "Filter by OCR text content",
            "type": "string",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "page": {
            "deprecated": true,
            "description": "Page number",
            "maximum": 9007199254740991,
            "minimum": 1,
            "type": "integer",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "personIds": {
            "deprecated": true,
            "description": "Filter by person IDs",
            "items": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            },
            "type": "array",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "query": {
            "description": "Natural language search query",
            "type": "string"
          },
          "queryAssetId": {
            "description": "Asset ID to use as search reference",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          },
          "rating": {
            "deprecated": true,
            "description": "Filter by rating [1-5], or null for unrated",
            "maximum": 5,
            "minimum": 1,
            "nullable": true,
            "type": "integer",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v2.6.0",
                "state": "Updated",
                "description": "Using -1 as a rating is deprecated and will be removed in the next major version."
              },
              {
                "version": "v3",
                "state": "Updated",
                "description": "Using -1 as a rating is no longer valid."
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "size": {
            "default": 100,
            "description": "Number of results to return",
            "maximum": 1000,
            "minimum": 1,
            "type": "integer"
          },
          "state": {
            "deprecated": true,
            "description": "Filter by state/province name",
            "nullable": true,
            "type": "string",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "tagIds": {
            "deprecated": true,
            "description": "Filter by tag IDs",
            "items": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            },
            "nullable": true,
            "type": "array",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "takenAfter": {
            "deprecated": true,
            "description": "Filter by taken date (after)",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "takenBefore": {
            "deprecated": true,
            "description": "Filter by taken date (before)",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "trashedAfter": {
            "deprecated": true,
            "description": "Filter by trash date (after)",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "trashedBefore": {
            "deprecated": true,
            "description": "Filter by trash date (before)",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "type": {
            "$ref": "#/components/schemas/AssetTypeEnum",
            "deprecated": true,
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "updatedAfter": {
            "deprecated": true,
            "description": "Filter by update date (after)",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "updatedBefore": {
            "deprecated": true,
            "description": "Filter by update date (before)",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "visibility": {
            "$ref": "#/components/schemas/AssetVisibility",
            "deprecated": true,
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "withDeleted": {
            "deprecated": true,
            "description": "Include deleted assets",
            "type": "boolean",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "withExif": {
            "description": "Include EXIF data in response",
            "type": "boolean"
          }
        },
        "type": "object"
      },
      "SnapshotDto": {
        "properties": {
          "id": {
            "type": "string"
          },
          "paths": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "summary": {
            "$ref": "#/components/schemas/SnapshotSummaryDto"
          },
          "tags": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "time": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "paths",
          "time"
        ],
        "type": "object"
      },
      "SnapshotSummaryDto": {
        "properties": {
          "dataAdded": {
            "maximum": 9007199254740991,
            "minimum": -9007199254740991,
            "type": "integer"
          },
          "filesChanged": {
            "maximum": 9007199254740991,
            "minimum": -9007199254740991,
            "type": "integer"
          },
          "filesNew": {
            "maximum": 9007199254740991,
            "minimum": -9007199254740991,
            "type": "integer"
          },
          "filesUnmodified": {
            "maximum": 9007199254740991,
            "minimum": -9007199254740991,
            "type": "integer"
          },
          "totalBytes": {
            "maximum": 9007199254740991,
            "minimum": -9007199254740991,
            "type": "integer"
          },
          "totalFiles": {
            "maximum": 9007199254740991,
            "minimum": -9007199254740991,
            "type": "integer"
          }
        },
        "required": [
          "dataAdded",
          "filesChanged",
          "filesNew",
          "filesUnmodified",
          "totalBytes",
          "totalFiles"
        ],
        "type": "object"
      },
      "SourceType": {
        "description": "Face detection source type",
        "enum": [
          "machine-learning",
          "exif",
          "manual"
        ],
        "type": "string"
      },
      "StackCreateDto": {
        "properties": {
          "assetIds": {
            "description": "Asset IDs (first becomes primary, min 2)",
            "items": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            },
            "minItems": 2,
            "type": "array"
          }
        },
        "required": [
          "assetIds"
        ],
        "type": "object"
      },
      "StackResponseDto": {
        "description": "Stack response",
        "properties": {
          "assets": {
            "items": {
              "$ref": "#/components/schemas/AssetResponseDto"
            },
            "type": "array"
          },
          "id": {
            "description": "Stack ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          },
          "primaryAssetId": {
            "description": "Primary asset ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          }
        },
        "required": [
          "assets",
          "id",
          "primaryAssetId"
        ],
        "type": "object"
      },
      "StackUpdateDto": {
        "properties": {
          "primaryAssetId": {
            "description": "Primary asset ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          }
        },
        "type": "object"
      },
      "StatisticsSearchDto": {
        "properties": {
          "albumIds": {
            "deprecated": true,
            "description": "Filter by album IDs",
            "items": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            },
            "type": "array",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "city": {
            "deprecated": true,
            "description": "Filter by city name",
            "nullable": true,
            "type": "string",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "country": {
            "deprecated": true,
            "description": "Filter by country name",
            "nullable": true,
            "type": "string",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "createdAfter": {
            "deprecated": true,
            "description": "Filter by creation date (after)",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "createdBefore": {
            "deprecated": true,
            "description": "Filter by creation date (before)",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "description": {
            "deprecated": true,
            "description": "Filter by description text",
            "type": "string",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "filter": {
            "$ref": "#/components/schemas/SearchFilter",
            "x-immich-history": [
              {
                "version": "v3.2.0",
                "state": "Added"
              }
            ]
          },
          "isEncoded": {
            "deprecated": true,
            "description": "Filter by encoded status",
            "type": "boolean",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "isFavorite": {
            "deprecated": true,
            "description": "Filter by favorite status",
            "type": "boolean",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "isMotion": {
            "deprecated": true,
            "description": "Filter by motion photo status",
            "type": "boolean",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "isNotInAlbum": {
            "deprecated": true,
            "description": "Filter assets not in any album",
            "type": "boolean",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "isOffline": {
            "deprecated": true,
            "description": "Filter by offline status",
            "type": "boolean",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "lensModel": {
            "deprecated": true,
            "description": "Filter by lens model",
            "nullable": true,
            "type": "string",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "libraryId": {
            "deprecated": true,
            "description": "Library ID to filter by",
            "format": "uuid",
            "nullable": true,
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "make": {
            "deprecated": true,
            "description": "Filter by camera make",
            "nullable": true,
            "type": "string",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "model": {
            "deprecated": true,
            "description": "Filter by camera model",
            "nullable": true,
            "type": "string",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "ocr": {
            "deprecated": true,
            "description": "Filter by OCR text content",
            "type": "string",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "personIds": {
            "deprecated": true,
            "description": "Filter by person IDs",
            "items": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            },
            "type": "array",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "rating": {
            "deprecated": true,
            "description": "Filter by rating [1-5], or null for unrated",
            "maximum": 5,
            "minimum": 1,
            "nullable": true,
            "type": "integer",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v2.6.0",
                "state": "Updated",
                "description": "Using -1 as a rating is deprecated and will be removed in the next major version."
              },
              {
                "version": "v3",
                "state": "Updated",
                "description": "Using -1 as a rating is no longer valid."
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "state": {
            "deprecated": true,
            "description": "Filter by state/province name",
            "nullable": true,
            "type": "string",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "tagIds": {
            "deprecated": true,
            "description": "Filter by tag IDs",
            "items": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            },
            "nullable": true,
            "type": "array",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "takenAfter": {
            "deprecated": true,
            "description": "Filter by taken date (after)",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "takenBefore": {
            "deprecated": true,
            "description": "Filter by taken date (before)",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "trashedAfter": {
            "deprecated": true,
            "description": "Filter by trash date (after)",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "trashedBefore": {
            "deprecated": true,
            "description": "Filter by trash date (before)",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "type": {
            "$ref": "#/components/schemas/AssetTypeEnum",
            "deprecated": true,
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "updatedAfter": {
            "deprecated": true,
            "description": "Filter by update date (after)",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "updatedBefore": {
            "deprecated": true,
            "description": "Filter by update date (before)",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          },
          "visibility": {
            "$ref": "#/components/schemas/AssetVisibility",
            "deprecated": true,
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3.2.0",
                "state": "Deprecated"
              }
            ],
            "x-immich-state": "Deprecated"
          }
        },
        "type": "object"
      },
      "StorageFolder": {
        "description": "Storage folder",
        "enum": [
          "encoded-video",
          "library",
          "upload",
          "profile",
          "thumbs",
          "backups"
        ],
        "type": "string"
      },
      "StringFilter": {
        "properties": {
          "eq": {
            "type": "string"
          },
          "in": {
            "items": {
              "type": "string"
            },
            "minItems": 1,
            "type": "array"
          },
          "ne": {
            "type": "string"
          },
          "notIn": {
            "items": {
              "type": "string"
            },
            "minItems": 1,
            "type": "array"
          }
        },
        "type": "object"
      },
      "StringFilterNullable": {
        "properties": {
          "eq": {
            "nullable": true,
            "type": "string"
          },
          "in": {
            "items": {
              "type": "string"
            },
            "minItems": 1,
            "type": "array"
          },
          "ne": {
            "nullable": true,
            "type": "string"
          },
          "notIn": {
            "items": {
              "type": "string"
            },
            "minItems": 1,
            "type": "array"
          }
        },
        "type": "object"
      },
      "StringPatternFilter": {
        "properties": {
          "endsWith": {
            "minLength": 1,
            "type": "string"
          },
          "eq": {
            "nullable": true,
            "type": "string"
          },
          "in": {
            "items": {
              "type": "string"
            },
            "minItems": 1,
            "type": "array"
          },
          "like": {
            "minLength": 1,
            "type": "string"
          },
          "ne": {
            "nullable": true,
            "type": "string"
          },
          "notIn": {
            "items": {
              "type": "string"
            },
            "minItems": 1,
            "type": "array"
          },
          "notLike": {
            "minLength": 1,
            "type": "string"
          },
          "startsWith": {
            "minLength": 1,
            "type": "string"
          }
        },
        "type": "object"
      },
      "StringSimilarityFilter": {
        "properties": {
          "matches": {
            "minLength": 1,
            "type": "string"
          }
        },
        "required": [
          "matches"
        ],
        "type": "object"
      },
      "SupportModeResponseDto": {
        "properties": {
          "includePaths": {
            "description": "Send file paths as-is instead of redacted placeholders",
            "type": "boolean"
          },
          "remainingRuns": {
            "description": "How many more backup, cleanup, restore and delete runs use verbose restic logging",
            "maximum": 20,
            "minimum": 0,
            "type": "integer"
          },
          "streamToFuto": {
            "description": "Stream those runs’ logs to FUTO; requires the support-log-streaming feature",
            "type": "boolean"
          },
          "streamingAvailable": {
            "description": "Whether this account may stream support logs to FUTO",
            "type": "boolean"
          }
        },
        "required": [
          "includePaths",
          "remainingRuns",
          "streamToFuto",
          "streamingAvailable"
        ],
        "type": "object"
      },
      "SupportModeUpdateRequestDto": {
        "properties": {
          "includePaths": {
            "description": "Send file paths as-is instead of redacted placeholders",
            "type": "boolean"
          },
          "remainingRuns": {
            "description": "How many more backup, cleanup, restore and delete runs use verbose restic logging",
            "maximum": 20,
            "minimum": 0,
            "type": "integer"
          },
          "streamToFuto": {
            "description": "Stream those runs’ logs to FUTO; requires the support-log-streaming feature",
            "type": "boolean"
          }
        },
        "required": [
          "includePaths",
          "remainingRuns",
          "streamToFuto"
        ],
        "type": "object"
      },
      "SyncAckDeleteDto": {
        "properties": {
          "types": {
            "description": "Sync entity types to delete acks for",
            "items": {
              "$ref": "#/components/schemas/SyncEntityType"
            },
            "type": "array"
          }
        },
        "type": "object"
      },
      "SyncAckDto": {
        "properties": {
          "ack": {
            "description": "Acknowledgment ID",
            "type": "string"
          },
          "type": {
            "$ref": "#/components/schemas/SyncEntityType"
          }
        },
        "required": [
          "ack",
          "type"
        ],
        "type": "object"
      },
      "SyncAckSetDto": {
        "properties": {
          "acks": {
            "description": "Acknowledgment IDs (max 1000)",
            "items": {
              "type": "string"
            },
            "maxItems": 1000,
            "type": "array"
          }
        },
        "required": [
          "acks"
        ],
        "type": "object"
      },
      "SyncAckV1": {
        "properties": {},
        "type": "object"
      },
      "SyncAlbumDeleteV1": {
        "properties": {
          "albumId": {
            "description": "Album ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          }
        },
        "required": [
          "albumId"
        ],
        "type": "object"
      },
      "SyncAlbumToAssetDeleteV1": {
        "properties": {
          "albumId": {
            "description": "Album ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          },
          "assetId": {
            "description": "Asset ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          }
        },
        "required": [
          "albumId",
          "assetId"
        ],
        "type": "object"
      },
      "SyncAlbumToAssetV1": {
        "properties": {
          "albumId": {
            "description": "Album ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          },
          "assetId": {
            "description": "Asset ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          }
        },
        "required": [
          "albumId",
          "assetId"
        ],
        "type": "object"
      },
      "SyncAlbumUserDeleteV1": {
        "properties": {
          "albumId": {
            "description": "Album ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          },
          "userId": {
            "description": "User ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          }
        },
        "required": [
          "albumId",
          "userId"
        ],
        "type": "object"
      },
      "SyncAlbumUserV1": {
        "properties": {
          "albumId": {
            "description": "Album ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          },
          "role": {
            "$ref": "#/components/schemas/AlbumUserRole"
          },
          "userId": {
            "description": "User ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          }
        },
        "required": [
          "albumId",
          "role",
          "userId"
        ],
        "type": "object"
      },
      "SyncAlbumV1": {
        "properties": {
          "createdAt": {
            "description": "Created at",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string"
          },
          "description": {
            "description": "Album description",
            "type": "string"
          },
          "id": {
            "description": "Album ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          },
          "isActivityEnabled": {
            "description": "Is activity enabled",
            "type": "boolean"
          },
          "name": {
            "description": "Album name",
            "type": "string"
          },
          "order": {
            "$ref": "#/components/schemas/AssetOrder"
          },
          "ownerId": {
            "description": "Owner ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          },
          "thumbnailAssetId": {
            "description": "Thumbnail asset ID",
            "nullable": true,
            "type": "string"
          },
          "updatedAt": {
            "description": "Updated at",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string"
          }
        },
        "required": [
          "createdAt",
          "description",
          "id",
          "isActivityEnabled",
          "name",
          "order",
          "ownerId",
          "thumbnailAssetId",
          "updatedAt"
        ],
        "type": "object"
      },
      "SyncAlbumV2": {
        "properties": {
          "createdAt": {
            "description": "Created at",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string"
          },
          "description": {
            "description": "Album description",
            "type": "string"
          },
          "id": {
            "description": "Album ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          },
          "isActivityEnabled": {
            "description": "Is activity enabled",
            "type": "boolean"
          },
          "name": {
            "description": "Album name",
            "type": "string"
          },
          "order": {
            "$ref": "#/components/schemas/AssetOrder"
          },
          "thumbnailAssetId": {
            "description": "Thumbnail asset ID",
            "nullable": true,
            "type": "string"
          },
          "updatedAt": {
            "description": "Updated at",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string"
          }
        },
        "required": [
          "createdAt",
          "description",
          "id",
          "isActivityEnabled",
          "name",
          "order",
          "thumbnailAssetId",
          "updatedAt"
        ],
        "type": "object"
      },
      "SyncAssetDeleteV1": {
        "properties": {
          "assetId": {
            "description": "Asset ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          }
        },
        "required": [
          "assetId"
        ],
        "type": "object"
      },
      "SyncAssetEditDeleteV1": {
        "properties": {
          "editId": {
            "description": "Edit ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          }
        },
        "required": [
          "editId"
        ],
        "type": "object"
      },
      "SyncAssetEditV1": {
        "properties": {
          "action": {
            "$ref": "#/components/schemas/AssetEditAction"
          },
          "assetId": {
            "description": "Asset ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          },
          "id": {
            "description": "Edit ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          },
          "parameters": {
            "additionalProperties": {},
            "description": "Edit parameters",
            "type": "object"
          },
          "sequence": {
            "description": "Edit sequence",
            "maximum": 9007199254740991,
            "minimum": -9007199254740991,
            "type": "integer"
          }
        },
        "required": [
          "action",
          "assetId",
          "id",
          "parameters",
          "sequence"
        ],
        "type": "object"
      },
      "SyncAssetExifV1": {
        "properties": {
          "assetId": {
            "description": "Asset ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          },
          "city": {
            "description": "City",
            "nullable": true,
            "type": "string"
          },
          "country": {
            "description": "Country",
            "nullable": true,
            "type": "string"
          },
          "dateTimeOriginal": {
            "description": "Date time original",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "nullable": true,
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string"
          },
          "description": {
            "description": "Description",
            "nullable": true,
            "type": "string"
          },
          "exifImageHeight": {
            "description": "Exif image height",
            "maximum": 9007199254740991,
            "minimum": -9007199254740991,
            "nullable": true,
            "type": "integer"
          },
          "exifImageWidth": {
            "description": "Exif image width",
            "maximum": 9007199254740991,
            "minimum": -9007199254740991,
            "nullable": true,
            "type": "integer"
          },
          "exposureTime": {
            "description": "Exposure time",
            "nullable": true,
            "type": "string"
          },
          "fNumber": {
            "description": "F number",
            "format": "double",
            "nullable": true,
            "type": "number"
          },
          "fileSizeInByte": {
            "description": "File size in byte",
            "maximum": 9007199254740991,
            "minimum": -9007199254740991,
            "nullable": true,
            "type": "integer"
          },
          "focalLength": {
            "description": "Focal length",
            "format": "double",
            "nullable": true,
            "type": "number"
          },
          "fps": {
            "description": "FPS",
            "format": "double",
            "nullable": true,
            "type": "number"
          },
          "iso": {
            "description": "ISO",
            "maximum": 9007199254740991,
            "minimum": -9007199254740991,
            "nullable": true,
            "type": "integer"
          },
          "latitude": {
            "description": "Latitude",
            "format": "double",
            "nullable": true,
            "type": "number"
          },
          "lensModel": {
            "description": "Lens model",
            "nullable": true,
            "type": "string"
          },
          "longitude": {
            "description": "Longitude",
            "format": "double",
            "nullable": true,
            "type": "number"
          },
          "make": {
            "description": "Make",
            "nullable": true,
            "type": "string"
          },
          "model": {
            "description": "Model",
            "nullable": true,
            "type": "string"
          },
          "modifyDate": {
            "description": "Modify date",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "nullable": true,
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string"
          },
          "orientation": {
            "description": "Orientation",
            "nullable": true,
            "type": "string"
          },
          "profileDescription": {
            "description": "Profile description",
            "nullable": true,
            "type": "string"
          },
          "projectionType": {
            "description": "Projection type",
            "nullable": true,
            "type": "string"
          },
          "rating": {
            "description": "Rating",
            "maximum": 9007199254740991,
            "minimum": -9007199254740991,
            "nullable": true,
            "type": "integer"
          },
          "state": {
            "description": "State",
            "nullable": true,
            "type": "string"
          },
          "timeZone": {
            "description": "Time zone",
            "nullable": true,
            "type": "string"
          }
        },
        "required": [
          "assetId",
          "city",
          "country",
          "dateTimeOriginal",
          "description",
          "exifImageHeight",
          "exifImageWidth",
          "exposureTime",
          "fNumber",
          "fileSizeInByte",
          "focalLength",
          "fps",
          "iso",
          "latitude",
          "lensModel",
          "longitude",
          "make",
          "model",
          "modifyDate",
          "orientation",
          "profileDescription",
          "projectionType",
          "rating",
          "state",
          "timeZone"
        ],
        "type": "object"
      },
      "SyncAssetFaceDeleteV1": {
        "properties": {
          "assetFaceId": {
            "description": "Asset face ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          }
        },
        "required": [
          "assetFaceId"
        ],
        "type": "object"
      },
      "SyncAssetFaceV1": {
        "properties": {
          "assetId": {
            "description": "Asset ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          },
          "boundingBoxX1": {
            "description": "Bounding box X1",
            "maximum": 9007199254740991,
            "minimum": -9007199254740991,
            "type": "integer"
          },
          "boundingBoxX2": {
            "description": "Bounding box X2",
            "maximum": 9007199254740991,
            "minimum": -9007199254740991,
            "type": "integer"
          },
          "boundingBoxY1": {
            "description": "Bounding box Y1",
            "maximum": 9007199254740991,
            "minimum": -9007199254740991,
            "type": "integer"
          },
          "boundingBoxY2": {
            "description": "Bounding box Y2",
            "maximum": 9007199254740991,
            "minimum": -9007199254740991,
            "type": "integer"
          },
          "id": {
            "description": "Asset face ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          },
          "imageHeight": {
            "description": "Image height",
            "maximum": 9007199254740991,
            "minimum": -9007199254740991,
            "type": "integer"
          },
          "imageWidth": {
            "description": "Image width",
            "maximum": 9007199254740991,
            "minimum": -9007199254740991,
            "type": "integer"
          },
          "personId": {
            "description": "Person ID",
            "nullable": true,
            "type": "string"
          },
          "sourceType": {
            "description": "Source type",
            "type": "string"
          }
        },
        "required": [
          "assetId",
          "boundingBoxX1",
          "boundingBoxX2",
          "boundingBoxY1",
          "boundingBoxY2",
          "id",
          "imageHeight",
          "imageWidth",
          "personId",
          "sourceType"
        ],
        "type": "object"
      },
      "SyncAssetFaceV3": {
        "properties": {
          "assetId": {
            "description": "Asset ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          },
          "boundingBoxX1": {
            "description": "Bounding box X1",
            "maximum": 9007199254740991,
            "minimum": -9007199254740991,
            "type": "integer"
          },
          "boundingBoxX2": {
            "description": "Bounding box X2",
            "maximum": 9007199254740991,
            "minimum": -9007199254740991,
            "type": "integer"
          },
          "boundingBoxY1": {
            "description": "Bounding box Y1",
            "maximum": 9007199254740991,
            "minimum": -9007199254740991,
            "type": "integer"
          },
          "boundingBoxY2": {
            "description": "Bounding box Y2",
            "maximum": 9007199254740991,
            "minimum": -9007199254740991,
            "type": "integer"
          },
          "deletedAt": {
            "description": "Face deleted at",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "nullable": true,
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string"
          },
          "id": {
            "description": "Asset face ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          },
          "imageHeight": {
            "description": "Image height",
            "maximum": 9007199254740991,
            "minimum": -9007199254740991,
            "type": "integer"
          },
          "imageWidth": {
            "description": "Image width",
            "maximum": 9007199254740991,
            "minimum": -9007199254740991,
            "type": "integer"
          },
          "isVisible": {
            "description": "Is the face visible in the asset",
            "type": "boolean"
          },
          "personId": {
            "description": "Person ID",
            "nullable": true,
            "type": "string"
          },
          "sourceType": {
            "description": "Source type",
            "type": "string"
          }
        },
        "required": [
          "assetId",
          "boundingBoxX1",
          "boundingBoxX2",
          "boundingBoxY1",
          "boundingBoxY2",
          "deletedAt",
          "id",
          "imageHeight",
          "imageWidth",
          "isVisible",
          "personId",
          "sourceType"
        ],
        "type": "object"
      },
      "SyncAssetMetadataDeleteV1": {
        "properties": {
          "assetId": {
            "description": "Asset ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          },
          "key": {
            "description": "Key",
            "type": "string"
          }
        },
        "required": [
          "assetId",
          "key"
        ],
        "type": "object"
      },
      "SyncAssetMetadataV1": {
        "properties": {
          "assetId": {
            "description": "Asset ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          },
          "key": {
            "description": "Key",
            "type": "string"
          },
          "value": {
            "additionalProperties": {},
            "description": "Value",
            "type": "object"
          }
        },
        "required": [
          "assetId",
          "key",
          "value"
        ],
        "type": "object"
      },
      "SyncAssetOcrDeleteV1": {
        "properties": {
          "assetId": {
            "description": "Original asset ID of the deleted OCR entry",
            "type": "string"
          },
          "deletedAt": {
            "description": "Timestamp when the OCR entry was deleted",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string"
          },
          "id": {
            "description": "Audit row ID of the deleted OCR entry",
            "type": "string"
          }
        },
        "required": [
          "assetId",
          "deletedAt",
          "id"
        ],
        "type": "object"
      },
      "SyncAssetOcrV1": {
        "properties": {
          "assetId": {
            "description": "Asset ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          },
          "boxScore": {
            "description": "Confidence score of the bounding box",
            "format": "double",
            "type": "number"
          },
          "id": {
            "description": "OCR entry ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          },
          "isVisible": {
            "description": "Whether the OCR entry is visible",
            "type": "boolean"
          },
          "text": {
            "description": "Recognized text content",
            "type": "string"
          },
          "textScore": {
            "description": "Confidence score of the recognized text",
            "format": "double",
            "type": "number"
          },
          "x1": {
            "description": "Top-left X coordinate (normalized 0–1)",
            "format": "double",
            "type": "number"
          },
          "x2": {
            "description": "Top-right X coordinate (normalized 0–1)",
            "format": "double",
            "type": "number"
          },
          "x3": {
            "description": "Bottom-right X coordinate (normalized 0–1)",
            "format": "double",
            "type": "number"
          },
          "x4": {
            "description": "Bottom-left X coordinate (normalized 0–1)",
            "format": "double",
            "type": "number"
          },
          "y1": {
            "description": "Top-left Y coordinate (normalized 0–1)",
            "format": "double",
            "type": "number"
          },
          "y2": {
            "description": "Top-right Y coordinate (normalized 0–1)",
            "format": "double",
            "type": "number"
          },
          "y3": {
            "description": "Bottom-right Y coordinate (normalized 0–1)",
            "format": "double",
            "type": "number"
          },
          "y4": {
            "description": "Bottom-left Y coordinate (normalized 0–1)",
            "format": "double",
            "type": "number"
          }
        },
        "required": [
          "assetId",
          "boxScore",
          "id",
          "isVisible",
          "text",
          "textScore",
          "x1",
          "x2",
          "x3",
          "x4",
          "y1",
          "y2",
          "y3",
          "y4"
        ],
        "type": "object"
      },
      "SyncAssetV1": {
        "properties": {
          "checksum": {
            "description": "Checksum",
            "type": "string"
          },
          "createdAt": {
            "description": "Uploaded to Immich at",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "nullable": true,
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string"
          },
          "deletedAt": {
            "description": "Deleted at",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "nullable": true,
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string"
          },
          "duration": {
            "description": "Duration",
            "nullable": true,
            "type": "string"
          },
          "fileCreatedAt": {
            "description": "File created at",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "nullable": true,
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string"
          },
          "fileModifiedAt": {
            "description": "File modified at",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "nullable": true,
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string"
          },
          "height": {
            "description": "Asset height",
            "maximum": 9007199254740991,
            "minimum": -9007199254740991,
            "nullable": true,
            "type": "integer"
          },
          "id": {
            "description": "Asset ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          },
          "isEdited": {
            "description": "Is edited",
            "type": "boolean"
          },
          "isFavorite": {
            "description": "Is favorite",
            "type": "boolean"
          },
          "libraryId": {
            "description": "Library ID",
            "nullable": true,
            "type": "string"
          },
          "livePhotoVideoId": {
            "description": "Live photo video ID",
            "nullable": true,
            "type": "string"
          },
          "localDateTime": {
            "description": "Local date time",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "nullable": true,
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string"
          },
          "originalFileName": {
            "description": "Original file name",
            "type": "string"
          },
          "ownerId": {
            "description": "Owner ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          },
          "stackId": {
            "description": "Stack ID",
            "nullable": true,
            "type": "string"
          },
          "thumbhash": {
            "description": "Thumbhash",
            "nullable": true,
            "type": "string"
          },
          "type": {
            "$ref": "#/components/schemas/AssetTypeEnum"
          },
          "visibility": {
            "$ref": "#/components/schemas/AssetVisibility"
          },
          "width": {
            "description": "Asset width",
            "maximum": 9007199254740991,
            "minimum": -9007199254740991,
            "nullable": true,
            "type": "integer"
          }
        },
        "required": [
          "checksum",
          "createdAt",
          "deletedAt",
          "duration",
          "fileCreatedAt",
          "fileModifiedAt",
          "height",
          "id",
          "isEdited",
          "isFavorite",
          "libraryId",
          "livePhotoVideoId",
          "localDateTime",
          "originalFileName",
          "ownerId",
          "stackId",
          "thumbhash",
          "type",
          "visibility",
          "width"
        ],
        "type": "object"
      },
      "SyncAssetV2": {
        "properties": {
          "checksum": {
            "description": "Checksum",
            "type": "string"
          },
          "createdAt": {
            "description": "Uploaded to Immich at",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "nullable": true,
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string"
          },
          "deletedAt": {
            "description": "Deleted at",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "nullable": true,
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string"
          },
          "duration": {
            "description": "Duration",
            "maximum": 2147483647,
            "minimum": 0,
            "nullable": true,
            "type": "integer"
          },
          "fileCreatedAt": {
            "description": "File created at",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "nullable": true,
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string"
          },
          "fileModifiedAt": {
            "description": "File modified at",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "nullable": true,
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string"
          },
          "height": {
            "description": "Asset height",
            "maximum": 9007199254740991,
            "minimum": -9007199254740991,
            "nullable": true,
            "type": "integer"
          },
          "id": {
            "description": "Asset ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          },
          "isEdited": {
            "description": "Is edited",
            "type": "boolean"
          },
          "isFavorite": {
            "description": "Is favorite",
            "type": "boolean"
          },
          "libraryId": {
            "description": "Library ID",
            "nullable": true,
            "type": "string"
          },
          "livePhotoVideoId": {
            "description": "Live photo video ID",
            "nullable": true,
            "type": "string"
          },
          "localDateTime": {
            "description": "Local date time",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "nullable": true,
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string"
          },
          "originalFileName": {
            "description": "Original file name",
            "type": "string"
          },
          "ownerId": {
            "description": "Owner ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          },
          "stackId": {
            "description": "Stack ID",
            "nullable": true,
            "type": "string"
          },
          "thumbhash": {
            "description": "Thumbhash",
            "nullable": true,
            "type": "string"
          },
          "type": {
            "$ref": "#/components/schemas/AssetTypeEnum"
          },
          "visibility": {
            "$ref": "#/components/schemas/AssetVisibility"
          },
          "width": {
            "description": "Asset width",
            "maximum": 9007199254740991,
            "minimum": -9007199254740991,
            "nullable": true,
            "type": "integer"
          }
        },
        "required": [
          "checksum",
          "createdAt",
          "deletedAt",
          "duration",
          "fileCreatedAt",
          "fileModifiedAt",
          "height",
          "id",
          "isEdited",
          "isFavorite",
          "libraryId",
          "livePhotoVideoId",
          "localDateTime",
          "originalFileName",
          "ownerId",
          "stackId",
          "thumbhash",
          "type",
          "visibility",
          "width"
        ],
        "type": "object"
      },
      "SyncAuthUserV1": {
        "properties": {
          "avatarColor": {
            "allOf": [
              {
                "$ref": "#/components/schemas/UserAvatarColor"
              }
            ],
            "nullable": true
          },
          "deletedAt": {
            "description": "User deleted at",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "nullable": true,
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string"
          },
          "email": {
            "description": "User email",
            "type": "string"
          },
          "hasProfileImage": {
            "description": "User has profile image",
            "type": "boolean"
          },
          "id": {
            "description": "User ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          },
          "isAdmin": {
            "description": "User is admin",
            "type": "boolean"
          },
          "name": {
            "description": "User name",
            "type": "string"
          },
          "oauthId": {
            "description": "User OAuth ID",
            "type": "string"
          },
          "pinCode": {
            "description": "User pin code",
            "nullable": true,
            "type": "string"
          },
          "profileChangedAt": {
            "description": "User profile changed at",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string"
          },
          "quotaSizeInBytes": {
            "description": "Quota size in bytes",
            "maximum": 9007199254740991,
            "minimum": -9007199254740991,
            "nullable": true,
            "type": "integer"
          },
          "quotaUsageInBytes": {
            "description": "Quota usage in bytes",
            "maximum": 9007199254740991,
            "minimum": -9007199254740991,
            "type": "integer"
          },
          "storageLabel": {
            "description": "User storage label",
            "nullable": true,
            "type": "string"
          }
        },
        "required": [
          "deletedAt",
          "email",
          "hasProfileImage",
          "id",
          "isAdmin",
          "name",
          "oauthId",
          "pinCode",
          "profileChangedAt",
          "quotaSizeInBytes",
          "quotaUsageInBytes",
          "storageLabel"
        ],
        "type": "object"
      },
      "SyncAuthUserV2": {
        "properties": {
          "avatarColor": {
            "allOf": [
              {
                "$ref": "#/components/schemas/UserAvatarColor"
              }
            ],
            "nullable": true
          },
          "deletedAt": {
            "description": "User deleted at",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "nullable": true,
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string"
          },
          "email": {
            "description": "User email",
            "type": "string"
          },
          "hasProfileImage": {
            "description": "User has profile image",
            "type": "boolean"
          },
          "id": {
            "description": "User ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          },
          "isAdmin": {
            "description": "User is admin",
            "type": "boolean"
          },
          "name": {
            "description": "User name",
            "type": "string"
          },
          "oauthId": {
            "description": "User OAuth ID",
            "nullable": true,
            "type": "string"
          },
          "pinCode": {
            "description": "User pin code",
            "nullable": true,
            "type": "string"
          },
          "profileChangedAt": {
            "description": "User profile changed at",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string"
          },
          "quotaSizeInBytes": {
            "description": "Quota size in bytes",
            "maximum": 9007199254740991,
            "minimum": -9007199254740991,
            "nullable": true,
            "type": "integer"
          },
          "quotaUsageInBytes": {
            "description": "Quota usage in bytes",
            "maximum": 9007199254740991,
            "minimum": -9007199254740991,
            "type": "integer"
          },
          "storageLabel": {
            "description": "User storage label",
            "nullable": true,
            "type": "string"
          }
        },
        "required": [
          "deletedAt",
          "email",
          "hasProfileImage",
          "id",
          "isAdmin",
          "name",
          "oauthId",
          "pinCode",
          "profileChangedAt",
          "quotaSizeInBytes",
          "quotaUsageInBytes",
          "storageLabel"
        ],
        "type": "object"
      },
      "SyncCompleteV1": {
        "properties": {},
        "type": "object"
      },
      "SyncEntityType": {
        "description": "Sync entity type",
        "enum": [
          "AuthUserV1",
          "AuthUserV2",
          "UserV1",
          "UserDeleteV1",
          "AssetV1",
          "AssetV2",
          "AssetDeleteV1",
          "AssetExifV1",
          "AssetEditV1",
          "AssetEditDeleteV1",
          "AssetMetadataV1",
          "AssetMetadataDeleteV1",
          "AssetOcrV1",
          "AssetOcrDeleteV1",
          "PartnerV1",
          "PartnerDeleteV1",
          "PartnerAssetV1",
          "PartnerAssetV2",
          "PartnerAssetBackfillV1",
          "PartnerAssetBackfillV2",
          "PartnerAssetDeleteV1",
          "PartnerAssetExifV1",
          "PartnerAssetExifBackfillV1",
          "PartnerStackBackfillV1",
          "PartnerStackDeleteV1",
          "PartnerStackV1",
          "AlbumV1",
          "AlbumV2",
          "AlbumDeleteV1",
          "AlbumUserV1",
          "AlbumUserBackfillV1",
          "AlbumUserDeleteV1",
          "AlbumAssetCreateV1",
          "AlbumAssetCreateV2",
          "AlbumAssetUpdateV1",
          "AlbumAssetUpdateV2",
          "AlbumAssetBackfillV1",
          "AlbumAssetBackfillV2",
          "AlbumAssetExifCreateV1",
          "AlbumAssetExifUpdateV1",
          "AlbumAssetExifBackfillV1",
          "AlbumToAssetV1",
          "AlbumToAssetDeleteV1",
          "AlbumToAssetBackfillV1",
          "MemoryV1",
          "MemoryV2",
          "MemoryDeleteV1",
          "MemoryToAssetV1",
          "MemoryToAssetV2",
          "MemoryToAssetDeleteV1",
          "StackV1",
          "StackDeleteV1",
          "PersonV1",
          "PersonDeleteV1",
          "AssetFaceV1",
          "AssetFaceV2",
          "AssetFaceV3",
          "AssetFaceDeleteV1",
          "UserMetadataV1",
          "UserMetadataDeleteV1",
          "SyncAckV1",
          "SyncResetV1",
          "SyncCompleteV1"
        ],
        "type": "string"
      },
      "SyncMemoryAssetDeleteV1": {
        "properties": {
          "assetId": {
            "description": "Asset ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          },
          "memoryId": {
            "description": "Memory ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          }
        },
        "required": [
          "assetId",
          "memoryId"
        ],
        "type": "object"
      },
      "SyncMemoryAssetV1": {
        "properties": {
          "assetId": {
            "description": "Asset ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          },
          "memoryId": {
            "description": "Memory ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          }
        },
        "required": [
          "assetId",
          "memoryId"
        ],
        "type": "object"
      },
      "SyncMemoryDeleteV1": {
        "properties": {
          "memoryId": {
            "description": "Memory ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          }
        },
        "required": [
          "memoryId"
        ],
        "type": "object"
      },
      "SyncMemoryV1": {
        "properties": {
          "createdAt": {
            "description": "Created at",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string"
          },
          "data": {
            "additionalProperties": {},
            "description": "Data",
            "type": "object"
          },
          "deletedAt": {
            "description": "Deleted at",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "nullable": true,
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string"
          },
          "hideAt": {
            "description": "Hide at",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "nullable": true,
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string"
          },
          "id": {
            "description": "Memory ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          },
          "isSaved": {
            "description": "Is saved",
            "type": "boolean"
          },
          "memoryAt": {
            "description": "Memory at",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string"
          },
          "ownerId": {
            "description": "Owner ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          },
          "seenAt": {
            "description": "Seen at",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "nullable": true,
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string"
          },
          "showAt": {
            "description": "Show at",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "nullable": true,
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string"
          },
          "type": {
            "$ref": "#/components/schemas/MemoryTypeV1"
          },
          "updatedAt": {
            "description": "Updated at",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string"
          }
        },
        "required": [
          "createdAt",
          "data",
          "deletedAt",
          "hideAt",
          "id",
          "isSaved",
          "memoryAt",
          "ownerId",
          "seenAt",
          "showAt",
          "type",
          "updatedAt"
        ],
        "type": "object"
      },
      "SyncMemoryV2": {
        "properties": {
          "createdAt": {
            "description": "Created at",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string"
          },
          "data": {
            "additionalProperties": {},
            "description": "Data",
            "type": "object"
          },
          "deletedAt": {
            "description": "Deleted at",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "nullable": true,
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string"
          },
          "hideAt": {
            "description": "Hide at",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "nullable": true,
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string"
          },
          "id": {
            "description": "Memory ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          },
          "isSaved": {
            "description": "Is saved",
            "type": "boolean"
          },
          "memoryAt": {
            "description": "Memory at",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string"
          },
          "ownerId": {
            "description": "Owner ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          },
          "seenAt": {
            "description": "Seen at",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "nullable": true,
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string"
          },
          "showAt": {
            "description": "Show at",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "nullable": true,
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string"
          },
          "type": {
            "$ref": "#/components/schemas/MemoryType"
          },
          "updatedAt": {
            "description": "Updated at",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string"
          }
        },
        "required": [
          "createdAt",
          "data",
          "deletedAt",
          "hideAt",
          "id",
          "isSaved",
          "memoryAt",
          "ownerId",
          "seenAt",
          "showAt",
          "type",
          "updatedAt"
        ],
        "type": "object"
      },
      "SyncPartnerDeleteV1": {
        "properties": {
          "sharedById": {
            "description": "Shared by ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          },
          "sharedWithId": {
            "description": "Shared with ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          }
        },
        "required": [
          "sharedById",
          "sharedWithId"
        ],
        "type": "object"
      },
      "SyncPartnerV1": {
        "properties": {
          "inTimeline": {
            "description": "In timeline",
            "type": "boolean"
          },
          "sharedById": {
            "description": "Shared by ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          },
          "sharedWithId": {
            "description": "Shared with ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          }
        },
        "required": [
          "inTimeline",
          "sharedById",
          "sharedWithId"
        ],
        "type": "object"
      },
      "SyncPersonDeleteV1": {
        "properties": {
          "personId": {
            "description": "Person ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          }
        },
        "required": [
          "personId"
        ],
        "type": "object"
      },
      "SyncPersonV1": {
        "properties": {
          "birthDate": {
            "description": "Birth date",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "nullable": true,
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string"
          },
          "color": {
            "description": "Color",
            "nullable": true,
            "type": "string"
          },
          "createdAt": {
            "description": "Created at",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string"
          },
          "faceAssetId": {
            "description": "Face asset ID",
            "nullable": true,
            "type": "string"
          },
          "id": {
            "description": "Person ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          },
          "isFavorite": {
            "description": "Is favorite",
            "type": "boolean"
          },
          "isHidden": {
            "description": "Is hidden",
            "type": "boolean"
          },
          "name": {
            "description": "Person name",
            "type": "string"
          },
          "ownerId": {
            "description": "Owner ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          },
          "updatedAt": {
            "description": "Updated at",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string"
          }
        },
        "required": [
          "birthDate",
          "color",
          "createdAt",
          "faceAssetId",
          "id",
          "isFavorite",
          "isHidden",
          "name",
          "ownerId",
          "updatedAt"
        ],
        "type": "object"
      },
      "SyncRequestType": {
        "description": "Sync request type",
        "enum": [
          "AlbumsV1",
          "AlbumsV2",
          "AlbumUsersV1",
          "AlbumToAssetsV1",
          "AlbumAssetsV1",
          "AlbumAssetsV2",
          "AlbumAssetExifsV1",
          "AssetsV1",
          "AssetsV2",
          "AssetExifsV1",
          "AssetEditsV1",
          "AssetMetadataV1",
          "AssetOcrV1",
          "AuthUsersV1",
          "AuthUsersV2",
          "MemoriesV1",
          "MemoriesV2",
          "MemoryToAssetsV1",
          "MemoryToAssetsV2",
          "PartnersV1",
          "PartnerAssetsV1",
          "PartnerAssetsV2",
          "PartnerAssetExifsV1",
          "PartnerStacksV1",
          "StacksV1",
          "UsersV1",
          "PeopleV1",
          "AssetFacesV1",
          "AssetFacesV2",
          "AssetFacesV3",
          "UserMetadataV1"
        ],
        "type": "string"
      },
      "SyncResetV1": {
        "properties": {},
        "type": "object"
      },
      "SyncStackDeleteV1": {
        "properties": {
          "stackId": {
            "description": "Stack ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          }
        },
        "required": [
          "stackId"
        ],
        "type": "object"
      },
      "SyncStackV1": {
        "properties": {
          "createdAt": {
            "description": "Created at",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string"
          },
          "id": {
            "description": "Stack ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          },
          "ownerId": {
            "description": "Owner ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          },
          "primaryAssetId": {
            "description": "Primary asset ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          },
          "updatedAt": {
            "description": "Updated at",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string"
          }
        },
        "required": [
          "createdAt",
          "id",
          "ownerId",
          "primaryAssetId",
          "updatedAt"
        ],
        "type": "object"
      },
      "SyncStreamDto": {
        "properties": {
          "reset": {
            "description": "Reset sync state",
            "type": "boolean"
          },
          "types": {
            "description": "Sync request types",
            "items": {
              "$ref": "#/components/schemas/SyncRequestType"
            },
            "type": "array"
          }
        },
        "required": [
          "types"
        ],
        "type": "object"
      },
      "SyncUserDeleteV1": {
        "properties": {
          "userId": {
            "description": "User ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          }
        },
        "required": [
          "userId"
        ],
        "type": "object"
      },
      "SyncUserMetadataDeleteV1": {
        "properties": {
          "key": {
            "$ref": "#/components/schemas/UserMetadataKey"
          },
          "userId": {
            "description": "User ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          }
        },
        "required": [
          "key",
          "userId"
        ],
        "type": "object"
      },
      "SyncUserMetadataV1": {
        "properties": {
          "key": {
            "$ref": "#/components/schemas/UserMetadataKey"
          },
          "userId": {
            "description": "User ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          },
          "value": {
            "additionalProperties": {},
            "description": "User metadata value",
            "type": "object"
          }
        },
        "required": [
          "key",
          "userId",
          "value"
        ],
        "type": "object"
      },
      "SyncUserV1": {
        "properties": {
          "avatarColor": {
            "allOf": [
              {
                "$ref": "#/components/schemas/UserAvatarColor"
              }
            ],
            "nullable": true
          },
          "deletedAt": {
            "description": "User deleted at",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "nullable": true,
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string"
          },
          "email": {
            "description": "User email",
            "type": "string"
          },
          "hasProfileImage": {
            "description": "User has profile image",
            "type": "boolean"
          },
          "id": {
            "description": "User ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          },
          "name": {
            "description": "User name",
            "type": "string"
          },
          "profileChangedAt": {
            "description": "User profile changed at",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string"
          }
        },
        "required": [
          "deletedAt",
          "email",
          "hasProfileImage",
          "id",
          "name",
          "profileChangedAt"
        ],
        "type": "object"
      },
      "SystemConfigTemplateStorageOptionDto": {
        "properties": {
          "dayOptions": {
            "description": "Available day format options for storage template",
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "hourOptions": {
            "description": "Available hour format options for storage template",
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "minuteOptions": {
            "description": "Available minute format options for storage template",
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "monthOptions": {
            "description": "Available month format options for storage template",
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "presetOptions": {
            "description": "Available preset template options",
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "secondOptions": {
            "description": "Available second format options for storage template",
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "weekOptions": {
            "description": "Available week format options for storage template",
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "yearOptions": {
            "description": "Available year format options for storage template",
            "items": {
              "type": "string"
            },
            "type": "array"
          }
        },
        "required": [
          "dayOptions",
          "hourOptions",
          "minuteOptions",
          "monthOptions",
          "presetOptions",
          "secondOptions",
          "weekOptions",
          "yearOptions"
        ],
        "type": "object"
      },
      "TagBulkAssetsDto": {
        "properties": {
          "assetIds": {
            "description": "Asset IDs",
            "items": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            },
            "type": "array"
          },
          "tagIds": {
            "description": "Tag IDs",
            "items": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
              "type": "string"
            },
            "type": "array"
          }
        },
        "required": [
          "assetIds",
          "tagIds"
        ],
        "type": "object"
      },
      "TagBulkAssetsResponseDto": {
        "properties": {
          "count": {
            "description": "Number of assets tagged",
            "maximum": 9007199254740991,
            "minimum": -9007199254740991,
            "type": "integer"
          }
        },
        "required": [
          "count"
        ],
        "type": "object"
      },
      "TagCreateDto": {
        "properties": {
          "color": {
            "description": "Tag color (hex)",
            "nullable": true,
            "pattern": "^#?([0-9A-Fa-f]{3}|[0-9A-Fa-f]{4}|[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$",
            "type": "string"
          },
          "name": {
            "description": "Tag name",
            "pattern": "^[^/]*$",
            "type": "string"
          },
          "parentId": {
            "description": "Parent tag ID",
            "format": "uuid",
            "nullable": true,
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          }
        },
        "required": [
          "name"
        ],
        "type": "object"
      },
      "TagResponseDto": {
        "properties": {
          "color": {
            "description": "Tag color (hex)",
            "type": "string"
          },
          "createdAt": {
            "description": "Creation date",
            "format": "date-time",
            "type": "string"
          },
          "id": {
            "description": "Tag ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          },
          "name": {
            "description": "Tag name",
            "type": "string"
          },
          "parentId": {
            "description": "Parent tag ID",
            "type": "string"
          },
          "updatedAt": {
            "description": "Last update date",
            "format": "date-time",
            "type": "string"
          },
          "value": {
            "description": "Tag value (full path)",
            "type": "string"
          }
        },
        "required": [
          "createdAt",
          "id",
          "name",
          "updatedAt",
          "value"
        ],
        "type": "object"
      },
      "TagUpdateDto": {
        "properties": {
          "color": {
            "description": "Tag color (hex)",
            "nullable": true,
            "pattern": "^#?([0-9A-Fa-f]{3}|[0-9A-Fa-f]{4}|[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$",
            "type": "string"
          },
          "name": {
            "description": "Tag name",
            "pattern": "^[^/]*$",
            "type": "string"
          }
        },
        "type": "object"
      },
      "TagUpsertDto": {
        "properties": {
          "tags": {
            "description": "Tag names to upsert",
            "items": {
              "type": "string"
            },
            "type": "array"
          }
        },
        "required": [
          "tags"
        ],
        "type": "object"
      },
      "TagsResponse": {
        "properties": {
          "enabled": {
            "description": "Whether tags are enabled",
            "type": "boolean"
          },
          "sidebarWeb": {
            "description": "Whether tags appear in web sidebar",
            "type": "boolean"
          }
        },
        "required": [
          "enabled",
          "sidebarWeb"
        ],
        "type": "object"
      },
      "TagsUpdate": {
        "properties": {
          "enabled": {
            "description": "Whether tags are enabled",
            "type": "boolean"
          },
          "sidebarWeb": {
            "description": "Whether tags appear in web sidebar",
            "type": "boolean"
          }
        },
        "type": "object"
      },
      "TelemetryLevel": {
        "enum": [
          "full",
          "none"
        ],
        "type": "string"
      },
      "TemplateDto": {
        "properties": {
          "template": {
            "description": "Template name",
            "type": "string"
          }
        },
        "required": [
          "template"
        ],
        "type": "object"
      },
      "TemplateResponseDto": {
        "properties": {
          "html": {
            "description": "Template HTML content",
            "type": "string"
          },
          "name": {
            "description": "Template name",
            "type": "string"
          }
        },
        "required": [
          "html",
          "name"
        ],
        "type": "object"
      },
      "TestEmailResponseDto": {
        "properties": {
          "messageId": {
            "description": "Email message ID",
            "type": "string"
          }
        },
        "required": [
          "messageId"
        ],
        "type": "object"
      },
      "TicketAction": {
        "enum": [
          "repository.delete",
          "repository.disable-worm"
        ],
        "type": "string"
      },
      "TicketCreateRequestDto": {
        "properties": {
          "action": {
            "$ref": "#/components/schemas/TicketAction"
          },
          "repositoryId": {
            "description": "Repository the ticket is bound to",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
            "type": "string"
          }
        },
        "required": [
          "action",
          "repositoryId"
        ],
        "type": "object"
      },
      "TicketCreateResponseDto": {
        "properties": {
          "redirectTo": {
            "description": "Identity provider URL the browser must be sent to",
            "type": "string"
          }
        },
        "required": [
          "redirectTo"
        ],
        "type": "object"
      },
      "TimeBucketAssetResponseDto": {
        "properties": {
          "city": {
            "description": "Array of city names extracted from EXIF GPS data",
            "items": {
              "nullable": true,
              "type": "string"
            },
            "type": "array"
          },
          "country": {
            "description": "Array of country names extracted from EXIF GPS data",
            "items": {
              "nullable": true,
              "type": "string"
            },
            "type": "array"
          },
          "createdAt": {
            "description": "Array of UTC timestamps when each asset was originally uploaded to Immich",
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "duration": {
            "description": "Array of video/gif durations in milliseconds (null for static images)",
            "items": {
              "maximum": 2147483647,
              "minimum": 0,
              "nullable": true,
              "type": "integer"
            },
            "type": "array"
          },
          "fileCreatedAt": {
            "description": "Array of file creation timestamps in UTC",
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "id": {
            "description": "Array of asset IDs in the time bucket",
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "isFavorite": {
            "description": "Array indicating whether each asset is favorited",
            "items": {
              "type": "boolean"
            },
            "type": "array"
          },
          "isImage": {
            "description": "Array indicating whether each asset is an image (false for videos)",
            "items": {
              "type": "boolean"
            },
            "type": "array"
          },
          "isTrashed": {
            "description": "Array indicating whether each asset is in the trash",
            "items": {
              "type": "boolean"
            },
            "type": "array"
          },
          "latitude": {
            "description": "Array of latitude coordinates extracted from EXIF GPS data",
            "items": {
              "format": "double",
              "nullable": true,
              "type": "number"
            },
            "type": "array"
          },
          "livePhotoVideoId": {
            "description": "Array of live photo video asset IDs (null for non-live photos)",
            "items": {
              "nullable": true,
              "type": "string"
            },
            "type": "array"
          },
          "localOffsetHours": {
            "description": "Array of UTC offset hours at the time each photo was taken. Positive values are east of UTC, negative values are west of UTC. Values may be fractional (e.g., 5.5 for +05:30, -9.75 for -09:45). Applying this offset to 'fileCreatedAt' will give you the time the photo was taken from the photographer's perspective.",
            "items": {
              "format": "double",
              "type": "number"
            },
            "type": "array"
          },
          "longitude": {
            "description": "Array of longitude coordinates extracted from EXIF GPS data",
            "items": {
              "format": "double",
              "nullable": true,
              "type": "number"
            },
            "type": "array"
          },
          "ownerId": {
            "description": "Array of owner IDs for each asset",
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "projectionType": {
            "description": "Array of projection types for 360° content (e.g., \"EQUIRECTANGULAR\", \"CUBEFACE\", \"CYLINDRICAL\")",
            "items": {
              "nullable": true,
              "type": "string"
            },
            "type": "array"
          },
          "ratio": {
            "description": "Array of aspect ratios (width/height) for each asset",
            "items": {
              "format": "double",
              "type": "number"
            },
            "type": "array"
          },
          "stack": {
            "description": "Array of stack information as [stackId, assetCount] tuples (null for non-stacked assets)",
            "items": {
              "items": {
                "type": "string"
              },
              "maxItems": 2,
              "minItems": 2,
              "nullable": true,
              "type": "array"
            },
            "type": "array"
          },
          "thumbhash": {
            "description": "Array of BlurHash strings for generating asset previews (base64 encoded)",
            "items": {
              "nullable": true,
              "type": "string"
            },
            "type": "array"
          },
          "visibility": {
            "description": "Array of visibility statuses for each asset (e.g., ARCHIVE, TIMELINE, HIDDEN, LOCKED)",
            "items": {
              "$ref": "#/components/schemas/AssetVisibility"
            },
            "type": "array"
          }
        },
        "required": [
          "createdAt",
          "duration",
          "fileCreatedAt",
          "id",
          "isFavorite",
          "isImage",
          "isTrashed",
          "livePhotoVideoId",
          "localOffsetHours",
          "ownerId",
          "projectionType",
          "ratio",
          "thumbhash",
          "visibility"
        ],
        "type": "object"
      },
      "TimeBucketsResponseDto": {
        "properties": {
          "count": {
            "description": "Number of assets in this time bucket",
            "example": 42,
            "maximum": 9007199254740991,
            "minimum": -9007199254740991,
            "type": "integer"
          },
          "timeBucket": {
            "description": "Time bucket identifier in YYYY-MM-DD format representing the start of the time period",
            "example": "2024-01-01",
            "type": "string"
          }
        },
        "required": [
          "count",
          "timeBucket"
        ],
        "type": "object"
      },
      "ToneMapping": {
        "description": "Tone mapping",
        "enum": [
          "hable",
          "mobius",
          "reinhard",
          "disabled"
        ],
        "type": "string"
      },
      "TranscodeHWAccel": {
        "description": "Transcode hardware acceleration",
        "enum": [
          "nvenc",
          "qsv",
          "vaapi",
          "rkmpp",
          "disabled"
        ],
        "type": "string"
      },
      "TranscodePolicy": {
        "description": "Transcode policy",
        "enum": [
          "all",
          "optimal",
          "bitrate",
          "required",
          "disabled"
        ],
        "type": "string"
      },
      "TrashResponseDto": {
        "properties": {
          "count": {
            "description": "Number of items in trash",
            "maximum": 9007199254740991,
            "minimum": -9007199254740991,
            "type": "integer"
          }
        },
        "required": [
          "count"
        ],
        "type": "object"
      },
      "UpdateAlbumDto": {
        "properties": {
          "albumName": {
            "description": "Album name",
            "type": "string"
          },
          "albumThumbnailAssetId": {
            "description": "Album thumbnail asset ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          },
          "description": {
            "description": "Album description",
            "nullable": true,
            "type": "string",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v3",
                "state": "Updated",
                "description": "Sending an empty string is deprecated; send null instead. Empty strings will no longer be coerced to null in v4."
              }
            ]
          },
          "isActivityEnabled": {
            "description": "Enable activity feed",
            "type": "boolean"
          },
          "order": {
            "$ref": "#/components/schemas/AssetOrder"
          }
        },
        "type": "object"
      },
      "UpdateAlbumUserDto": {
        "properties": {
          "role": {
            "$ref": "#/components/schemas/AlbumUserRole"
          }
        },
        "required": [
          "role"
        ],
        "type": "object"
      },
      "UpdateAssetDto": {
        "properties": {
          "dateTimeOriginal": {
            "description": "Original date and time",
            "type": "string"
          },
          "description": {
            "description": "Asset description",
            "type": "string"
          },
          "isFavorite": {
            "description": "Mark as favorite",
            "type": "boolean"
          },
          "latitude": {
            "description": "Latitude coordinate",
            "format": "double",
            "maximum": 90,
            "minimum": -90,
            "type": "number"
          },
          "livePhotoVideoId": {
            "description": "Live photo video ID",
            "format": "uuid",
            "nullable": true,
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          },
          "longitude": {
            "description": "Longitude coordinate",
            "format": "double",
            "maximum": 180,
            "minimum": -180,
            "type": "number"
          },
          "rating": {
            "description": "Rating in range [1-5] (starred), -1 (rejected), or null (unrated)",
            "maximum": 5,
            "minimum": -1,
            "nullable": true,
            "type": "integer",
            "x-immich-history": [
              {
                "version": "v1",
                "state": "Added"
              },
              {
                "version": "v2",
                "state": "Stable"
              },
              {
                "version": "v3",
                "state": "Updated",
                "description": "Using 0 as a rating is no longer valid."
              }
            ],
            "x-immich-state": "Stable"
          },
          "visibility": {
            "$ref": "#/components/schemas/AssetVisibility"
          }
        },
        "type": "object"
      },
      "UpdateLibraryDto": {
        "properties": {
          "exclusionPatterns": {
            "description": "Exclusion patterns (max 128)",
            "items": {
              "type": "string"
            },
            "maxItems": 128,
            "type": "array"
          },
          "importPaths": {
            "description": "Import paths (max 128)",
            "items": {
              "type": "string"
            },
            "maxItems": 128,
            "type": "array"
          },
          "name": {
            "description": "Library name",
            "minLength": 1,
            "type": "string"
          }
        },
        "type": "object"
      },
      "UsageByUserDto": {
        "properties": {
          "photos": {
            "description": "Number of photos",
            "maximum": 9007199254740991,
            "minimum": -9007199254740991,
            "type": "integer"
          },
          "quotaSizeInBytes": {
            "description": "User quota size in bytes (null if unlimited)",
            "maximum": 9007199254740991,
            "minimum": -9007199254740991,
            "nullable": true,
            "type": "integer"
          },
          "usage": {
            "description": "Total storage usage in bytes",
            "maximum": 9007199254740991,
            "minimum": -9007199254740991,
            "type": "integer"
          },
          "usagePhotos": {
            "description": "Storage usage for photos in bytes",
            "maximum": 9007199254740991,
            "minimum": -9007199254740991,
            "type": "integer"
          },
          "usageVideos": {
            "description": "Storage usage for videos in bytes",
            "maximum": 9007199254740991,
            "minimum": -9007199254740991,
            "type": "integer"
          },
          "userId": {
            "description": "User ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          },
          "userName": {
            "description": "User name",
            "type": "string"
          },
          "videos": {
            "description": "Number of videos",
            "maximum": 9007199254740991,
            "minimum": -9007199254740991,
            "type": "integer"
          }
        },
        "required": [
          "photos",
          "quotaSizeInBytes",
          "usage",
          "usagePhotos",
          "usageVideos",
          "userId",
          "userName",
          "videos"
        ],
        "type": "object"
      },
      "UserAdminCreateDto": {
        "properties": {
          "avatarColor": {
            "allOf": [
              {
                "$ref": "#/components/schemas/UserAvatarColor"
              }
            ],
            "nullable": true
          },
          "email": {
            "description": "User email",
            "format": "email",
            "pattern": "^[\\p{L}\\p{M}\\p{N}.!#$%&'*+/=?^_`{|}~-]+@[\\p{L}\\p{N}](?:[\\p{L}\\p{M}\\p{N}-]{0,61}[\\p{L}\\p{M}\\p{N}])?(?:\\.[\\p{L}\\p{N}](?:[\\p{L}\\p{M}\\p{N}-]{0,61}[\\p{L}\\p{M}\\p{N}])?)*$",
            "type": "string"
          },
          "isAdmin": {
            "description": "Grant admin privileges",
            "type": "boolean"
          },
          "name": {
            "description": "User name",
            "type": "string"
          },
          "notify": {
            "description": "Send notification email",
            "type": "boolean"
          },
          "password": {
            "description": "User password",
            "type": "string"
          },
          "pinCode": {
            "description": "PIN code",
            "example": "123456",
            "nullable": true,
            "pattern": "^\\d{6}$",
            "type": "string"
          },
          "quotaSizeInBytes": {
            "description": "Storage quota in bytes",
            "maximum": 9007199254740991,
            "minimum": 0,
            "nullable": true,
            "type": "integer"
          },
          "shouldChangePassword": {
            "description": "Require password change on next login",
            "type": "boolean"
          },
          "storageLabel": {
            "description": "Storage label",
            "nullable": true,
            "type": "string"
          }
        },
        "required": [
          "email",
          "name",
          "password"
        ],
        "type": "object"
      },
      "UserAdminDeleteDto": {
        "properties": {
          "force": {
            "description": "Force delete even if user has assets",
            "type": "boolean"
          }
        },
        "type": "object"
      },
      "UserAdminResponseDto": {
        "properties": {
          "avatarColor": {
            "$ref": "#/components/schemas/UserAvatarColor"
          },
          "clusterGroupId": {
            "description": "Cluster group the user is a member of",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string",
            "x-immich-history": [
              {
                "version": "v3.2.0",
                "state": "Added"
              }
            ]
          },
          "createdAt": {
            "description": "Creation date",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string"
          },
          "deletedAt": {
            "description": "Deletion date",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "nullable": true,
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string"
          },
          "email": {
            "description": "User email",
            "format": "email",
            "pattern": "^[\\p{L}\\p{M}\\p{N}.!#$%&'*+/=?^_`{|}~-]+@[\\p{L}\\p{N}](?:[\\p{L}\\p{M}\\p{N}-]{0,61}[\\p{L}\\p{M}\\p{N}])?(?:\\.[\\p{L}\\p{N}](?:[\\p{L}\\p{M}\\p{N}-]{0,61}[\\p{L}\\p{M}\\p{N}])?)*$",
            "type": "string"
          },
          "id": {
            "description": "User ID",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
            "type": "string"
          },
          "isAdmin": {
            "description": "Is admin user",
            "type": "boolean"
          },
          "license": {
            "allOf": [
              {
                "$ref": "#/components/schemas/UserLicense"
              }
            ],
            "nullable": true
          },
          "name": {
            "description": "User name",
            "type": "string"
          },
          "oauthId": {
            "description": "OAuth ID",
            "type": "string"
          },
          "profileChangedAt": {
            "description": "Profile change date",
            "format": "date-time",
            "type": "string"
          },
          "profileImagePath": {
            "description": "Profile image path",
            "type": "string"
          },
          "quotaSizeInBytes": {
            "description": "Storage quota in bytes",
            "maximum": 9007199254740991,
            "minimum": 0,
            "nullable": true,
            "type": "integer"
          },
          "quotaUsageInBytes": {
            "description": "Storage usage in bytes",
            "maximum": 9007199254740991,
            "minimum": 0,
            "nullable": true,
            "type": "integer"
          },
          "shouldChangePassword": {
            "description": "Require password change on next login",
            "type": "boolean"
          },
          "status": {
            "$ref": "#/components/schemas/UserStatus"
          },
          "storageLabel": {
            "description": "Storage label",
            "nullable": true,
            "type": "string"
          },
          "updatedAt": {
            "description": "Last update date",
            "example": "2024-01-01T00:00:00.000Z",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "type": "string"
          }
        },
        "required": [
          "avatarColor",
          "clusterGroupId",
          "createdAt",
          "deletedAt",
          "email",
          "id",
          "isAdmin",
          "license",
          "name",
          "oauthId",
          "profileChangedAt",
          "profileImagePath",
          "quotaSizeInBytes",
          "quotaUsageInBytes",
          "shouldChangePassword",
          "status",
          "storageLabel",
          "updatedAt"
        ],
        "type": "object"
      },
      "UserAdminUpdateDto": {
        "properties": {
          "avatarColor": {
            "allOf": [
              {
                "$ref": "#/components/schemas/UserAvatarColor"
              }
            ],
            "nullable": true
          },
          "email": {
            "description": "User email",
            "format": "email",
            "pattern": "^[\\p{L}\\p{M}\\p{N}.!#$%&'*+/=?^_`{|}~-]+@[\\p{L}\\p{N}](?:[\\p{L}\\p{M}\\p{N}-]{0,61}[\\p{L}\\p{M}\\p{N}])?(?:\\.[\\p{L}\\p{N}](?:[\\p{L}\\p{M}\\p{N}-]{0,61}[\\p{L}\\p{M}\\p{N}])?)*$",
            "type": "string"
          },
          "isAdmin": {
            "description": "Grant admin privileges",
            "type": "boolean"
          },
          "name": {
            "description": "User name",
            "type": "string"
          },
          "password": {
            "description": "User password",
            "type": "string"
          },
          "pinCode": {
            "description": "PIN code",
            "example": "123456",
            "nullable": true,
            "pattern": "^\\d{6}$",
            "type": "string"
          },
          "quotaSizeInBytes": {
            "description": "Storage quota in bytes",
            "maximum": 9007199254740991,
            "minimum": 0,
            "nullable": true,
            "type": "integer"
          },
          "shouldChangePassword": {
            "description": "Require password change on next login",
            "type": "boolean"
          },
          "storageLabel": {
            "description": "Storage label",
            "nullable": true,
            "type": "string"
          }
        },
        "type": "object"
      },
      "UserAvatarColor": {
        "description": "User avatar color",
        "enum": [
          "primary",
          "pink",
          "red",
          "yellow",
          "blue",
          "green",
          "purple",
          "orange",
          "gray",
          "amber"
        ],
        "type": "string"
      },
      "UserConfigClipDto": {
        "properties": {
          "enabled": {
            "description": "Whether the task is enabled",
            "type": "boolean"
          }
        },
        "required": [
          "enabled"
        ],
        "type": "object"
      },
      "UserConfigDto": {
        "description": "Configuration properties that are visible to a logged user",
        "properties": {
          "ffmpeg": {
            "$ref": "#/components/schemas/UserConfigFFmpegDto"
          },
          "image": {
            "$ref": "#/components/schemas/UserConfigImageDto"
          },
          "machineLearning": {
            "$ref": "#/components/schemas/UserConfigMachineLearningDto"
          },
          "map": {
            "$ref": "#/components/schemas/UserConfigMapDto"
          },
          "notifications": {
            "$ref": "#/components/schemas/UserConfigNotificationsDto"
          },
          "oauth": {
            "$ref": "#/components/schemas/UserConfigOAuthDto"
          },
          "passkey": {
            "$ref": "#/components/schemas/UserConfigPasskeyDto"
          },
          "passwordLogin": {
            "$ref": "#/components/schemas/UserConfigPasswordLoginDto"
          },
          "reverseGeocoding": {
            "$ref": "#/components/schemas/UserConfigReverseGeocodingDto"
          },
          "server": {
            "$ref": "#/components/schemas/UserConfigServerDto"
          },
          "trash": {
            "$ref": "#/components/schemas/UserConfigTrashDto"
          },
          "user": {
            "$ref": "#/components/schemas/UserConfigUserDto"
          }
        },
        "required": [
          "ffmpeg",
          "image",
          "machineLearning",
          "map",
          "notifications",
          "oauth",
          "passkey",
          "passwordLogin",
          "reverseGeocoding",
          "server",
          "trash",
          "user"
        ],
        "type": "object"
      },
      "UserConfigDuplicateDetectionDto": {
        "properties": {
          "enabled": {
            "description": "Whether the task is enabled",
            "type": "boolean"
          }
        },
        "required": [
          "enabled"
        ],
        "type": "object"
      },
      "UserConfigFFmpegDto": {
        "properties": {
          "realtime": {
            "$ref": "#/components/schemas/UserConfigFFmpegRealtimeDto"
          }
        },
        "required": [
          "realtime"
        ],
        "type": "object"
      },
      "UserConfigFFmpegRealtimeDto": {
        "properties": {
          "enabled": {
            "description": "Enable real-time HLS transcoding (alpha)",
            "type": "boolean"
          },
          "resolutions": {
            "description": "Resolutions to use for real-time HLS transcoding",
            "items": {
              "$ref": "#/components/schemas/HlsVideoResolution"
 

File truncated at 1 MB.