immich/server/immich-openapi-specs.json

{
  "openapi": "3.0.0",
  "paths": {
    "/album": {
      "get": {
        "operationId": "getAllAlbums",
        "parameters": [
          {
            "name": "shared",
            "required": false,
            "in": "query",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "assetId",
            "required": false,
            "in": "query",
            "description": "Only returns albums that contain the asset\nIgnores the shared parameter\nundefined: get all albums",
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/AlbumResponseDto"
                  }
                }
              }
            }
          }
        },
        "tags": [
          "Album"
        ],
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ]
      },
      "post": {
        "operationId": "createAlbum",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateAlbumDto"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AlbumResponseDto"
                }
              }
            }
          }
        },
        "tags": [
          "Album"
        ],
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ]
      }
    },
    "/api-key": {
      "post": {
        "operationId": "createKey",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/APIKeyCreateDto"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/APIKeyCreateResponseDto"
                }
              }
            }
          }
        },
        "tags": [
          "API Key"
        ],
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ]
      },
      "get": {
        "operationId": "getKeys",
        "parameters": [],
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/APIKeyResponseDto"
                  }
                }
              }
            }
          }
        },
        "tags": [
          "API Key"
        ],
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ]
      }
    },
    "/api-key/{id}": {
      "get": {
        "operationId": "getKey",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/APIKeyResponseDto"
                }
              }
            }
          }
        },
        "tags": [
          "API Key"
        ],
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ]
      },
      "put": {
        "operationId": "updateKey",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/APIKeyUpdateDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/APIKeyResponseDto"
                }
              }
            }
          }
        },
        "tags": [
          "API Key"
        ],
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ]
      },
      "delete": {
        "operationId": "deleteKey",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": ""
          }
        },
        "tags": [
          "API Key"
        ],
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ]
      }
    },
    "/auth/login": {
      "post": {
        "operationId": "login",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/LoginCredentialDto"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/LoginResponseDto"
                }
              }
            }
          }
        },
        "tags": [
          "Authentication"
        ]
      }
    },
    "/auth/admin-sign-up": {
      "post": {
        "operationId": "adminSignUp",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SignUpDto"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AdminSignupResponseDto"
                }
              }
            }
          },
          "400": {
            "description": "The server already has an admin"
          }
        },
        "tags": [
          "Authentication"
        ]
      }
    },
    "/auth/devices": {
      "get": {
        "operationId": "getAuthDevices",
        "parameters": [],
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/AuthDeviceResponseDto"
                  }
                }
              }
            }
          }
        },
        "tags": [
          "Authentication"
        ],
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ]
      },
      "delete": {
        "operationId": "logoutAuthDevices",
        "parameters": [],
        "responses": {
          "200": {
            "description": ""
          }
        },
        "tags": [
          "Authentication"
        ],
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ]
      }
    },
    "/auth/devices/{id}": {
      "delete": {
        "operationId": "logoutAuthDevice",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": ""
          }
        },
        "tags": [
          "Authentication"
        ],
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ]
      }
    },
    "/auth/validateToken": {
      "post": {
        "operationId": "validateAccessToken",
        "parameters": [],
        "responses": {
          "201": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ValidateAccessTokenResponseDto"
                }
              }
            }
          }
        },
        "tags": [
          "Authentication"
        ],
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ]
      }
    },
    "/auth/change-password": {
      "post": {
        "operationId": "changePassword",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ChangePasswordDto"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UserResponseDto"
                }
              }
            }
          }
        },
        "tags": [
          "Authentication"
        ],
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ]
      }
    },
    "/auth/logout": {
      "post": {
        "operationId": "logout",
        "parameters": [],
        "responses": {
          "201": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/LogoutResponseDto"
                }
              }
            }
          }
        },
        "tags": [
          "Authentication"
        ],
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ]
      }
    },
    "/jobs": {
      "get": {
        "operationId": "getAllJobsStatus",
        "parameters": [],
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AllJobStatusResponseDto"
                }
              }
            }
          }
        },
        "tags": [
          "Job"
        ],
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ]
      }
    },
    "/jobs/{jobId}": {
      "put": {
        "operationId": "sendJobCommand",
        "parameters": [
          {
            "name": "jobId",
            "required": true,
            "in": "path",
            "schema": {
              "$ref": "#/components/schemas/JobName"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/JobCommandDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/JobStatusDto"
                }
              }
            }
          }
        },
        "tags": [
          "Job"
        ],
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ]
      }
    },
    "/oauth/mobile-redirect": {
      "get": {
        "operationId": "mobileRedirect",
        "parameters": [],
        "responses": {
          "200": {
            "description": ""
          }
        },
        "tags": [
          "OAuth"
        ]
      }
    },
    "/oauth/config": {
      "post": {
        "operationId": "generateConfig",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/OAuthConfigDto"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OAuthConfigResponseDto"
                }
              }
            }
          }
        },
        "tags": [
          "OAuth"
        ]
      }
    },
    "/oauth/callback": {
      "post": {
        "operationId": "callback",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/OAuthCallbackDto"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/LoginResponseDto"
                }
              }
            }
          }
        },
        "tags": [
          "OAuth"
        ]
      }
    },
    "/oauth/link": {
      "post": {
        "operationId": "link",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/OAuthCallbackDto"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UserResponseDto"
                }
              }
            }
          }
        },
        "tags": [
          "OAuth"
        ],
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ]
      }
    },
    "/oauth/unlink": {
      "post": {
        "operationId": "unlink",
        "parameters": [],
        "responses": {
          "201": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UserResponseDto"
                }
              }
            }
          }
        },
        "tags": [
          "OAuth"
        ],
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ]
      }
    },
    "/search": {
      "get": {
        "operationId": "search",
        "parameters": [
          {
            "name": "q",
            "required": false,
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "query",
            "required": false,
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "clip",
            "required": false,
            "in": "query",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "type",
            "required": false,
            "in": "query",
            "schema": {
              "enum": [
                "IMAGE",
                "VIDEO",
                "AUDIO",
                "OTHER"
              ],
              "type": "string"
            }
          },
          {
            "name": "isFavorite",
            "required": false,
            "in": "query",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "isArchived",
            "required": false,
            "in": "query",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "exifInfo.city",
            "required": false,
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "exifInfo.state",
            "required": false,
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "exifInfo.country",
            "required": false,
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "exifInfo.make",
            "required": false,
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "exifInfo.model",
            "required": false,
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "smartInfo.objects",
            "required": false,
            "in": "query",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          },
          {
            "name": "smartInfo.tags",
            "required": false,
            "in": "query",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          },
          {
            "name": "recent",
            "required": false,
            "in": "query",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "motion",
            "required": false,
            "in": "query",
            "schema": {
              "type": "boolean"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SearchResponseDto"
                }
              }
            }
          }
        },
        "tags": [
          "Search"
        ],
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ]
      }
    },
    "/search/config": {
      "get": {
        "operationId": "getSearchConfig",
        "parameters": [],
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SearchConfigResponseDto"
                }
              }
            }
          }
        },
        "tags": [
          "Search"
        ],
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ]
      }
    },
    "/search/explore": {
      "get": {
        "operationId": "getExploreData",
        "parameters": [],
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/SearchExploreResponseDto"
                  }
                }
              }
            }
          }
        },
        "tags": [
          "Search"
        ],
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ]
      }
    },
    "/server-info": {
      "get": {
        "operationId": "getServerInfo",
        "parameters": [],
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ServerInfoResponseDto"
                }
              }
            }
          }
        },
        "tags": [
          "Server Info"
        ],
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ]
      }
    },
    "/server-info/ping": {
      "get": {
        "operationId": "pingServer",
        "parameters": [],
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ServerPingResponse"
                }
              }
            }
          }
        },
        "tags": [
          "Server Info"
        ]
      }
    },
    "/server-info/version": {
      "get": {
        "operationId": "getServerVersion",
        "parameters": [],
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ServerVersionReponseDto"
                }
              }
            }
          }
        },
        "tags": [
          "Server Info"
        ]
      }
    },
    "/server-info/stats": {
      "get": {
        "operationId": "getStats",
        "parameters": [],
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ServerStatsResponseDto"
                }
              }
            }
          }
        },
        "tags": [
          "Server Info"
        ],
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ]
      }
    },
    "/share": {
      "get": {
        "operationId": "getAllSharedLinks",
        "parameters": [],
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/SharedLinkResponseDto"
                  }
                }
              }
            }
          }
        },
        "tags": [
          "share"
        ],
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ]
      }
    },
    "/share/me": {
      "get": {
        "operationId": "getMySharedLink",
        "parameters": [
          {
            "name": "key",
            "required": false,
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SharedLinkResponseDto"
                }
              }
            }
          }
        },
        "tags": [
          "share"
        ],
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ]
      }
    },
    "/share/{id}": {
      "get": {
        "operationId": "getSharedLinkById",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SharedLinkResponseDto"
                }
              }
            }
          }
        },
        "tags": [
          "share"
        ],
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ]
      },
      "delete": {
        "operationId": "removeSharedLink",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": ""
          }
        },
        "tags": [
          "share"
        ],
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ]
      },
      "patch": {
        "operationId": "editSharedLink",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/EditSharedLinkDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SharedLinkResponseDto"
                }
              }
            }
          }
        },
        "tags": [
          "share"
        ],
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ]
      }
    },
    "/system-config": {
      "get": {
        "operationId": "getConfig",
        "parameters": [],
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SystemConfigDto"
                }
              }
            }
          }
        },
        "tags": [
          "System Config"
        ],
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ]
      },
      "put": {
        "operationId": "updateConfig",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SystemConfigDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SystemConfigDto"
                }
              }
            }
          }
        },
        "tags": [
          "System Config"
        ],
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ]
      }
    },
    "/system-config/defaults": {
      "get": {
        "operationId": "getDefaults",
        "parameters": [],
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SystemConfigDto"
                }
              }
            }
          }
        },
        "tags": [
          "System Config"
        ],
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ]
      }
    },
    "/system-config/storage-template-options": {
      "get": {
        "operationId": "getStorageTemplateOptions",
        "parameters": [],
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SystemConfigTemplateStorageOptionDto"
                }
              }
            }
          }
        },
        "tags": [
          "System Config"
        ],
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ]
      }
    },
    "/user": {
      "get": {
        "operationId": "getAllUsers",
        "parameters": [
          {
            "name": "isAll",
            "required": true,
            "in": "query",
            "schema": {
              "type": "boolean"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/UserResponseDto"
                  }
                }
              }
            }
          }
        },
        "tags": [
          "User"
        ],
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ]
      },
      "post": {
        "operationId": "createUser",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateUserDto"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UserResponseDto"
                }
              }
            }
          }
        },
        "tags": [
          "User"
        ],
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ]
      },
      "put": {
        "operationId": "updateUser",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateUserDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UserResponseDto"
                }
              }
            }
          }
        },
        "tags": [
          "User"
        ],
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ]
      }
    },
    "/user/info/{userId}": {
      "get": {
        "operationId": "getUserById",
        "parameters": [
          {
            "name": "userId",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UserResponseDto"
                }
              }
            }
          }
        },
        "tags": [
          "User"
        ],
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ]
      }
    },
    "/user/me": {
      "get": {
        "operationId": "getMyUserInfo",
        "parameters": [],
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UserResponseDto"
                }
              }
            }
          }
        },
        "tags": [
          "User"
        ],
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ]
      }
    },
    "/user/count": {
      "get": {
        "operationId": "getUserCount",
        "parameters": [
          {
            "name": "admin",
            "required": false,
            "in": "query",
            "schema": {
              "default": false,
              "type": "boolean"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UserCountResponseDto"
                }
              }
            }
          }
        },
        "tags": [
          "User"
        ]
      }
    },
    "/user/{userId}": {
      "delete": {
        "operationId": "deleteUser",
        "parameters": [
          {
            "name": "userId",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UserResponseDto"
                }
              }
            }
          }
        },
        "tags": [
          "User"
        ],
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ]
      }
    },
    "/user/{userId}/restore": {
      "post": {
        "operationId": "restoreUser",
        "parameters": [
          {
            "name": "userId",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "responses": {
          "201": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UserResponseDto"
                }
              }
            }
          }
        },
        "tags": [
          "User"
        ],
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ]
      }
    },
    "/user/profile-image": {
      "post": {
        "operationId": "createProfileImage",
        "parameters": [],
        "requestBody": {
          "required": true,
          "description": "A new avatar for the user",
          "content": {
            "multipart/form-data": {
              "schema": {
                "$ref": "#/components/schemas/CreateProfileImageDto"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CreateProfileImageResponseDto"
                }
              }
            }
          }
        },
        "tags": [
          "User"
        ],
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ]
      }
    },
    "/user/profile-image/{userId}": {
      "get": {
        "operationId": "getProfileImage",
        "parameters": [
          {
            "name": "userId",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        },
        "tags": [
          "User"
        ],
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ]
      }
    },
    "/asset/upload": {
      "post": {
        "operationId": "uploadFile",
        "parameters": [
          {
            "name": "key",
            "required": false,
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "description": "Asset Upload Information",
          "content": {
            "multipart/form-data": {
              "schema": {
                "$ref": "#/components/schemas/CreateAssetDto"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AssetFileUploadResponseDto"
                }
              }
            }
          }
        },
        "tags": [
          "Asset"
        ],
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ]
      }
    },
    "/asset/download/{assetId}": {
      "get": {
        "operationId": "downloadFile",
        "parameters": [
          {
            "name": "assetId",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          },
          {
            "name": "key",
            "required": false,
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/octet-stream": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            },
            "description": ""
          }
        },
        "tags": [
          "Asset"
        ],
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ]
      }
    },
    "/asset/download-files": {
      "post": {
        "operationId": "downloadFiles",
        "parameters": [
          {
            "name": "key",
            "required": false,
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/DownloadFilesDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "content": {
              "application/octet-stream": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            },
            "description": ""
          },
          "201": {
            "description": ""
          }
        },
        "tags": [
          "Asset"
        ],
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ]
      }
    },
    "/asset/download-library": {
      "get": {
        "operationId": "downloadLibrary",
        "description": "Current this is not used in any UI element",
        "parameters": [
          {
            "name": "name",
            "required": false,
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "skip",
            "required": false,
            "in": "query",
            "schema": {
              "type": "number"
            }
          },
          {
            "name": "key",
            "required": false,
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/octet-stream": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            },
            "description": ""
          }
        },
        "tags": [
          "Asset"
        ],
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ]
      }
    },
    "/asset/file/{assetId}": {
      "get": {
        "operationId": "serveFile",
        "parameters": [
          {
            "name": "isThumb",
            "required": false,
            "in": "query",
            "schema": {
              "title": "Is serve thumbnail (resize) file",
              "type": "boolean"
            }
          },
          {
            "name": "isWeb",
            "required": false,
            "in": "query",
            "schema": {
              "title": "Is request made from web",
              "type": "boolean"
            }
          },
          {
            "name": "assetId",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          },
          {
            "name": "key",
            "required": false,
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/octet-stream": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            },
            "description": ""
          }
        },
        "tags": [
          "Asset"
        ],
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ]
      }
    },
    "/asset/thumbnail/{assetId}": {
      "get": {
        "operationId": "getAssetThumbnail",
        "parameters": [
          {
            "name": "assetId",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          },
          {
            "name": "format",
            "required": false,
            "in": "query",
            "schema": {
              "$ref": "#/components/schemas/ThumbnailFormat"
            }
          },
          {
            "name": "key",
            "required": false,
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/octet-stream": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            },
            "description": ""
          }
        },
        "tags": [
          "Asset"
        ],
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ]
      }
    },
    "/asset/curated-objects": {
      "get": {
        "operationId": "getCuratedObjects",
        "parameters": [],
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/CuratedObjectsResponseDto"
                  }
                }
              }
            }
          }
        },
        "tags": [
          "Asset"
        ],
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ]
      }
    },
    "/asset/curated-locations": {
      "get": {
        "operationId": "getCuratedLocations",
        "parameters": [],
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/CuratedLocationsResponseDto"
                  }
                }
              }
            }
          }
        },
        "tags": [
          "Asset"
        ],
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ]
      }
    },
    "/asset/search-terms": {
      "get": {
        "operationId": "getAssetSearchTerms",
        "parameters": [],
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                }
              }
            }
          }
        },
        "tags": [
          "Asset"
        ],
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ]
      }
    },
    "/asset/search": {
      "post": {
        "operationId": "searchAsset",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SearchAssetDto"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/AssetResponseDto"
                  }
                }
              }
            }
          }
        },
        "tags": [
          "Asset"
        ],
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ]
      }
    },
    "/asset/count-by-time-bucket": {
      "post": {
        "operationId": "getAssetCountByTimeBucket",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/GetAssetCountByTimeBucketDto"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AssetCountByTimeBucketResponseDto"
                }
              }
            }
          }
        },
        "tags": [
          "Asset"
        ],
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ]
      }
    },
    "/asset/count-by-user-id": {
      "get": {
        "operationId": "getAssetCountByUserId",
        "parameters": [],
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AssetCountByUserIdResponseDto"
                }
              }
            }
          }
        },
        "tags": [
          "Asset"
        ],
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ]
      }
    },
    "/asset/stat/archive": {
      "get": {
        "operationId": "getArchivedAssetCountByUserId",
        "parameters": [],
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AssetCountByUserIdResponseDto"
                }
              }
            }
          }
        },
        "tags": [
          "Asset"
        ],
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ]
      }
    },
    "/asset": {
      "get": {
        "operationId": "getAllAssets",
        "description": "Get all AssetEntity belong to the user",
        "parameters": [
          {
            "name": "isFavorite",
            "required": false,
            "in": "query",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "isArchived",
            "required": false,
            "in": "query",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "skip",
            "required": false,
            "in": "query",
            "schema": {
              "type": "number"
            }
          },
          {
            "name": "if-none-match",
            "in": "header",
            "description": "ETag of data already cached on the client",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/AssetResponseDto"
                  }
                }
              }
            }
          }
        },
        "tags": [
          "Asset"
        ],
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ]
      },
      "delete": {
        "operationId": "deleteAsset",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/DeleteAssetDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/DeleteAssetResponseDto"
                  }
                }
              }
            }
          }
        },
        "tags": [
          "Asset"
        ],
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ]
      }
    },
    "/asset/time-bucket": {
      "post": {
        "operationId": "getAssetByTimeBucket",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/GetAssetByTimeBucketDto"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/AssetResponseDto"
                  }
                }
              }
            }
          }
        },
        "tags": [
          "Asset"
        ],
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ]
      }
    },
    "/asset/map-marker": {
      "get": {
        "operationId": "getMapMarkers",
        "description": "Get all assets that have GPS information embedded",
        "parameters": [
          {
            "name": "isFavorite",
            "required": false,
            "in": "query",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "isArchived",
            "required": false,
            "in": "query",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "skip",
            "required": false,
            "in": "query",
            "schema": {
              "type": "number"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/MapMarkerResponseDto"
                  }
                }
              }
            }
          }
        },
        "tags": [
          "Asset"
        ],
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ]
      }
    },
    "/asset/{deviceId}": {
      "get": {
        "operationId": "getUserAssetsByDeviceId",
        "description": "Get all asset of a device that are in the database, ID only.",
        "parameters": [
          {
            "name": "deviceId",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                }
              }
            }
          }
        },
        "tags": [
          "Asset"
        ],
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ]
      }
    },
    "/asset/assetById/{assetId}": {
      "get": {
        "operationId": "getAssetById",
        "description": "Get a single asset's information",
        "parameters": [
          {
            "name": "assetId",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          },
          {
            "name": "key",
            "required": false,
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AssetResponseDto"
                }
              }
            }
          }
        },
        "tags": [
          "Asset"
        ],
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ]
      }
    },
    "/asset/{assetId}": {
      "put": {
        "operationId": "updateAsset",
        "description": "Update an asset",
        "parameters": [
          {
            "name": "assetId",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateAssetDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AssetResponseDto"
                }
              }
            }
          }
        },
        "tags": [
          "Asset"
        ],
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ]
      }
    },
    "/asset/check": {
      "post": {
        "operationId": "checkDuplicateAsset",
        "description": "Check duplicated asset before uploading - for Web upload used",
        "parameters": [
          {
            "name": "key",
            "required": false,
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CheckDuplicateAssetDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CheckDuplicateAssetResponseDto"
                }
              }
            }
          }
        },
        "tags": [
          "Asset"
        ],
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ]
      }
    },
    "/asset/exist": {
      "post": {
        "operationId": "checkExistingAssets",
        "description": "Checks if multiple assets exist on the server and returns all existing - used by background backup",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CheckExistingAssetsDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CheckExistingAssetsResponseDto"
                }
              }
            }
          }
        },
        "tags": [
          "Asset"
        ],
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ]
      }
    },
    "/asset/shared-link": {
      "post": {
        "operationId": "createAssetsSharedLink",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateAssetsShareLinkDto"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SharedLinkResponseDto"
                }
              }
            }
          }
        },
        "tags": [
          "Asset"
        ],
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ]
      }
    },
    "/asset/shared-link/add": {
      "patch": {
        "operationId": "addAssetsToSharedLink",
        "parameters": [
          {
            "name": "key",
            "required": false,
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AddAssetsDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SharedLinkResponseDto"
                }
              }
            }
          }
        },
        "tags": [
          "Asset"
        ],
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ]
      }
    },
    "/asset/shared-link/remove": {
      "patch": {
        "operationId": "removeAssetsFromSharedLink",
        "parameters": [
          {
            "name": "key",
            "required": false,
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/RemoveAssetsDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SharedLinkResponseDto"
                }
              }
            }
          }
        },
        "tags": [
          "Asset"
        ],
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ]
      }
    },
    "/tag": {
      "post": {
        "operationId": "create",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateTagDto"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TagResponseDto"
                }
              }
            }
          }
        },
        "tags": [
          "Tag"
        ],
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ]
      },
      "get": {
        "operationId": "findAll",
        "parameters": [],
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/TagResponseDto"
                  }
                }
              }
            }
          }
        },
        "tags": [
          "Tag"
        ],
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ]
      }
    },
    "/tag/{id}": {
      "get": {
        "operationId": "findOne",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TagResponseDto"
                }
              }
            }
          }
        },
        "tags": [
          "Tag"
        ],
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ]
      },
      "patch": {
        "operationId": "update",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateTagDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TagResponseDto"
                }
              }
            }
          }
        },
        "tags": [
          "Tag"
        ],
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ]
      },
      "delete": {
        "operationId": "delete",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": ""
          }
        },
        "tags": [
          "Tag"
        ],
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ]
      }
    },
    "/album/count-by-user-id": {
      "get": {
        "operationId": "getAlbumCountByUserId",
        "parameters": [],
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AlbumCountResponseDto"
                }
              }
            }
          }
        },
        "tags": [
          "Album"
        ],
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ]
      }
    },
    "/album/{albumId}/users": {
      "put": {
        "operationId": "addUsersToAlbum",
        "parameters": [
          {
            "name": "albumId",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AddUsersDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AlbumResponseDto"
                }
              }
            }
          }
        },
        "tags": [
          "Album"
        ],
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ]
      }
    },
    "/album/{albumId}/assets": {
      "put": {
        "operationId": "addAssetsToAlbum",
        "parameters": [
          {
            "name": "albumId",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          },
          {
            "name": "key",
            "required": false,
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AddAssetsDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AddAssetsResponseDto"
                }
              }
            }
          }
        },
        "tags": [
          "Album"
        ],
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ]
      },
      "delete": {
        "operationId": "removeAssetFromAlbum",
        "parameters": [
          {
            "name": "albumId",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/RemoveAssetsDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AlbumResponseDto"
                }
              }
            }
          }
        },
        "tags": [
          "Album"
        ],
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ]
      }
    },
    "/album/{albumId}": {
      "get": {
        "operationId": "getAlbumInfo",
        "parameters": [
          {
            "name": "albumId",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          },
          {
            "name": "key",
            "required": false,
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AlbumResponseDto"
                }
              }
            }
          }
        },
        "tags": [
          "Album"
        ],
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ]
      },
      "delete": {
        "operationId": "deleteAlbum",
        "parameters": [
          {
            "name": "albumId",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": ""
          }
        },
        "tags": [
          "Album"
        ],
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ]
      },
      "patch": {
        "operationId": "updateAlbumInfo",
        "parameters": [
          {
            "name": "albumId",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateAlbumDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AlbumResponseDto"
                }
              }
            }
          }
        },
        "tags": [
          "Album"
        ],
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ]
      }
    },
    "/album/{albumId}/user/{userId}": {
      "delete": {
        "operationId": "removeUserFromAlbum",
        "parameters": [
          {
            "name": "albumId",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          },
          {
            "name": "userId",
            "required": true,
            "in": "path",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": ""
          }
        },
        "tags": [
          "Album"
        ],
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ]
      }
    },
    "/album/{albumId}/download": {
      "get": {
        "operationId": "downloadArchive",
        "parameters": [
          {
            "name": "albumId",
            "required": true,
            "in": "path",
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          },
          {
            "name": "name",
            "required": false,
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "skip",
            "required": false,
            "in": "query",
            "schema": {
              "type": "number"
            }
          },
          {
            "name": "key",
            "required": false,
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/zip": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            },
            "description": ""
          }
        },
        "tags": [
          "Album"
        ],
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ]
      }
    },
    "/album/create-shared-link": {
      "post": {
        "operationId": "createAlbumSharedLink",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateAlbumShareLinkDto"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SharedLinkResponseDto"
                }
              }
            }
          }
        },
        "tags": [
          "Album"
        ],
        "security": [
          {
            "bearer": []
          },
          {
            "cookie": []
          },
          {
            "api_key": []
          }
        ]
      }
    }
  },
  "info": {
    "title": "Immich",
    "description": "Immich API",
    "version": "1.55.1",
    "contact": {}
  },
  "tags": [],
  "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": {
      "UserResponseDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "email": {
            "type": "string"
          },
          "firstName": {
            "type": "string"
          },
          "lastName": {
            "type": "string"
          },
          "createdAt": {
            "type": "string"
          },
          "profileImagePath": {
            "type": "string"
          },
          "shouldChangePassword": {
            "type": "boolean"
          },
          "isAdmin": {
            "type": "boolean"
          },
          "deletedAt": {
            "format": "date-time",
            "type": "string"
          },
          "updatedAt": {
            "type": "string"
          },
          "oauthId": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "email",
          "firstName",
          "lastName",
          "createdAt",
          "profileImagePath",
          "shouldChangePassword",
          "isAdmin",
          "oauthId"
        ]
      },
      "AssetTypeEnum": {
        "type": "string",
        "enum": [
          "IMAGE",
          "VIDEO",
          "AUDIO",
          "OTHER"
        ]
      },
      "ExifResponseDto": {
        "type": "object",
        "properties": {
          "fileSizeInByte": {
            "type": "integer",
            "nullable": true,
            "default": null,
            "format": "int64"
          },
          "make": {
            "type": "string",
            "nullable": true,
            "default": null
          },
          "model": {
            "type": "string",
            "nullable": true,
            "default": null
          },
          "exifImageWidth": {
            "type": "number",
            "nullable": true,
            "default": null
          },
          "exifImageHeight": {
            "type": "number",
            "nullable": true,
            "default": null
          },
          "orientation": {
            "type": "string",
            "nullable": true,
            "default": null
          },
          "dateTimeOriginal": {
            "format": "date-time",
            "type": "string",
            "nullable": true,
            "default": null
          },
          "modifyDate": {
            "format": "date-time",
            "type": "string",
            "nullable": true,
            "default": null
          },
          "timeZone": {
            "type": "string",
            "nullable": true,
            "default": null
          },
          "lensModel": {
            "type": "string",
            "nullable": true,
            "default": null
          },
          "fNumber": {
            "type": "number",
            "nullable": true,
            "default": null
          },
          "focalLength": {
            "type": "number",
            "nullable": true,
            "default": null
          },
          "iso": {
            "type": "number",
            "nullable": true,
            "default": null
          },
          "exposureTime": {
            "type": "string",
            "nullable": true,
            "default": null
          },
          "latitude": {
            "type": "number",
            "nullable": true,
            "default": null
          },
          "longitude": {
            "type": "number",
            "nullable": true,
            "default": null
          },
          "city": {
            "type": "string",
            "nullable": true,
            "default": null
          },
          "state": {
            "type": "string",
            "nullable": true,
            "default": null
          },
          "country": {
            "type": "string",
            "nullable": true,
            "default": null
          },
          "description": {
            "type": "string",
            "nullable": true,
            "default": null
          }
        }
      },
      "SmartInfoResponseDto": {
        "type": "object",
        "properties": {
          "tags": {
            "nullable": true,
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "objects": {
            "nullable": true,
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      },
      "TagTypeEnum": {
        "type": "string",
        "enum": [
          "OBJECT",
          "FACE",
          "CUSTOM"
        ]
      },
      "TagResponseDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "type": {
            "$ref": "#/components/schemas/TagTypeEnum"
          },
          "name": {
            "type": "string"
          },
          "userId": {
            "type": "string"
          },
          "renameTagId": {
            "type": "string",
            "nullable": true
          }
        },
        "required": [
          "id",
          "type",
          "name",
          "userId"
        ]
      },
      "AssetResponseDto": {
        "type": "object",
        "properties": {
          "type": {
            "$ref": "#/components/schemas/AssetTypeEnum"
          },
          "id": {
            "type": "string"
          },
          "deviceAssetId": {
            "type": "string"
          },
          "ownerId": {
            "type": "string"
          },
          "deviceId": {
            "type": "string"
          },
          "originalPath": {
            "type": "string"
          },
          "originalFileName": {
            "type": "string"
          },
          "resizePath": {
            "type": "string",
            "nullable": true
          },
          "fileCreatedAt": {
            "type": "string"
          },
          "fileModifiedAt": {
            "type": "string"
          },
          "updatedAt": {
            "type": "string"
          },
          "isFavorite": {
            "type": "boolean"
          },
          "isArchived": {
            "type": "boolean"
          },
          "mimeType": {
            "type": "string",
            "nullable": true
          },
          "duration": {
            "type": "string"
          },
          "webpPath": {
            "type": "string",
            "nullable": true
          },
          "encodedVideoPath": {
            "type": "string",
            "nullable": true
          },
          "exifInfo": {
            "$ref": "#/components/schemas/ExifResponseDto"
          },
          "smartInfo": {
            "$ref": "#/components/schemas/SmartInfoResponseDto"
          },
          "livePhotoVideoId": {
            "type": "string",
            "nullable": true
          },
          "tags": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/TagResponseDto"
            }
          }
        },
        "required": [
          "type",
          "id",
          "deviceAssetId",
          "ownerId",
          "deviceId",
          "originalPath",
          "originalFileName",
          "resizePath",
          "fileCreatedAt",
          "fileModifiedAt",
          "updatedAt",
          "isFavorite",
          "isArchived",
          "mimeType",
          "duration",
          "webpPath"
        ]
      },
      "AlbumResponseDto": {
        "type": "object",
        "properties": {
          "assetCount": {
            "type": "integer"
          },
          "id": {
            "type": "string"
          },
          "ownerId": {
            "type": "string"
          },
          "albumName": {
            "type": "string"
          },
          "createdAt": {
            "type": "string"
          },
          "updatedAt": {
            "type": "string"
          },
          "albumThumbnailAssetId": {
            "type": "string",
            "nullable": true
          },
          "shared": {
            "type": "boolean"
          },
          "sharedUsers": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/UserResponseDto"
            }
          },
          "assets": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/AssetResponseDto"
            }
          },
          "owner": {
            "$ref": "#/components/schemas/UserResponseDto"
          }
        },
        "required": [
          "assetCount",
          "id",
          "ownerId",
          "albumName",
          "createdAt",
          "updatedAt",
          "albumThumbnailAssetId",
          "shared",
          "sharedUsers",
          "assets",
          "owner"
        ]
      },
      "APIKeyCreateDto": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          }
        }
      },
      "APIKeyResponseDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "createdAt": {
            "type": "string"
          },
          "updatedAt": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "name",
          "createdAt",
          "updatedAt"
        ]
      },
      "APIKeyCreateResponseDto": {
        "type": "object",
        "properties": {
          "secret": {
            "type": "string"
          },
          "apiKey": {
            "$ref": "#/components/schemas/APIKeyResponseDto"
          }
        },
        "required": [
          "secret",
          "apiKey"
        ]
      },
      "APIKeyUpdateDto": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          }
        },
        "required": [
          "name"
        ]
      },
      "LoginCredentialDto": {
        "type": "object",
        "properties": {
          "email": {
            "type": "string",
            "example": "testuser@email.com"
          },
          "password": {
            "type": "string",
            "example": "password"
          }
        },
        "required": [
          "email",
          "password"
        ]
      },
      "LoginResponseDto": {
        "type": "object",
        "properties": {
          "accessToken": {
            "type": "string",
            "readOnly": true
          },
          "userId": {
            "type": "string",
            "readOnly": true
          },
          "userEmail": {
            "type": "string",
            "readOnly": true
          },
          "firstName": {
            "type": "string",
            "readOnly": true
          },
          "lastName": {
            "type": "string",
            "readOnly": true
          },
          "profileImagePath": {
            "type": "string",
            "readOnly": true
          },
          "isAdmin": {
            "type": "boolean",
            "readOnly": true
          },
          "shouldChangePassword": {
            "type": "boolean",
            "readOnly": true
          }
        },
        "required": [
          "accessToken",
          "userId",
          "userEmail",
          "firstName",
          "lastName",
          "profileImagePath",
          "isAdmin",
          "shouldChangePassword"
        ]
      },
      "SignUpDto": {
        "type": "object",
        "properties": {
          "email": {
            "type": "string",
            "example": "testuser@email.com"
          },
          "password": {
            "type": "string",
            "example": "password"
          },
          "firstName": {
            "type": "string",
            "example": "Admin"
          },
          "lastName": {
            "type": "string",
            "example": "Doe"
          }
        },
        "required": [
          "email",
          "password",
          "firstName",
          "lastName"
        ]
      },
      "AdminSignupResponseDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "email": {
            "type": "string"
          },
          "firstName": {
            "type": "string"
          },
          "lastName": {
            "type": "string"
          },
          "createdAt": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "email",
          "firstName",
          "lastName",
          "createdAt"
        ]
      },
      "AuthDeviceResponseDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "createdAt": {
            "type": "string"
          },
          "updatedAt": {
            "type": "string"
          },
          "current": {
            "type": "boolean"
          },
          "deviceType": {
            "type": "string"
          },
          "deviceOS": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "createdAt",
          "updatedAt",
          "current",
          "deviceType",
          "deviceOS"
        ]
      },
      "ValidateAccessTokenResponseDto": {
        "type": "object",
        "properties": {
          "authStatus": {
            "type": "boolean"
          }
        },
        "required": [
          "authStatus"
        ]
      },
      "ChangePasswordDto": {
        "type": "object",
        "properties": {
          "password": {
            "type": "string",
            "example": "password"
          },
          "newPassword": {
            "type": "string",
            "example": "password"
          }
        },
        "required": [
          "password",
          "newPassword"
        ]
      },
      "LogoutResponseDto": {
        "type": "object",
        "properties": {
          "successful": {
            "type": "boolean"
          },
          "redirectUri": {
            "type": "string"
          }
        },
        "required": [
          "successful",
          "redirectUri"
        ]
      },
      "JobCountsDto": {
        "type": "object",
        "properties": {
          "active": {
            "type": "integer"
          },
          "completed": {
            "type": "integer"
          },
          "failed": {
            "type": "integer"
          },
          "delayed": {
            "type": "integer"
          },
          "waiting": {
            "type": "integer"
          },
          "paused": {
            "type": "integer"
          }
        },
        "required": [
          "active",
          "completed",
          "failed",
          "delayed",
          "waiting",
          "paused"
        ]
      },
      "QueueStatusDto": {
        "type": "object",
        "properties": {
          "isActive": {
            "type": "boolean"
          },
          "isPaused": {
            "type": "boolean"
          }
        },
        "required": [
          "isActive",
          "isPaused"
        ]
      },
      "JobStatusDto": {
        "type": "object",
        "properties": {
          "jobCounts": {
            "$ref": "#/components/schemas/JobCountsDto"
          },
          "queueStatus": {
            "$ref": "#/components/schemas/QueueStatusDto"
          }
        },
        "required": [
          "jobCounts",
          "queueStatus"
        ]
      },
      "AllJobStatusResponseDto": {
        "type": "object",
        "properties": {
          "thumbnail-generation-queue": {
            "$ref": "#/components/schemas/JobStatusDto"
          },
          "metadata-extraction-queue": {
            "$ref": "#/components/schemas/JobStatusDto"
          },
          "video-conversion-queue": {
            "$ref": "#/components/schemas/JobStatusDto"
          },
          "object-tagging-queue": {
            "$ref": "#/components/schemas/JobStatusDto"
          },
          "clip-encoding-queue": {
            "$ref": "#/components/schemas/JobStatusDto"
          },
          "storage-template-migration-queue": {
            "$ref": "#/components/schemas/JobStatusDto"
          },
          "background-task-queue": {
            "$ref": "#/components/schemas/JobStatusDto"
          },
          "search-queue": {
            "$ref": "#/components/schemas/JobStatusDto"
          }
        },
        "required": [
          "thumbnail-generation-queue",
          "metadata-extraction-queue",
          "video-conversion-queue",
          "object-tagging-queue",
          "clip-encoding-queue",
          "storage-template-migration-queue",
          "background-task-queue",
          "search-queue"
        ]
      },
      "JobName": {
        "type": "string",
        "enum": [
          "thumbnail-generation-queue",
          "metadata-extraction-queue",
          "video-conversion-queue",
          "object-tagging-queue",
          "clip-encoding-queue",
          "background-task-queue",
          "storage-template-migration-queue",
          "search-queue"
        ]
      },
      "JobCommand": {
        "type": "string",
        "enum": [
          "start",
          "pause",
          "resume",
          "empty"
        ]
      },
      "JobCommandDto": {
        "type": "object",
        "properties": {
          "command": {
            "$ref": "#/components/schemas/JobCommand"
          },
          "force": {
            "type": "boolean"
          }
        },
        "required": [
          "command",
          "force"
        ]
      },
      "OAuthConfigDto": {
        "type": "object",
        "properties": {
          "redirectUri": {
            "type": "string"
          }
        },
        "required": [
          "redirectUri"
        ]
      },
      "OAuthConfigResponseDto": {
        "type": "object",
        "properties": {
          "enabled": {
            "type": "boolean"
          },
          "passwordLoginEnabled": {
            "type": "boolean"
          },
          "url": {
            "type": "string"
          },
          "buttonText": {
            "type": "string"
          },
          "autoLaunch": {
            "type": "boolean"
          }
        },
        "required": [
          "enabled",
          "passwordLoginEnabled"
        ]
      },
      "OAuthCallbackDto": {
        "type": "object",
        "properties": {
          "url": {
            "type": "string"
          }
        },
        "required": [
          "url"
        ]
      },
      "SearchFacetCountResponseDto": {
        "type": "object",
        "properties": {
          "count": {
            "type": "integer"
          },
          "value": {
            "type": "string"
          }
        },
        "required": [
          "count",
          "value"
        ]
      },
      "SearchFacetResponseDto": {
        "type": "object",
        "properties": {
          "fieldName": {
            "type": "string"
          },
          "counts": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/SearchFacetCountResponseDto"
            }
          }
        },
        "required": [
          "fieldName",
          "counts"
        ]
      },
      "SearchAlbumResponseDto": {
        "type": "object",
        "properties": {
          "total": {
            "type": "integer"
          },
          "count": {
            "type": "integer"
          },
          "items": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/AlbumResponseDto"
            }
          },
          "facets": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/SearchFacetResponseDto"
            }
          }
        },
        "required": [
          "total",
          "count",
          "items",
          "facets"
        ]
      },
      "SearchAssetResponseDto": {
        "type": "object",
        "properties": {
          "total": {
            "type": "integer"
          },
          "count": {
            "type": "integer"
          },
          "items": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/AssetResponseDto"
            }
          },
          "facets": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/SearchFacetResponseDto"
            }
          }
        },
        "required": [
          "total",
          "count",
          "items",
          "facets"
        ]
      },
      "SearchResponseDto": {
        "type": "object",
        "properties": {
          "albums": {
            "$ref": "#/components/schemas/SearchAlbumResponseDto"
          },
          "assets": {
            "$ref": "#/components/schemas/SearchAssetResponseDto"
          }
        },
        "required": [
          "albums",
          "assets"
        ]
      },
      "SearchConfigResponseDto": {
        "type": "object",
        "properties": {
          "enabled": {
            "type": "boolean"
          }
        },
        "required": [
          "enabled"
        ]
      },
      "SearchExploreItem": {
        "type": "object",
        "properties": {
          "value": {
            "type": "string"
          },
          "data": {
            "$ref": "#/components/schemas/AssetResponseDto"
          }
        },
        "required": [
          "value",
          "data"
        ]
      },
      "SearchExploreResponseDto": {
        "type": "object",
        "properties": {
          "fieldName": {
            "type": "string"
          },
          "items": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/SearchExploreItem"
            }
          }
        },
        "required": [
          "fieldName",
          "items"
        ]
      },
      "ServerInfoResponseDto": {
        "type": "object",
        "properties": {
          "diskSizeRaw": {
            "type": "integer",
            "format": "int64"
          },
          "diskUseRaw": {
            "type": "integer",
            "format": "int64"
          },
          "diskAvailableRaw": {
            "type": "integer",
            "format": "int64"
          },
          "diskUsagePercentage": {
            "type": "number",
            "format": "float"
          },
          "diskSize": {
            "type": "string"
          },
          "diskUse": {
            "type": "string"
          },
          "diskAvailable": {
            "type": "string"
          }
        },
        "required": [
          "diskSizeRaw",
          "diskUseRaw",
          "diskAvailableRaw",
          "diskUsagePercentage",
          "diskSize",
          "diskUse",
          "diskAvailable"
        ]
      },
      "ServerPingResponse": {
        "type": "object",
        "properties": {
          "res": {
            "type": "string",
            "readOnly": true,
            "example": "pong"
          }
        },
        "required": [
          "res"
        ]
      },
      "ServerVersionReponseDto": {
        "type": "object",
        "properties": {
          "major": {
            "type": "integer"
          },
          "minor": {
            "type": "integer"
          },
          "patch": {
            "type": "integer"
          }
        },
        "required": [
          "major",
          "minor",
          "patch"
        ]
      },
      "UsageByUserDto": {
        "type": "object",
        "properties": {
          "userId": {
            "type": "string"
          },
          "userFirstName": {
            "type": "string"
          },
          "userLastName": {
            "type": "string"
          },
          "photos": {
            "type": "integer"
          },
          "videos": {
            "type": "integer"
          },
          "usage": {
            "type": "integer",
            "format": "int64"
          }
        },
        "required": [
          "userId",
          "userFirstName",
          "userLastName",
          "photos",
          "videos",
          "usage"
        ]
      },
      "ServerStatsResponseDto": {
        "type": "object",
        "properties": {
          "photos": {
            "type": "integer",
            "default": 0
          },
          "videos": {
            "type": "integer",
            "default": 0
          },
          "usage": {
            "type": "integer",
            "default": 0,
            "format": "int64"
          },
          "usageByUser": {
            "default": [],
            "title": "Array of usage for each user",
            "example": [
              {
                "photos": 1,
                "videos": 1,
                "diskUsageRaw": 1
              }
            ],
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/UsageByUserDto"
            }
          }
        },
        "required": [
          "photos",
          "videos",
          "usage",
          "usageByUser"
        ]
      },
      "SharedLinkType": {
        "type": "string",
        "enum": [
          "ALBUM",
          "INDIVIDUAL"
        ]
      },
      "SharedLinkResponseDto": {
        "type": "object",
        "properties": {
          "type": {
            "$ref": "#/components/schemas/SharedLinkType"
          },
          "id": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "userId": {
            "type": "string"
          },
          "key": {
            "type": "string"
          },
          "createdAt": {
            "type": "string"
          },
          "expiresAt": {
            "type": "string",
            "nullable": true
          },
          "assets": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/AssetResponseDto"
            }
          },
          "album": {
            "$ref": "#/components/schemas/AlbumResponseDto"
          },
          "allowUpload": {
            "type": "boolean"
          },
          "allowDownload": {
            "type": "boolean"
          },
          "showExif": {
            "type": "boolean"
          }
        },
        "required": [
          "type",
          "id",
          "userId",
          "key",
          "createdAt",
          "expiresAt",
          "assets",
          "allowUpload",
          "allowDownload",
          "showExif"
        ]
      },
      "EditSharedLinkDto": {
        "type": "object",
        "properties": {
          "description": {
            "type": "string"
          },
          "expiresAt": {
            "type": "string",
            "nullable": true
          },
          "allowUpload": {
            "type": "boolean"
          },
          "allowDownload": {
            "type": "boolean"
          },
          "showExif": {
            "type": "boolean"
          }
        }
      },
      "SystemConfigFFmpegDto": {
        "type": "object",
        "properties": {
          "crf": {
            "type": "string"
          },
          "preset": {
            "type": "string"
          },
          "targetVideoCodec": {
            "type": "string"
          },
          "targetAudioCodec": {
            "type": "string"
          },
          "targetResolution": {
            "type": "string"
          },
          "transcode": {
            "type": "string",
            "enum": [
              "all",
              "optimal",
              "required",
              "disabled"
            ]
          }
        },
        "required": [
          "crf",
          "preset",
          "targetVideoCodec",
          "targetAudioCodec",
          "targetResolution",
          "transcode"
        ]
      },
      "SystemConfigOAuthDto": {
        "type": "object",
        "properties": {
          "enabled": {
            "type": "boolean"
          },
          "issuerUrl": {
            "type": "string"
          },
          "clientId": {
            "type": "string"
          },
          "clientSecret": {
            "type": "string"
          },
          "scope": {
            "type": "string"
          },
          "buttonText": {
            "type": "string"
          },
          "autoRegister": {
            "type": "boolean"
          },
          "autoLaunch": {
            "type": "boolean"
          },
          "mobileOverrideEnabled": {
            "type": "boolean"
          },
          "mobileRedirectUri": {
            "type": "string"
          }
        },
        "required": [
          "enabled",
          "issuerUrl",
          "clientId",
          "clientSecret",
          "scope",
          "buttonText",
          "autoRegister",
          "autoLaunch",
          "mobileOverrideEnabled",
          "mobileRedirectUri"
        ]
      },
      "SystemConfigPasswordLoginDto": {
        "type": "object",
        "properties": {
          "enabled": {
            "type": "boolean"
          }
        },
        "required": [
          "enabled"
        ]
      },
      "SystemConfigStorageTemplateDto": {
        "type": "object",
        "properties": {
          "template": {
            "type": "string"
          }
        },
        "required": [
          "template"
        ]
      },
      "SystemConfigDto": {
        "type": "object",
        "properties": {
          "ffmpeg": {
            "$ref": "#/components/schemas/SystemConfigFFmpegDto"
          },
          "oauth": {
            "$ref": "#/components/schemas/SystemConfigOAuthDto"
          },
          "passwordLogin": {
            "$ref": "#/components/schemas/SystemConfigPasswordLoginDto"
          },
          "storageTemplate": {
            "$ref": "#/components/schemas/SystemConfigStorageTemplateDto"
          }
        },
        "required": [
          "ffmpeg",
          "oauth",
          "passwordLogin",
          "storageTemplate"
        ]
      },
      "SystemConfigTemplateStorageOptionDto": {
        "type": "object",
        "properties": {
          "yearOptions": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "monthOptions": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "dayOptions": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "hourOptions": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "minuteOptions": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "secondOptions": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "presetOptions": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        },
        "required": [
          "yearOptions",
          "monthOptions",
          "dayOptions",
          "hourOptions",
          "minuteOptions",
          "secondOptions",
          "presetOptions"
        ]
      },
      "CreateUserDto": {
        "type": "object",
        "properties": {
          "email": {
            "type": "string",
            "example": "testuser@email.com"
          },
          "password": {
            "type": "string",
            "example": "password"
          },
          "firstName": {
            "type": "string",
            "example": "John"
          },
          "lastName": {
            "type": "string",
            "example": "Doe"
          }
        },
        "required": [
          "email",
          "password",
          "firstName",
          "lastName"
        ]
      },
      "UserCountResponseDto": {
        "type": "object",
        "properties": {
          "userCount": {
            "type": "integer"
          }
        },
        "required": [
          "userCount"
        ]
      },
      "UpdateUserDto": {
        "type": "object",
        "properties": {
          "email": {
            "type": "string",
            "example": "testuser@email.com"
          },
          "password": {
            "type": "string",
            "example": "password"
          },
          "firstName": {
            "type": "string",
            "example": "John"
          },
          "lastName": {
            "type": "string",
            "example": "Doe"
          },
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "isAdmin": {
            "type": "boolean"
          },
          "shouldChangePassword": {
            "type": "boolean"
          }
        },
        "required": [
          "id"
        ]
      },
      "CreateProfileImageDto": {
        "type": "object",
        "properties": {
          "file": {
            "type": "string",
            "format": "binary"
          }
        },
        "required": [
          "file"
        ]
      },
      "CreateProfileImageResponseDto": {
        "type": "object",
        "properties": {
          "userId": {
            "type": "string"
          },
          "profileImagePath": {
            "type": "string"
          }
        },
        "required": [
          "userId",
          "profileImagePath"
        ]
      },
      "CreateAssetDto": {
        "type": "object",
        "properties": {
          "assetType": {
            "$ref": "#/components/schemas/AssetTypeEnum"
          },
          "assetData": {
            "type": "string",
            "format": "binary"
          },
          "livePhotoData": {
            "type": "string",
            "format": "binary"
          },
          "deviceAssetId": {
            "type": "string"
          },
          "deviceId": {
            "type": "string"
          },
          "fileCreatedAt": {
            "type": "string"
          },
          "fileModifiedAt": {
            "type": "string"
          },
          "isFavorite": {
            "type": "boolean"
          },
          "isArchived": {
            "type": "boolean"
          },
          "isVisible": {
            "type": "boolean"
          },
          "fileExtension": {
            "type": "string"
          },
          "duration": {
            "type": "string"
          }
        },
        "required": [
          "assetType",
          "assetData",
          "deviceAssetId",
          "deviceId",
          "fileCreatedAt",
          "fileModifiedAt",
          "isFavorite",
          "fileExtension"
        ]
      },
      "AssetFileUploadResponseDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "duplicate": {
            "type": "boolean"
          }
        },
        "required": [
          "id",
          "duplicate"
        ]
      },
      "DownloadFilesDto": {
        "type": "object",
        "properties": {
          "assetIds": {
            "title": "Array of asset ids to be downloaded",
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        },
        "required": [
          "assetIds"
        ]
      },
      "ThumbnailFormat": {
        "type": "string",
        "enum": [
          "JPEG",
          "WEBP"
        ]
      },
      "CuratedObjectsResponseDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "object": {
            "type": "string"
          },
          "resizePath": {
            "type": "string"
          },
          "deviceAssetId": {
            "type": "string"
          },
          "deviceId": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "object",
          "resizePath",
          "deviceAssetId",
          "deviceId"
        ]
      },
      "CuratedLocationsResponseDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "city": {
            "type": "string"
          },
          "resizePath": {
            "type": "string"
          },
          "deviceAssetId": {
            "type": "string"
          },
          "deviceId": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "city",
          "resizePath",
          "deviceAssetId",
          "deviceId"
        ]
      },
      "SearchAssetDto": {
        "type": "object",
        "properties": {
          "searchTerm": {
            "type": "string"
          }
        },
        "required": [
          "searchTerm"
        ]
      },
      "TimeGroupEnum": {
        "type": "string",
        "enum": [
          "day",
          "month"
        ]
      },
      "GetAssetCountByTimeBucketDto": {
        "type": "object",
        "properties": {
          "timeGroup": {
            "$ref": "#/components/schemas/TimeGroupEnum"
          }
        },
        "required": [
          "timeGroup"
        ]
      },
      "AssetCountByTimeBucket": {
        "type": "object",
        "properties": {
          "timeBucket": {
            "type": "string"
          },
          "count": {
            "type": "integer"
          }
        },
        "required": [
          "timeBucket",
          "count"
        ]
      },
      "AssetCountByTimeBucketResponseDto": {
        "type": "object",
        "properties": {
          "totalCount": {
            "type": "integer"
          },
          "buckets": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/AssetCountByTimeBucket"
            }
          }
        },
        "required": [
          "totalCount",
          "buckets"
        ]
      },
      "AssetCountByUserIdResponseDto": {
        "type": "object",
        "properties": {
          "audio": {
            "type": "integer",
            "default": 0
          },
          "photos": {
            "type": "integer",
            "default": 0
          },
          "videos": {
            "type": "integer",
            "default": 0
          },
          "other": {
            "type": "integer",
            "default": 0
          },
          "total": {
            "type": "integer",
            "default": 0
          }
        },
        "required": [
          "audio",
          "photos",
          "videos",
          "other",
          "total"
        ]
      },
      "GetAssetByTimeBucketDto": {
        "type": "object",
        "properties": {
          "timeBucket": {
            "title": "Array of date time buckets",
            "example": [
              "2015-06-01T00:00:00.000Z",
              "2016-02-01T00:00:00.000Z",
              "2016-03-01T00:00:00.000Z"
            ],
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        },
        "required": [
          "timeBucket"
        ]
      },
      "MapMarkerResponseDto": {
        "type": "object",
        "properties": {
          "type": {
            "$ref": "#/components/schemas/AssetTypeEnum"
          },
          "lat": {
            "type": "number",
            "format": "double"
          },
          "lon": {
            "type": "number",
            "format": "double"
          },
          "id": {
            "type": "string"
          }
        },
        "required": [
          "type",
          "lat",
          "lon",
          "id"
        ]
      },
      "UpdateAssetDto": {
        "type": "object",
        "properties": {
          "tagIds": {
            "title": "Array of tag IDs to add to the asset",
            "example": [
              "bf973405-3f2a-48d2-a687-2ed4167164be",
              "dd41870b-5d00-46d2-924e-1d8489a0aa0f",
              "fad77c3f-deef-4e7e-9608-14c1aa4e559a"
            ],
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "isFavorite": {
            "type": "boolean"
          },
          "isArchived": {
            "type": "boolean"
          },
          "description": {
            "type": "string"
          }
        }
      },
      "DeleteAssetDto": {
        "type": "object",
        "properties": {
          "ids": {
            "title": "Array of asset IDs to delete",
            "example": [
              "bf973405-3f2a-48d2-a687-2ed4167164be",
              "dd41870b-5d00-46d2-924e-1d8489a0aa0f",
              "fad77c3f-deef-4e7e-9608-14c1aa4e559a"
            ],
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        },
        "required": [
          "ids"
        ]
      },
      "DeleteAssetStatus": {
        "type": "string",
        "enum": [
          "SUCCESS",
          "FAILED"
        ]
      },
      "DeleteAssetResponseDto": {
        "type": "object",
        "properties": {
          "status": {
            "$ref": "#/components/schemas/DeleteAssetStatus"
          },
          "id": {
            "type": "string"
          }
        },
        "required": [
          "status",
          "id"
        ]
      },
      "CheckDuplicateAssetDto": {
        "type": "object",
        "properties": {
          "deviceAssetId": {
            "type": "string"
          },
          "deviceId": {
            "type": "string"
          }
        },
        "required": [
          "deviceAssetId",
          "deviceId"
        ]
      },
      "CheckDuplicateAssetResponseDto": {
        "type": "object",
        "properties": {
          "isExist": {
            "type": "boolean"
          },
          "id": {
            "type": "string"
          }
        },
        "required": [
          "isExist"
        ]
      },
      "CheckExistingAssetsDto": {
        "type": "object",
        "properties": {
          "deviceAssetIds": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "deviceId": {
            "type": "string"
          }
        },
        "required": [
          "deviceAssetIds",
          "deviceId"
        ]
      },
      "CheckExistingAssetsResponseDto": {
        "type": "object",
        "properties": {
          "existingIds": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        },
        "required": [
          "existingIds"
        ]
      },
      "CreateAssetsShareLinkDto": {
        "type": "object",
        "properties": {
          "assetIds": {
            "title": "Array asset IDs to be shared",
            "example": [
              "bf973405-3f2a-48d2-a687-2ed4167164be",
              "dd41870b-5d00-46d2-924e-1d8489a0aa0f",
              "fad77c3f-deef-4e7e-9608-14c1aa4e559a"
            ],
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "expiresAt": {
            "type": "string"
          },
          "allowUpload": {
            "type": "boolean"
          },
          "allowDownload": {
            "type": "boolean"
          },
          "showExif": {
            "type": "boolean"
          },
          "description": {
            "type": "string"
          }
        },
        "required": [
          "assetIds"
        ]
      },
      "AddAssetsDto": {
        "type": "object",
        "properties": {
          "assetIds": {
            "type": "array",
            "items": {
              "type": "string",
              "format": "uuid"
            }
          }
        },
        "required": [
          "assetIds"
        ]
      },
      "RemoveAssetsDto": {
        "type": "object",
        "properties": {
          "assetIds": {
            "type": "array",
            "items": {
              "type": "string",
              "format": "uuid"
            }
          }
        },
        "required": [
          "assetIds"
        ]
      },
      "CreateTagDto": {
        "type": "object",
        "properties": {
          "type": {
            "$ref": "#/components/schemas/TagTypeEnum"
          },
          "name": {
            "type": "string"
          }
        },
        "required": [
          "type",
          "name"
        ]
      },
      "UpdateTagDto": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "renameTagId": {
            "type": "string"
          }
        }
      },
      "AlbumCountResponseDto": {
        "type": "object",
        "properties": {
          "owned": {
            "type": "integer"
          },
          "shared": {
            "type": "integer"
          },
          "sharing": {
            "type": "integer"
          }
        },
        "required": [
          "owned",
          "shared",
          "sharing"
        ]
      },
      "CreateAlbumDto": {
        "type": "object",
        "properties": {
          "albumName": {
            "type": "string"
          },
          "sharedWithUserIds": {
            "type": "array",
            "items": {
              "type": "string",
              "format": "uuid"
            }
          },
          "assetIds": {
            "type": "array",
            "items": {
              "type": "string",
              "format": "uuid"
            }
          }
        },
        "required": [
          "albumName"
        ]
      },
      "AddUsersDto": {
        "type": "object",
        "properties": {
          "sharedUserIds": {
            "type": "array",
            "items": {
              "type": "string",
              "format": "uuid"
            }
          }
        },
        "required": [
          "sharedUserIds"
        ]
      },
      "AddAssetsResponseDto": {
        "type": "object",
        "properties": {
          "successfullyAdded": {
            "type": "integer"
          },
          "alreadyInAlbum": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "album": {
            "$ref": "#/components/schemas/AlbumResponseDto"
          }
        },
        "required": [
          "successfullyAdded",
          "alreadyInAlbum"
        ]
      },
      "UpdateAlbumDto": {
        "type": "object",
        "properties": {
          "albumName": {
            "type": "string"
          },
          "albumThumbnailAssetId": {
            "type": "string",
            "format": "uuid"
          }
        }
      },
      "CreateAlbumShareLinkDto": {
        "type": "object",
        "properties": {
          "albumId": {
            "type": "string",
            "format": "uuid"
          },
          "expiresAt": {
            "type": "string",
            "format": "date-time"
          },
          "allowUpload": {
            "type": "boolean"
          },
          "allowDownload": {
            "type": "boolean"
          },
          "showExif": {
            "type": "boolean"
          },
          "description": {
            "type": "string"
          }
        },
        "required": [
          "albumId"
        ]
      }
    }
  }
}