Run ops even if asset no longer matches criteria; add tests

Consolidates asset operation logic within TimelineManager class and removes the now redundant 
operations-support.svelte.ts file. 

Combines addAsset/updateAsset to be upsertAsset. 


Changes:
- Move `addAssetsToMonthGroups` logic into TimelineManager's `addAssetsToSegments`, `upsertAssetIntoSegment`, `postCreateSegments`, and `postUpsert` methods
- Move `runAssetOperation` from operations-support into TimelineManager's private `#runAssetOperation` method
- Rename public `addAssets`/`updateAssets` methods to unified `upsertAssets` for consistency
- Delete internal/operations-support.svelte.ts
- Update WebsocketSupport to use `upsertAssets` for both add and update operations
- Fix AssetOperation return type to allow undefined/void operations (not just `{ remove: boolean }`)
- Update MonthGroup constructor to accept `loaded` parameter for better initialization control
- Update all test references from `addAssets`/`updateAssets` to `upsertAssets`

This refactoring improves code maintainability by eliminating duplicate logic and consolidating all asset operations within the TimelineManager class where they belong.

.devcontainer/server/container-compose-overrides.yml

@@ -21,6 +21,7 @@ services:
       - app-node_modules:/usr/src/app/node_modules
       - sveltekit:/usr/src/app/web/.svelte-kit
       - coverage:/usr/src/app/web/coverage
+      - ../plugins:/build/corePlugin
   immich-web:
     env_file: !reset []
   immich-machine-learning:

.github/workflows/build-mobile.yml

@@ -165,7 +165,7 @@ jobs:
           fi
 
       - name: Publish Android Artifact
-        uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # v4.6.2
+        uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5.0.0
         with:
           name: release-apk-signed
           path: mobile/build/app/outputs/flutter-apk/*.apk
@@ -188,8 +188,8 @@ jobs:
     needs: pre-job
     permissions:
       contents: read
-    # Run on main branch or workflow_dispatch
-    if: ${{ !github.event.pull_request.head.repo.fork && fromJSON(needs.pre-job.outputs.should_run).mobile == true && github.ref == 'refs/heads/main' }}
+    # Run on main branch or workflow_dispatch, or on PRs/other branches (build only, no upload)
+    if: ${{ !github.event.pull_request.head.repo.fork && fromJSON(needs.pre-job.outputs.should_run).mobile == true }}
     runs-on: macos-latest
 
     steps:
@@ -303,12 +303,20 @@ jobs:
           APP_STORE_CONNECT_API_KEY_ID: ${{ secrets.APP_STORE_CONNECT_API_KEY_ID }}
           APP_STORE_CONNECT_API_KEY_ISSUER_ID: ${{ secrets.APP_STORE_CONNECT_API_KEY_ISSUER_ID }}
           ENVIRONMENT: ${{ inputs.environment || 'development' }}
+          BUNDLE_ID_SUFFIX: ${{ inputs.environment == 'production' && '' || 'development' }}
+          GITHUB_REF: ${{ github.ref }}
         working-directory: ./mobile/ios
         run: |
-          if [[ "$ENVIRONMENT" == "development" ]]; then
-            bundle exec fastlane gha_testflight_dev
+          # Only upload to TestFlight on main branch
+          if [[ "$GITHUB_REF" == "refs/heads/main" ]]; then
+            if [[ "$ENVIRONMENT" == "development" ]]; then
+              bundle exec fastlane gha_testflight_dev
+            else
+              bundle exec fastlane gha_release_prod
+            fi
           else
-            bundle exec fastlane gha_release_prod
+            # Build only, no TestFlight upload for non-main branches
+            bundle exec fastlane gha_build_only
           fi
 
       - name: Clean up keychain
@@ -317,7 +325,7 @@ jobs:
           security delete-keychain build.keychain || true
 
       - name: Upload IPA artifact
-        uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # v4
+        uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5.0.0
         with:
           name: ios-release-ipa
           path: mobile/ios/Runner.ipa

.github/workflows/cli.yml

@@ -84,7 +84,7 @@ jobs:
           token: ${{ steps.token.outputs.token }}
 
       - name: Set up QEMU
-        uses: docker/setup-qemu-action@29109295f81e9208d7d86ff1c6c12d2833863392 # v3.6.0
+        uses: docker/setup-qemu-action@c7c53464625b32c7a7e944ae62b3e17d2b600130 # v3.7.0
 
       - name: Set up Docker Buildx
         uses: docker/setup-buildx-action@e468171a9de216ec08956ac3ada2f0791b6bd435 # v3.11.1
@@ -105,7 +105,7 @@ jobs:
 
       - name: Generate docker image tags
         id: metadata
-        uses: docker/metadata-action@c1e51972afc2121e065aed6d45c65596fe445f3f # v5.8.0
+        uses: docker/metadata-action@318604b99e75e41977312d83839a89be02ca4893 # v5.9.0
         with:
           flavor: |
             latest=false

.github/workflows/close-duplicates.yml

@@ -35,7 +35,7 @@ jobs:
     needs: [get_body, should_run]
     if: ${{ needs.should_run.outputs.should_run == 'true' }}
     container:
-      image: ghcr.io/immich-app/mdq:main@sha256:6b8450bfc06770af1af66bce9bf2ced7d1d9b90df1a59fc4c83a17777a9f6723
+      image: ghcr.io/immich-app/mdq:main@sha256:9c905a4ff69f00c4b2f98b40b6090ab3ab18d1a15ed1379733b8691aa1fcb271
     outputs:
       checked: ${{ steps.get_checkbox.outputs.checked }}
     steps:

.github/workflows/codeql-analysis.yml

@@ -57,7 +57,7 @@ jobs:
 
       # Initializes the CodeQL tools for scanning.
       - name: Initialize CodeQL
-        uses: github/codeql-action/init@16140ae1a102900babc80a33c44059580f687047 # v4.30.9
+        uses: github/codeql-action/init@0499de31b99561a6d14a36a5f662c2a54f91beee # v4.31.2
         with:
           languages: ${{ matrix.language }}
           # If you wish to specify custom queries, you can do so here or in a config file.
@@ -70,7 +70,7 @@ jobs:
       # Autobuild attempts to build any compiled languages  (C/C++, C#, or Java).
       # If this step fails, then you should remove it and run the build manually (see below)
       - name: Autobuild
-        uses: github/codeql-action/autobuild@16140ae1a102900babc80a33c44059580f687047 # v4.30.9
+        uses: github/codeql-action/autobuild@0499de31b99561a6d14a36a5f662c2a54f91beee # v4.31.2
 
       # ℹ️ Command-line programs to run using the OS shell.
       # 📚 See https://docs.github.com/en/actions/using-workflows/workflow-syntax-for-github-actions#jobsjob_idstepsrun
@@ -83,6 +83,6 @@ jobs:
       #   ./location_of_script_within_repo/buildscript.sh
 
       - name: Perform CodeQL Analysis
-        uses: github/codeql-action/analyze@16140ae1a102900babc80a33c44059580f687047 # v4.30.9
+        uses: github/codeql-action/analyze@0499de31b99561a6d14a36a5f662c2a54f91beee # v4.31.2
         with:
           category: '/language:${{matrix.language}}'

.github/workflows/docs-build.yml

@@ -85,7 +85,7 @@ jobs:
         run: pnpm build
 
       - name: Upload build output
-        uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # v4.6.2
+        uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5.0.0
         with:
           name: docs-build-output
           path: docs/build/

.github/workflows/prepare-release.yml

@@ -62,7 +62,7 @@ jobs:
           ref: main
 
       - name: Install uv
-        uses: astral-sh/setup-uv@2ddd2b9cb38ad8efd50337e8ab201519a34c9f24 # v7.1.1
+        uses: astral-sh/setup-uv@85856786d1ce8acfbcc2f13a5f3fbd6b938f9f41 # v7.1.2
 
       - name: Setup pnpm
         uses: pnpm/action-setup@41ff72655975bd51cab0327fa583b6e92b6d3061 # v4.2.0
@@ -138,7 +138,7 @@ jobs:
           persist-credentials: false
 
       - name: Download APK
-        uses: actions/download-artifact@634f93cb2916e3fdff6788551b99b062d0335ce0 # v5.0.0
+        uses: actions/download-artifact@018cc2cf5baa6db3ef3c5f8a56943fffe632ef53 # v6.0.0
         with:
           name: release-apk-signed
           github-token: ${{ steps.generate-token.outputs.token }}

.github/workflows/release-pr.yml

@@ -0,0 +1,170 @@
+name: Manage release PR
+on:
+  workflow_dispatch:
+  push:
+    branches:
+      - main
+
+concurrency:
+  group: ${{ github.workflow }}
+  cancel-in-progress: true
+
+permissions: {}
+
+jobs:
+  bump:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Generate a token
+        id: generate-token
+        uses: actions/create-github-app-token@67018539274d69449ef7c02e8e71183d1719ab42 # v2.1.4
+        with:
+          app-id: ${{ secrets.PUSH_O_MATIC_APP_ID }}
+          private-key: ${{ secrets.PUSH_O_MATIC_APP_KEY }}
+
+      - name: Checkout
+        uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
+        with:
+          token: ${{ steps.generate-token.outputs.token }}
+          persist-credentials: true
+          ref: main
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@85856786d1ce8acfbcc2f13a5f3fbd6b938f9f41 # v7.1.2
+
+      - name: Setup pnpm
+        uses: pnpm/action-setup@41ff72655975bd51cab0327fa583b6e92b6d3061 # v4.2.0
+
+      - name: Setup Node
+        uses: actions/setup-node@2028fbc5c25fe9cf00d9f06a71cc4710d4507903 # v6.0.0
+        with:
+          node-version-file: './server/.nvmrc'
+          cache: 'pnpm'
+          cache-dependency-path: '**/pnpm-lock.yaml'
+
+      - name: Determine release type
+        id: bump-type
+        uses: ietf-tools/semver-action@c90370b2958652d71c06a3484129a4d423a6d8a8 # v1.11.0
+        with:
+          token: ${{ steps.generate-token.outputs.token }}
+
+      - name: Bump versions
+        env:
+          TYPE: ${{ steps.bump-type.outputs.bump }}
+        run: |
+          if [ "$TYPE" == "none" ]; then
+            exit 1 # TODO: Is there a cleaner way to abort the workflow?
+          fi
+          misc/release/pump-version.sh -s $TYPE -m true
+
+      - name: Manage Outline release document
+        id: outline
+        uses: actions/github-script@ed597411d8f924073f98dfc5c65a23a2325f34cd # v8.0.0
+        env:
+          OUTLINE_API_KEY: ${{ secrets.OUTLINE_API_KEY }}
+          NEXT_VERSION: ${{ steps.bump-type.outputs.next }}
+        with:
+          github-token: ${{ steps.generate-token.outputs.token }}
+          script: |
+            const fs = require('fs');
+
+            const outlineKey = process.env.OUTLINE_API_KEY;
+            const parentDocumentId = 'da856355-0844-43df-bd71-f8edce5382d9'
+            const collectionId = 'e2910656-714c-4871-8721-447d9353bd73';
+            const baseUrl = 'https://outline.immich.cloud';
+
+            const listResponse = await fetch(`${baseUrl}/api/documents.list`, {
+              method: 'POST',
+              headers: {
+                'Authorization': `Bearer ${outlineKey}`,
+                'Content-Type': 'application/json'
+              },
+              body: JSON.stringify({ parentDocumentId })
+            });
+
+            if (!listResponse.ok) {
+              throw new Error(`Outline list failed: ${listResponse.statusText}`);
+            }
+
+            const listData = await listResponse.json();
+            const allDocuments = listData.data || [];
+
+            const document = allDocuments.find(doc => doc.title === 'next');
+
+            let documentId;
+            let documentUrl;
+            let documentText;
+
+            if (!document) {
+              // Create new document
+              console.log('No existing document found. Creating new one...');
+              const notesTmpl = fs.readFileSync('misc/release/notes.tmpl', 'utf8');
+              const createResponse = await fetch(`${baseUrl}/api/documents.create`, {
+                method: 'POST',
+                headers: {
+                  'Authorization': `Bearer ${outlineKey}`,
+                  'Content-Type': 'application/json'
+                },
+                body: JSON.stringify({
+                  title: 'next',
+                  text: notesTmpl,
+                  collectionId: collectionId,
+                  parentDocumentId: parentDocumentId,
+                  publish: true
+                })
+              });
+
+              if (!createResponse.ok) {
+                throw new Error(`Failed to create document: ${createResponse.statusText}`);
+              }
+
+              const createData = await createResponse.json();
+              documentId = createData.data.id;
+              const urlId = createData.data.urlId;
+              documentUrl = `${baseUrl}/doc/next-${urlId}`;
+              documentText = createData.data.text || '';
+              console.log(`Created new document: ${documentUrl}`);
+            } else {
+              documentId = document.id;
+              const docPath = document.url;
+              documentUrl = `${baseUrl}${docPath}`;
+              documentText = document.text || '';
+              console.log(`Found existing document: ${documentUrl}`);
+            }
+
+            // Generate GitHub release notes
+            console.log('Generating GitHub release notes...');
+            const releaseNotesResponse = await github.rest.repos.generateReleaseNotes({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              tag_name: `${process.env.NEXT_VERSION}`,
+            });
+
+            // Combine the content
+            const changelog = `
+            # ${process.env.NEXT_VERSION}
+
+            ${documentText}
+
+            ${releaseNotesResponse.data.body}
+
+            ---
+
+            `
+
+            const existingChangelog = fs.existsSync('CHANGELOG.md') ? fs.readFileSync('CHANGELOG.md', 'utf8') : '';
+            fs.writeFileSync('CHANGELOG.md', changelog + existingChangelog, 'utf8');
+
+            core.setOutput('document_url', documentUrl);
+
+      - name: Create PR
+        id: create-pr
+        uses: peter-evans/create-pull-request@271a8d0340265f705b14b6d32b9829c1cb33d45e # v7.0.8
+        with:
+          token: ${{ steps.generate-token.outputs.token }}
+          commit-message: 'chore: release ${{ steps.bump-type.outputs.next }}'
+          title: 'chore: release ${{ steps.bump-type.outputs.next }}'
+          body: 'Release notes: ${{ steps.outline.outputs.document_url }}'
+          labels: 'changelog:skip'
+          branch: 'release/next'
+          draft: true

.github/workflows/test.yml

@@ -563,7 +563,7 @@ jobs:
           persist-credentials: false
           token: ${{ steps.token.outputs.token }}
       - name: Install uv
-        uses: astral-sh/setup-uv@2ddd2b9cb38ad8efd50337e8ab201519a34c9f24 # v7.1.1
+        uses: astral-sh/setup-uv@85856786d1ce8acfbcc2f13a5f3fbd6b938f9f41 # v7.1.2
       - uses: actions/setup-python@e797f83bcb11b83ae66e0230d6156d7c80228e7c # v6.0.0
         # TODO: add caching when supported (https://github.com/actions/setup-python/pull/818)
         # with:

Makefile

@@ -17,6 +17,9 @@ dev-docs:
 e2e:
 	@trap 'make e2e-down' EXIT; COMPOSE_BAKE=true docker compose -f ./e2e/docker-compose.yml up --remove-orphans
 
+e2e-dev:
+	@trap 'make e2e-down' EXIT; COMPOSE_BAKE=true docker compose -f ./e2e/docker-compose.dev.yml up --remove-orphans
+
 e2e-update:
 	@trap 'make e2e-down' EXIT; COMPOSE_BAKE=true docker compose -f ./e2e/docker-compose.yml up --build -V --remove-orphans
 

cli/package.json

@@ -20,7 +20,7 @@
     "@types/lodash-es": "^4.17.12",
     "@types/micromatch": "^4.0.9",
     "@types/mock-fs": "^4.13.1",
-    "@types/node": "^22.19.0",
+    "@types/node": "^22.19.1",
     "@vitest/coverage-v8": "^3.0.0",
     "byte-size": "^9.0.0",
     "cli-progress": "^3.12.0",

docker/docker-compose.dev.yml

@@ -41,6 +41,7 @@ services:
       - app-node_modules:/usr/src/app/node_modules
       - sveltekit:/usr/src/app/web/.svelte-kit
       - coverage:/usr/src/app/web/coverage
+      - ../plugins:/build/corePlugin
     env_file:
       - .env
     environment:

docs/docs/administration/maintenance-mode.md

@@ -0,0 +1,18 @@
+# Maintenance Mode
+
+Maintenance mode is used to perform administrative tasks such as restoring backups to Immich.
+
+You can enter maintenance mode by either:
+
+- Selecting "enable maintenance mode" in system settings in administration.
+- Running the enable maintenance mode [administration command](./server-commands.md).
+
+## Logging in during maintenance
+
+Maintenance mode uses a separate login system which is handled automatically behind the scenes in most cases. Enabling maintenance mode in settings will automatically log you into maintenance mode when the server comes back up.
+
+If you find that you've been logged out, you can:
+
+- Open the logs for the Immich server and look for _"🚧 Immich is in maintenance mode, you can log in using the following URL:"_
+- Run the enable maintenance mode [administration command](./server-commands.md) again, this will give you a new URL to login with.
+- Run the disable maintenance mode [administration command](./server-commands.md) then re-enter through system settings.

docs/docs/administration/server-commands.md

@@ -2,17 +2,19 @@
 
 The `immich-server` docker image comes preinstalled with an administrative CLI (`immich-admin`) that supports the following commands:
 
-| Command                  | Description                                                   |
-| ------------------------ | ------------------------------------------------------------- |
-| `help`                   | Display help                                                  |
-| `reset-admin-password`   | Reset the password for the admin user                         |
-| `disable-password-login` | Disable password login                                        |
-| `enable-password-login`  | Enable password login                                         |
-| `enable-oauth-login`     | Enable OAuth login                                            |
-| `disable-oauth-login`    | Disable OAuth login                                           |
-| `list-users`             | List Immich users                                             |
-| `version`                | Print Immich version                                          |
-| `change-media-location`  | Change database file paths to align with a new media location |
+| Command                    | Description                                                   |
+| -------------------------- | ------------------------------------------------------------- |
+| `help`                     | Display help                                                  |
+| `reset-admin-password`     | Reset the password for the admin user                         |
+| `disable-password-login`   | Disable password login                                        |
+| `enable-password-login`    | Enable password login                                         |
+| `disable-maintenance-mode` | Disable maintenance mode                                      |
+| `enable-maintenance-mode`  | Enable maintenance mode                                       |
+| `enable-oauth-login`       | Enable OAuth login                                            |
+| `disable-oauth-login`      | Disable OAuth login                                           |
+| `list-users`               | List Immich users                                             |
+| `version`                  | Print Immich version                                          |
+| `change-media-location`    | Change database file paths to align with a new media location |
 
 ## How to run a command
 
@@ -47,6 +49,23 @@ immich-admin enable-password-login
 Password login has been enabled.
 ```
 
+Disable Maintenance Mode
+
+```
+immich-admin disable-maintenace-mode
+Maintenance mode has been disabled.
+```
+
+Enable Maintenance Mode
+
+```
+immich-admin enable-maintenance-mode
+Maintenance mode has been enabled.
+
+Log in using the following URL:
+https://my.immich.app/maintenance?token=<token>
+```
+
 Enable OAuth login
 
 ```

docs/docs/developer/database-migrations.md

@@ -12,3 +12,13 @@ pnpm run migrations:generate <migration-name>
 3. Move the migration file to folder `./server/src/schema/migrations` in your code editor.
 
 The server will automatically detect `*.ts` file changes and restart. Part of the server start-up process includes running any new migrations, so it will be applied immediately.
+
+## Reverting a Migration
+
+If you need to undo the most recently applied migration—for example, when developing or testing on schema changes—run:
+
+```bash
+pnpm run migrations:revert
+```
+
+This command rolls back the latest migration and brings the database schema back to its previous state.

docs/docs/developer/setup.md

@@ -5,7 +5,7 @@ sidebar_position: 2
 # Setup
 
 :::note
-If there's a feature you're planning to work on, just give us a heads up in [Discord](https://discord.com/channels/979116623879368755/1071165397228855327) so we can:
+If there's a feature you're planning to work on, just give us a heads up in [#contributing](https://discord.com/channels/979116623879368755/1071165397228855327) on [our Discord](https://discord.immich.app) so we can:
 
 1. Let you know if it's something we would accept into Immich
 2. Provide any guidance on how something like that would ideally be implemented

e2e/docker-compose.dev.yml

@@ -0,0 +1,105 @@
+name: immich-e2e
+
+services:
+  immich-server:
+    container_name: immich-e2e-server
+    command: ['immich-dev']
+    image: immich-server-dev:latest
+    build:
+      context: ../
+      dockerfile: server/Dockerfile.dev
+      target: dev
+    environment:
+      - DB_HOSTNAME=database
+      - DB_USERNAME=postgres
+      - DB_PASSWORD=postgres
+      - DB_DATABASE_NAME=immich
+      - IMMICH_MACHINE_LEARNING_ENABLED=false
+      - IMMICH_TELEMETRY_INCLUDE=all
+      - IMMICH_ENV=testing
+      - IMMICH_PORT=2285
+      - IMMICH_IGNORE_MOUNT_CHECK_ERRORS=true
+    volumes:
+      - ./test-assets:/test-assets
+      - ..:/usr/src/app
+      - ${UPLOAD_LOCATION}/photos:/data
+      - /etc/localtime:/etc/localtime:ro
+      - pnpm-store:/usr/src/app/.pnpm-store
+      - server-node_modules:/usr/src/app/server/node_modules
+      - web-node_modules:/usr/src/app/web/node_modules
+      - github-node_modules:/usr/src/app/.github/node_modules
+      - cli-node_modules:/usr/src/app/cli/node_modules
+      - docs-node_modules:/usr/src/app/docs/node_modules
+      - e2e-node_modules:/usr/src/app/e2e/node_modules
+      - sdk-node_modules:/usr/src/app/open-api/typescript-sdk/node_modules
+      - app-node_modules:/usr/src/app/node_modules
+      - sveltekit:/usr/src/app/web/.svelte-kit
+      - coverage:/usr/src/app/web/coverage
+      - ../plugins:/build/corePlugin
+    depends_on:
+      redis:
+        condition: service_started
+      database:
+        condition: service_healthy
+
+  immich-web:
+    container_name: immich-e2e-web
+    image: immich-web-dev:latest
+    build:
+      context: ../
+      dockerfile: server/Dockerfile.dev
+      target: dev
+    command: ['immich-web']
+    ports:
+      - 2285:3000
+    environment:
+      - IMMICH_SERVER_URL=http://immich-server:2285/
+    volumes:
+      - ..:/usr/src/app
+      - pnpm-store:/usr/src/app/.pnpm-store
+      - server-node_modules:/usr/src/app/server/node_modules
+      - web-node_modules:/usr/src/app/web/node_modules
+      - github-node_modules:/usr/src/app/.github/node_modules
+      - cli-node_modules:/usr/src/app/cli/node_modules
+      - docs-node_modules:/usr/src/app/docs/node_modules
+      - e2e-node_modules:/usr/src/app/e2e/node_modules
+      - sdk-node_modules:/usr/src/app/open-api/typescript-sdk/node_modules
+      - app-node_modules:/usr/src/app/node_modules
+      - sveltekit:/usr/src/app/web/.svelte-kit
+      - coverage:/usr/src/app/web/coverage
+    restart: unless-stopped
+
+  redis:
+    image: redis:6.2-alpine@sha256:37e002448575b32a599109664107e374c8709546905c372a34d64919043b9ceb
+
+  database:
+    image: ghcr.io/immich-app/postgres:14-vectorchord0.3.0@sha256:6f3e9d2c2177af16c2988ff71425d79d89ca630ec2f9c8db03209ab716542338
+    command: -c fsync=off -c shared_preload_libraries=vchord.so -c config_file=/var/lib/postgresql/data/postgresql.conf
+    environment:
+      POSTGRES_PASSWORD: postgres
+      POSTGRES_USER: postgres
+      POSTGRES_DB: immich
+    ports:
+      - 5435:5432
+    healthcheck:
+      test: ['CMD-SHELL', 'pg_isready -U postgres -d immich']
+      interval: 1s
+      timeout: 5s
+      retries: 30
+      start_period: 10s
+
+volumes:
+  model-cache:
+  prometheus-data:
+  grafana-data:
+  pnpm-store:
+  server-node_modules:
+  web-node_modules:
+  github-node_modules:
+  cli-node_modules:
+  docs-node_modules:
+  e2e-node_modules:
+  sdk-node_modules:
+  app-node_modules:
+  sveltekit:
+  coverage:

e2e/package.json

@@ -25,7 +25,7 @@
     "@playwright/test": "^1.44.1",
     "@socket.io/component-emitter": "^3.1.2",
     "@types/luxon": "^3.4.2",
-    "@types/node": "^22.19.0",
+    "@types/node": "^22.19.1",
     "@types/oidc-provider": "^9.0.0",
     "@types/pg": "^8.15.1",
     "@types/pngjs": "^6.0.4",

e2e/src/api/specs/jobs.e2e-spec.ts

@@ -1,4 +1,4 @@
-import { JobCommand, JobName, LoginResponseDto, updateConfig } from '@immich/sdk';
+import { LoginResponseDto, QueueCommand, QueueName, updateConfig } from '@immich/sdk';
 import { cpSync, rmSync } from 'node:fs';
 import { readFile } from 'node:fs/promises';
 import { basename } from 'node:path';
@@ -17,28 +17,28 @@ describe('/jobs', () => {
 
   describe('PUT /jobs', () => {
     afterEach(async () => {
-      await utils.jobCommand(admin.accessToken, JobName.MetadataExtraction, {
-        command: JobCommand.Resume,
+      await utils.queueCommand(admin.accessToken, QueueName.MetadataExtraction, {
+        command: QueueCommand.Resume,
         force: false,
       });
 
-      await utils.jobCommand(admin.accessToken, JobName.ThumbnailGeneration, {
-        command: JobCommand.Resume,
+      await utils.queueCommand(admin.accessToken, QueueName.ThumbnailGeneration, {
+        command: QueueCommand.Resume,
         force: false,
       });
 
-      await utils.jobCommand(admin.accessToken, JobName.FaceDetection, {
-        command: JobCommand.Resume,
+      await utils.queueCommand(admin.accessToken, QueueName.FaceDetection, {
+        command: QueueCommand.Resume,
         force: false,
       });
 
-      await utils.jobCommand(admin.accessToken, JobName.SmartSearch, {
-        command: JobCommand.Resume,
+      await utils.queueCommand(admin.accessToken, QueueName.SmartSearch, {
+        command: QueueCommand.Resume,
         force: false,
       });
 
-      await utils.jobCommand(admin.accessToken, JobName.DuplicateDetection, {
-        command: JobCommand.Resume,
+      await utils.queueCommand(admin.accessToken, QueueName.DuplicateDetection, {
+        command: QueueCommand.Resume,
         force: false,
       });
 
@@ -59,8 +59,8 @@ describe('/jobs', () => {
     it('should queue metadata extraction for missing assets', async () => {
       const path = `${testAssetDir}/formats/raw/Nikon/D700/philadelphia.nef`;
 
-      await utils.jobCommand(admin.accessToken, JobName.MetadataExtraction, {
-        command: JobCommand.Pause,
+      await utils.queueCommand(admin.accessToken, QueueName.MetadataExtraction, {
+        command: QueueCommand.Pause,
         force: false,
       });
 
@@ -77,20 +77,20 @@ describe('/jobs', () => {
         expect(asset.exifInfo?.make).toBeNull();
       }
 
-      await utils.jobCommand(admin.accessToken, JobName.MetadataExtraction, {
-        command: JobCommand.Empty,
+      await utils.queueCommand(admin.accessToken, QueueName.MetadataExtraction, {
+        command: QueueCommand.Empty,
         force: false,
       });
 
       await utils.waitForQueueFinish(admin.accessToken, 'metadataExtraction');
 
-      await utils.jobCommand(admin.accessToken, JobName.MetadataExtraction, {
-        command: JobCommand.Resume,
+      await utils.queueCommand(admin.accessToken, QueueName.MetadataExtraction, {
+        command: QueueCommand.Resume,
         force: false,
       });
 
-      await utils.jobCommand(admin.accessToken, JobName.MetadataExtraction, {
-        command: JobCommand.Start,
+      await utils.queueCommand(admin.accessToken, QueueName.MetadataExtraction, {
+        command: QueueCommand.Start,
         force: false,
       });
 
@@ -124,8 +124,8 @@ describe('/jobs', () => {
 
       cpSync(`${testAssetDir}/formats/raw/Nikon/D80/glarus.nef`, path);
 
-      await utils.jobCommand(admin.accessToken, JobName.MetadataExtraction, {
-        command: JobCommand.Start,
+      await utils.queueCommand(admin.accessToken, QueueName.MetadataExtraction, {
+        command: QueueCommand.Start,
         force: false,
       });
 
@@ -144,8 +144,8 @@ describe('/jobs', () => {
     it('should queue thumbnail extraction for assets missing thumbs', async () => {
       const path = `${testAssetDir}/albums/nature/tanners_ridge.jpg`;
 
-      await utils.jobCommand(admin.accessToken, JobName.ThumbnailGeneration, {
-        command: JobCommand.Pause,
+      await utils.queueCommand(admin.accessToken, QueueName.ThumbnailGeneration, {
+        command: QueueCommand.Pause,
         force: false,
       });
 
@@ -153,32 +153,32 @@ describe('/jobs', () => {
         assetData: { bytes: await readFile(path), filename: basename(path) },
       });
 
-      await utils.waitForQueueFinish(admin.accessToken, JobName.MetadataExtraction);
-      await utils.waitForQueueFinish(admin.accessToken, JobName.ThumbnailGeneration);
+      await utils.waitForQueueFinish(admin.accessToken, QueueName.MetadataExtraction);
+      await utils.waitForQueueFinish(admin.accessToken, QueueName.ThumbnailGeneration);
 
       const assetBefore = await utils.getAssetInfo(admin.accessToken, id);
       expect(assetBefore.thumbhash).toBeNull();
 
-      await utils.jobCommand(admin.accessToken, JobName.ThumbnailGeneration, {
-        command: JobCommand.Empty,
+      await utils.queueCommand(admin.accessToken, QueueName.ThumbnailGeneration, {
+        command: QueueCommand.Empty,
         force: false,
       });
 
-      await utils.waitForQueueFinish(admin.accessToken, JobName.MetadataExtraction);
-      await utils.waitForQueueFinish(admin.accessToken, JobName.ThumbnailGeneration);
+      await utils.waitForQueueFinish(admin.accessToken, QueueName.MetadataExtraction);
+      await utils.waitForQueueFinish(admin.accessToken, QueueName.ThumbnailGeneration);
 
-      await utils.jobCommand(admin.accessToken, JobName.ThumbnailGeneration, {
-        command: JobCommand.Resume,
+      await utils.queueCommand(admin.accessToken, QueueName.ThumbnailGeneration, {
+        command: QueueCommand.Resume,
         force: false,
       });
 
-      await utils.jobCommand(admin.accessToken, JobName.ThumbnailGeneration, {
-        command: JobCommand.Start,
+      await utils.queueCommand(admin.accessToken, QueueName.ThumbnailGeneration, {
+        command: QueueCommand.Start,
         force: false,
       });
 
-      await utils.waitForQueueFinish(admin.accessToken, JobName.MetadataExtraction);
-      await utils.waitForQueueFinish(admin.accessToken, JobName.ThumbnailGeneration);
+      await utils.waitForQueueFinish(admin.accessToken, QueueName.MetadataExtraction);
+      await utils.waitForQueueFinish(admin.accessToken, QueueName.ThumbnailGeneration);
 
       const assetAfter = await utils.getAssetInfo(admin.accessToken, id);
       expect(assetAfter.thumbhash).not.toBeNull();
@@ -193,26 +193,26 @@ describe('/jobs', () => {
         assetData: { bytes: await readFile(path), filename: basename(path) },
       });
 
-      await utils.waitForQueueFinish(admin.accessToken, JobName.MetadataExtraction);
-      await utils.waitForQueueFinish(admin.accessToken, JobName.ThumbnailGeneration);
+      await utils.waitForQueueFinish(admin.accessToken, QueueName.MetadataExtraction);
+      await utils.waitForQueueFinish(admin.accessToken, QueueName.ThumbnailGeneration);
 
       const assetBefore = await utils.getAssetInfo(admin.accessToken, id);
 
       cpSync(`${testAssetDir}/albums/nature/notocactus_minimus.jpg`, path);
 
-      await utils.jobCommand(admin.accessToken, JobName.ThumbnailGeneration, {
-        command: JobCommand.Resume,
+      await utils.queueCommand(admin.accessToken, QueueName.ThumbnailGeneration, {
+        command: QueueCommand.Resume,
         force: false,
       });
 
       // This runs the missing thumbnail job
-      await utils.jobCommand(admin.accessToken, JobName.ThumbnailGeneration, {
-        command: JobCommand.Start,
+      await utils.queueCommand(admin.accessToken, QueueName.ThumbnailGeneration, {
+        command: QueueCommand.Start,
         force: false,
       });
 
-      await utils.waitForQueueFinish(admin.accessToken, JobName.MetadataExtraction);
-      await utils.waitForQueueFinish(admin.accessToken, JobName.ThumbnailGeneration);
+      await utils.waitForQueueFinish(admin.accessToken, QueueName.MetadataExtraction);
+      await utils.waitForQueueFinish(admin.accessToken, QueueName.ThumbnailGeneration);
 
       const assetAfter = await utils.getAssetInfo(admin.accessToken, id);
 

e2e/src/api/specs/maintenance.e2e-spec.ts

@@ -0,0 +1,172 @@
+import { LoginResponseDto } from '@immich/sdk';
+import { createUserDto } from 'src/fixtures';
+import { errorDto } from 'src/responses';
+import { app, utils } from 'src/utils';
+import request from 'supertest';
+import { beforeAll, describe, expect, it } from 'vitest';
+
+describe('/admin/maintenance', () => {
+  let cookie: string | undefined;
+  let admin: LoginResponseDto;
+  let nonAdmin: LoginResponseDto;
+
+  beforeAll(async () => {
+    await utils.resetDatabase();
+    admin = await utils.adminSetup();
+    nonAdmin = await utils.userSetup(admin.accessToken, createUserDto.user1);
+  });
+
+  // => outside of maintenance mode
+
+  describe('GET ~/server/config', async () => {
+    it('should indicate we are out of maintenance mode', async () => {
+      const { status, body } = await request(app).get('/server/config');
+      expect(status).toBe(200);
+      expect(body.maintenanceMode).toBeFalsy();
+    });
+  });
+
+  describe('POST /login', async () => {
+    it('should not work out of maintenance mode', async () => {
+      const { status, body } = await request(app).post('/admin/maintenance/login').send({ token: 'token' });
+      expect(status).toBe(400);
+      expect(body).toEqual(errorDto.badRequest('Not in maintenance mode'));
+    });
+  });
+
+  // => enter maintenance mode
+
+  describe.sequential('POST /', () => {
+    it('should require authentication', async () => {
+      const { status, body } = await request(app).post('/admin/maintenance').send({
+        action: 'end',
+      });
+      expect(status).toBe(401);
+      expect(body).toEqual(errorDto.unauthorized);
+    });
+
+    it('should only work for admins', async () => {
+      const { status, body } = await request(app)
+        .post('/admin/maintenance')
+        .set('Authorization', `Bearer ${nonAdmin.accessToken}`)
+        .send({ action: 'end' });
+      expect(status).toBe(403);
+      expect(body).toEqual(errorDto.forbidden);
+    });
+
+    it('should be a no-op if try to exit maintenance mode', async () => {
+      const { status } = await request(app)
+        .post('/admin/maintenance')
+        .set('Authorization', `Bearer ${admin.accessToken}`)
+        .send({ action: 'end' });
+      expect(status).toBe(201);
+    });
+
+    it('should enter maintenance mode', async () => {
+      const { status, headers } = await request(app)
+        .post('/admin/maintenance')
+        .set('Authorization', `Bearer ${admin.accessToken}`)
+        .send({
+          action: 'start',
+        });
+      expect(status).toBe(201);
+
+      cookie = headers['set-cookie'][0].split(';')[0];
+      expect(cookie).toEqual(
+        expect.stringMatching(/^immich_maintenance_token=[A-Za-z0-9-_]*\.[A-Za-z0-9-_]*\.[A-Za-z0-9-_]*$/),
+      );
+
+      await expect
+        .poll(
+          async () => {
+            const { body } = await request(app).get('/server/config');
+            return body.maintenanceMode;
+          },
+          {
+            interval: 5e2,
+            timeout: 1e4,
+          },
+        )
+        .toBeTruthy();
+    });
+  });
+
+  // => in maintenance mode
+
+  describe.sequential('in maintenance mode', () => {
+    describe('GET ~/server/config', async () => {
+      it('should indicate we are in maintenance mode', async () => {
+        const { status, body } = await request(app).get('/server/config');
+        expect(status).toBe(200);
+        expect(body.maintenanceMode).toBeTruthy();
+      });
+    });
+
+    describe('POST /login', async () => {
+      it('should fail without cookie or token in body', async () => {
+        const { status, body } = await request(app).post('/admin/maintenance/login').send({});
+        expect(status).toBe(401);
+        expect(body).toEqual(errorDto.unauthorizedWithMessage('Missing JWT Token'));
+      });
+
+      it('should succeed with cookie', async () => {
+        const { status, body } = await request(app).post('/admin/maintenance/login').set('cookie', cookie!).send({});
+        expect(status).toBe(201);
+        expect(body).toEqual(
+          expect.objectContaining({
+            username: 'Immich Admin',
+          }),
+        );
+      });
+
+      it('should succeed with token', async () => {
+        const { status, body } = await request(app)
+          .post('/admin/maintenance/login')
+          .send({
+            token: cookie!.split('=')[1].trim(),
+          });
+        expect(status).toBe(201);
+        expect(body).toEqual(
+          expect.objectContaining({
+            username: 'Immich Admin',
+          }),
+        );
+      });
+    });
+
+    describe('POST /', async () => {
+      it('should be a no-op if try to enter maintenance mode', async () => {
+        const { status } = await request(app)
+          .post('/admin/maintenance')
+          .set('cookie', cookie!)
+          .send({ action: 'start' });
+        expect(status).toBe(201);
+      });
+    });
+  });
+
+  // => exit maintenance mode
+
+  describe.sequential('POST /', () => {
+    it('should exit maintenance mode', async () => {
+      const { status } = await request(app).post('/admin/maintenance').set('cookie', cookie!).send({
+        action: 'end',
+      });
+
+      expect(status).toBe(201);
+
+      await expect
+        .poll(
+          async () => {
+            const { body } = await request(app).get('/server/config');
+            return body.maintenanceMode;
+          },
+          {
+            interval: 5e2,
+            timeout: 1e4,
+          },
+        )
+        .toBeFalsy();
+    });
+  });
+});

e2e/src/api/specs/server.e2e-spec.ts

@@ -136,6 +136,7 @@ describe('/server', () => {
         externalDomain: '',
         publicUsers: true,
         isOnboarded: false,
+        maintenanceMode: false,
         mapDarkStyleUrl: 'https://tiles.immich.cloud/v1/style/dark.json',
         mapLightStyleUrl: 'https://tiles.immich.cloud/v1/style/light.json',
       });

e2e/src/api/specs/user-admin.e2e-spec.ts

@@ -1,6 +1,6 @@
 import {
-  JobName,
   LoginResponseDto,
+  QueueName,
   createStack,
   deleteUserAdmin,
   getMyUser,
@@ -328,7 +328,7 @@ describe('/admin/users', () => {
         { headers: asBearerAuth(user.accessToken) },
       );
 
-      await utils.waitForQueueFinish(admin.accessToken, JobName.BackgroundTask);
+      await utils.waitForQueueFinish(admin.accessToken, QueueName.BackgroundTask);
 
       const { status, body } = await request(app)
         .delete(`/admin/users/${user.userId}`)

e2e/src/responses.ts

@@ -7,6 +7,12 @@ export const errorDto = {
     message: 'Authentication required',
     correlationId: expect.any(String),
   },
+  unauthorizedWithMessage: (message: string) => ({
+    error: 'Unauthorized',
+    statusCode: 401,
+    message,
+    correlationId: expect.any(String),
+  }),
   forbidden: {
     error: 'Forbidden',
     statusCode: 403,

e2e/src/utils.ts

@@ -1,5 +1,4 @@
 import {
-  AllJobStatusResponseDto,
   AssetMediaCreateDto,
   AssetMediaResponseDto,
   AssetResponseDto,
@@ -7,11 +6,13 @@ import {
   CheckExistingAssetsDto,
   CreateAlbumDto,
   CreateLibraryDto,
-  JobCommandDto,
-  JobName,
+  MaintenanceAction,
   MetadataSearchDto,
   Permission,
   PersonCreateDto,
+  QueueCommandDto,
+  QueueName,
+  QueuesResponseDto,
   SharedLinkCreateDto,
   UpdateLibraryDto,
   UserAdminCreateDto,
@@ -27,15 +28,16 @@ import {
   createStack,
   createUserAdmin,
   deleteAssets,
-  getAllJobsStatus,
   getAssetInfo,
   getConfig,
   getConfigDefaults,
+  getQueuesLegacy,
   login,
+  runQueueCommandLegacy,
   scanLibrary,
   searchAssets,
-  sendJobCommand,
   setBaseUrl,
+  setMaintenanceMode,
   signUpAdmin,
   tagAssets,
   updateAdminOnboarding,
@@ -477,8 +479,8 @@ export const utils = {
   tagAssets: (accessToken: string, tagId: string, assetIds: string[]) =>
     tagAssets({ id: tagId, bulkIdsDto: { ids: assetIds } }, { headers: asBearerAuth(accessToken) }),
 
-  jobCommand: async (accessToken: string, jobName: JobName, jobCommandDto: JobCommandDto) =>
-    sendJobCommand({ id: jobName, jobCommandDto }, { headers: asBearerAuth(accessToken) }),
+  queueCommand: async (accessToken: string, name: QueueName, queueCommandDto: QueueCommandDto) =>
+    runQueueCommandLegacy({ name, queueCommandDto }, { headers: asBearerAuth(accessToken) }),
 
   setAuthCookies: async (context: BrowserContext, accessToken: string, domain = '127.0.0.1') =>
     await context.addCookies([
@@ -514,6 +516,42 @@ export const utils = {
       },
     ]),
 
+  setMaintenanceAuthCookie: async (context: BrowserContext, token: string, domain = '127.0.0.1') =>
+    await context.addCookies([
+      {
+        name: 'immich_maintenance_token',
+        value: token,
+        domain,
+        path: '/',
+        expires: 2_058_028_213,
+        httpOnly: true,
+        secure: false,
+        sameSite: 'Lax',
+      },
+    ]),
+
+  enterMaintenance: async (accessToken: string) => {
+    let setCookie: string[] | undefined;
+
+    await setMaintenanceMode(
+      {
+        setMaintenanceModeDto: {
+          action: MaintenanceAction.Start,
+        },
+      },
+      {
+        headers: asBearerAuth(accessToken),
+        fetch: (...args: Parameters<typeof fetch>) =>
+          fetch(...args).then((response) => {
+            setCookie = response.headers.getSetCookie();
+            return response;
+          }),
+      },
+    );
+
+    return setCookie;
+  },
+
   resetTempFolder: () => {
     rmSync(`${testAssetDir}/temp`, { recursive: true, force: true });
     mkdirSync(`${testAssetDir}/temp`, { recursive: true });
@@ -524,13 +562,13 @@ export const utils = {
     await updateConfig({ systemConfigDto: defaultConfig }, { headers: asBearerAuth(accessToken) });
   },
 
-  isQueueEmpty: async (accessToken: string, queue: keyof AllJobStatusResponseDto) => {
-    const queues = await getAllJobsStatus({ headers: asBearerAuth(accessToken) });
+  isQueueEmpty: async (accessToken: string, queue: keyof QueuesResponseDto) => {
+    const queues = await getQueuesLegacy({ headers: asBearerAuth(accessToken) });
     const jobCounts = queues[queue].jobCounts;
     return !jobCounts.active && !jobCounts.waiting;
   },
 
-  waitForQueueFinish: (accessToken: string, queue: keyof AllJobStatusResponseDto, ms?: number) => {
+  waitForQueueFinish: (accessToken: string, queue: keyof QueuesResponseDto, ms?: number) => {
     // eslint-disable-next-line no-async-promise-executor
     return new Promise<void>(async (resolve, reject) => {
       const timeout = setTimeout(() => reject(new Error('Timed out waiting for queue to empty')), ms || 10_000);

e2e/src/web/specs/maintenance.e2e-spec.ts

@@ -0,0 +1,52 @@
+import { LoginResponseDto } from '@immich/sdk';
+import { expect, test } from '@playwright/test';
+import { utils } from 'src/utils';
+
+test.describe.configure({ mode: 'serial' });
+
+test.describe('Maintenance', () => {
+  let admin: LoginResponseDto;
+
+  test.beforeAll(async () => {
+    utils.initSdk();
+    await utils.resetDatabase();
+    admin = await utils.adminSetup();
+  });
+
+  test('enter and exit maintenance mode', async ({ context, page }) => {
+    await utils.setAuthCookies(context, admin.accessToken);
+
+    await page.goto('/admin/system-settings?isOpen=maintenance');
+    await page.getByRole('button', { name: 'Start maintenance mode' }).click();
+
+    await page.waitForURL(`/maintenance?${new URLSearchParams({ continue: '/admin/system-settings' })}`);
+    await expect(page.getByText('Temporarily Unavailable')).toBeVisible();
+    await page.getByRole('button', { name: 'End maintenance mode' }).click();
+    await page.waitForURL('/admin/system-settings');
+  });
+
+  test('maintenance shows no options to users until they authenticate', async ({ page }) => {
+    const setCookie = await utils.enterMaintenance(admin.accessToken);
+    const cookie = setCookie
+      ?.map((cookie) => cookie.split(';')[0].split('='))
+      ?.find(([name]) => name === 'immich_maintenance_token');
+
+    expect(cookie).toBeTruthy();
+
+    await expect(async () => {
+      await page.goto('/');
+      await page.waitForURL('/maintenance?**', {
+        timeout: 1e3,
+      });
+    }).toPass({ timeout: 1e4 });
+
+    await expect(page.getByText('Temporarily Unavailable')).toBeVisible();
+    await expect(page.getByRole('button', { name: 'End maintenance mode' })).toHaveCount(0);
+
+    await page.goto(`/maintenance?${new URLSearchParams({ token: cookie![1] })}`);
+    await expect(page.getByText('Temporarily Unavailable')).toBeVisible();
+    await expect(page.getByRole('button', { name: 'End maintenance mode' })).toBeVisible();
+    await page.getByRole('button', { name: 'End maintenance mode' }).click();
+    await page.waitForURL('/auth/login');
+  });
+});

e2e/src/web/specs/user-admin.e2e-spec.ts

@@ -58,8 +58,12 @@ test.describe('User Administration', () => {
     await expect(page.getByLabel('Admin User')).toBeChecked();
     await page.getByRole('button', { name: 'Confirm' }).click();
 
-    const updated = await getUserAdmin({ id: user.userId }, { headers: asBearerAuth(admin.accessToken) });
-    expect(updated.isAdmin).toBe(true);
+    await expect
+      .poll(async () => {
+        const userAdmin = await getUserAdmin({ id: user.userId }, { headers: asBearerAuth(admin.accessToken) });
+        return userAdmin.isAdmin;
+      })
+      .toBe(true);
   });
 
   test('revoke admin access', async ({ context, page }) => {
@@ -83,7 +87,11 @@ test.describe('User Administration', () => {
     await expect(page.getByLabel('Admin User')).not.toBeChecked();
     await page.getByRole('button', { name: 'Confirm' }).click();
 
-    const updated = await getUserAdmin({ id: user.userId }, { headers: asBearerAuth(admin.accessToken) });
-    expect(updated.isAdmin).toBe(false);
+    await expect
+      .poll(async () => {
+        const userAdmin = await getUserAdmin({ id: user.userId }, { headers: asBearerAuth(admin.accessToken) });
+        return userAdmin.isAdmin;
+      })
+      .toBe(false);
   });
 });

i18n/en.json

@@ -17,7 +17,6 @@
   "add_birthday": "Add a birthday",
   "add_endpoint": "Add endpoint",
   "add_exclusion_pattern": "Add exclusion pattern",
-  "add_import_path": "Add import path",
   "add_location": "Add location",
   "add_more_users": "Add more users",
   "add_partner": "Add partner",
@@ -32,6 +31,7 @@
   "add_to_album_toggle": "Toggle selection for {album}",
   "add_to_albums": "Add to albums",
   "add_to_albums_count": "Add to albums ({count})",
+  "add_to_bottom_bar": "Add to",
   "add_to_shared_album": "Add to shared album",
   "add_upload_to_stack": "Add upload to stack",
   "add_url": "Add URL",
@@ -112,13 +112,17 @@
     "jobs_failed": "{jobCount, plural, other {# failed}}",
     "library_created": "Created library: {library}",
     "library_deleted": "Library deleted",
-    "library_import_path_description": "Specify a folder to import. This folder, including subfolders, will be scanned for images and videos.",
+    "library_details": "Library details",
+    "library_folder_description": "Specify a folder to import. This folder, including subfolders, will be scanned for images and videos.",
+    "library_remove_exclusion_pattern_prompt": "Are you sure you want to remove this exclusion pattern?",
+    "library_remove_folder_prompt": "Are you sure you want to remove this import folder?",
     "library_scanning": "Periodic Scanning",
     "library_scanning_description": "Configure periodic library scanning",
     "library_scanning_enable_description": "Enable periodic library scanning",
     "library_settings": "External Library",
     "library_settings_description": "Manage external library settings",
     "library_tasks_description": "Scan external libraries for new and/or changed assets",
+    "library_updated": "Updated library",
     "library_watching_enable_description": "Watch external libraries for file changes",
     "library_watching_settings": "Library watching [EXPERIMENTAL]",
     "library_watching_settings_description": "Automatically watch for changed files",
@@ -173,6 +177,10 @@
     "machine_learning_smart_search_enabled": "Enable smart search",
     "machine_learning_smart_search_enabled_description": "If disabled, images will not be encoded for smart search.",
     "machine_learning_url_description": "The URL of the machine learning server. If more than one URL is provided, each server will be attempted one-at-a-time until one responds successfully, in order from first to last. Servers that don't respond will be temporarily ignored until they come back online.",
+    "maintenance_settings": "Maintenance",
+    "maintenance_settings_description": "Put Immich into maintenance mode.",
+    "maintenance_start": "Start maintenance mode",
+    "maintenance_start_error": "Failed to start maintenance mode.",
     "manage_concurrency": "Manage Concurrency",
     "manage_log_settings": "Manage log settings",
     "map_dark_style": "Dark style",
@@ -430,6 +438,7 @@
   "age_months": "Age {months, plural, one {# month} other {# months}}",
   "age_year_months": "Age 1 year, {months, plural, one {# month} other {# months}}",
   "age_years": "{years, plural, other {Age #}}",
+  "album": "Album",
   "album_added": "Album added",
   "album_added_notification_setting_description": "Receive an email notification when you are added to a shared album",
   "album_cover_updated": "Album cover updated",
@@ -895,8 +904,6 @@
   "edit_description_prompt": "Please select a new description:",
   "edit_exclusion_pattern": "Edit exclusion pattern",
   "edit_faces": "Edit faces",
-  "edit_import_path": "Edit import path",
-  "edit_import_paths": "Edit Import Paths",
   "edit_key": "Edit key",
   "edit_link": "Edit link",
   "edit_location": "Edit location",
@@ -968,8 +975,8 @@
     "failed_to_stack_assets": "Failed to stack assets",
     "failed_to_unstack_assets": "Failed to un-stack assets",
     "failed_to_update_notification_status": "Failed to update notification status",
-    "import_path_already_exists": "This import path already exists.",
     "incorrect_email_or_password": "Incorrect email or password",
+    "library_folder_already_exists": "This import path already exists.",
     "paths_validation_failed": "{paths, plural, one {# path} other {# paths}} failed validation",
     "profile_picture_transparent_pixels": "Profile pictures cannot have transparent pixels. Please zoom in and/or move the image.",
     "quota_higher_than_disk_size": "You set a quota higher than the disk size",
@@ -978,7 +985,6 @@
     "unable_to_add_assets_to_shared_link": "Unable to add assets to shared link",
     "unable_to_add_comment": "Unable to add comment",
     "unable_to_add_exclusion_pattern": "Unable to add exclusion pattern",
-    "unable_to_add_import_path": "Unable to add import path",
     "unable_to_add_partners": "Unable to add partners",
     "unable_to_add_remove_archive": "Unable to {archived, select, true {remove asset from} other {add asset to}} archive",
     "unable_to_add_remove_favorites": "Unable to {favorite, select, true {add asset to} other {remove asset from}} favorites",
@@ -1001,12 +1007,10 @@
     "unable_to_delete_asset": "Unable to delete asset",
     "unable_to_delete_assets": "Error deleting assets",
     "unable_to_delete_exclusion_pattern": "Unable to delete exclusion pattern",
-    "unable_to_delete_import_path": "Unable to delete import path",
     "unable_to_delete_shared_link": "Unable to delete shared link",
     "unable_to_delete_user": "Unable to delete user",
     "unable_to_download_files": "Unable to download files",
     "unable_to_edit_exclusion_pattern": "Unable to edit exclusion pattern",
-    "unable_to_edit_import_path": "Unable to edit import path",
     "unable_to_empty_trash": "Unable to empty trash",
     "unable_to_enter_fullscreen": "Unable to enter fullscreen",
     "unable_to_exit_fullscreen": "Unable to exit fullscreen",
@@ -1057,6 +1061,7 @@
     "unable_to_update_user": "Unable to update user",
     "unable_to_upload_file": "Unable to upload file"
   },
+  "exclusion_pattern": "Exclusion pattern",
   "exif": "Exif",
   "exif_bottom_sheet_description": "Add Description...",
   "exif_bottom_sheet_description_error": "Error updating description",
@@ -1245,6 +1250,8 @@
   "let_others_respond": "Let others respond",
   "level": "Level",
   "library": "Library",
+  "library_add_folder": "Add folder",
+  "library_edit_folder": "Edit folder",
   "library_options": "Library options",
   "library_page_device_albums": "Albums on Device",
   "library_page_new_album": "New album",
@@ -1316,6 +1323,11 @@
   "loop_videos_description": "Enable to automatically loop a video in the detail viewer.",
   "main_branch_warning": "You're using a development version; we strongly recommend using a release version!",
   "main_menu": "Main menu",
+  "maintenance_description": "Immich has been put into <link>maintenance mode</link>.",
+  "maintenance_end": "End maintenance mode",
+  "maintenance_end_error": "Failed to end maintenance mode.",
+  "maintenance_logged_in_as": "Currently logged in as {user}",
+  "maintenance_title": "Temporarily Unavailable",
   "make": "Make",
   "manage_geolocation": "Manage location",
   "manage_media_access_rationale": "This permission is required for proper handling of moving assets to the trash and restoring them from it.",
@@ -1385,6 +1397,7 @@
   "more": "More",
   "move": "Move",
   "move_off_locked_folder": "Move out of locked folder",
+  "move_to": "Move to",
   "move_to_lock_folder_action_prompt": "{count} added to the locked folder",
   "move_to_locked_folder": "Move to locked folder",
   "move_to_locked_folder_confirmation": "These photos and video will be removed from all albums, and only viewable from the locked folder",
@@ -1827,6 +1840,8 @@
   "server_offline": "Server Offline",
   "server_online": "Server Online",
   "server_privacy": "Server Privacy",
+  "server_restarting_description": "This page will refresh momentarily.",
+  "server_restarting_title": "Server is restarting",
   "server_stats": "Server Stats",
   "server_update_available": "Server update is available",
   "server_version": "Server Version",
@@ -2181,6 +2196,7 @@
   "welcome": "Welcome",
   "welcome_to_immich": "Welcome to Immich",
   "wifi_name": "Wi-Fi Name",
+  "workflow": "Workflow",
   "wrong_pin_code": "Wrong PIN code",
   "year": "Year",
   "years_ago": "{years, plural, one {# year} other {# years}} ago",

machine-learning/immich_ml/models/ocr/detection.py

@@ -6,7 +6,7 @@ from numpy.typing import NDArray
 from PIL import Image
 from rapidocr.ch_ppocr_det.utils import DBPostProcess
 from rapidocr.inference_engine.base import FileInfo, InferSession
-from rapidocr.utils import DownloadFile, DownloadFileInput
+from rapidocr.utils.download_file import DownloadFile, DownloadFileInput
 from rapidocr.utils.typings import EngineType, LangDet, OCRVersion, TaskType
 from rapidocr.utils.typings import ModelType as RapidModelType
 

machine-learning/immich_ml/models/ocr/recognition.py

@@ -6,7 +6,7 @@ from PIL import Image
 from rapidocr.ch_ppocr_rec import TextRecInput
 from rapidocr.ch_ppocr_rec import TextRecognizer as RapidTextRecognizer
 from rapidocr.inference_engine.base import FileInfo, InferSession
-from rapidocr.utils import DownloadFile, DownloadFileInput
+from rapidocr.utils.download_file import DownloadFile, DownloadFileInput
 from rapidocr.utils.typings import EngineType, LangRec, OCRVersion, TaskType
 from rapidocr.utils.typings import ModelType as RapidModelType
 from rapidocr.utils.vis_res import VisRes

misc/release/pump-version.sh

@@ -3,12 +3,12 @@
 #
 # Pump one or both of the server/mobile versions in appropriate files
 #
-# usage: './scripts/pump-version.sh -s <major|minor|patch> <-m>
+# usage: './scripts/pump-version.sh -s <major|minor|patch> <-m> <true|false>
 #
 # examples:
-#    ./scripts/pump-version.sh -s major        # 1.0.0+50 => 2.0.0+50
-#    ./scripts/pump-version.sh -s minor -m     # 1.0.0+50 => 1.1.0+51
-#    ./scripts/pump-version.sh -m              # 1.0.0+50 => 1.0.0+51
+#    ./scripts/pump-version.sh -s major         # 1.0.0+50 => 2.0.0+50
+#    ./scripts/pump-version.sh -s minor -m true # 1.0.0+50 => 1.1.0+51
+#    ./scripts/pump-version.sh -m true          # 1.0.0+50 => 1.0.0+51
 #
 
 SERVER_PUMP="false"

mobile/ios/Runner.xcodeproj/project.pbxproj

@@ -3,7 +3,7 @@
 	archiveVersion = 1;
 	classes = {
 	};
-	objectVersion = 77;
+	objectVersion = 54;
 	objects = {
 
 /* Begin PBXBuildFile section */
@@ -136,11 +136,15 @@
 /* Begin PBXFileSystemSynchronizedRootGroup section */
 		B231F52D2E93A44A00BC45D1 /* Core */ = {
 			isa = PBXFileSystemSynchronizedRootGroup;
+			exceptions = (
+			);
 			path = Core;
 			sourceTree = "<group>";
 		};
 		B2CF7F8C2DDE4EBB00744BF6 /* Sync */ = {
 			isa = PBXFileSystemSynchronizedRootGroup;
+			exceptions = (
+			);
 			path = Sync;
 			sourceTree = "<group>";
 		};
@@ -154,6 +158,8 @@
 		};
 		FEE084F22EC172080045228E /* Schemas */ = {
 			isa = PBXFileSystemSynchronizedRootGroup;
+			exceptions = (
+			);
 			path = Schemas;
 			sourceTree = "<group>";
 		};
@@ -543,14 +549,10 @@
 			inputFileListPaths = (
 				"${PODS_ROOT}/Target Support Files/Pods-Runner/Pods-Runner-resources-${CONFIGURATION}-input-files.xcfilelist",
 			);
-			inputPaths = (
-			);
 			name = "[CP] Copy Pods Resources";
 			outputFileListPaths = (
 				"${PODS_ROOT}/Target Support Files/Pods-Runner/Pods-Runner-resources-${CONFIGURATION}-output-files.xcfilelist",
 			);
-			outputPaths = (
-			);
 			runOnlyForDeploymentPostprocessing = 0;
 			shellPath = /bin/sh;
 			shellScript = "\"${PODS_ROOT}/Target Support Files/Pods-Runner/Pods-Runner-resources.sh\"\n";
@@ -579,14 +581,10 @@
 			inputFileListPaths = (
 				"${PODS_ROOT}/Target Support Files/Pods-Runner/Pods-Runner-frameworks-${CONFIGURATION}-input-files.xcfilelist",
 			);
-			inputPaths = (
-			);
 			name = "[CP] Embed Pods Frameworks";
 			outputFileListPaths = (
 				"${PODS_ROOT}/Target Support Files/Pods-Runner/Pods-Runner-frameworks-${CONFIGURATION}-output-files.xcfilelist",
 			);
-			outputPaths = (
-			);
 			runOnlyForDeploymentPostprocessing = 0;
 			shellPath = /bin/sh;
 			shellScript = "\"${PODS_ROOT}/Target Support Files/Pods-Runner/Pods-Runner-frameworks.sh\"\n";

mobile/ios/Runner.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved

@@ -0,0 +1,177 @@
+{
+  "originHash" : "9be33bfaa68721646604aefff3cabbdaf9a193da192aae024c265065671f6c49",
+  "pins" : [
+    {
+      "identity" : "combine-schedulers",
+      "kind" : "remoteSourceControl",
+      "location" : "https://github.com/pointfreeco/combine-schedulers",
+      "state" : {
+        "revision" : "fd16d76fd8b9a976d88bfb6cacc05ca8d19c91b6",
+        "version" : "1.1.0"
+      }
+    },
+    {
+      "identity" : "grdb.swift",
+      "kind" : "remoteSourceControl",
+      "location" : "https://github.com/groue/GRDB.swift",
+      "state" : {
+        "revision" : "18497b68fdbb3a09528d260a0a0e1e7e61c8c53d",
+        "version" : "7.8.0"
+      }
+    },
+    {
+      "identity" : "opencombine",
+      "kind" : "remoteSourceControl",
+      "location" : "https://github.com/OpenCombine/OpenCombine.git",
+      "state" : {
+        "revision" : "8576f0d579b27020beccbccc3ea6844f3ddfc2c2",
+        "version" : "0.14.0"
+      }
+    },
+    {
+      "identity" : "sqlite-data",
+      "kind" : "remoteSourceControl",
+      "location" : "https://github.com/pointfreeco/sqlite-data",
+      "state" : {
+        "revision" : "b66b894b9a5710f1072c8eb6448a7edfc2d743d9",
+        "version" : "1.3.0"
+      }
+    },
+    {
+      "identity" : "swift-case-paths",
+      "kind" : "remoteSourceControl",
+      "location" : "https://github.com/pointfreeco/swift-case-paths",
+      "state" : {
+        "revision" : "6989976265be3f8d2b5802c722f9ba168e227c71",
+        "version" : "1.7.2"
+      }
+    },
+    {
+      "identity" : "swift-clocks",
+      "kind" : "remoteSourceControl",
+      "location" : "https://github.com/pointfreeco/swift-clocks",
+      "state" : {
+        "revision" : "cc46202b53476d64e824e0b6612da09d84ffde8e",
+        "version" : "1.0.6"
+      }
+    },
+    {
+      "identity" : "swift-collections",
+      "kind" : "remoteSourceControl",
+      "location" : "https://github.com/apple/swift-collections",
+      "state" : {
+        "revision" : "7b847a3b7008b2dc2f47ca3110d8c782fb2e5c7e",
+        "version" : "1.3.0"
+      }
+    },
+    {
+      "identity" : "swift-concurrency-extras",
+      "kind" : "remoteSourceControl",
+      "location" : "https://github.com/pointfreeco/swift-concurrency-extras",
+      "state" : {
+        "revision" : "5a3825302b1a0d744183200915a47b508c828e6f",
+        "version" : "1.3.2"
+      }
+    },
+    {
+      "identity" : "swift-custom-dump",
+      "kind" : "remoteSourceControl",
+      "location" : "https://github.com/pointfreeco/swift-custom-dump",
+      "state" : {
+        "revision" : "82645ec760917961cfa08c9c0c7104a57a0fa4b1",
+        "version" : "1.3.3"
+      }
+    },
+    {
+      "identity" : "swift-dependencies",
+      "kind" : "remoteSourceControl",
+      "location" : "https://github.com/pointfreeco/swift-dependencies",
+      "state" : {
+        "revision" : "a10f9feeb214bc72b5337b6ef6d5a029360db4cc",
+        "version" : "1.10.0"
+      }
+    },
+    {
+      "identity" : "swift-http-structured-headers",
+      "kind" : "remoteSourceControl",
+      "location" : "https://github.com/apple/swift-http-structured-headers.git",
+      "state" : {
+        "revision" : "a9f3c352f4d46afd155e00b3c6e85decae6bcbeb",
+        "version" : "1.5.0"
+      }
+    },
+    {
+      "identity" : "swift-identified-collections",
+      "kind" : "remoteSourceControl",
+      "location" : "https://github.com/pointfreeco/swift-identified-collections",
+      "state" : {
+        "revision" : "322d9ffeeba85c9f7c4984b39422ec7cc3c56597",
+        "version" : "1.1.1"
+      }
+    },
+    {
+      "identity" : "swift-perception",
+      "kind" : "remoteSourceControl",
+      "location" : "https://github.com/pointfreeco/swift-perception",
+      "state" : {
+        "revision" : "4f47ebafed5f0b0172cf5c661454fa8e28fb2ac4",
+        "version" : "2.0.9"
+      }
+    },
+    {
+      "identity" : "swift-sharing",
+      "kind" : "remoteSourceControl",
+      "location" : "https://github.com/pointfreeco/swift-sharing",
+      "state" : {
+        "revision" : "3bfc408cc2d0bee2287c174da6b1c76768377818",
+        "version" : "2.7.4"
+      }
+    },
+    {
+      "identity" : "swift-snapshot-testing",
+      "kind" : "remoteSourceControl",
+      "location" : "https://github.com/pointfreeco/swift-snapshot-testing",
+      "state" : {
+        "revision" : "a8b7c5e0ed33d8ab8887d1654d9b59f2cbad529b",
+        "version" : "1.18.7"
+      }
+    },
+    {
+      "identity" : "swift-structured-queries",
+      "kind" : "remoteSourceControl",
+      "location" : "https://github.com/pointfreeco/swift-structured-queries",
+      "state" : {
+        "revision" : "9c84335373bae5f5c9f7b5f0adf3ae10f2cab5b9",
+        "version" : "0.25.2"
+      }
+    },
+    {
+      "identity" : "swift-syntax",
+      "kind" : "remoteSourceControl",
+      "location" : "https://github.com/swiftlang/swift-syntax",
+      "state" : {
+        "revision" : "4799286537280063c85a32f09884cfbca301b1a1",
+        "version" : "602.0.0"
+      }
+    },
+    {
+      "identity" : "swift-tagged",
+      "kind" : "remoteSourceControl",
+      "location" : "https://github.com/pointfreeco/swift-tagged",
+      "state" : {
+        "revision" : "3907a9438f5b57d317001dc99f3f11b46882272b",
+        "version" : "0.10.0"
+      }
+    },
+    {
+      "identity" : "xctest-dynamic-overlay",
+      "kind" : "remoteSourceControl",
+      "location" : "https://github.com/pointfreeco/xctest-dynamic-overlay",
+      "state" : {
+        "revision" : "4c27acf5394b645b70d8ba19dc249c0472d5f618",
+        "version" : "1.7.0"
+      }
+    }
+  ],
+  "version" : 3
+}

mobile/ios/Runner.xcworkspace/xcshareddata/swiftpm/Package.resolved

@@ -28,6 +28,15 @@
         "version" : "1.3.0"
       }
     },
+    {
+      "identity" : "swift-case-paths",
+      "kind" : "remoteSourceControl",
+      "location" : "https://github.com/pointfreeco/swift-case-paths",
+      "state" : {
+        "revision" : "6989976265be3f8d2b5802c722f9ba168e227c71",
+        "version" : "1.7.2"
+      }
+    },
     {
       "identity" : "swift-clocks",
       "kind" : "remoteSourceControl",
@@ -136,6 +145,15 @@
         "version" : "602.0.0"
       }
     },
+    {
+      "identity" : "swift-tagged",
+      "kind" : "remoteSourceControl",
+      "location" : "https://github.com/pointfreeco/swift-tagged",
+      "state" : {
+        "revision" : "3907a9438f5b57d317001dc99f3f11b46882272b",
+        "version" : "0.10.0"
+      }
+    },
     {
       "identity" : "xctest-dynamic-overlay",
       "kind" : "remoteSourceControl",

mobile/ios/fastlane/Fastfile

@@ -112,7 +112,7 @@ end
       workspace: "Runner.xcworkspace",
       configuration: configuration,
       export_method: "app-store",
-      xcargs: "CODE_SIGN_IDENTITY='#{CODE_SIGN_IDENTITY}' CODE_SIGN_STYLE=Manual",
+      xcargs: "-skipMacroValidation CODE_SIGN_IDENTITY='#{CODE_SIGN_IDENTITY}' CODE_SIGN_STYLE=Manual",
       export_options: {
         provisioningProfiles: {
           "#{app_identifier}" => "#{app_identifier} AppStore",
@@ -195,7 +195,7 @@ end
       configuration: "Release",
       export_method: "app-store",
       skip_package_ipa: false,
-      xcargs: "-allowProvisioningUpdates",
+      xcargs: "-skipMacroValidation -allowProvisioningUpdates",
       export_options: {
         method: "app-store",
         signingStyle: "automatic",
@@ -210,4 +210,37 @@ end
     )
   end
 
+  desc "iOS Build Only (no TestFlight upload)"
+  lane :gha_build_only do
+    # Use the same build process as production, just skip the upload
+    # This ensures PR builds validate the same way as production builds
+    
+    # Install provisioning profiles (use development profiles for PR builds)
+    install_provisioning_profile(path: "profile_dev.mobileprovision")
+    install_provisioning_profile(path: "profile_dev_share.mobileprovision")
+    install_provisioning_profile(path: "profile_dev_widget.mobileprovision")
+    
+    # Configure code signing for dev bundle IDs
+    configure_code_signing(bundle_id_suffix: "development")
+    
+    # Build the app (same as gha_testflight_dev but without upload)
+    build_app(
+      scheme: "Runner",
+      workspace: "Runner.xcworkspace",
+      configuration: "Release",
+      export_method: "app-store",
+      skip_package_ipa: true,
+      xcargs: "-skipMacroValidation CODE_SIGN_IDENTITY='#{CODE_SIGN_IDENTITY}' CODE_SIGN_STYLE=Manual",
+      export_options: {
+        provisioningProfiles: {
+          "#{BASE_BUNDLE_ID}.development" => "#{BASE_BUNDLE_ID}.development AppStore",
+          "#{BASE_BUNDLE_ID}.development.ShareExtension" => "#{BASE_BUNDLE_ID}.development.ShareExtension AppStore",
+          "#{BASE_BUNDLE_ID}.development.Widget" => "#{BASE_BUNDLE_ID}.development.Widget AppStore"
+        },
+        signingStyle: "manual",
+        signingCertificate: CODE_SIGN_IDENTITY
+      }
+    )
+  end
+
 end

mobile/lib/domain/services/background_worker.service.dart

@@ -177,6 +177,12 @@ class BackgroundWorkerBgService extends BackgroundWorkerFlutterApi {
   }
 
   Future<void> _cleanup() async {
+    await runZonedGuarded(_handleCleanup, (error, stack) {
+      dPrint(() => "Error during background worker cleanup: $error, $stack");
+    });
+  }
+
+  Future<void> _handleCleanup() async {
     // If ref is null, it means the service was never initialized properly
     if (_isCleanedUp || _ref == null) {
       return;
@@ -186,11 +192,16 @@ class BackgroundWorkerBgService extends BackgroundWorkerFlutterApi {
       _isCleanedUp = true;
       final backgroundSyncManager = _ref?.read(backgroundSyncProvider);
       final nativeSyncApi = _ref?.read(nativeSyncApiProvider);
+
+      await _drift.close();
+      await _driftLogger.close();
+
       _ref?.dispose();
       _ref = null;
 
       _cancellationToken.cancel();
       _logger.info("Cleaning up background worker");
+
       final cleanupFutures = [
         nativeSyncApi?.cancelHashing(),
         workerManagerPatch.dispose().catchError((_) async {
@@ -199,8 +210,7 @@ class BackgroundWorkerBgService extends BackgroundWorkerFlutterApi {
         }),
         LogService.I.dispose(),
         Store.dispose(),
-        _drift.close(),
-        _driftLogger.close(),
+
         backgroundSyncManager?.cancel(),
       ];
 

mobile/lib/presentation/widgets/action_buttons/add_action_button.widget.dart

@@ -0,0 +1,191 @@
+import 'package:easy_localization/easy_localization.dart';
+import 'package:flutter/material.dart';
+import 'package:hooks_riverpod/hooks_riverpod.dart';
+import 'package:immich_mobile/extensions/build_context_extensions.dart';
+import 'package:immich_mobile/presentation/widgets/action_buttons/base_action_button.widget.dart';
+import 'package:immich_mobile/presentation/widgets/action_buttons/unarchive_action_button.widget.dart';
+import 'package:immich_mobile/providers/infrastructure/asset_viewer/current_asset.provider.dart';
+import 'package:immich_mobile/presentation/widgets/album/album_selector.widget.dart';
+import 'package:immich_mobile/providers/infrastructure/album.provider.dart';
+import 'package:immich_mobile/providers/routes.provider.dart';
+import 'package:immich_mobile/widgets/common/immich_toast.dart';
+import 'package:immich_mobile/providers/user.provider.dart';
+
+import 'package:immich_mobile/domain/models/album/album.model.dart';
+import 'package:immich_mobile/domain/models/asset/base_asset.model.dart';
+
+import 'package:immich_mobile/constants/enums.dart';
+import 'package:immich_mobile/presentation/widgets/action_buttons/archive_action_button.widget.dart';
+import 'package:immich_mobile/presentation/widgets/action_buttons/move_to_lock_folder_action_button.widget.dart';
+import 'package:immich_mobile/presentation/widgets/bottom_sheet/base_bottom_sheet.widget.dart';
+
+enum AddToMenuItem { album, archive, unarchive, lockedFolder }
+
+class AddActionButton extends ConsumerWidget {
+  const AddActionButton({super.key});
+
+  Future<void> _showAddOptions(BuildContext context, WidgetRef ref) async {
+    final asset = ref.read(currentAssetNotifier);
+    if (asset == null) return;
+
+    final user = ref.read(currentUserProvider);
+    final isOwner = asset is RemoteAsset && asset.ownerId == user?.id;
+    final isInLockedView = ref.watch(inLockedViewProvider);
+    final isArchived = asset is RemoteAsset && asset.visibility == AssetVisibility.archive;
+    final hasRemote = asset is RemoteAsset;
+    final showArchive = isOwner && !isInLockedView && hasRemote && !isArchived;
+    final showUnarchive = isOwner && !isInLockedView && hasRemote && isArchived;
+    final menuItemHeight = 30.0;
+
+    final List<PopupMenuEntry<AddToMenuItem>> items = [
+      PopupMenuItem(
+        enabled: false,
+        textStyle: context.textTheme.labelMedium,
+        height: 40,
+        child: Text("add_to_bottom_bar".tr()),
+      ),
+      PopupMenuItem(
+        height: menuItemHeight,
+        value: AddToMenuItem.album,
+        child: ListTile(leading: const Icon(Icons.photo_album_outlined), title: Text("album".tr())),
+      ),
+      const PopupMenuDivider(),
+      PopupMenuItem(enabled: false, textStyle: context.textTheme.labelMedium, height: 40, child: Text("move_to".tr())),
+      if (isOwner) ...[
+        if (showArchive)
+          PopupMenuItem(
+            height: menuItemHeight,
+            value: AddToMenuItem.archive,
+            child: ListTile(leading: const Icon(Icons.archive_outlined), title: Text("archive".tr())),
+          ),
+        if (showUnarchive)
+          PopupMenuItem(
+            height: menuItemHeight,
+            value: AddToMenuItem.unarchive,
+            child: ListTile(leading: const Icon(Icons.unarchive_outlined), title: Text("unarchive".tr())),
+          ),
+        PopupMenuItem(
+          height: menuItemHeight,
+          value: AddToMenuItem.lockedFolder,
+          child: ListTile(leading: const Icon(Icons.lock_outline), title: Text("locked_folder".tr())),
+        ),
+      ],
+    ];
+
+    final AddToMenuItem? selected = await showMenu<AddToMenuItem>(
+      context: context,
+      color: context.themeData.scaffoldBackgroundColor,
+      position: _menuPosition(context),
+      items: items,
+    );
+
+    if (selected == null) {
+      return;
+    }
+
+    switch (selected) {
+      case AddToMenuItem.album:
+        _openAlbumSelector(context, ref);
+        break;
+      case AddToMenuItem.archive:
+        await performArchiveAction(context, ref, source: ActionSource.viewer);
+        break;
+      case AddToMenuItem.unarchive:
+        await performUnArchiveAction(context, ref, source: ActionSource.viewer);
+        break;
+      case AddToMenuItem.lockedFolder:
+        await performMoveToLockFolderAction(context, ref, source: ActionSource.viewer);
+        break;
+    }
+  }
+
+  RelativeRect _menuPosition(BuildContext context) {
+    final renderObject = context.findRenderObject();
+    if (renderObject is! RenderBox) {
+      return RelativeRect.fill;
+    }
+
+    final size = renderObject.size;
+    final position = renderObject.localToGlobal(Offset.zero);
+
+    return RelativeRect.fromLTRB(position.dx, position.dy - size.height - 200, position.dx + size.width, position.dy);
+  }
+
+  void _openAlbumSelector(BuildContext context, WidgetRef ref) {
+    final currentAsset = ref.read(currentAssetNotifier);
+    if (currentAsset == null) {
+      ImmichToast.show(context: context, msg: "Cannot load asset information.", toastType: ToastType.error);
+      return;
+    }
+
+    final List<Widget> slivers = [
+      AlbumSelector(onAlbumSelected: (album) => _addCurrentAssetToAlbum(context, ref, album)),
+    ];
+
+    showModalBottomSheet(
+      context: context,
+      isScrollControlled: true,
+      backgroundColor: Colors.transparent,
+      builder: (_) {
+        return BaseBottomSheet(
+          actions: const [],
+          slivers: slivers,
+          initialChildSize: 0.6,
+          minChildSize: 0.3,
+          maxChildSize: 0.95,
+          expand: false,
+          backgroundColor: context.isDarkTheme ? Colors.black : Colors.white,
+        );
+      },
+    );
+  }
+
+  Future<void> _addCurrentAssetToAlbum(BuildContext context, WidgetRef ref, RemoteAlbum album) async {
+    final latest = ref.read(currentAssetNotifier);
+
+    if (latest == null) {
+      ImmichToast.show(context: context, msg: "Cannot load asset information.", toastType: ToastType.error);
+      return;
+    }
+
+    final addedCount = await ref.read(remoteAlbumProvider.notifier).addAssets(album.id, [latest.remoteId!]);
+
+    if (!context.mounted) {
+      return;
+    }
+
+    if (addedCount == 0) {
+      ImmichToast.show(
+        context: context,
+        msg: 'add_to_album_bottom_sheet_already_exists'.tr(namedArgs: {'album': album.name}),
+      );
+    } else {
+      ImmichToast.show(
+        context: context,
+        msg: 'add_to_album_bottom_sheet_added'.tr(namedArgs: {'album': album.name}),
+      );
+    }
+
+    if (!context.mounted) {
+      return;
+    }
+    await Navigator.of(context).maybePop();
+  }
+
+  @override
+  Widget build(BuildContext context, WidgetRef ref) {
+    final asset = ref.watch(currentAssetNotifier);
+    if (asset == null) {
+      return const SizedBox.shrink();
+    }
+    return Builder(
+      builder: (buttonContext) {
+        return BaseActionButton(
+          iconData: Icons.add,
+          label: "add_to_bottom_bar".tr(),
+          onPressed: () => _showAddOptions(buttonContext, ref),
+        );
+      },
+    );
+  }
+}

mobile/lib/presentation/widgets/action_buttons/archive_action_button.widget.dart

@@ -10,33 +10,36 @@ import 'package:immich_mobile/providers/infrastructure/action.provider.dart';
 import 'package:immich_mobile/providers/timeline/multiselect.provider.dart';
 import 'package:immich_mobile/widgets/common/immich_toast.dart';
 
+// used to allow performing archive action from different sources  (without duplicating code)
+Future<void> performArchiveAction(BuildContext context, WidgetRef ref, {required ActionSource source}) async {
+  if (!context.mounted) return;
+
+  final result = await ref.read(actionProvider.notifier).archive(source);
+  ref.read(multiSelectProvider.notifier).reset();
+
+  if (source == ActionSource.viewer) {
+    EventStream.shared.emit(const ViewerReloadAssetEvent());
+  }
+
+  final successMessage = 'archive_action_prompt'.t(context: context, args: {'count': result.count.toString()});
+
+  if (context.mounted) {
+    ImmichToast.show(
+      context: context,
+      msg: result.success ? successMessage : 'scaffold_body_error_occurred'.t(context: context),
+      gravity: ToastGravity.BOTTOM,
+      toastType: result.success ? ToastType.success : ToastType.error,
+    );
+  }
+}
+
 class ArchiveActionButton extends ConsumerWidget {
   final ActionSource source;
 
   const ArchiveActionButton({super.key, required this.source});
 
-  void _onTap(BuildContext context, WidgetRef ref) async {
-    if (!context.mounted) {
-      return;
-    }
-
-    final result = await ref.read(actionProvider.notifier).archive(source);
-    ref.read(multiSelectProvider.notifier).reset();
-
-    if (source == ActionSource.viewer) {
-      EventStream.shared.emit(const ViewerReloadAssetEvent());
-    }
-
-    final successMessage = 'archive_action_prompt'.t(context: context, args: {'count': result.count.toString()});
-
-    if (context.mounted) {
-      ImmichToast.show(
-        context: context,
-        msg: result.success ? successMessage : 'scaffold_body_error_occurred'.t(context: context),
-        gravity: ToastGravity.BOTTOM,
-        toastType: result.success ? ToastType.success : ToastType.error,
-      );
-    }
+  Future<void> _onTap(BuildContext context, WidgetRef ref) async {
+    await performArchiveAction(context, ref, source: source);
   }
 
   @override

mobile/lib/presentation/widgets/action_buttons/move_to_lock_folder_action_button.widget.dart

@@ -10,36 +10,39 @@ import 'package:immich_mobile/providers/infrastructure/action.provider.dart';
 import 'package:immich_mobile/providers/timeline/multiselect.provider.dart';
 import 'package:immich_mobile/widgets/common/immich_toast.dart';
 
+// Reusable helper: move to locked folder from any source (e.g called from menu)
+Future<void> performMoveToLockFolderAction(BuildContext context, WidgetRef ref, {required ActionSource source}) async {
+  if (!context.mounted) return;
+
+  final result = await ref.read(actionProvider.notifier).moveToLockFolder(source);
+  ref.read(multiSelectProvider.notifier).reset();
+
+  if (source == ActionSource.viewer) {
+    EventStream.shared.emit(const ViewerReloadAssetEvent());
+  }
+
+  final successMessage = 'move_to_lock_folder_action_prompt'.t(
+    context: context,
+    args: {'count': result.count.toString()},
+  );
+
+  if (context.mounted) {
+    ImmichToast.show(
+      context: context,
+      msg: result.success ? successMessage : 'scaffold_body_error_occurred'.t(context: context),
+      gravity: ToastGravity.BOTTOM,
+      toastType: result.success ? ToastType.success : ToastType.error,
+    );
+  }
+}
+
 class MoveToLockFolderActionButton extends ConsumerWidget {
   final ActionSource source;
 
   const MoveToLockFolderActionButton({super.key, required this.source});
 
-  void _onTap(BuildContext context, WidgetRef ref) async {
-    if (!context.mounted) {
-      return;
-    }
-
-    final result = await ref.read(actionProvider.notifier).moveToLockFolder(source);
-    ref.read(multiSelectProvider.notifier).reset();
-
-    if (source == ActionSource.viewer) {
-      EventStream.shared.emit(const ViewerReloadAssetEvent());
-    }
-
-    final successMessage = 'move_to_lock_folder_action_prompt'.t(
-      context: context,
-      args: {'count': result.count.toString()},
-    );
-
-    if (context.mounted) {
-      ImmichToast.show(
-        context: context,
-        msg: result.success ? successMessage : 'scaffold_body_error_occurred'.t(context: context),
-        gravity: ToastGravity.BOTTOM,
-        toastType: result.success ? ToastType.success : ToastType.error,
-      );
-    }
+  Future<void> _onTap(BuildContext context, WidgetRef ref) async {
+    await performMoveToLockFolderAction(context, ref, source: source);
   }
 
   @override

mobile/lib/presentation/widgets/action_buttons/unarchive_action_button.widget.dart

@@ -1,3 +1,5 @@
+// dart
+// File: `lib/presentation/widgets/action_buttons/unarchive_action_button.widget.dart`
 import 'package:flutter/material.dart';
 import 'package:fluttertoast/fluttertoast.dart';
 import 'package:hooks_riverpod/hooks_riverpod.dart';
@@ -7,30 +9,39 @@ import 'package:immich_mobile/presentation/widgets/action_buttons/base_action_bu
 import 'package:immich_mobile/providers/infrastructure/action.provider.dart';
 import 'package:immich_mobile/providers/timeline/multiselect.provider.dart';
 import 'package:immich_mobile/widgets/common/immich_toast.dart';
+import 'package:immich_mobile/domain/utils/event_stream.dart';
+import 'package:immich_mobile/presentation/widgets/asset_viewer/asset_viewer.state.dart';
+
+// used to allow performing unarchive action from different sources (without duplicating code)
+Future<void> performUnArchiveAction(BuildContext context, WidgetRef ref, {required ActionSource source}) async {
+  if (!context.mounted) return;
+
+  final result = await ref.read(actionProvider.notifier).unArchive(source);
+  ref.read(multiSelectProvider.notifier).reset();
+
+  if (source == ActionSource.viewer) {
+    EventStream.shared.emit(const ViewerReloadAssetEvent());
+  }
+
+  final successMessage = 'unarchive_action_prompt'.t(context: context, args: {'count': result.count.toString()});
+
+  if (context.mounted) {
+    ImmichToast.show(
+      context: context,
+      msg: result.success ? successMessage : 'scaffold_body_error_occurred'.t(context: context),
+      gravity: ToastGravity.BOTTOM,
+      toastType: result.success ? ToastType.success : ToastType.error,
+    );
+  }
+}
 
 class UnArchiveActionButton extends ConsumerWidget {
   final ActionSource source;
 
   const UnArchiveActionButton({super.key, required this.source});
 
-  void _onTap(BuildContext context, WidgetRef ref) async {
-    if (!context.mounted) {
-      return;
-    }
-
-    final result = await ref.read(actionProvider.notifier).unArchive(source);
-    ref.read(multiSelectProvider.notifier).reset();
-
-    final successMessage = 'unarchive_action_prompt'.t(context: context, args: {'count': result.count.toString()});
-
-    if (context.mounted) {
-      ImmichToast.show(
-        context: context,
-        msg: result.success ? successMessage : 'scaffold_body_error_occurred'.t(context: context),
-        gravity: ToastGravity.BOTTOM,
-        toastType: result.success ? ToastType.success : ToastType.error,
-      );
-    }
+  Future<void> _onTap(BuildContext context, WidgetRef ref) async {
+    await performUnArchiveAction(context, ref, source: source);
   }
 
   @override

mobile/lib/presentation/widgets/asset_viewer/bottom_bar.widget.dart

@@ -3,13 +3,12 @@ import 'package:hooks_riverpod/hooks_riverpod.dart';
 import 'package:immich_mobile/constants/enums.dart';
 import 'package:immich_mobile/domain/models/asset/base_asset.model.dart';
 import 'package:immich_mobile/extensions/build_context_extensions.dart';
-import 'package:immich_mobile/presentation/widgets/action_buttons/archive_action_button.widget.dart';
 import 'package:immich_mobile/presentation/widgets/action_buttons/delete_action_button.widget.dart';
 import 'package:immich_mobile/presentation/widgets/action_buttons/delete_local_action_button.widget.dart';
 import 'package:immich_mobile/presentation/widgets/action_buttons/edit_image_action_button.widget.dart';
 import 'package:immich_mobile/presentation/widgets/action_buttons/share_action_button.widget.dart';
-import 'package:immich_mobile/presentation/widgets/action_buttons/unarchive_action_button.widget.dart';
 import 'package:immich_mobile/presentation/widgets/action_buttons/upload_action_button.widget.dart';
+import 'package:immich_mobile/presentation/widgets/action_buttons/add_action_button.widget.dart';
 import 'package:immich_mobile/presentation/widgets/asset_viewer/asset_viewer.state.dart';
 import 'package:immich_mobile/providers/infrastructure/asset_viewer/current_asset.provider.dart';
 import 'package:immich_mobile/providers/infrastructure/readonly_mode.provider.dart';
@@ -34,7 +33,6 @@ class ViewerBottomBar extends ConsumerWidget {
     int opacity = ref.watch(assetViewerProvider.select((state) => state.backgroundOpacity));
     final showControls = ref.watch(assetViewerProvider.select((s) => s.showingControls));
     final isInLockedView = ref.watch(inLockedViewProvider);
-    final isArchived = asset is RemoteAsset && asset.visibility == AssetVisibility.archive;
 
     if (!showControls) {
       opacity = 0;
@@ -44,11 +42,9 @@ class ViewerBottomBar extends ConsumerWidget {
       const ShareActionButton(source: ActionSource.viewer),
       if (asset.isLocalOnly) const UploadActionButton(source: ActionSource.viewer),
       if (asset.type == AssetType.image) const EditImageActionButton(),
+      if (asset.hasRemote) const AddActionButton(),
+
       if (isOwner) ...[
-        if (asset.hasRemote && isOwner && isArchived)
-          const UnArchiveActionButton(source: ActionSource.viewer)
-        else
-          const ArchiveActionButton(source: ActionSource.viewer),
         asset.isLocalOnly
             ? const DeleteLocalActionButton(source: ActionSource.viewer)
             : const DeleteActionButton(source: ActionSource.viewer, showConfirmation: true),

mobile/lib/providers/infrastructure/action.provider.dart

@@ -264,9 +264,8 @@ class ActionNotifier extends Notifier<void> {
   }
 
   Future<ActionResult?> deleteLocal(ActionSource source, BuildContext context) async {
-    // Always perform the operation if there is only one merged asset
     final assets = _getAssets(source);
-    bool? backedUpOnly = assets.length == 1 && assets.first.storage == AssetState.merged
+    bool? backedUpOnly = assets.every((asset) => asset.storage == AssetState.merged)
         ? true
         : await showDialog<bool>(
             context: context,

mobile/lib/repositories/folder_api.repository.dart

@@ -8,7 +8,7 @@ import 'package:openapi/api.dart';
 final folderApiRepositoryProvider = Provider((ref) => FolderApiRepository(ref.watch(apiServiceProvider).viewApi));
 
 class FolderApiRepository extends ApiRepository {
-  final ViewApi _api;
+  final ViewsApi _api;
   final Logger _log = Logger("FolderApiRepository");
 
   FolderApiRepository(this._api);

mobile/lib/services/api.service.dart

@@ -17,7 +17,7 @@ class ApiService implements Authentication {
 
   late UsersApi usersApi;
   late AuthenticationApi authenticationApi;
-  late OAuthApi oAuthApi;
+  late AuthenticationApi oAuthApi;
   late AlbumsApi albumsApi;
   late AssetsApi assetsApi;
   late SearchApi searchApi;
@@ -32,7 +32,7 @@ class ApiService implements Authentication {
   late DownloadApi downloadApi;
   late TrashApi trashApi;
   late StacksApi stacksApi;
-  late ViewApi viewApi;
+  late ViewsApi viewApi;
   late MemoriesApi memoriesApi;
   late SessionsApi sessionsApi;
 
@@ -56,7 +56,7 @@ class ApiService implements Authentication {
     }
     usersApi = UsersApi(_apiClient);
     authenticationApi = AuthenticationApi(_apiClient);
-    oAuthApi = OAuthApi(_apiClient);
+    oAuthApi = AuthenticationApi(_apiClient);
     albumsApi = AlbumsApi(_apiClient);
     assetsApi = AssetsApi(_apiClient);
     serverInfoApi = ServerApi(_apiClient);
@@ -71,7 +71,7 @@ class ApiService implements Authentication {
     downloadApi = DownloadApi(_apiClient);
     trashApi = TrashApi(_apiClient);
     stacksApi = StacksApi(_apiClient);
-    viewApi = ViewApi(_apiClient);
+    viewApi = ViewsApi(_apiClient);
     memoriesApi = MemoriesApi(_apiClient);
     sessionsApi = SessionsApi(_apiClient);
   }

mobile/lib/services/deep_link.service.dart

@@ -77,6 +77,7 @@ class DeepLinkService {
       "memory" => await _buildMemoryDeepLink(queryParams['id'] ?? ''),
       "asset" => await _buildAssetDeepLink(queryParams['id'] ?? '', ref),
       "album" => await _buildAlbumDeepLink(queryParams['id'] ?? ''),
+      "activity" => await _buildActivityDeepLink(queryParams['albumId'] ?? ''),
       _ => null,
     };
 
@@ -185,4 +186,18 @@ class DeepLinkService {
       return AlbumViewerRoute(albumId: album.id);
     }
   }
+
+  Future<PageRouteInfo?> _buildActivityDeepLink(String albumId) async {
+    if (Store.isBetaTimelineEnabled == false) {
+      return null;
+    }
+
+    final album = await _betaRemoteAlbumService.get(albumId);
+
+    if (album == null || album.isActivityEnabled == false) {
+      return null;
+    }
+
+    return DriftActivitiesRoute(album: album);
+  }
 }

mobile/openapi/README.md

@@ -73,225 +73,237 @@ All URIs are relative to */api*
 
 Class | Method | HTTP request | Description
 ------------ | ------------- | ------------- | -------------
-*APIKeysApi* | [**createApiKey**](doc//APIKeysApi.md#createapikey) | **POST** /api-keys | 
-*APIKeysApi* | [**deleteApiKey**](doc//APIKeysApi.md#deleteapikey) | **DELETE** /api-keys/{id} | 
-*APIKeysApi* | [**getApiKey**](doc//APIKeysApi.md#getapikey) | **GET** /api-keys/{id} | 
-*APIKeysApi* | [**getApiKeys**](doc//APIKeysApi.md#getapikeys) | **GET** /api-keys | 
-*APIKeysApi* | [**getMyApiKey**](doc//APIKeysApi.md#getmyapikey) | **GET** /api-keys/me | 
-*APIKeysApi* | [**updateApiKey**](doc//APIKeysApi.md#updateapikey) | **PUT** /api-keys/{id} | 
-*ActivitiesApi* | [**createActivity**](doc//ActivitiesApi.md#createactivity) | **POST** /activities | 
-*ActivitiesApi* | [**deleteActivity**](doc//ActivitiesApi.md#deleteactivity) | **DELETE** /activities/{id} | 
-*ActivitiesApi* | [**getActivities**](doc//ActivitiesApi.md#getactivities) | **GET** /activities | 
-*ActivitiesApi* | [**getActivityStatistics**](doc//ActivitiesApi.md#getactivitystatistics) | **GET** /activities/statistics | 
-*AlbumsApi* | [**addAssetsToAlbum**](doc//AlbumsApi.md#addassetstoalbum) | **PUT** /albums/{id}/assets | 
-*AlbumsApi* | [**addAssetsToAlbums**](doc//AlbumsApi.md#addassetstoalbums) | **PUT** /albums/assets | 
-*AlbumsApi* | [**addUsersToAlbum**](doc//AlbumsApi.md#adduserstoalbum) | **PUT** /albums/{id}/users | 
-*AlbumsApi* | [**createAlbum**](doc//AlbumsApi.md#createalbum) | **POST** /albums | 
-*AlbumsApi* | [**deleteAlbum**](doc//AlbumsApi.md#deletealbum) | **DELETE** /albums/{id} | 
-*AlbumsApi* | [**getAlbumInfo**](doc//AlbumsApi.md#getalbuminfo) | **GET** /albums/{id} | 
-*AlbumsApi* | [**getAlbumStatistics**](doc//AlbumsApi.md#getalbumstatistics) | **GET** /albums/statistics | 
-*AlbumsApi* | [**getAllAlbums**](doc//AlbumsApi.md#getallalbums) | **GET** /albums | 
-*AlbumsApi* | [**removeAssetFromAlbum**](doc//AlbumsApi.md#removeassetfromalbum) | **DELETE** /albums/{id}/assets | 
-*AlbumsApi* | [**removeUserFromAlbum**](doc//AlbumsApi.md#removeuserfromalbum) | **DELETE** /albums/{id}/user/{userId} | 
-*AlbumsApi* | [**updateAlbumInfo**](doc//AlbumsApi.md#updatealbuminfo) | **PATCH** /albums/{id} | 
-*AlbumsApi* | [**updateAlbumUser**](doc//AlbumsApi.md#updatealbumuser) | **PUT** /albums/{id}/user/{userId} | 
-*AssetsApi* | [**checkBulkUpload**](doc//AssetsApi.md#checkbulkupload) | **POST** /assets/bulk-upload-check | checkBulkUpload
-*AssetsApi* | [**checkExistingAssets**](doc//AssetsApi.md#checkexistingassets) | **POST** /assets/exist | checkExistingAssets
-*AssetsApi* | [**copyAsset**](doc//AssetsApi.md#copyasset) | **PUT** /assets/copy | 
-*AssetsApi* | [**deleteAssetMetadata**](doc//AssetsApi.md#deleteassetmetadata) | **DELETE** /assets/{id}/metadata/{key} | 
-*AssetsApi* | [**deleteAssets**](doc//AssetsApi.md#deleteassets) | **DELETE** /assets | 
-*AssetsApi* | [**downloadAsset**](doc//AssetsApi.md#downloadasset) | **GET** /assets/{id}/original | 
-*AssetsApi* | [**getAllUserAssetsByDeviceId**](doc//AssetsApi.md#getalluserassetsbydeviceid) | **GET** /assets/device/{deviceId} | getAllUserAssetsByDeviceId
-*AssetsApi* | [**getAssetInfo**](doc//AssetsApi.md#getassetinfo) | **GET** /assets/{id} | 
-*AssetsApi* | [**getAssetMetadata**](doc//AssetsApi.md#getassetmetadata) | **GET** /assets/{id}/metadata | 
-*AssetsApi* | [**getAssetMetadataByKey**](doc//AssetsApi.md#getassetmetadatabykey) | **GET** /assets/{id}/metadata/{key} | 
-*AssetsApi* | [**getAssetOcr**](doc//AssetsApi.md#getassetocr) | **GET** /assets/{id}/ocr | 
-*AssetsApi* | [**getAssetStatistics**](doc//AssetsApi.md#getassetstatistics) | **GET** /assets/statistics | 
-*AssetsApi* | [**getRandom**](doc//AssetsApi.md#getrandom) | **GET** /assets/random | 
-*AssetsApi* | [**playAssetVideo**](doc//AssetsApi.md#playassetvideo) | **GET** /assets/{id}/video/playback | 
-*AssetsApi* | [**replaceAsset**](doc//AssetsApi.md#replaceasset) | **PUT** /assets/{id}/original | Replace the asset with new file, without changing its id
-*AssetsApi* | [**runAssetJobs**](doc//AssetsApi.md#runassetjobs) | **POST** /assets/jobs | 
-*AssetsApi* | [**updateAsset**](doc//AssetsApi.md#updateasset) | **PUT** /assets/{id} | 
-*AssetsApi* | [**updateAssetMetadata**](doc//AssetsApi.md#updateassetmetadata) | **PUT** /assets/{id}/metadata | 
-*AssetsApi* | [**updateAssets**](doc//AssetsApi.md#updateassets) | **PUT** /assets | 
-*AssetsApi* | [**uploadAsset**](doc//AssetsApi.md#uploadasset) | **POST** /assets | 
-*AssetsApi* | [**viewAsset**](doc//AssetsApi.md#viewasset) | **GET** /assets/{id}/thumbnail | 
-*AuthAdminApi* | [**unlinkAllOAuthAccountsAdmin**](doc//AuthAdminApi.md#unlinkalloauthaccountsadmin) | **POST** /admin/auth/unlink-all | 
-*AuthenticationApi* | [**changePassword**](doc//AuthenticationApi.md#changepassword) | **POST** /auth/change-password | 
-*AuthenticationApi* | [**changePinCode**](doc//AuthenticationApi.md#changepincode) | **PUT** /auth/pin-code | 
-*AuthenticationApi* | [**getAuthStatus**](doc//AuthenticationApi.md#getauthstatus) | **GET** /auth/status | 
-*AuthenticationApi* | [**lockAuthSession**](doc//AuthenticationApi.md#lockauthsession) | **POST** /auth/session/lock | 
-*AuthenticationApi* | [**login**](doc//AuthenticationApi.md#login) | **POST** /auth/login | 
-*AuthenticationApi* | [**logout**](doc//AuthenticationApi.md#logout) | **POST** /auth/logout | 
-*AuthenticationApi* | [**resetPinCode**](doc//AuthenticationApi.md#resetpincode) | **DELETE** /auth/pin-code | 
-*AuthenticationApi* | [**setupPinCode**](doc//AuthenticationApi.md#setuppincode) | **POST** /auth/pin-code | 
-*AuthenticationApi* | [**signUpAdmin**](doc//AuthenticationApi.md#signupadmin) | **POST** /auth/admin-sign-up | 
-*AuthenticationApi* | [**unlockAuthSession**](doc//AuthenticationApi.md#unlockauthsession) | **POST** /auth/session/unlock | 
-*AuthenticationApi* | [**validateAccessToken**](doc//AuthenticationApi.md#validateaccesstoken) | **POST** /auth/validateToken | 
-*DeprecatedApi* | [**createPartnerDeprecated**](doc//DeprecatedApi.md#createpartnerdeprecated) | **POST** /partners/{id} | 
-*DeprecatedApi* | [**getRandom**](doc//DeprecatedApi.md#getrandom) | **GET** /assets/random | 
-*DeprecatedApi* | [**replaceAsset**](doc//DeprecatedApi.md#replaceasset) | **PUT** /assets/{id}/original | Replace the asset with new file, without changing its id
-*DownloadApi* | [**downloadArchive**](doc//DownloadApi.md#downloadarchive) | **POST** /download/archive | 
-*DownloadApi* | [**getDownloadInfo**](doc//DownloadApi.md#getdownloadinfo) | **POST** /download/info | 
-*DuplicatesApi* | [**deleteDuplicate**](doc//DuplicatesApi.md#deleteduplicate) | **DELETE** /duplicates/{id} | 
-*DuplicatesApi* | [**deleteDuplicates**](doc//DuplicatesApi.md#deleteduplicates) | **DELETE** /duplicates | 
-*DuplicatesApi* | [**getAssetDuplicates**](doc//DuplicatesApi.md#getassetduplicates) | **GET** /duplicates | 
-*FacesApi* | [**createFace**](doc//FacesApi.md#createface) | **POST** /faces | 
-*FacesApi* | [**deleteFace**](doc//FacesApi.md#deleteface) | **DELETE** /faces/{id} | 
-*FacesApi* | [**getFaces**](doc//FacesApi.md#getfaces) | **GET** /faces | 
-*FacesApi* | [**reassignFacesById**](doc//FacesApi.md#reassignfacesbyid) | **PUT** /faces/{id} | 
-*JobsApi* | [**createJob**](doc//JobsApi.md#createjob) | **POST** /jobs | 
-*JobsApi* | [**getAllJobsStatus**](doc//JobsApi.md#getalljobsstatus) | **GET** /jobs | 
-*JobsApi* | [**sendJobCommand**](doc//JobsApi.md#sendjobcommand) | **PUT** /jobs/{id} | 
-*LibrariesApi* | [**createLibrary**](doc//LibrariesApi.md#createlibrary) | **POST** /libraries | 
-*LibrariesApi* | [**deleteLibrary**](doc//LibrariesApi.md#deletelibrary) | **DELETE** /libraries/{id} | 
-*LibrariesApi* | [**getAllLibraries**](doc//LibrariesApi.md#getalllibraries) | **GET** /libraries | 
-*LibrariesApi* | [**getLibrary**](doc//LibrariesApi.md#getlibrary) | **GET** /libraries/{id} | 
-*LibrariesApi* | [**getLibraryStatistics**](doc//LibrariesApi.md#getlibrarystatistics) | **GET** /libraries/{id}/statistics | 
-*LibrariesApi* | [**scanLibrary**](doc//LibrariesApi.md#scanlibrary) | **POST** /libraries/{id}/scan | 
-*LibrariesApi* | [**updateLibrary**](doc//LibrariesApi.md#updatelibrary) | **PUT** /libraries/{id} | 
-*LibrariesApi* | [**validate**](doc//LibrariesApi.md#validate) | **POST** /libraries/{id}/validate | 
-*MapApi* | [**getMapMarkers**](doc//MapApi.md#getmapmarkers) | **GET** /map/markers | 
-*MapApi* | [**reverseGeocode**](doc//MapApi.md#reversegeocode) | **GET** /map/reverse-geocode | 
-*MemoriesApi* | [**addMemoryAssets**](doc//MemoriesApi.md#addmemoryassets) | **PUT** /memories/{id}/assets | 
-*MemoriesApi* | [**createMemory**](doc//MemoriesApi.md#creatememory) | **POST** /memories | 
-*MemoriesApi* | [**deleteMemory**](doc//MemoriesApi.md#deletememory) | **DELETE** /memories/{id} | 
-*MemoriesApi* | [**getMemory**](doc//MemoriesApi.md#getmemory) | **GET** /memories/{id} | 
-*MemoriesApi* | [**memoriesStatistics**](doc//MemoriesApi.md#memoriesstatistics) | **GET** /memories/statistics | 
-*MemoriesApi* | [**removeMemoryAssets**](doc//MemoriesApi.md#removememoryassets) | **DELETE** /memories/{id}/assets | 
-*MemoriesApi* | [**searchMemories**](doc//MemoriesApi.md#searchmemories) | **GET** /memories | 
-*MemoriesApi* | [**updateMemory**](doc//MemoriesApi.md#updatememory) | **PUT** /memories/{id} | 
-*NotificationsApi* | [**deleteNotification**](doc//NotificationsApi.md#deletenotification) | **DELETE** /notifications/{id} | 
-*NotificationsApi* | [**deleteNotifications**](doc//NotificationsApi.md#deletenotifications) | **DELETE** /notifications | 
-*NotificationsApi* | [**getNotification**](doc//NotificationsApi.md#getnotification) | **GET** /notifications/{id} | 
-*NotificationsApi* | [**getNotifications**](doc//NotificationsApi.md#getnotifications) | **GET** /notifications | 
-*NotificationsApi* | [**updateNotification**](doc//NotificationsApi.md#updatenotification) | **PUT** /notifications/{id} | 
-*NotificationsApi* | [**updateNotifications**](doc//NotificationsApi.md#updatenotifications) | **PUT** /notifications | 
-*NotificationsAdminApi* | [**createNotification**](doc//NotificationsAdminApi.md#createnotification) | **POST** /admin/notifications | 
-*NotificationsAdminApi* | [**getNotificationTemplateAdmin**](doc//NotificationsAdminApi.md#getnotificationtemplateadmin) | **POST** /admin/notifications/templates/{name} | 
-*NotificationsAdminApi* | [**sendTestEmailAdmin**](doc//NotificationsAdminApi.md#sendtestemailadmin) | **POST** /admin/notifications/test-email | 
-*OAuthApi* | [**finishOAuth**](doc//OAuthApi.md#finishoauth) | **POST** /oauth/callback | 
-*OAuthApi* | [**linkOAuthAccount**](doc//OAuthApi.md#linkoauthaccount) | **POST** /oauth/link | 
-*OAuthApi* | [**redirectOAuthToMobile**](doc//OAuthApi.md#redirectoauthtomobile) | **GET** /oauth/mobile-redirect | 
-*OAuthApi* | [**startOAuth**](doc//OAuthApi.md#startoauth) | **POST** /oauth/authorize | 
-*OAuthApi* | [**unlinkOAuthAccount**](doc//OAuthApi.md#unlinkoauthaccount) | **POST** /oauth/unlink | 
-*PartnersApi* | [**createPartner**](doc//PartnersApi.md#createpartner) | **POST** /partners | 
-*PartnersApi* | [**createPartnerDeprecated**](doc//PartnersApi.md#createpartnerdeprecated) | **POST** /partners/{id} | 
-*PartnersApi* | [**getPartners**](doc//PartnersApi.md#getpartners) | **GET** /partners | 
-*PartnersApi* | [**removePartner**](doc//PartnersApi.md#removepartner) | **DELETE** /partners/{id} | 
-*PartnersApi* | [**updatePartner**](doc//PartnersApi.md#updatepartner) | **PUT** /partners/{id} | 
-*PeopleApi* | [**createPerson**](doc//PeopleApi.md#createperson) | **POST** /people | 
-*PeopleApi* | [**deletePeople**](doc//PeopleApi.md#deletepeople) | **DELETE** /people | 
-*PeopleApi* | [**deletePerson**](doc//PeopleApi.md#deleteperson) | **DELETE** /people/{id} | 
-*PeopleApi* | [**getAllPeople**](doc//PeopleApi.md#getallpeople) | **GET** /people | 
-*PeopleApi* | [**getPerson**](doc//PeopleApi.md#getperson) | **GET** /people/{id} | 
-*PeopleApi* | [**getPersonStatistics**](doc//PeopleApi.md#getpersonstatistics) | **GET** /people/{id}/statistics | 
-*PeopleApi* | [**getPersonThumbnail**](doc//PeopleApi.md#getpersonthumbnail) | **GET** /people/{id}/thumbnail | 
-*PeopleApi* | [**mergePerson**](doc//PeopleApi.md#mergeperson) | **POST** /people/{id}/merge | 
-*PeopleApi* | [**reassignFaces**](doc//PeopleApi.md#reassignfaces) | **PUT** /people/{id}/reassign | 
-*PeopleApi* | [**updatePeople**](doc//PeopleApi.md#updatepeople) | **PUT** /people | 
-*PeopleApi* | [**updatePerson**](doc//PeopleApi.md#updateperson) | **PUT** /people/{id} | 
-*SearchApi* | [**getAssetsByCity**](doc//SearchApi.md#getassetsbycity) | **GET** /search/cities | 
-*SearchApi* | [**getExploreData**](doc//SearchApi.md#getexploredata) | **GET** /search/explore | 
-*SearchApi* | [**getSearchSuggestions**](doc//SearchApi.md#getsearchsuggestions) | **GET** /search/suggestions | 
-*SearchApi* | [**searchAssetStatistics**](doc//SearchApi.md#searchassetstatistics) | **POST** /search/statistics | 
-*SearchApi* | [**searchAssets**](doc//SearchApi.md#searchassets) | **POST** /search/metadata | 
-*SearchApi* | [**searchLargeAssets**](doc//SearchApi.md#searchlargeassets) | **POST** /search/large-assets | 
-*SearchApi* | [**searchPerson**](doc//SearchApi.md#searchperson) | **GET** /search/person | 
-*SearchApi* | [**searchPlaces**](doc//SearchApi.md#searchplaces) | **GET** /search/places | 
-*SearchApi* | [**searchRandom**](doc//SearchApi.md#searchrandom) | **POST** /search/random | 
-*SearchApi* | [**searchSmart**](doc//SearchApi.md#searchsmart) | **POST** /search/smart | 
-*ServerApi* | [**deleteServerLicense**](doc//ServerApi.md#deleteserverlicense) | **DELETE** /server/license | 
-*ServerApi* | [**getAboutInfo**](doc//ServerApi.md#getaboutinfo) | **GET** /server/about | 
-*ServerApi* | [**getApkLinks**](doc//ServerApi.md#getapklinks) | **GET** /server/apk-links | 
-*ServerApi* | [**getServerConfig**](doc//ServerApi.md#getserverconfig) | **GET** /server/config | 
-*ServerApi* | [**getServerFeatures**](doc//ServerApi.md#getserverfeatures) | **GET** /server/features | 
-*ServerApi* | [**getServerLicense**](doc//ServerApi.md#getserverlicense) | **GET** /server/license | 
-*ServerApi* | [**getServerStatistics**](doc//ServerApi.md#getserverstatistics) | **GET** /server/statistics | 
-*ServerApi* | [**getServerVersion**](doc//ServerApi.md#getserverversion) | **GET** /server/version | 
-*ServerApi* | [**getStorage**](doc//ServerApi.md#getstorage) | **GET** /server/storage | 
-*ServerApi* | [**getSupportedMediaTypes**](doc//ServerApi.md#getsupportedmediatypes) | **GET** /server/media-types | 
-*ServerApi* | [**getTheme**](doc//ServerApi.md#gettheme) | **GET** /server/theme | 
-*ServerApi* | [**getVersionCheck**](doc//ServerApi.md#getversioncheck) | **GET** /server/version-check | 
-*ServerApi* | [**getVersionHistory**](doc//ServerApi.md#getversionhistory) | **GET** /server/version-history | 
-*ServerApi* | [**pingServer**](doc//ServerApi.md#pingserver) | **GET** /server/ping | 
-*ServerApi* | [**setServerLicense**](doc//ServerApi.md#setserverlicense) | **PUT** /server/license | 
-*SessionsApi* | [**createSession**](doc//SessionsApi.md#createsession) | **POST** /sessions | 
-*SessionsApi* | [**deleteAllSessions**](doc//SessionsApi.md#deleteallsessions) | **DELETE** /sessions | 
-*SessionsApi* | [**deleteSession**](doc//SessionsApi.md#deletesession) | **DELETE** /sessions/{id} | 
-*SessionsApi* | [**getSessions**](doc//SessionsApi.md#getsessions) | **GET** /sessions | 
-*SessionsApi* | [**lockSession**](doc//SessionsApi.md#locksession) | **POST** /sessions/{id}/lock | 
-*SessionsApi* | [**updateSession**](doc//SessionsApi.md#updatesession) | **PUT** /sessions/{id} | 
-*SharedLinksApi* | [**addSharedLinkAssets**](doc//SharedLinksApi.md#addsharedlinkassets) | **PUT** /shared-links/{id}/assets | 
-*SharedLinksApi* | [**createSharedLink**](doc//SharedLinksApi.md#createsharedlink) | **POST** /shared-links | 
-*SharedLinksApi* | [**getAllSharedLinks**](doc//SharedLinksApi.md#getallsharedlinks) | **GET** /shared-links | 
-*SharedLinksApi* | [**getMySharedLink**](doc//SharedLinksApi.md#getmysharedlink) | **GET** /shared-links/me | 
-*SharedLinksApi* | [**getSharedLinkById**](doc//SharedLinksApi.md#getsharedlinkbyid) | **GET** /shared-links/{id} | 
-*SharedLinksApi* | [**removeSharedLink**](doc//SharedLinksApi.md#removesharedlink) | **DELETE** /shared-links/{id} | 
-*SharedLinksApi* | [**removeSharedLinkAssets**](doc//SharedLinksApi.md#removesharedlinkassets) | **DELETE** /shared-links/{id}/assets | 
-*SharedLinksApi* | [**updateSharedLink**](doc//SharedLinksApi.md#updatesharedlink) | **PATCH** /shared-links/{id} | 
-*StacksApi* | [**createStack**](doc//StacksApi.md#createstack) | **POST** /stacks | 
-*StacksApi* | [**deleteStack**](doc//StacksApi.md#deletestack) | **DELETE** /stacks/{id} | 
-*StacksApi* | [**deleteStacks**](doc//StacksApi.md#deletestacks) | **DELETE** /stacks | 
-*StacksApi* | [**getStack**](doc//StacksApi.md#getstack) | **GET** /stacks/{id} | 
-*StacksApi* | [**removeAssetFromStack**](doc//StacksApi.md#removeassetfromstack) | **DELETE** /stacks/{id}/assets/{assetId} | 
-*StacksApi* | [**searchStacks**](doc//StacksApi.md#searchstacks) | **GET** /stacks | 
-*StacksApi* | [**updateStack**](doc//StacksApi.md#updatestack) | **PUT** /stacks/{id} | 
-*SyncApi* | [**deleteSyncAck**](doc//SyncApi.md#deletesyncack) | **DELETE** /sync/ack | 
-*SyncApi* | [**getDeltaSync**](doc//SyncApi.md#getdeltasync) | **POST** /sync/delta-sync | 
-*SyncApi* | [**getFullSyncForUser**](doc//SyncApi.md#getfullsyncforuser) | **POST** /sync/full-sync | 
-*SyncApi* | [**getSyncAck**](doc//SyncApi.md#getsyncack) | **GET** /sync/ack | 
-*SyncApi* | [**getSyncStream**](doc//SyncApi.md#getsyncstream) | **POST** /sync/stream | 
-*SyncApi* | [**sendSyncAck**](doc//SyncApi.md#sendsyncack) | **POST** /sync/ack | 
-*SystemConfigApi* | [**getConfig**](doc//SystemConfigApi.md#getconfig) | **GET** /system-config | 
-*SystemConfigApi* | [**getConfigDefaults**](doc//SystemConfigApi.md#getconfigdefaults) | **GET** /system-config/defaults | 
-*SystemConfigApi* | [**getStorageTemplateOptions**](doc//SystemConfigApi.md#getstoragetemplateoptions) | **GET** /system-config/storage-template-options | 
-*SystemConfigApi* | [**updateConfig**](doc//SystemConfigApi.md#updateconfig) | **PUT** /system-config | 
-*SystemMetadataApi* | [**getAdminOnboarding**](doc//SystemMetadataApi.md#getadminonboarding) | **GET** /system-metadata/admin-onboarding | 
-*SystemMetadataApi* | [**getReverseGeocodingState**](doc//SystemMetadataApi.md#getreversegeocodingstate) | **GET** /system-metadata/reverse-geocoding-state | 
-*SystemMetadataApi* | [**getVersionCheckState**](doc//SystemMetadataApi.md#getversioncheckstate) | **GET** /system-metadata/version-check-state | 
-*SystemMetadataApi* | [**updateAdminOnboarding**](doc//SystemMetadataApi.md#updateadminonboarding) | **POST** /system-metadata/admin-onboarding | 
-*TagsApi* | [**bulkTagAssets**](doc//TagsApi.md#bulktagassets) | **PUT** /tags/assets | 
-*TagsApi* | [**createTag**](doc//TagsApi.md#createtag) | **POST** /tags | 
-*TagsApi* | [**deleteTag**](doc//TagsApi.md#deletetag) | **DELETE** /tags/{id} | 
-*TagsApi* | [**getAllTags**](doc//TagsApi.md#getalltags) | **GET** /tags | 
-*TagsApi* | [**getTagById**](doc//TagsApi.md#gettagbyid) | **GET** /tags/{id} | 
-*TagsApi* | [**tagAssets**](doc//TagsApi.md#tagassets) | **PUT** /tags/{id}/assets | 
-*TagsApi* | [**untagAssets**](doc//TagsApi.md#untagassets) | **DELETE** /tags/{id}/assets | 
-*TagsApi* | [**updateTag**](doc//TagsApi.md#updatetag) | **PUT** /tags/{id} | 
-*TagsApi* | [**upsertTags**](doc//TagsApi.md#upserttags) | **PUT** /tags | 
-*TimelineApi* | [**getTimeBucket**](doc//TimelineApi.md#gettimebucket) | **GET** /timeline/bucket | 
-*TimelineApi* | [**getTimeBuckets**](doc//TimelineApi.md#gettimebuckets) | **GET** /timeline/buckets | 
-*TrashApi* | [**emptyTrash**](doc//TrashApi.md#emptytrash) | **POST** /trash/empty | 
-*TrashApi* | [**restoreAssets**](doc//TrashApi.md#restoreassets) | **POST** /trash/restore/assets | 
-*TrashApi* | [**restoreTrash**](doc//TrashApi.md#restoretrash) | **POST** /trash/restore | 
-*UsersApi* | [**createProfileImage**](doc//UsersApi.md#createprofileimage) | **POST** /users/profile-image | 
-*UsersApi* | [**deleteProfileImage**](doc//UsersApi.md#deleteprofileimage) | **DELETE** /users/profile-image | 
-*UsersApi* | [**deleteUserLicense**](doc//UsersApi.md#deleteuserlicense) | **DELETE** /users/me/license | 
-*UsersApi* | [**deleteUserOnboarding**](doc//UsersApi.md#deleteuseronboarding) | **DELETE** /users/me/onboarding | 
-*UsersApi* | [**getMyPreferences**](doc//UsersApi.md#getmypreferences) | **GET** /users/me/preferences | 
-*UsersApi* | [**getMyUser**](doc//UsersApi.md#getmyuser) | **GET** /users/me | 
-*UsersApi* | [**getProfileImage**](doc//UsersApi.md#getprofileimage) | **GET** /users/{id}/profile-image | 
-*UsersApi* | [**getUser**](doc//UsersApi.md#getuser) | **GET** /users/{id} | 
-*UsersApi* | [**getUserLicense**](doc//UsersApi.md#getuserlicense) | **GET** /users/me/license | 
-*UsersApi* | [**getUserOnboarding**](doc//UsersApi.md#getuseronboarding) | **GET** /users/me/onboarding | 
-*UsersApi* | [**searchUsers**](doc//UsersApi.md#searchusers) | **GET** /users | 
-*UsersApi* | [**setUserLicense**](doc//UsersApi.md#setuserlicense) | **PUT** /users/me/license | 
-*UsersApi* | [**setUserOnboarding**](doc//UsersApi.md#setuseronboarding) | **PUT** /users/me/onboarding | 
-*UsersApi* | [**updateMyPreferences**](doc//UsersApi.md#updatemypreferences) | **PUT** /users/me/preferences | 
-*UsersApi* | [**updateMyUser**](doc//UsersApi.md#updatemyuser) | **PUT** /users/me | 
-*UsersAdminApi* | [**createUserAdmin**](doc//UsersAdminApi.md#createuseradmin) | **POST** /admin/users | 
-*UsersAdminApi* | [**deleteUserAdmin**](doc//UsersAdminApi.md#deleteuseradmin) | **DELETE** /admin/users/{id} | 
-*UsersAdminApi* | [**getUserAdmin**](doc//UsersAdminApi.md#getuseradmin) | **GET** /admin/users/{id} | 
-*UsersAdminApi* | [**getUserPreferencesAdmin**](doc//UsersAdminApi.md#getuserpreferencesadmin) | **GET** /admin/users/{id}/preferences | 
-*UsersAdminApi* | [**getUserSessionsAdmin**](doc//UsersAdminApi.md#getusersessionsadmin) | **GET** /admin/users/{id}/sessions | 
-*UsersAdminApi* | [**getUserStatisticsAdmin**](doc//UsersAdminApi.md#getuserstatisticsadmin) | **GET** /admin/users/{id}/statistics | 
-*UsersAdminApi* | [**restoreUserAdmin**](doc//UsersAdminApi.md#restoreuseradmin) | **POST** /admin/users/{id}/restore | 
-*UsersAdminApi* | [**searchUsersAdmin**](doc//UsersAdminApi.md#searchusersadmin) | **GET** /admin/users | 
-*UsersAdminApi* | [**updateUserAdmin**](doc//UsersAdminApi.md#updateuseradmin) | **PUT** /admin/users/{id} | 
-*UsersAdminApi* | [**updateUserPreferencesAdmin**](doc//UsersAdminApi.md#updateuserpreferencesadmin) | **PUT** /admin/users/{id}/preferences | 
-*ViewApi* | [**getAssetsByOriginalPath**](doc//ViewApi.md#getassetsbyoriginalpath) | **GET** /view/folder | 
-*ViewApi* | [**getUniqueOriginalPaths**](doc//ViewApi.md#getuniqueoriginalpaths) | **GET** /view/folder/unique-paths | 
+*APIKeysApi* | [**createApiKey**](doc//APIKeysApi.md#createapikey) | **POST** /api-keys | Create an API key
+*APIKeysApi* | [**deleteApiKey**](doc//APIKeysApi.md#deleteapikey) | **DELETE** /api-keys/{id} | Delete an API key
+*APIKeysApi* | [**getApiKey**](doc//APIKeysApi.md#getapikey) | **GET** /api-keys/{id} | Retrieve an API key
+*APIKeysApi* | [**getApiKeys**](doc//APIKeysApi.md#getapikeys) | **GET** /api-keys | List all API keys
+*APIKeysApi* | [**getMyApiKey**](doc//APIKeysApi.md#getmyapikey) | **GET** /api-keys/me | Retrieve the current API key
+*APIKeysApi* | [**updateApiKey**](doc//APIKeysApi.md#updateapikey) | **PUT** /api-keys/{id} | Update an API key
+*ActivitiesApi* | [**createActivity**](doc//ActivitiesApi.md#createactivity) | **POST** /activities | Create an activity
+*ActivitiesApi* | [**deleteActivity**](doc//ActivitiesApi.md#deleteactivity) | **DELETE** /activities/{id} | Delete an activity
+*ActivitiesApi* | [**getActivities**](doc//ActivitiesApi.md#getactivities) | **GET** /activities | List all activities
+*ActivitiesApi* | [**getActivityStatistics**](doc//ActivitiesApi.md#getactivitystatistics) | **GET** /activities/statistics | Retrieve activity statistics
+*AlbumsApi* | [**addAssetsToAlbum**](doc//AlbumsApi.md#addassetstoalbum) | **PUT** /albums/{id}/assets | Add assets to an album
+*AlbumsApi* | [**addAssetsToAlbums**](doc//AlbumsApi.md#addassetstoalbums) | **PUT** /albums/assets | Add assets to albums
+*AlbumsApi* | [**addUsersToAlbum**](doc//AlbumsApi.md#adduserstoalbum) | **PUT** /albums/{id}/users | Share album with users
+*AlbumsApi* | [**createAlbum**](doc//AlbumsApi.md#createalbum) | **POST** /albums | Create an album
+*AlbumsApi* | [**deleteAlbum**](doc//AlbumsApi.md#deletealbum) | **DELETE** /albums/{id} | Delete an album
+*AlbumsApi* | [**getAlbumInfo**](doc//AlbumsApi.md#getalbuminfo) | **GET** /albums/{id} | Retrieve an album
+*AlbumsApi* | [**getAlbumStatistics**](doc//AlbumsApi.md#getalbumstatistics) | **GET** /albums/statistics | Retrieve album statistics
+*AlbumsApi* | [**getAllAlbums**](doc//AlbumsApi.md#getallalbums) | **GET** /albums | List all albums
+*AlbumsApi* | [**removeAssetFromAlbum**](doc//AlbumsApi.md#removeassetfromalbum) | **DELETE** /albums/{id}/assets | Remove assets from an album
+*AlbumsApi* | [**removeUserFromAlbum**](doc//AlbumsApi.md#removeuserfromalbum) | **DELETE** /albums/{id}/user/{userId} | Remove user from album
+*AlbumsApi* | [**updateAlbumInfo**](doc//AlbumsApi.md#updatealbuminfo) | **PATCH** /albums/{id} | Update an album
+*AlbumsApi* | [**updateAlbumUser**](doc//AlbumsApi.md#updatealbumuser) | **PUT** /albums/{id}/user/{userId} | Update user role
+*AssetsApi* | [**checkBulkUpload**](doc//AssetsApi.md#checkbulkupload) | **POST** /assets/bulk-upload-check | Check bulk upload
+*AssetsApi* | [**checkExistingAssets**](doc//AssetsApi.md#checkexistingassets) | **POST** /assets/exist | Check existing assets
+*AssetsApi* | [**copyAsset**](doc//AssetsApi.md#copyasset) | **PUT** /assets/copy | Copy asset
+*AssetsApi* | [**deleteAssetMetadata**](doc//AssetsApi.md#deleteassetmetadata) | **DELETE** /assets/{id}/metadata/{key} | Delete asset metadata by key
+*AssetsApi* | [**deleteAssets**](doc//AssetsApi.md#deleteassets) | **DELETE** /assets | Delete assets
+*AssetsApi* | [**downloadAsset**](doc//AssetsApi.md#downloadasset) | **GET** /assets/{id}/original | Download original asset
+*AssetsApi* | [**getAllUserAssetsByDeviceId**](doc//AssetsApi.md#getalluserassetsbydeviceid) | **GET** /assets/device/{deviceId} | Retrieve assets by device ID
+*AssetsApi* | [**getAssetInfo**](doc//AssetsApi.md#getassetinfo) | **GET** /assets/{id} | Retrieve an asset
+*AssetsApi* | [**getAssetMetadata**](doc//AssetsApi.md#getassetmetadata) | **GET** /assets/{id}/metadata | Get asset metadata
+*AssetsApi* | [**getAssetMetadataByKey**](doc//AssetsApi.md#getassetmetadatabykey) | **GET** /assets/{id}/metadata/{key} | Retrieve asset metadata by key
+*AssetsApi* | [**getAssetOcr**](doc//AssetsApi.md#getassetocr) | **GET** /assets/{id}/ocr | Retrieve asset OCR data
+*AssetsApi* | [**getAssetStatistics**](doc//AssetsApi.md#getassetstatistics) | **GET** /assets/statistics | Get asset statistics
+*AssetsApi* | [**getRandom**](doc//AssetsApi.md#getrandom) | **GET** /assets/random | Get random assets
+*AssetsApi* | [**playAssetVideo**](doc//AssetsApi.md#playassetvideo) | **GET** /assets/{id}/video/playback | Play asset video
+*AssetsApi* | [**replaceAsset**](doc//AssetsApi.md#replaceasset) | **PUT** /assets/{id}/original | Replace asset
+*AssetsApi* | [**runAssetJobs**](doc//AssetsApi.md#runassetjobs) | **POST** /assets/jobs | Run an asset job
+*AssetsApi* | [**updateAsset**](doc//AssetsApi.md#updateasset) | **PUT** /assets/{id} | Update an asset
+*AssetsApi* | [**updateAssetMetadata**](doc//AssetsApi.md#updateassetmetadata) | **PUT** /assets/{id}/metadata | Update asset metadata
+*AssetsApi* | [**updateAssets**](doc//AssetsApi.md#updateassets) | **PUT** /assets | Update assets
+*AssetsApi* | [**uploadAsset**](doc//AssetsApi.md#uploadasset) | **POST** /assets | Upload asset
+*AssetsApi* | [**viewAsset**](doc//AssetsApi.md#viewasset) | **GET** /assets/{id}/thumbnail | View asset thumbnail
+*AuthenticationApi* | [**changePassword**](doc//AuthenticationApi.md#changepassword) | **POST** /auth/change-password | Change password
+*AuthenticationApi* | [**changePinCode**](doc//AuthenticationApi.md#changepincode) | **PUT** /auth/pin-code | Change pin code
+*AuthenticationApi* | [**finishOAuth**](doc//AuthenticationApi.md#finishoauth) | **POST** /oauth/callback | Finish OAuth
+*AuthenticationApi* | [**getAuthStatus**](doc//AuthenticationApi.md#getauthstatus) | **GET** /auth/status | Retrieve auth status
+*AuthenticationApi* | [**linkOAuthAccount**](doc//AuthenticationApi.md#linkoauthaccount) | **POST** /oauth/link | Link OAuth account
+*AuthenticationApi* | [**lockAuthSession**](doc//AuthenticationApi.md#lockauthsession) | **POST** /auth/session/lock | Lock auth session
+*AuthenticationApi* | [**login**](doc//AuthenticationApi.md#login) | **POST** /auth/login | Login
+*AuthenticationApi* | [**logout**](doc//AuthenticationApi.md#logout) | **POST** /auth/logout | Logout
+*AuthenticationApi* | [**redirectOAuthToMobile**](doc//AuthenticationApi.md#redirectoauthtomobile) | **GET** /oauth/mobile-redirect | Redirect OAuth to mobile
+*AuthenticationApi* | [**resetPinCode**](doc//AuthenticationApi.md#resetpincode) | **DELETE** /auth/pin-code | Reset pin code
+*AuthenticationApi* | [**setupPinCode**](doc//AuthenticationApi.md#setuppincode) | **POST** /auth/pin-code | Setup pin code
+*AuthenticationApi* | [**signUpAdmin**](doc//AuthenticationApi.md#signupadmin) | **POST** /auth/admin-sign-up | Register admin
+*AuthenticationApi* | [**startOAuth**](doc//AuthenticationApi.md#startoauth) | **POST** /oauth/authorize | Start OAuth
+*AuthenticationApi* | [**unlinkOAuthAccount**](doc//AuthenticationApi.md#unlinkoauthaccount) | **POST** /oauth/unlink | Unlink OAuth account
+*AuthenticationApi* | [**unlockAuthSession**](doc//AuthenticationApi.md#unlockauthsession) | **POST** /auth/session/unlock | Unlock auth session
+*AuthenticationApi* | [**validateAccessToken**](doc//AuthenticationApi.md#validateaccesstoken) | **POST** /auth/validateToken | Validate access token
+*AuthenticationAdminApi* | [**unlinkAllOAuthAccountsAdmin**](doc//AuthenticationAdminApi.md#unlinkalloauthaccountsadmin) | **POST** /admin/auth/unlink-all | Unlink all OAuth accounts
+*DeprecatedApi* | [**createPartnerDeprecated**](doc//DeprecatedApi.md#createpartnerdeprecated) | **POST** /partners/{id} | Create a partner
+*DeprecatedApi* | [**getAllUserAssetsByDeviceId**](doc//DeprecatedApi.md#getalluserassetsbydeviceid) | **GET** /assets/device/{deviceId} | Retrieve assets by device ID
+*DeprecatedApi* | [**getDeltaSync**](doc//DeprecatedApi.md#getdeltasync) | **POST** /sync/delta-sync | Get delta sync for user
+*DeprecatedApi* | [**getFullSyncForUser**](doc//DeprecatedApi.md#getfullsyncforuser) | **POST** /sync/full-sync | Get full sync for user
+*DeprecatedApi* | [**getRandom**](doc//DeprecatedApi.md#getrandom) | **GET** /assets/random | Get random assets
+*DeprecatedApi* | [**replaceAsset**](doc//DeprecatedApi.md#replaceasset) | **PUT** /assets/{id}/original | Replace asset
+*DownloadApi* | [**downloadArchive**](doc//DownloadApi.md#downloadarchive) | **POST** /download/archive | Download asset archive
+*DownloadApi* | [**getDownloadInfo**](doc//DownloadApi.md#getdownloadinfo) | **POST** /download/info | Retrieve download information
+*DuplicatesApi* | [**deleteDuplicate**](doc//DuplicatesApi.md#deleteduplicate) | **DELETE** /duplicates/{id} | Delete a duplicate
+*DuplicatesApi* | [**deleteDuplicates**](doc//DuplicatesApi.md#deleteduplicates) | **DELETE** /duplicates | Delete duplicates
+*DuplicatesApi* | [**getAssetDuplicates**](doc//DuplicatesApi.md#getassetduplicates) | **GET** /duplicates | Retrieve duplicates
+*FacesApi* | [**createFace**](doc//FacesApi.md#createface) | **POST** /faces | Create a face
+*FacesApi* | [**deleteFace**](doc//FacesApi.md#deleteface) | **DELETE** /faces/{id} | Delete a face
+*FacesApi* | [**getFaces**](doc//FacesApi.md#getfaces) | **GET** /faces | Retrieve faces for asset
+*FacesApi* | [**reassignFacesById**](doc//FacesApi.md#reassignfacesbyid) | **PUT** /faces/{id} | Re-assign a face to another person
+*JobsApi* | [**createJob**](doc//JobsApi.md#createjob) | **POST** /jobs | Create a manual job
+*JobsApi* | [**getQueuesLegacy**](doc//JobsApi.md#getqueueslegacy) | **GET** /jobs | Retrieve queue counts and status
+*JobsApi* | [**runQueueCommandLegacy**](doc//JobsApi.md#runqueuecommandlegacy) | **PUT** /jobs/{name} | Run jobs
+*LibrariesApi* | [**createLibrary**](doc//LibrariesApi.md#createlibrary) | **POST** /libraries | Create a library
+*LibrariesApi* | [**deleteLibrary**](doc//LibrariesApi.md#deletelibrary) | **DELETE** /libraries/{id} | Delete a library
+*LibrariesApi* | [**getAllLibraries**](doc//LibrariesApi.md#getalllibraries) | **GET** /libraries | Retrieve libraries
+*LibrariesApi* | [**getLibrary**](doc//LibrariesApi.md#getlibrary) | **GET** /libraries/{id} | Retrieve a library
+*LibrariesApi* | [**getLibraryStatistics**](doc//LibrariesApi.md#getlibrarystatistics) | **GET** /libraries/{id}/statistics | Retrieve library statistics
+*LibrariesApi* | [**scanLibrary**](doc//LibrariesApi.md#scanlibrary) | **POST** /libraries/{id}/scan | Scan a library
+*LibrariesApi* | [**updateLibrary**](doc//LibrariesApi.md#updatelibrary) | **PUT** /libraries/{id} | Update a library
+*LibrariesApi* | [**validate**](doc//LibrariesApi.md#validate) | **POST** /libraries/{id}/validate | Validate library settings
+*MaintenanceAdminApi* | [**maintenanceLogin**](doc//MaintenanceAdminApi.md#maintenancelogin) | **POST** /admin/maintenance/login | Log into maintenance mode
+*MaintenanceAdminApi* | [**setMaintenanceMode**](doc//MaintenanceAdminApi.md#setmaintenancemode) | **POST** /admin/maintenance | Set maintenance mode
+*MapApi* | [**getMapMarkers**](doc//MapApi.md#getmapmarkers) | **GET** /map/markers | Retrieve map markers
+*MapApi* | [**reverseGeocode**](doc//MapApi.md#reversegeocode) | **GET** /map/reverse-geocode | Reverse geocode coordinates
+*MemoriesApi* | [**addMemoryAssets**](doc//MemoriesApi.md#addmemoryassets) | **PUT** /memories/{id}/assets | Add assets to a memory
+*MemoriesApi* | [**createMemory**](doc//MemoriesApi.md#creatememory) | **POST** /memories | Create a memory
+*MemoriesApi* | [**deleteMemory**](doc//MemoriesApi.md#deletememory) | **DELETE** /memories/{id} | Delete a memory
+*MemoriesApi* | [**getMemory**](doc//MemoriesApi.md#getmemory) | **GET** /memories/{id} | Retrieve a memory
+*MemoriesApi* | [**memoriesStatistics**](doc//MemoriesApi.md#memoriesstatistics) | **GET** /memories/statistics | Retrieve memories statistics
+*MemoriesApi* | [**removeMemoryAssets**](doc//MemoriesApi.md#removememoryassets) | **DELETE** /memories/{id}/assets | Remove assets from a memory
+*MemoriesApi* | [**searchMemories**](doc//MemoriesApi.md#searchmemories) | **GET** /memories | Retrieve memories
+*MemoriesApi* | [**updateMemory**](doc//MemoriesApi.md#updatememory) | **PUT** /memories/{id} | Update a memory
+*NotificationsApi* | [**deleteNotification**](doc//NotificationsApi.md#deletenotification) | **DELETE** /notifications/{id} | Delete a notification
+*NotificationsApi* | [**deleteNotifications**](doc//NotificationsApi.md#deletenotifications) | **DELETE** /notifications | Delete notifications
+*NotificationsApi* | [**getNotification**](doc//NotificationsApi.md#getnotification) | **GET** /notifications/{id} | Get a notification
+*NotificationsApi* | [**getNotifications**](doc//NotificationsApi.md#getnotifications) | **GET** /notifications | Retrieve notifications
+*NotificationsApi* | [**updateNotification**](doc//NotificationsApi.md#updatenotification) | **PUT** /notifications/{id} | Update a notification
+*NotificationsApi* | [**updateNotifications**](doc//NotificationsApi.md#updatenotifications) | **PUT** /notifications | Update notifications
+*NotificationsAdminApi* | [**createNotification**](doc//NotificationsAdminApi.md#createnotification) | **POST** /admin/notifications | Create a notification
+*NotificationsAdminApi* | [**getNotificationTemplateAdmin**](doc//NotificationsAdminApi.md#getnotificationtemplateadmin) | **POST** /admin/notifications/templates/{name} | Render email template
+*NotificationsAdminApi* | [**sendTestEmailAdmin**](doc//NotificationsAdminApi.md#sendtestemailadmin) | **POST** /admin/notifications/test-email | Send test email
+*PartnersApi* | [**createPartner**](doc//PartnersApi.md#createpartner) | **POST** /partners | Create a partner
+*PartnersApi* | [**createPartnerDeprecated**](doc//PartnersApi.md#createpartnerdeprecated) | **POST** /partners/{id} | Create a partner
+*PartnersApi* | [**getPartners**](doc//PartnersApi.md#getpartners) | **GET** /partners | Retrieve partners
+*PartnersApi* | [**removePartner**](doc//PartnersApi.md#removepartner) | **DELETE** /partners/{id} | Remove a partner
+*PartnersApi* | [**updatePartner**](doc//PartnersApi.md#updatepartner) | **PUT** /partners/{id} | Update a partner
+*PeopleApi* | [**createPerson**](doc//PeopleApi.md#createperson) | **POST** /people | Create a person
+*PeopleApi* | [**deletePeople**](doc//PeopleApi.md#deletepeople) | **DELETE** /people | Delete people
+*PeopleApi* | [**deletePerson**](doc//PeopleApi.md#deleteperson) | **DELETE** /people/{id} | Delete person
+*PeopleApi* | [**getAllPeople**](doc//PeopleApi.md#getallpeople) | **GET** /people | Get all people
+*PeopleApi* | [**getPerson**](doc//PeopleApi.md#getperson) | **GET** /people/{id} | Get a person
+*PeopleApi* | [**getPersonStatistics**](doc//PeopleApi.md#getpersonstatistics) | **GET** /people/{id}/statistics | Get person statistics
+*PeopleApi* | [**getPersonThumbnail**](doc//PeopleApi.md#getpersonthumbnail) | **GET** /people/{id}/thumbnail | Get person thumbnail
+*PeopleApi* | [**mergePerson**](doc//PeopleApi.md#mergeperson) | **POST** /people/{id}/merge | Merge people
+*PeopleApi* | [**reassignFaces**](doc//PeopleApi.md#reassignfaces) | **PUT** /people/{id}/reassign | Reassign faces
+*PeopleApi* | [**updatePeople**](doc//PeopleApi.md#updatepeople) | **PUT** /people | Update people
+*PeopleApi* | [**updatePerson**](doc//PeopleApi.md#updateperson) | **PUT** /people/{id} | Update person
+*PluginsApi* | [**getPlugin**](doc//PluginsApi.md#getplugin) | **GET** /plugins/{id} | Retrieve a plugin
+*PluginsApi* | [**getPlugins**](doc//PluginsApi.md#getplugins) | **GET** /plugins | List all plugins
+*SearchApi* | [**getAssetsByCity**](doc//SearchApi.md#getassetsbycity) | **GET** /search/cities | Retrieve assets by city
+*SearchApi* | [**getExploreData**](doc//SearchApi.md#getexploredata) | **GET** /search/explore | Retrieve explore data
+*SearchApi* | [**getSearchSuggestions**](doc//SearchApi.md#getsearchsuggestions) | **GET** /search/suggestions | Retrieve search suggestions
+*SearchApi* | [**searchAssetStatistics**](doc//SearchApi.md#searchassetstatistics) | **POST** /search/statistics | Search asset statistics
+*SearchApi* | [**searchAssets**](doc//SearchApi.md#searchassets) | **POST** /search/metadata | Search assets by metadata
+*SearchApi* | [**searchLargeAssets**](doc//SearchApi.md#searchlargeassets) | **POST** /search/large-assets | Search large assets
+*SearchApi* | [**searchPerson**](doc//SearchApi.md#searchperson) | **GET** /search/person | Search people
+*SearchApi* | [**searchPlaces**](doc//SearchApi.md#searchplaces) | **GET** /search/places | Search places
+*SearchApi* | [**searchRandom**](doc//SearchApi.md#searchrandom) | **POST** /search/random | Search random assets
+*SearchApi* | [**searchSmart**](doc//SearchApi.md#searchsmart) | **POST** /search/smart | Smart asset search
+*ServerApi* | [**deleteServerLicense**](doc//ServerApi.md#deleteserverlicense) | **DELETE** /server/license | Delete server product key
+*ServerApi* | [**getAboutInfo**](doc//ServerApi.md#getaboutinfo) | **GET** /server/about | Get server information
+*ServerApi* | [**getApkLinks**](doc//ServerApi.md#getapklinks) | **GET** /server/apk-links | Get APK links
+*ServerApi* | [**getServerConfig**](doc//ServerApi.md#getserverconfig) | **GET** /server/config | Get config
+*ServerApi* | [**getServerFeatures**](doc//ServerApi.md#getserverfeatures) | **GET** /server/features | Get features
+*ServerApi* | [**getServerLicense**](doc//ServerApi.md#getserverlicense) | **GET** /server/license | Get product key
+*ServerApi* | [**getServerStatistics**](doc//ServerApi.md#getserverstatistics) | **GET** /server/statistics | Get statistics
+*ServerApi* | [**getServerVersion**](doc//ServerApi.md#getserverversion) | **GET** /server/version | Get server version
+*ServerApi* | [**getStorage**](doc//ServerApi.md#getstorage) | **GET** /server/storage | Get storage
+*ServerApi* | [**getSupportedMediaTypes**](doc//ServerApi.md#getsupportedmediatypes) | **GET** /server/media-types | Get supported media types
+*ServerApi* | [**getTheme**](doc//ServerApi.md#gettheme) | **GET** /server/theme | Get theme
+*ServerApi* | [**getVersionCheck**](doc//ServerApi.md#getversioncheck) | **GET** /server/version-check | Get version check status
+*ServerApi* | [**getVersionHistory**](doc//ServerApi.md#getversionhistory) | **GET** /server/version-history | Get version history
+*ServerApi* | [**pingServer**](doc//ServerApi.md#pingserver) | **GET** /server/ping | Ping
+*ServerApi* | [**setServerLicense**](doc//ServerApi.md#setserverlicense) | **PUT** /server/license | Set server product key
+*SessionsApi* | [**createSession**](doc//SessionsApi.md#createsession) | **POST** /sessions | Create a session
+*SessionsApi* | [**deleteAllSessions**](doc//SessionsApi.md#deleteallsessions) | **DELETE** /sessions | Delete all sessions
+*SessionsApi* | [**deleteSession**](doc//SessionsApi.md#deletesession) | **DELETE** /sessions/{id} | Delete a session
+*SessionsApi* | [**getSessions**](doc//SessionsApi.md#getsessions) | **GET** /sessions | Retrieve sessions
+*SessionsApi* | [**lockSession**](doc//SessionsApi.md#locksession) | **POST** /sessions/{id}/lock | Lock a session
+*SessionsApi* | [**updateSession**](doc//SessionsApi.md#updatesession) | **PUT** /sessions/{id} | Update a session
+*SharedLinksApi* | [**addSharedLinkAssets**](doc//SharedLinksApi.md#addsharedlinkassets) | **PUT** /shared-links/{id}/assets | Add assets to a shared link
+*SharedLinksApi* | [**createSharedLink**](doc//SharedLinksApi.md#createsharedlink) | **POST** /shared-links | Create a shared link
+*SharedLinksApi* | [**getAllSharedLinks**](doc//SharedLinksApi.md#getallsharedlinks) | **GET** /shared-links | Retrieve all shared links
+*SharedLinksApi* | [**getMySharedLink**](doc//SharedLinksApi.md#getmysharedlink) | **GET** /shared-links/me | Retrieve current shared link
+*SharedLinksApi* | [**getSharedLinkById**](doc//SharedLinksApi.md#getsharedlinkbyid) | **GET** /shared-links/{id} | Retrieve a shared link
+*SharedLinksApi* | [**removeSharedLink**](doc//SharedLinksApi.md#removesharedlink) | **DELETE** /shared-links/{id} | Delete a shared link
+*SharedLinksApi* | [**removeSharedLinkAssets**](doc//SharedLinksApi.md#removesharedlinkassets) | **DELETE** /shared-links/{id}/assets | Remove assets from a shared link
+*SharedLinksApi* | [**updateSharedLink**](doc//SharedLinksApi.md#updatesharedlink) | **PATCH** /shared-links/{id} | Update a shared link
+*StacksApi* | [**createStack**](doc//StacksApi.md#createstack) | **POST** /stacks | Create a stack
+*StacksApi* | [**deleteStack**](doc//StacksApi.md#deletestack) | **DELETE** /stacks/{id} | Delete a stack
+*StacksApi* | [**deleteStacks**](doc//StacksApi.md#deletestacks) | **DELETE** /stacks | Delete stacks
+*StacksApi* | [**getStack**](doc//StacksApi.md#getstack) | **GET** /stacks/{id} | Retrieve a stack
+*StacksApi* | [**removeAssetFromStack**](doc//StacksApi.md#removeassetfromstack) | **DELETE** /stacks/{id}/assets/{assetId} | Remove an asset from a stack
+*StacksApi* | [**searchStacks**](doc//StacksApi.md#searchstacks) | **GET** /stacks | Retrieve stacks
+*StacksApi* | [**updateStack**](doc//StacksApi.md#updatestack) | **PUT** /stacks/{id} | Update a stack
+*SyncApi* | [**deleteSyncAck**](doc//SyncApi.md#deletesyncack) | **DELETE** /sync/ack | Delete acknowledgements
+*SyncApi* | [**getDeltaSync**](doc//SyncApi.md#getdeltasync) | **POST** /sync/delta-sync | Get delta sync for user
+*SyncApi* | [**getFullSyncForUser**](doc//SyncApi.md#getfullsyncforuser) | **POST** /sync/full-sync | Get full sync for user
+*SyncApi* | [**getSyncAck**](doc//SyncApi.md#getsyncack) | **GET** /sync/ack | Retrieve acknowledgements
+*SyncApi* | [**getSyncStream**](doc//SyncApi.md#getsyncstream) | **POST** /sync/stream | Stream sync changes
+*SyncApi* | [**sendSyncAck**](doc//SyncApi.md#sendsyncack) | **POST** /sync/ack | Acknowledge changes
+*SystemConfigApi* | [**getConfig**](doc//SystemConfigApi.md#getconfig) | **GET** /system-config | Get system configuration
+*SystemConfigApi* | [**getConfigDefaults**](doc//SystemConfigApi.md#getconfigdefaults) | **GET** /system-config/defaults | Get system configuration defaults
+*SystemConfigApi* | [**getStorageTemplateOptions**](doc//SystemConfigApi.md#getstoragetemplateoptions) | **GET** /system-config/storage-template-options | Get storage template options
+*SystemConfigApi* | [**updateConfig**](doc//SystemConfigApi.md#updateconfig) | **PUT** /system-config | Update system configuration
+*SystemMetadataApi* | [**getAdminOnboarding**](doc//SystemMetadataApi.md#getadminonboarding) | **GET** /system-metadata/admin-onboarding | Retrieve admin onboarding
+*SystemMetadataApi* | [**getReverseGeocodingState**](doc//SystemMetadataApi.md#getreversegeocodingstate) | **GET** /system-metadata/reverse-geocoding-state | Retrieve reverse geocoding state
+*SystemMetadataApi* | [**getVersionCheckState**](doc//SystemMetadataApi.md#getversioncheckstate) | **GET** /system-metadata/version-check-state | Retrieve version check state
+*SystemMetadataApi* | [**updateAdminOnboarding**](doc//SystemMetadataApi.md#updateadminonboarding) | **POST** /system-metadata/admin-onboarding | Update admin onboarding
+*TagsApi* | [**bulkTagAssets**](doc//TagsApi.md#bulktagassets) | **PUT** /tags/assets | Tag assets
+*TagsApi* | [**createTag**](doc//TagsApi.md#createtag) | **POST** /tags | Create a tag
+*TagsApi* | [**deleteTag**](doc//TagsApi.md#deletetag) | **DELETE** /tags/{id} | Delete a tag
+*TagsApi* | [**getAllTags**](doc//TagsApi.md#getalltags) | **GET** /tags | Retrieve tags
+*TagsApi* | [**getTagById**](doc//TagsApi.md#gettagbyid) | **GET** /tags/{id} | Retrieve a tag
+*TagsApi* | [**tagAssets**](doc//TagsApi.md#tagassets) | **PUT** /tags/{id}/assets | Tag assets
+*TagsApi* | [**untagAssets**](doc//TagsApi.md#untagassets) | **DELETE** /tags/{id}/assets | Untag assets
+*TagsApi* | [**updateTag**](doc//TagsApi.md#updatetag) | **PUT** /tags/{id} | Update a tag
+*TagsApi* | [**upsertTags**](doc//TagsApi.md#upserttags) | **PUT** /tags | Upsert tags
+*TimelineApi* | [**getTimeBucket**](doc//TimelineApi.md#gettimebucket) | **GET** /timeline/bucket | Get time bucket
+*TimelineApi* | [**getTimeBuckets**](doc//TimelineApi.md#gettimebuckets) | **GET** /timeline/buckets | Get time buckets
+*TrashApi* | [**emptyTrash**](doc//TrashApi.md#emptytrash) | **POST** /trash/empty | Empty trash
+*TrashApi* | [**restoreAssets**](doc//TrashApi.md#restoreassets) | **POST** /trash/restore/assets | Restore assets
+*TrashApi* | [**restoreTrash**](doc//TrashApi.md#restoretrash) | **POST** /trash/restore | Restore trash
+*UsersApi* | [**createProfileImage**](doc//UsersApi.md#createprofileimage) | **POST** /users/profile-image | Create user profile image
+*UsersApi* | [**deleteProfileImage**](doc//UsersApi.md#deleteprofileimage) | **DELETE** /users/profile-image | Delete user profile image
+*UsersApi* | [**deleteUserLicense**](doc//UsersApi.md#deleteuserlicense) | **DELETE** /users/me/license | Delete user product key
+*UsersApi* | [**deleteUserOnboarding**](doc//UsersApi.md#deleteuseronboarding) | **DELETE** /users/me/onboarding | Delete user onboarding
+*UsersApi* | [**getMyPreferences**](doc//UsersApi.md#getmypreferences) | **GET** /users/me/preferences | Get my preferences
+*UsersApi* | [**getMyUser**](doc//UsersApi.md#getmyuser) | **GET** /users/me | Get current user
+*UsersApi* | [**getProfileImage**](doc//UsersApi.md#getprofileimage) | **GET** /users/{id}/profile-image | Retrieve user profile image
+*UsersApi* | [**getUser**](doc//UsersApi.md#getuser) | **GET** /users/{id} | Retrieve a user
+*UsersApi* | [**getUserLicense**](doc//UsersApi.md#getuserlicense) | **GET** /users/me/license | Retrieve user product key
+*UsersApi* | [**getUserOnboarding**](doc//UsersApi.md#getuseronboarding) | **GET** /users/me/onboarding | Retrieve user onboarding
+*UsersApi* | [**searchUsers**](doc//UsersApi.md#searchusers) | **GET** /users | Get all users
+*UsersApi* | [**setUserLicense**](doc//UsersApi.md#setuserlicense) | **PUT** /users/me/license | Set user product key
+*UsersApi* | [**setUserOnboarding**](doc//UsersApi.md#setuseronboarding) | **PUT** /users/me/onboarding | Update user onboarding
+*UsersApi* | [**updateMyPreferences**](doc//UsersApi.md#updatemypreferences) | **PUT** /users/me/preferences | Update my preferences
+*UsersApi* | [**updateMyUser**](doc//UsersApi.md#updatemyuser) | **PUT** /users/me | Update current user
+*UsersAdminApi* | [**createUserAdmin**](doc//UsersAdminApi.md#createuseradmin) | **POST** /admin/users | Create a user
+*UsersAdminApi* | [**deleteUserAdmin**](doc//UsersAdminApi.md#deleteuseradmin) | **DELETE** /admin/users/{id} | Delete a user
+*UsersAdminApi* | [**getUserAdmin**](doc//UsersAdminApi.md#getuseradmin) | **GET** /admin/users/{id} | Retrieve a user
+*UsersAdminApi* | [**getUserPreferencesAdmin**](doc//UsersAdminApi.md#getuserpreferencesadmin) | **GET** /admin/users/{id}/preferences | Retrieve user preferences
+*UsersAdminApi* | [**getUserSessionsAdmin**](doc//UsersAdminApi.md#getusersessionsadmin) | **GET** /admin/users/{id}/sessions | Retrieve user sessions
+*UsersAdminApi* | [**getUserStatisticsAdmin**](doc//UsersAdminApi.md#getuserstatisticsadmin) | **GET** /admin/users/{id}/statistics | Retrieve user statistics
+*UsersAdminApi* | [**restoreUserAdmin**](doc//UsersAdminApi.md#restoreuseradmin) | **POST** /admin/users/{id}/restore | Restore a deleted user
+*UsersAdminApi* | [**searchUsersAdmin**](doc//UsersAdminApi.md#searchusersadmin) | **GET** /admin/users | Search users
+*UsersAdminApi* | [**updateUserAdmin**](doc//UsersAdminApi.md#updateuseradmin) | **PUT** /admin/users/{id} | Update a user
+*UsersAdminApi* | [**updateUserPreferencesAdmin**](doc//UsersAdminApi.md#updateuserpreferencesadmin) | **PUT** /admin/users/{id}/preferences | Update user preferences
+*ViewsApi* | [**getAssetsByOriginalPath**](doc//ViewsApi.md#getassetsbyoriginalpath) | **GET** /view/folder | Retrieve assets by original path
+*ViewsApi* | [**getUniqueOriginalPaths**](doc//ViewsApi.md#getuniqueoriginalpaths) | **GET** /view/folder/unique-paths | Retrieve unique paths
+*WorkflowsApi* | [**createWorkflow**](doc//WorkflowsApi.md#createworkflow) | **POST** /workflows | Create a workflow
+*WorkflowsApi* | [**deleteWorkflow**](doc//WorkflowsApi.md#deleteworkflow) | **DELETE** /workflows/{id} | Delete a workflow
+*WorkflowsApi* | [**getWorkflow**](doc//WorkflowsApi.md#getworkflow) | **GET** /workflows/{id} | Retrieve a workflow
+*WorkflowsApi* | [**getWorkflows**](doc//WorkflowsApi.md#getworkflows) | **GET** /workflows | List all workflows
+*WorkflowsApi* | [**updateWorkflow**](doc//WorkflowsApi.md#updateworkflow) | **PUT** /workflows/{id} | Update a workflow
 
 
 ## Documentation For Models
@@ -315,7 +327,6 @@ Class | Method | HTTP request | Description
  - [AlbumsAddAssetsResponseDto](doc//AlbumsAddAssetsResponseDto.md)
  - [AlbumsResponse](doc//AlbumsResponse.md)
  - [AlbumsUpdate](doc//AlbumsUpdate.md)
- - [AllJobStatusResponseDto](doc//AllJobStatusResponseDto.md)
  - [AssetBulkDeleteDto](doc//AssetBulkDeleteDto.md)
  - [AssetBulkUpdateDto](doc//AssetBulkUpdateDto.md)
  - [AssetBulkUploadCheckDto](doc//AssetBulkUploadCheckDto.md)
@@ -384,13 +395,8 @@ Class | Method | HTTP request | Description
  - [FoldersResponse](doc//FoldersResponse.md)
  - [FoldersUpdate](doc//FoldersUpdate.md)
  - [ImageFormat](doc//ImageFormat.md)
- - [JobCommand](doc//JobCommand.md)
- - [JobCommandDto](doc//JobCommandDto.md)
- - [JobCountsDto](doc//JobCountsDto.md)
  - [JobCreateDto](doc//JobCreateDto.md)
- - [JobName](doc//JobName.md)
  - [JobSettingsDto](doc//JobSettingsDto.md)
- - [JobStatusDto](doc//JobStatusDto.md)
  - [LibraryResponseDto](doc//LibraryResponseDto.md)
  - [LibraryStatsResponseDto](doc//LibraryStatsResponseDto.md)
  - [LicenseKeyDto](doc//LicenseKeyDto.md)
@@ -400,6 +406,9 @@ Class | Method | HTTP request | Description
  - [LoginResponseDto](doc//LoginResponseDto.md)
  - [LogoutResponseDto](doc//LogoutResponseDto.md)
  - [MachineLearningAvailabilityChecksDto](doc//MachineLearningAvailabilityChecksDto.md)
+ - [MaintenanceAction](doc//MaintenanceAction.md)
+ - [MaintenanceAuthDto](doc//MaintenanceAuthDto.md)
+ - [MaintenanceLoginDto](doc//MaintenanceLoginDto.md)
  - [ManualJobName](doc//ManualJobName.md)
  - [MapMarkerResponseDto](doc//MapMarkerResponseDto.md)
  - [MapReverseGeocodeResponseDto](doc//MapReverseGeocodeResponseDto.md)
@@ -447,9 +456,20 @@ Class | Method | HTTP request | Description
  - [PinCodeResetDto](doc//PinCodeResetDto.md)
  - [PinCodeSetupDto](doc//PinCodeSetupDto.md)
  - [PlacesResponseDto](doc//PlacesResponseDto.md)
+ - [PluginActionResponseDto](doc//PluginActionResponseDto.md)
+ - [PluginContext](doc//PluginContext.md)
+ - [PluginFilterResponseDto](doc//PluginFilterResponseDto.md)
+ - [PluginResponseDto](doc//PluginResponseDto.md)
+ - [PluginTriggerType](doc//PluginTriggerType.md)
  - [PurchaseResponse](doc//PurchaseResponse.md)
  - [PurchaseUpdate](doc//PurchaseUpdate.md)
+ - [QueueCommand](doc//QueueCommand.md)
+ - [QueueCommandDto](doc//QueueCommandDto.md)
+ - [QueueName](doc//QueueName.md)
+ - [QueueResponseDto](doc//QueueResponseDto.md)
+ - [QueueStatisticsDto](doc//QueueStatisticsDto.md)
  - [QueueStatusDto](doc//QueueStatusDto.md)
+ - [QueuesResponseDto](doc//QueuesResponseDto.md)
  - [RandomSearchDto](doc//RandomSearchDto.md)
  - [RatingsResponse](doc//RatingsResponse.md)
  - [RatingsUpdate](doc//RatingsUpdate.md)
@@ -481,6 +501,7 @@ Class | Method | HTTP request | Description
  - [SessionResponseDto](doc//SessionResponseDto.md)
  - [SessionUnlockDto](doc//SessionUnlockDto.md)
  - [SessionUpdateDto](doc//SessionUpdateDto.md)
+ - [SetMaintenanceModeDto](doc//SetMaintenanceModeDto.md)
  - [SharedLinkCreateDto](doc//SharedLinkCreateDto.md)
  - [SharedLinkEditDto](doc//SharedLinkEditDto.md)
  - [SharedLinkResponseDto](doc//SharedLinkResponseDto.md)
@@ -600,6 +621,13 @@ Class | Method | HTTP request | Description
  - [VersionCheckStateResponseDto](doc//VersionCheckStateResponseDto.md)
  - [VideoCodec](doc//VideoCodec.md)
  - [VideoContainer](doc//VideoContainer.md)
+ - [WorkflowActionItemDto](doc//WorkflowActionItemDto.md)
+ - [WorkflowActionResponseDto](doc//WorkflowActionResponseDto.md)
+ - [WorkflowCreateDto](doc//WorkflowCreateDto.md)
+ - [WorkflowFilterItemDto](doc//WorkflowFilterItemDto.md)
+ - [WorkflowFilterResponseDto](doc//WorkflowFilterResponseDto.md)
+ - [WorkflowResponseDto](doc//WorkflowResponseDto.md)
+ - [WorkflowUpdateDto](doc//WorkflowUpdateDto.md)
 
 
 ## Documentation For Authorization

mobile/openapi/lib/api.dart

@@ -34,21 +34,22 @@ part 'api/api_keys_api.dart';
 part 'api/activities_api.dart';
 part 'api/albums_api.dart';
 part 'api/assets_api.dart';
-part 'api/auth_admin_api.dart';
 part 'api/authentication_api.dart';
+part 'api/authentication_admin_api.dart';
 part 'api/deprecated_api.dart';
 part 'api/download_api.dart';
 part 'api/duplicates_api.dart';
 part 'api/faces_api.dart';
 part 'api/jobs_api.dart';
 part 'api/libraries_api.dart';
+part 'api/maintenance_admin_api.dart';
 part 'api/map_api.dart';
 part 'api/memories_api.dart';
 part 'api/notifications_api.dart';
 part 'api/notifications_admin_api.dart';
-part 'api/o_auth_api.dart';
 part 'api/partners_api.dart';
 part 'api/people_api.dart';
+part 'api/plugins_api.dart';
 part 'api/search_api.dart';
 part 'api/server_api.dart';
 part 'api/sessions_api.dart';
@@ -62,7 +63,8 @@ part 'api/timeline_api.dart';
 part 'api/trash_api.dart';
 part 'api/users_api.dart';
 part 'api/users_admin_api.dart';
-part 'api/view_api.dart';
+part 'api/views_api.dart';
+part 'api/workflows_api.dart';
 
 part 'model/api_key_create_dto.dart';
 part 'model/api_key_create_response_dto.dart';
@@ -83,7 +85,6 @@ part 'model/albums_add_assets_dto.dart';
 part 'model/albums_add_assets_response_dto.dart';
 part 'model/albums_response.dart';
 part 'model/albums_update.dart';
-part 'model/all_job_status_response_dto.dart';
 part 'model/asset_bulk_delete_dto.dart';
 part 'model/asset_bulk_update_dto.dart';
 part 'model/asset_bulk_upload_check_dto.dart';
@@ -152,13 +153,8 @@ part 'model/facial_recognition_config.dart';
 part 'model/folders_response.dart';
 part 'model/folders_update.dart';
 part 'model/image_format.dart';
-part 'model/job_command.dart';
-part 'model/job_command_dto.dart';
-part 'model/job_counts_dto.dart';
 part 'model/job_create_dto.dart';
-part 'model/job_name.dart';
 part 'model/job_settings_dto.dart';
-part 'model/job_status_dto.dart';
 part 'model/library_response_dto.dart';
 part 'model/library_stats_response_dto.dart';
 part 'model/license_key_dto.dart';
@@ -168,6 +164,9 @@ part 'model/login_credential_dto.dart';
 part 'model/login_response_dto.dart';
 part 'model/logout_response_dto.dart';
 part 'model/machine_learning_availability_checks_dto.dart';
+part 'model/maintenance_action.dart';
+part 'model/maintenance_auth_dto.dart';
+part 'model/maintenance_login_dto.dart';
 part 'model/manual_job_name.dart';
 part 'model/map_marker_response_dto.dart';
 part 'model/map_reverse_geocode_response_dto.dart';
@@ -215,9 +214,20 @@ part 'model/pin_code_change_dto.dart';
 part 'model/pin_code_reset_dto.dart';
 part 'model/pin_code_setup_dto.dart';
 part 'model/places_response_dto.dart';
+part 'model/plugin_action_response_dto.dart';
+part 'model/plugin_context.dart';
+part 'model/plugin_filter_response_dto.dart';
+part 'model/plugin_response_dto.dart';
+part 'model/plugin_trigger_type.dart';
 part 'model/purchase_response.dart';
 part 'model/purchase_update.dart';
+part 'model/queue_command.dart';
+part 'model/queue_command_dto.dart';
+part 'model/queue_name.dart';
+part 'model/queue_response_dto.dart';
+part 'model/queue_statistics_dto.dart';
 part 'model/queue_status_dto.dart';
+part 'model/queues_response_dto.dart';
 part 'model/random_search_dto.dart';
 part 'model/ratings_response.dart';
 part 'model/ratings_update.dart';
@@ -249,6 +259,7 @@ part 'model/session_create_response_dto.dart';
 part 'model/session_response_dto.dart';
 part 'model/session_unlock_dto.dart';
 part 'model/session_update_dto.dart';
+part 'model/set_maintenance_mode_dto.dart';
 part 'model/shared_link_create_dto.dart';
 part 'model/shared_link_edit_dto.dart';
 part 'model/shared_link_response_dto.dart';
@@ -368,6 +379,13 @@ part 'model/validate_library_response_dto.dart';
 part 'model/version_check_state_response_dto.dart';
 part 'model/video_codec.dart';
 part 'model/video_container.dart';
+part 'model/workflow_action_item_dto.dart';
+part 'model/workflow_action_response_dto.dart';
+part 'model/workflow_create_dto.dart';
+part 'model/workflow_filter_item_dto.dart';
+part 'model/workflow_filter_response_dto.dart';
+part 'model/workflow_response_dto.dart';
+part 'model/workflow_update_dto.dart';
 
 
 /// An [ApiClient] instance that uses the default values obtained from

mobile/openapi/lib/api/activities_api.dart

@@ -16,7 +16,9 @@ class ActivitiesApi {
 
   final ApiClient apiClient;
 
-  /// This endpoint requires the `activity.create` permission.
+  /// Create an activity
+  ///
+  /// Create a like or a comment for an album, or an asset in an album.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -48,7 +50,9 @@ class ActivitiesApi {
     );
   }
 
-  /// This endpoint requires the `activity.create` permission.
+  /// Create an activity
+  ///
+  /// Create a like or a comment for an album, or an asset in an album.
   ///
   /// Parameters:
   ///
@@ -68,7 +72,9 @@ class ActivitiesApi {
     return null;
   }
 
-  /// This endpoint requires the `activity.delete` permission.
+  /// Delete an activity
+  ///
+  /// Removes a like or comment from a given album or asset in an album.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -101,7 +107,9 @@ class ActivitiesApi {
     );
   }
 
-  /// This endpoint requires the `activity.delete` permission.
+  /// Delete an activity
+  ///
+  /// Removes a like or comment from a given album or asset in an album.
   ///
   /// Parameters:
   ///
@@ -113,7 +121,9 @@ class ActivitiesApi {
     }
   }
 
-  /// This endpoint requires the `activity.read` permission.
+  /// List all activities
+  ///
+  /// Returns a list of activities for the selected asset or album. The activities are returned in sorted order, with the oldest activities appearing first.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -167,7 +177,9 @@ class ActivitiesApi {
     );
   }
 
-  /// This endpoint requires the `activity.read` permission.
+  /// List all activities
+  ///
+  /// Returns a list of activities for the selected asset or album. The activities are returned in sorted order, with the oldest activities appearing first.
   ///
   /// Parameters:
   ///
@@ -198,7 +210,9 @@ class ActivitiesApi {
     return null;
   }
 
-  /// This endpoint requires the `activity.statistics` permission.
+  /// Retrieve activity statistics
+  ///
+  /// Returns the number of likes and comments for a given album or asset in an album.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -237,7 +251,9 @@ class ActivitiesApi {
     );
   }
 
-  /// This endpoint requires the `activity.statistics` permission.
+  /// Retrieve activity statistics
+  ///
+  /// Returns the number of likes and comments for a given album or asset in an album.
   ///
   /// Parameters:
   ///

mobile/openapi/lib/api/albums_api.dart

@@ -16,7 +16,9 @@ class AlbumsApi {
 
   final ApiClient apiClient;
 
-  /// This endpoint requires the `albumAsset.create` permission.
+  /// Add assets to an album
+  ///
+  /// Add multiple assets to a specific album by its ID.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -62,7 +64,9 @@ class AlbumsApi {
     );
   }
 
-  /// This endpoint requires the `albumAsset.create` permission.
+  /// Add assets to an album
+  ///
+  /// Add multiple assets to a specific album by its ID.
   ///
   /// Parameters:
   ///
@@ -91,7 +95,9 @@ class AlbumsApi {
     return null;
   }
 
-  /// This endpoint requires the `albumAsset.create` permission.
+  /// Add assets to albums
+  ///
+  /// Send a list of asset IDs and album IDs to add each asset to each album.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -134,7 +140,9 @@ class AlbumsApi {
     );
   }
 
-  /// This endpoint requires the `albumAsset.create` permission.
+  /// Add assets to albums
+  ///
+  /// Send a list of asset IDs and album IDs to add each asset to each album.
   ///
   /// Parameters:
   ///
@@ -158,7 +166,9 @@ class AlbumsApi {
     return null;
   }
 
-  /// This endpoint requires the `albumUser.create` permission.
+  /// Share album with users
+  ///
+  /// Share an album with multiple users. Each user can be given a specific role in the album.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -193,7 +203,9 @@ class AlbumsApi {
     );
   }
 
-  /// This endpoint requires the `albumUser.create` permission.
+  /// Share album with users
+  ///
+  /// Share an album with multiple users. Each user can be given a specific role in the album.
   ///
   /// Parameters:
   ///
@@ -215,7 +227,9 @@ class AlbumsApi {
     return null;
   }
 
-  /// This endpoint requires the `album.create` permission.
+  /// Create an album
+  ///
+  /// Create a new album. The album can also be created with initial users and assets.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -247,7 +261,9 @@ class AlbumsApi {
     );
   }
 
-  /// This endpoint requires the `album.create` permission.
+  /// Create an album
+  ///
+  /// Create a new album. The album can also be created with initial users and assets.
   ///
   /// Parameters:
   ///
@@ -267,7 +283,9 @@ class AlbumsApi {
     return null;
   }
 
-  /// This endpoint requires the `album.delete` permission.
+  /// Delete an album
+  ///
+  /// Delete a specific album by its ID. Note the album is initially trashed and then immediately scheduled for deletion, but relies on a background job to complete the process.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -300,7 +318,9 @@ class AlbumsApi {
     );
   }
 
-  /// This endpoint requires the `album.delete` permission.
+  /// Delete an album
+  ///
+  /// Delete a specific album by its ID. Note the album is initially trashed and then immediately scheduled for deletion, but relies on a background job to complete the process.
   ///
   /// Parameters:
   ///
@@ -312,7 +332,9 @@ class AlbumsApi {
     }
   }
 
-  /// This endpoint requires the `album.read` permission.
+  /// Retrieve an album
+  ///
+  /// Retrieve information about a specific album by its ID.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -361,7 +383,9 @@ class AlbumsApi {
     );
   }
 
-  /// This endpoint requires the `album.read` permission.
+  /// Retrieve an album
+  ///
+  /// Retrieve information about a specific album by its ID.
   ///
   /// Parameters:
   ///
@@ -387,7 +411,9 @@ class AlbumsApi {
     return null;
   }
 
-  /// This endpoint requires the `album.statistics` permission.
+  /// Retrieve album statistics
+  ///
+  /// Returns statistics about the albums available to the authenticated user.
   ///
   /// Note: This method returns the HTTP [Response].
   Future<Response> getAlbumStatisticsWithHttpInfo() async {
@@ -415,7 +441,9 @@ class AlbumsApi {
     );
   }
 
-  /// This endpoint requires the `album.statistics` permission.
+  /// Retrieve album statistics
+  ///
+  /// Returns statistics about the albums available to the authenticated user.
   Future<AlbumStatisticsResponseDto?> getAlbumStatistics() async {
     final response = await getAlbumStatisticsWithHttpInfo();
     if (response.statusCode >= HttpStatus.badRequest) {
@@ -431,7 +459,9 @@ class AlbumsApi {
     return null;
   }
 
-  /// This endpoint requires the `album.read` permission.
+  /// List all albums
+  ///
+  /// Retrieve a list of albums available to the authenticated user.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -473,7 +503,9 @@ class AlbumsApi {
     );
   }
 
-  /// This endpoint requires the `album.read` permission.
+  /// List all albums
+  ///
+  /// Retrieve a list of albums available to the authenticated user.
   ///
   /// Parameters:
   ///
@@ -499,7 +531,9 @@ class AlbumsApi {
     return null;
   }
 
-  /// This endpoint requires the `albumAsset.delete` permission.
+  /// Remove assets from an album
+  ///
+  /// Remove multiple assets from a specific album by its ID.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -534,7 +568,9 @@ class AlbumsApi {
     );
   }
 
-  /// This endpoint requires the `albumAsset.delete` permission.
+  /// Remove assets from an album
+  ///
+  /// Remove multiple assets from a specific album by its ID.
   ///
   /// Parameters:
   ///
@@ -559,7 +595,9 @@ class AlbumsApi {
     return null;
   }
 
-  /// This endpoint requires the `albumUser.delete` permission.
+  /// Remove user from album
+  ///
+  /// Remove a user from an album. Use an ID of \"me\" to leave a shared album.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -595,7 +633,9 @@ class AlbumsApi {
     );
   }
 
-  /// This endpoint requires the `albumUser.delete` permission.
+  /// Remove user from album
+  ///
+  /// Remove a user from an album. Use an ID of \"me\" to leave a shared album.
   ///
   /// Parameters:
   ///
@@ -609,7 +649,9 @@ class AlbumsApi {
     }
   }
 
-  /// This endpoint requires the `album.update` permission.
+  /// Update an album
+  ///
+  /// Update the information of a specific album by its ID. This endpoint can be used to update the album name, description, sort order, etc. However, it is not used to add or remove assets or users from the album.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -644,7 +686,9 @@ class AlbumsApi {
     );
   }
 
-  /// This endpoint requires the `album.update` permission.
+  /// Update an album
+  ///
+  /// Update the information of a specific album by its ID. This endpoint can be used to update the album name, description, sort order, etc. However, it is not used to add or remove assets or users from the album.
   ///
   /// Parameters:
   ///
@@ -666,7 +710,9 @@ class AlbumsApi {
     return null;
   }
 
-  /// This endpoint requires the `albumUser.update` permission.
+  /// Update user role
+  ///
+  /// Change the role for a specific user in a specific album.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -704,7 +750,9 @@ class AlbumsApi {
     );
   }
 
-  /// This endpoint requires the `albumUser.update` permission.
+  /// Update user role
+  ///
+  /// Change the role for a specific user in a specific album.
   ///
   /// Parameters:
   ///

mobile/openapi/lib/api/api_keys_api.dart

@@ -16,7 +16,9 @@ class APIKeysApi {
 
   final ApiClient apiClient;
 
-  /// This endpoint requires the `apiKey.create` permission.
+  /// Create an API key
+  ///
+  /// Creates a new API key. It will be limited to the permissions specified.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -48,7 +50,9 @@ class APIKeysApi {
     );
   }
 
-  /// This endpoint requires the `apiKey.create` permission.
+  /// Create an API key
+  ///
+  /// Creates a new API key. It will be limited to the permissions specified.
   ///
   /// Parameters:
   ///
@@ -68,7 +72,9 @@ class APIKeysApi {
     return null;
   }
 
-  /// This endpoint requires the `apiKey.delete` permission.
+  /// Delete an API key
+  ///
+  /// Deletes an API key identified by its ID. The current user must own this API key.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -101,7 +107,9 @@ class APIKeysApi {
     );
   }
 
-  /// This endpoint requires the `apiKey.delete` permission.
+  /// Delete an API key
+  ///
+  /// Deletes an API key identified by its ID. The current user must own this API key.
   ///
   /// Parameters:
   ///
@@ -113,7 +121,9 @@ class APIKeysApi {
     }
   }
 
-  /// This endpoint requires the `apiKey.read` permission.
+  /// Retrieve an API key
+  ///
+  /// Retrieve an API key by its ID. The current user must own this API key.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -146,7 +156,9 @@ class APIKeysApi {
     );
   }
 
-  /// This endpoint requires the `apiKey.read` permission.
+  /// Retrieve an API key
+  ///
+  /// Retrieve an API key by its ID. The current user must own this API key.
   ///
   /// Parameters:
   ///
@@ -166,7 +178,9 @@ class APIKeysApi {
     return null;
   }
 
-  /// This endpoint requires the `apiKey.read` permission.
+  /// List all API keys
+  ///
+  /// Retrieve all API keys of the current user.
   ///
   /// Note: This method returns the HTTP [Response].
   Future<Response> getApiKeysWithHttpInfo() async {
@@ -194,7 +208,9 @@ class APIKeysApi {
     );
   }
 
-  /// This endpoint requires the `apiKey.read` permission.
+  /// List all API keys
+  ///
+  /// Retrieve all API keys of the current user.
   Future<List<APIKeyResponseDto>?> getApiKeys() async {
     final response = await getApiKeysWithHttpInfo();
     if (response.statusCode >= HttpStatus.badRequest) {
@@ -213,7 +229,11 @@ class APIKeysApi {
     return null;
   }
 
-  /// Performs an HTTP 'GET /api-keys/me' operation and returns the [Response].
+  /// Retrieve the current API key
+  ///
+  /// Retrieve the API key that is used to access this endpoint.
+  ///
+  /// Note: This method returns the HTTP [Response].
   Future<Response> getMyApiKeyWithHttpInfo() async {
     // ignore: prefer_const_declarations
     final apiPath = r'/api-keys/me';
@@ -239,6 +259,9 @@ class APIKeysApi {
     );
   }
 
+  /// Retrieve the current API key
+  ///
+  /// Retrieve the API key that is used to access this endpoint.
   Future<APIKeyResponseDto?> getMyApiKey() async {
     final response = await getMyApiKeyWithHttpInfo();
     if (response.statusCode >= HttpStatus.badRequest) {
@@ -254,7 +277,9 @@ class APIKeysApi {
     return null;
   }
 
-  /// This endpoint requires the `apiKey.update` permission.
+  /// Update an API key
+  ///
+  /// Updates the name and permissions of an API key by its ID. The current user must own this API key.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -289,7 +314,9 @@ class APIKeysApi {
     );
   }
 
-  /// This endpoint requires the `apiKey.update` permission.
+  /// Update an API key
+  ///
+  /// Updates the name and permissions of an API key by its ID. The current user must own this API key.
   ///
   /// Parameters:
   ///

mobile/openapi/lib/api/assets_api.dart

@@ -16,9 +16,9 @@ class AssetsApi {
 
   final ApiClient apiClient;
 
-  /// checkBulkUpload
+  /// Check bulk upload
   ///
-  /// Checks if assets exist by checksums. This endpoint requires the `asset.upload` permission.
+  /// Determine which assets have already been uploaded to the server based on their SHA1 checksums.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -50,9 +50,9 @@ class AssetsApi {
     );
   }
 
-  /// checkBulkUpload
+  /// Check bulk upload
   ///
-  /// Checks if assets exist by checksums. This endpoint requires the `asset.upload` permission.
+  /// Determine which assets have already been uploaded to the server based on their SHA1 checksums.
   ///
   /// Parameters:
   ///
@@ -72,7 +72,7 @@ class AssetsApi {
     return null;
   }
 
-  /// checkExistingAssets
+  /// Check existing assets
   ///
   /// Checks if multiple assets exist on the server and returns all existing - used by background backup
   ///
@@ -106,7 +106,7 @@ class AssetsApi {
     );
   }
 
-  /// checkExistingAssets
+  /// Check existing assets
   ///
   /// Checks if multiple assets exist on the server and returns all existing - used by background backup
   ///
@@ -128,7 +128,9 @@ class AssetsApi {
     return null;
   }
 
-  /// This endpoint requires the `asset.copy` permission.
+  /// Copy asset
+  ///
+  /// Copy asset information like albums, tags, etc. from one asset to another.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -160,7 +162,9 @@ class AssetsApi {
     );
   }
 
-  /// This endpoint requires the `asset.copy` permission.
+  /// Copy asset
+  ///
+  /// Copy asset information like albums, tags, etc. from one asset to another.
   ///
   /// Parameters:
   ///
@@ -172,7 +176,9 @@ class AssetsApi {
     }
   }
 
-  /// This endpoint requires the `asset.update` permission.
+  /// Delete asset metadata by key
+  ///
+  /// Delete a specific metadata key-value pair associated with the specified asset.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -208,7 +214,9 @@ class AssetsApi {
     );
   }
 
-  /// This endpoint requires the `asset.update` permission.
+  /// Delete asset metadata by key
+  ///
+  /// Delete a specific metadata key-value pair associated with the specified asset.
   ///
   /// Parameters:
   ///
@@ -222,7 +230,9 @@ class AssetsApi {
     }
   }
 
-  /// This endpoint requires the `asset.delete` permission.
+  /// Delete assets
+  ///
+  /// Deletes multiple assets at the same time.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -254,7 +264,9 @@ class AssetsApi {
     );
   }
 
-  /// This endpoint requires the `asset.delete` permission.
+  /// Delete assets
+  ///
+  /// Deletes multiple assets at the same time.
   ///
   /// Parameters:
   ///
@@ -266,7 +278,9 @@ class AssetsApi {
     }
   }
 
-  /// This endpoint requires the `asset.download` permission.
+  /// Download original asset
+  ///
+  /// Downloads the original file of the specified asset.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -310,7 +324,9 @@ class AssetsApi {
     );
   }
 
-  /// This endpoint requires the `asset.download` permission.
+  /// Download original asset
+  ///
+  /// Downloads the original file of the specified asset.
   ///
   /// Parameters:
   ///
@@ -334,7 +350,7 @@ class AssetsApi {
     return null;
   }
 
-  /// getAllUserAssetsByDeviceId
+  /// Retrieve assets by device ID
   ///
   /// Get all asset of a device that are in the database, ID only.
   ///
@@ -369,7 +385,7 @@ class AssetsApi {
     );
   }
 
-  /// getAllUserAssetsByDeviceId
+  /// Retrieve assets by device ID
   ///
   /// Get all asset of a device that are in the database, ID only.
   ///
@@ -394,7 +410,9 @@ class AssetsApi {
     return null;
   }
 
-  /// This endpoint requires the `asset.read` permission.
+  /// Retrieve an asset
+  ///
+  /// Retrieve detailed information about a specific asset.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -438,7 +456,9 @@ class AssetsApi {
     );
   }
 
-  /// This endpoint requires the `asset.read` permission.
+  /// Retrieve an asset
+  ///
+  /// Retrieve detailed information about a specific asset.
   ///
   /// Parameters:
   ///
@@ -462,7 +482,9 @@ class AssetsApi {
     return null;
   }
 
-  /// This endpoint requires the `asset.read` permission.
+  /// Get asset metadata
+  ///
+  /// Retrieve all metadata key-value pairs associated with the specified asset.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -495,7 +517,9 @@ class AssetsApi {
     );
   }
 
-  /// This endpoint requires the `asset.read` permission.
+  /// Get asset metadata
+  ///
+  /// Retrieve all metadata key-value pairs associated with the specified asset.
   ///
   /// Parameters:
   ///
@@ -518,7 +542,9 @@ class AssetsApi {
     return null;
   }
 
-  /// This endpoint requires the `asset.read` permission.
+  /// Retrieve asset metadata by key
+  ///
+  /// Retrieve the value of a specific metadata key associated with the specified asset.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -554,7 +580,9 @@ class AssetsApi {
     );
   }
 
-  /// This endpoint requires the `asset.read` permission.
+  /// Retrieve asset metadata by key
+  ///
+  /// Retrieve the value of a specific metadata key associated with the specified asset.
   ///
   /// Parameters:
   ///
@@ -576,7 +604,9 @@ class AssetsApi {
     return null;
   }
 
-  /// This endpoint requires the `asset.read` permission.
+  /// Retrieve asset OCR data
+  ///
+  /// Retrieve all OCR (Optical Character Recognition) data associated with the specified asset.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -609,7 +639,9 @@ class AssetsApi {
     );
   }
 
-  /// This endpoint requires the `asset.read` permission.
+  /// Retrieve asset OCR data
+  ///
+  /// Retrieve all OCR (Optical Character Recognition) data associated with the specified asset.
   ///
   /// Parameters:
   ///
@@ -632,7 +664,9 @@ class AssetsApi {
     return null;
   }
 
-  /// This endpoint requires the `asset.statistics` permission.
+  /// Get asset statistics
+  ///
+  /// Retrieve various statistics about the assets owned by the authenticated user.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -678,7 +712,9 @@ class AssetsApi {
     );
   }
 
-  /// This endpoint requires the `asset.statistics` permission.
+  /// Get asset statistics
+  ///
+  /// Retrieve various statistics about the assets owned by the authenticated user.
   ///
   /// Parameters:
   ///
@@ -702,7 +738,9 @@ class AssetsApi {
     return null;
   }
 
-  /// This property was deprecated in v1.116.0. This endpoint requires the `asset.read` permission.
+  /// Get random assets
+  ///
+  /// Retrieve a specified number of random assets for the authenticated user.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -738,7 +776,9 @@ class AssetsApi {
     );
   }
 
-  /// This property was deprecated in v1.116.0. This endpoint requires the `asset.read` permission.
+  /// Get random assets
+  ///
+  /// Retrieve a specified number of random assets for the authenticated user.
   ///
   /// Parameters:
   ///
@@ -761,7 +801,9 @@ class AssetsApi {
     return null;
   }
 
-  /// This endpoint requires the `asset.view` permission.
+  /// Play asset video
+  ///
+  /// Streams the video file for the specified asset. This endpoint also supports byte range requests.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -805,7 +847,9 @@ class AssetsApi {
     );
   }
 
-  /// This endpoint requires the `asset.view` permission.
+  /// Play asset video
+  ///
+  /// Streams the video file for the specified asset. This endpoint also supports byte range requests.
   ///
   /// Parameters:
   ///
@@ -829,9 +873,9 @@ class AssetsApi {
     return null;
   }
 
-  /// Replace the asset with new file, without changing its id
+  /// Replace asset
   ///
-  /// This property was deprecated in v1.142.0. Replace the asset with new file, without changing its id. This endpoint requires the `asset.replace` permission.
+  /// Replace the asset with new file, without changing its id.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -923,9 +967,9 @@ class AssetsApi {
     );
   }
 
-  /// Replace the asset with new file, without changing its id
+  /// Replace asset
   ///
-  /// This property was deprecated in v1.142.0. Replace the asset with new file, without changing its id. This endpoint requires the `asset.replace` permission.
+  /// Replace the asset with new file, without changing its id.
   ///
   /// Parameters:
   ///
@@ -963,7 +1007,12 @@ class AssetsApi {
     return null;
   }
 
-  /// Performs an HTTP 'POST /assets/jobs' operation and returns the [Response].
+  /// Run an asset job
+  ///
+  /// Run a specific job on a set of assets.
+  ///
+  /// Note: This method returns the HTTP [Response].
+  ///
   /// Parameters:
   ///
   /// * [AssetJobsDto] assetJobsDto (required):
@@ -992,6 +1041,10 @@ class AssetsApi {
     );
   }
 
+  /// Run an asset job
+  ///
+  /// Run a specific job on a set of assets.
+  ///
   /// Parameters:
   ///
   /// * [AssetJobsDto] assetJobsDto (required):
@@ -1002,7 +1055,9 @@ class AssetsApi {
     }
   }
 
-  /// This endpoint requires the `asset.update` permission.
+  /// Update an asset
+  ///
+  /// Update information of a specific asset.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -1037,7 +1092,9 @@ class AssetsApi {
     );
   }
 
-  /// This endpoint requires the `asset.update` permission.
+  /// Update an asset
+  ///
+  /// Update information of a specific asset.
   ///
   /// Parameters:
   ///
@@ -1059,7 +1116,9 @@ class AssetsApi {
     return null;
   }
 
-  /// This endpoint requires the `asset.update` permission.
+  /// Update asset metadata
+  ///
+  /// Update or add metadata key-value pairs for the specified asset.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -1094,7 +1153,9 @@ class AssetsApi {
     );
   }
 
-  /// This endpoint requires the `asset.update` permission.
+  /// Update asset metadata
+  ///
+  /// Update or add metadata key-value pairs for the specified asset.
   ///
   /// Parameters:
   ///
@@ -1119,7 +1180,9 @@ class AssetsApi {
     return null;
   }
 
-  /// This endpoint requires the `asset.update` permission.
+  /// Update assets
+  ///
+  /// Updates multiple assets at the same time.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -1151,7 +1214,9 @@ class AssetsApi {
     );
   }
 
-  /// This endpoint requires the `asset.update` permission.
+  /// Update assets
+  ///
+  /// Updates multiple assets at the same time.
   ///
   /// Parameters:
   ///
@@ -1163,7 +1228,9 @@ class AssetsApi {
     }
   }
 
-  /// This endpoint requires the `asset.upload` permission.
+  /// Upload asset
+  ///
+  /// Uploads a new asset to the server.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -1290,7 +1357,9 @@ class AssetsApi {
     );
   }
 
-  /// This endpoint requires the `asset.upload` permission.
+  /// Upload asset
+  ///
+  /// Uploads a new asset to the server.
   ///
   /// Parameters:
   ///
@@ -1339,7 +1408,9 @@ class AssetsApi {
     return null;
   }
 
-  /// This endpoint requires the `asset.view` permission.
+  /// View asset thumbnail
+  ///
+  /// Retrieve the thumbnail image for the specified asset.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -1388,7 +1459,9 @@ class AssetsApi {
     );
   }
 
-  /// This endpoint requires the `asset.view` permission.
+  /// View asset thumbnail
+  ///
+  /// Retrieve the thumbnail image for the specified asset.
   ///
   /// Parameters:
   ///

mobile/openapi/lib/api/authentication_admin_api.dart

@@ -11,12 +11,14 @@
 part of openapi.api;
 
 
-class AuthAdminApi {
-  AuthAdminApi([ApiClient? apiClient]) : apiClient = apiClient ?? defaultApiClient;
+class AuthenticationAdminApi {
+  AuthenticationAdminApi([ApiClient? apiClient]) : apiClient = apiClient ?? defaultApiClient;
 
   final ApiClient apiClient;
 
-  /// This endpoint is an admin-only route, and requires the `adminAuth.unlinkAll` permission.
+  /// Unlink all OAuth accounts
+  ///
+  /// Unlinks all OAuth accounts associated with user accounts in the system.
   ///
   /// Note: This method returns the HTTP [Response].
   Future<Response> unlinkAllOAuthAccountsAdminWithHttpInfo() async {
@@ -44,7 +46,9 @@ class AuthAdminApi {
     );
   }
 
-  /// This endpoint is an admin-only route, and requires the `adminAuth.unlinkAll` permission.
+  /// Unlink all OAuth accounts
+  ///
+  /// Unlinks all OAuth accounts associated with user accounts in the system.
   Future<void> unlinkAllOAuthAccountsAdmin() async {
     final response = await unlinkAllOAuthAccountsAdminWithHttpInfo();
     if (response.statusCode >= HttpStatus.badRequest) {

mobile/openapi/lib/api/authentication_api.dart

@@ -16,7 +16,9 @@ class AuthenticationApi {
 
   final ApiClient apiClient;
 
-  /// This endpoint requires the `auth.changePassword` permission.
+  /// Change password
+  ///
+  /// Change the password of the current user.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -48,7 +50,9 @@ class AuthenticationApi {
     );
   }
 
-  /// This endpoint requires the `auth.changePassword` permission.
+  /// Change password
+  ///
+  /// Change the password of the current user.
   ///
   /// Parameters:
   ///
@@ -68,7 +72,9 @@ class AuthenticationApi {
     return null;
   }
 
-  /// This endpoint requires the `pinCode.update` permission.
+  /// Change pin code
+  ///
+  /// Change the pin code for the current user.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -100,7 +106,9 @@ class AuthenticationApi {
     );
   }
 
-  /// This endpoint requires the `pinCode.update` permission.
+  /// Change pin code
+  ///
+  /// Change the pin code for the current user.
   ///
   /// Parameters:
   ///
@@ -112,7 +120,67 @@ class AuthenticationApi {
     }
   }
 
-  /// Performs an HTTP 'GET /auth/status' operation and returns the [Response].
+  /// Finish OAuth
+  ///
+  /// Complete the OAuth authorization process by exchanging the authorization code for a session token.
+  ///
+  /// Note: This method returns the HTTP [Response].
+  ///
+  /// Parameters:
+  ///
+  /// * [OAuthCallbackDto] oAuthCallbackDto (required):
+  Future<Response> finishOAuthWithHttpInfo(OAuthCallbackDto oAuthCallbackDto,) async {
+    // ignore: prefer_const_declarations
+    final apiPath = r'/oauth/callback';
+
+    // ignore: prefer_final_locals
+    Object? postBody = oAuthCallbackDto;
+
+    final queryParams = <QueryParam>[];
+    final headerParams = <String, String>{};
+    final formParams = <String, String>{};
+
+    const contentTypes = <String>['application/json'];
+
+
+    return apiClient.invokeAPI(
+      apiPath,
+      'POST',
+      queryParams,
+      postBody,
+      headerParams,
+      formParams,
+      contentTypes.isEmpty ? null : contentTypes.first,
+    );
+  }
+
+  /// Finish OAuth
+  ///
+  /// Complete the OAuth authorization process by exchanging the authorization code for a session token.
+  ///
+  /// Parameters:
+  ///
+  /// * [OAuthCallbackDto] oAuthCallbackDto (required):
+  Future<LoginResponseDto?> finishOAuth(OAuthCallbackDto oAuthCallbackDto,) async {
+    final response = await finishOAuthWithHttpInfo(oAuthCallbackDto,);
+    if (response.statusCode >= HttpStatus.badRequest) {
+      throw ApiException(response.statusCode, await _decodeBodyBytes(response));
+    }
+    // When a remote server returns no body with a status of 204, we shall not decode it.
+    // At the time of writing this, `dart:convert` will throw an "Unexpected end of input"
+    // FormatException when trying to decode an empty string.
+    if (response.body.isNotEmpty && response.statusCode != HttpStatus.noContent) {
+      return await apiClient.deserializeAsync(await _decodeBodyBytes(response), 'LoginResponseDto',) as LoginResponseDto;
+    
+    }
+    return null;
+  }
+
+  /// Retrieve auth status
+  ///
+  /// Get information about the current session, including whether the user has a password, and if the session can access locked assets.
+  ///
+  /// Note: This method returns the HTTP [Response].
   Future<Response> getAuthStatusWithHttpInfo() async {
     // ignore: prefer_const_declarations
     final apiPath = r'/auth/status';
@@ -138,6 +206,9 @@ class AuthenticationApi {
     );
   }
 
+  /// Retrieve auth status
+  ///
+  /// Get information about the current session, including whether the user has a password, and if the session can access locked assets.
   Future<AuthStatusResponseDto?> getAuthStatus() async {
     final response = await getAuthStatusWithHttpInfo();
     if (response.statusCode >= HttpStatus.badRequest) {
@@ -153,7 +224,67 @@ class AuthenticationApi {
     return null;
   }
 
-  /// Performs an HTTP 'POST /auth/session/lock' operation and returns the [Response].
+  /// Link OAuth account
+  ///
+  /// Link an OAuth account to the authenticated user.
+  ///
+  /// Note: This method returns the HTTP [Response].
+  ///
+  /// Parameters:
+  ///
+  /// * [OAuthCallbackDto] oAuthCallbackDto (required):
+  Future<Response> linkOAuthAccountWithHttpInfo(OAuthCallbackDto oAuthCallbackDto,) async {
+    // ignore: prefer_const_declarations
+    final apiPath = r'/oauth/link';
+
+    // ignore: prefer_final_locals
+    Object? postBody = oAuthCallbackDto;
+
+    final queryParams = <QueryParam>[];
+    final headerParams = <String, String>{};
+    final formParams = <String, String>{};
+
+    const contentTypes = <String>['application/json'];
+
+
+    return apiClient.invokeAPI(
+      apiPath,
+      'POST',
+      queryParams,
+      postBody,
+      headerParams,
+      formParams,
+      contentTypes.isEmpty ? null : contentTypes.first,
+    );
+  }
+
+  /// Link OAuth account
+  ///
+  /// Link an OAuth account to the authenticated user.
+  ///
+  /// Parameters:
+  ///
+  /// * [OAuthCallbackDto] oAuthCallbackDto (required):
+  Future<UserAdminResponseDto?> linkOAuthAccount(OAuthCallbackDto oAuthCallbackDto,) async {
+    final response = await linkOAuthAccountWithHttpInfo(oAuthCallbackDto,);
+    if (response.statusCode >= HttpStatus.badRequest) {
+      throw ApiException(response.statusCode, await _decodeBodyBytes(response));
+    }
+    // When a remote server returns no body with a status of 204, we shall not decode it.
+    // At the time of writing this, `dart:convert` will throw an "Unexpected end of input"
+    // FormatException when trying to decode an empty string.
+    if (response.body.isNotEmpty && response.statusCode != HttpStatus.noContent) {
+      return await apiClient.deserializeAsync(await _decodeBodyBytes(response), 'UserAdminResponseDto',) as UserAdminResponseDto;
+    
+    }
+    return null;
+  }
+
+  /// Lock auth session
+  ///
+  /// Remove elevated access to locked assets from the current session.
+  ///
+  /// Note: This method returns the HTTP [Response].
   Future<Response> lockAuthSessionWithHttpInfo() async {
     // ignore: prefer_const_declarations
     final apiPath = r'/auth/session/lock';
@@ -179,6 +310,9 @@ class AuthenticationApi {
     );
   }
 
+  /// Lock auth session
+  ///
+  /// Remove elevated access to locked assets from the current session.
   Future<void> lockAuthSession() async {
     final response = await lockAuthSessionWithHttpInfo();
     if (response.statusCode >= HttpStatus.badRequest) {
@@ -186,7 +320,12 @@ class AuthenticationApi {
     }
   }
 
-  /// Performs an HTTP 'POST /auth/login' operation and returns the [Response].
+  /// Login
+  ///
+  /// Login with username and password and receive a session token.
+  ///
+  /// Note: This method returns the HTTP [Response].
+  ///
   /// Parameters:
   ///
   /// * [LoginCredentialDto] loginCredentialDto (required):
@@ -215,6 +354,10 @@ class AuthenticationApi {
     );
   }
 
+  /// Login
+  ///
+  /// Login with username and password and receive a session token.
+  ///
   /// Parameters:
   ///
   /// * [LoginCredentialDto] loginCredentialDto (required):
@@ -233,7 +376,11 @@ class AuthenticationApi {
     return null;
   }
 
-  /// Performs an HTTP 'POST /auth/logout' operation and returns the [Response].
+  /// Logout
+  ///
+  /// Logout the current user and invalidate the session token.
+  ///
+  /// Note: This method returns the HTTP [Response].
   Future<Response> logoutWithHttpInfo() async {
     // ignore: prefer_const_declarations
     final apiPath = r'/auth/logout';
@@ -259,6 +406,9 @@ class AuthenticationApi {
     );
   }
 
+  /// Logout
+  ///
+  /// Logout the current user and invalidate the session token.
   Future<LogoutResponseDto?> logout() async {
     final response = await logoutWithHttpInfo();
     if (response.statusCode >= HttpStatus.badRequest) {
@@ -274,7 +424,49 @@ class AuthenticationApi {
     return null;
   }
 
-  /// This endpoint requires the `pinCode.delete` permission.
+  /// Redirect OAuth to mobile
+  ///
+  /// Requests to this URL are automatically forwarded to the mobile app, and is used in some cases for OAuth redirecting.
+  ///
+  /// Note: This method returns the HTTP [Response].
+  Future<Response> redirectOAuthToMobileWithHttpInfo() async {
+    // ignore: prefer_const_declarations
+    final apiPath = r'/oauth/mobile-redirect';
+
+    // ignore: prefer_final_locals
+    Object? postBody;
+
+    final queryParams = <QueryParam>[];
+    final headerParams = <String, String>{};
+    final formParams = <String, String>{};
+
+    const contentTypes = <String>[];
+
+
+    return apiClient.invokeAPI(
+      apiPath,
+      'GET',
+      queryParams,
+      postBody,
+      headerParams,
+      formParams,
+      contentTypes.isEmpty ? null : contentTypes.first,
+    );
+  }
+
+  /// Redirect OAuth to mobile
+  ///
+  /// Requests to this URL are automatically forwarded to the mobile app, and is used in some cases for OAuth redirecting.
+  Future<void> redirectOAuthToMobile() async {
+    final response = await redirectOAuthToMobileWithHttpInfo();
+    if (response.statusCode >= HttpStatus.badRequest) {
+      throw ApiException(response.statusCode, await _decodeBodyBytes(response));
+    }
+  }
+
+  /// Reset pin code
+  ///
+  /// Reset the pin code for the current user by providing the account password
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -306,7 +498,9 @@ class AuthenticationApi {
     );
   }
 
-  /// This endpoint requires the `pinCode.delete` permission.
+  /// Reset pin code
+  ///
+  /// Reset the pin code for the current user by providing the account password
   ///
   /// Parameters:
   ///
@@ -318,7 +512,9 @@ class AuthenticationApi {
     }
   }
 
-  /// This endpoint requires the `pinCode.create` permission.
+  /// Setup pin code
+  ///
+  /// Setup a new pin code for the current user.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -350,7 +546,9 @@ class AuthenticationApi {
     );
   }
 
-  /// This endpoint requires the `pinCode.create` permission.
+  /// Setup pin code
+  ///
+  /// Setup a new pin code for the current user.
   ///
   /// Parameters:
   ///
@@ -362,7 +560,12 @@ class AuthenticationApi {
     }
   }
 
-  /// Performs an HTTP 'POST /auth/admin-sign-up' operation and returns the [Response].
+  /// Register admin
+  ///
+  /// Create the first admin user in the system.
+  ///
+  /// Note: This method returns the HTTP [Response].
+  ///
   /// Parameters:
   ///
   /// * [SignUpDto] signUpDto (required):
@@ -391,6 +594,10 @@ class AuthenticationApi {
     );
   }
 
+  /// Register admin
+  ///
+  /// Create the first admin user in the system.
+  ///
   /// Parameters:
   ///
   /// * [SignUpDto] signUpDto (required):
@@ -409,7 +616,116 @@ class AuthenticationApi {
     return null;
   }
 
-  /// Performs an HTTP 'POST /auth/session/unlock' operation and returns the [Response].
+  /// Start OAuth
+  ///
+  /// Initiate the OAuth authorization process.
+  ///
+  /// Note: This method returns the HTTP [Response].
+  ///
+  /// Parameters:
+  ///
+  /// * [OAuthConfigDto] oAuthConfigDto (required):
+  Future<Response> startOAuthWithHttpInfo(OAuthConfigDto oAuthConfigDto,) async {
+    // ignore: prefer_const_declarations
+    final apiPath = r'/oauth/authorize';
+
+    // ignore: prefer_final_locals
+    Object? postBody = oAuthConfigDto;
+
+    final queryParams = <QueryParam>[];
+    final headerParams = <String, String>{};
+    final formParams = <String, String>{};
+
+    const contentTypes = <String>['application/json'];
+
+
+    return apiClient.invokeAPI(
+      apiPath,
+      'POST',
+      queryParams,
+      postBody,
+      headerParams,
+      formParams,
+      contentTypes.isEmpty ? null : contentTypes.first,
+    );
+  }
+
+  /// Start OAuth
+  ///
+  /// Initiate the OAuth authorization process.
+  ///
+  /// Parameters:
+  ///
+  /// * [OAuthConfigDto] oAuthConfigDto (required):
+  Future<OAuthAuthorizeResponseDto?> startOAuth(OAuthConfigDto oAuthConfigDto,) async {
+    final response = await startOAuthWithHttpInfo(oAuthConfigDto,);
+    if (response.statusCode >= HttpStatus.badRequest) {
+      throw ApiException(response.statusCode, await _decodeBodyBytes(response));
+    }
+    // When a remote server returns no body with a status of 204, we shall not decode it.
+    // At the time of writing this, `dart:convert` will throw an "Unexpected end of input"
+    // FormatException when trying to decode an empty string.
+    if (response.body.isNotEmpty && response.statusCode != HttpStatus.noContent) {
+      return await apiClient.deserializeAsync(await _decodeBodyBytes(response), 'OAuthAuthorizeResponseDto',) as OAuthAuthorizeResponseDto;
+    
+    }
+    return null;
+  }
+
+  /// Unlink OAuth account
+  ///
+  /// Unlink the OAuth account from the authenticated user.
+  ///
+  /// Note: This method returns the HTTP [Response].
+  Future<Response> unlinkOAuthAccountWithHttpInfo() async {
+    // ignore: prefer_const_declarations
+    final apiPath = r'/oauth/unlink';
+
+    // ignore: prefer_final_locals
+    Object? postBody;
+
+    final queryParams = <QueryParam>[];
+    final headerParams = <String, String>{};
+    final formParams = <String, String>{};
+
+    const contentTypes = <String>[];
+
+
+    return apiClient.invokeAPI(
+      apiPath,
+      'POST',
+      queryParams,
+      postBody,
+      headerParams,
+      formParams,
+      contentTypes.isEmpty ? null : contentTypes.first,
+    );
+  }
+
+  /// Unlink OAuth account
+  ///
+  /// Unlink the OAuth account from the authenticated user.
+  Future<UserAdminResponseDto?> unlinkOAuthAccount() async {
+    final response = await unlinkOAuthAccountWithHttpInfo();
+    if (response.statusCode >= HttpStatus.badRequest) {
+      throw ApiException(response.statusCode, await _decodeBodyBytes(response));
+    }
+    // When a remote server returns no body with a status of 204, we shall not decode it.
+    // At the time of writing this, `dart:convert` will throw an "Unexpected end of input"
+    // FormatException when trying to decode an empty string.
+    if (response.body.isNotEmpty && response.statusCode != HttpStatus.noContent) {
+      return await apiClient.deserializeAsync(await _decodeBodyBytes(response), 'UserAdminResponseDto',) as UserAdminResponseDto;
+    
+    }
+    return null;
+  }
+
+  /// Unlock auth session
+  ///
+  /// Temporarily grant the session elevated access to locked assets by providing the correct PIN code.
+  ///
+  /// Note: This method returns the HTTP [Response].
+  ///
   /// Parameters:
   ///
   /// * [SessionUnlockDto] sessionUnlockDto (required):
@@ -438,6 +754,10 @@ class AuthenticationApi {
     );
   }
 
+  /// Unlock auth session
+  ///
+  /// Temporarily grant the session elevated access to locked assets by providing the correct PIN code.
+  ///
   /// Parameters:
   ///
   /// * [SessionUnlockDto] sessionUnlockDto (required):
@@ -448,7 +768,11 @@ class AuthenticationApi {
     }
   }
 
-  /// Performs an HTTP 'POST /auth/validateToken' operation and returns the [Response].
+  /// Validate access token
+  ///
+  /// Validate the current authorization method is still valid.
+  ///
+  /// Note: This method returns the HTTP [Response].
   Future<Response> validateAccessTokenWithHttpInfo() async {
     // ignore: prefer_const_declarations
     final apiPath = r'/auth/validateToken';
@@ -474,6 +798,9 @@ class AuthenticationApi {
     );
   }
 
+  /// Validate access token
+  ///
+  /// Validate the current authorization method is still valid.
   Future<ValidateAccessTokenResponseDto?> validateAccessToken() async {
     final response = await validateAccessTokenWithHttpInfo();
     if (response.statusCode >= HttpStatus.badRequest) {

mobile/openapi/lib/api/deprecated_api.dart

@@ -16,7 +16,9 @@ class DeprecatedApi {
 
   final ApiClient apiClient;
 
-  /// This property was deprecated in v1.141.0. This endpoint requires the `partner.create` permission.
+  /// Create a partner
+  ///
+  /// Create a new partner to share assets with.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -49,7 +51,9 @@ class DeprecatedApi {
     );
   }
 
-  /// This property was deprecated in v1.141.0. This endpoint requires the `partner.create` permission.
+  /// Create a partner
+  ///
+  /// Create a new partner to share assets with.
   ///
   /// Parameters:
   ///
@@ -69,7 +73,184 @@ class DeprecatedApi {
     return null;
   }
 
-  /// This property was deprecated in v1.116.0. This endpoint requires the `asset.read` permission.
+  /// Retrieve assets by device ID
+  ///
+  /// Get all asset of a device that are in the database, ID only.
+  ///
+  /// Note: This method returns the HTTP [Response].
+  ///
+  /// Parameters:
+  ///
+  /// * [String] deviceId (required):
+  Future<Response> getAllUserAssetsByDeviceIdWithHttpInfo(String deviceId,) async {
+    // ignore: prefer_const_declarations
+    final apiPath = r'/assets/device/{deviceId}'
+      .replaceAll('{deviceId}', deviceId);
+
+    // ignore: prefer_final_locals
+    Object? postBody;
+
+    final queryParams = <QueryParam>[];
+    final headerParams = <String, String>{};
+    final formParams = <String, String>{};
+
+    const contentTypes = <String>[];
+
+
+    return apiClient.invokeAPI(
+      apiPath,
+      'GET',
+      queryParams,
+      postBody,
+      headerParams,
+      formParams,
+      contentTypes.isEmpty ? null : contentTypes.first,
+    );
+  }
+
+  /// Retrieve assets by device ID
+  ///
+  /// Get all asset of a device that are in the database, ID only.
+  ///
+  /// Parameters:
+  ///
+  /// * [String] deviceId (required):
+  Future<List<String>?> getAllUserAssetsByDeviceId(String deviceId,) async {
+    final response = await getAllUserAssetsByDeviceIdWithHttpInfo(deviceId,);
+    if (response.statusCode >= HttpStatus.badRequest) {
+      throw ApiException(response.statusCode, await _decodeBodyBytes(response));
+    }
+    // When a remote server returns no body with a status of 204, we shall not decode it.
+    // At the time of writing this, `dart:convert` will throw an "Unexpected end of input"
+    // FormatException when trying to decode an empty string.
+    if (response.body.isNotEmpty && response.statusCode != HttpStatus.noContent) {
+      final responseBody = await _decodeBodyBytes(response);
+      return (await apiClient.deserializeAsync(responseBody, 'List<String>') as List)
+        .cast<String>()
+        .toList(growable: false);
+
+    }
+    return null;
+  }
+
+  /// Get delta sync for user
+  ///
+  /// Retrieve changed assets since the last sync for the authenticated user.
+  ///
+  /// Note: This method returns the HTTP [Response].
+  ///
+  /// Parameters:
+  ///
+  /// * [AssetDeltaSyncDto] assetDeltaSyncDto (required):
+  Future<Response> getDeltaSyncWithHttpInfo(AssetDeltaSyncDto assetDeltaSyncDto,) async {
+    // ignore: prefer_const_declarations
+    final apiPath = r'/sync/delta-sync';
+
+    // ignore: prefer_final_locals
+    Object? postBody = assetDeltaSyncDto;
+
+    final queryParams = <QueryParam>[];
+    final headerParams = <String, String>{};
+    final formParams = <String, String>{};
+
+    const contentTypes = <String>['application/json'];
+
+
+    return apiClient.invokeAPI(
+      apiPath,
+      'POST',
+      queryParams,
+      postBody,
+      headerParams,
+      formParams,
+      contentTypes.isEmpty ? null : contentTypes.first,
+    );
+  }
+
+  /// Get delta sync for user
+  ///
+  /// Retrieve changed assets since the last sync for the authenticated user.
+  ///
+  /// Parameters:
+  ///
+  /// * [AssetDeltaSyncDto] assetDeltaSyncDto (required):
+  Future<AssetDeltaSyncResponseDto?> getDeltaSync(AssetDeltaSyncDto assetDeltaSyncDto,) async {
+    final response = await getDeltaSyncWithHttpInfo(assetDeltaSyncDto,);
+    if (response.statusCode >= HttpStatus.badRequest) {
+      throw ApiException(response.statusCode, await _decodeBodyBytes(response));
+    }
+    // When a remote server returns no body with a status of 204, we shall not decode it.
+    // At the time of writing this, `dart:convert` will throw an "Unexpected end of input"
+    // FormatException when trying to decode an empty string.
+    if (response.body.isNotEmpty && response.statusCode != HttpStatus.noContent) {
+      return await apiClient.deserializeAsync(await _decodeBodyBytes(response), 'AssetDeltaSyncResponseDto',) as AssetDeltaSyncResponseDto;
+    
+    }
+    return null;
+  }
+
+  /// Get full sync for user
+  ///
+  /// Retrieve all assets for a full synchronization for the authenticated user.
+  ///
+  /// Note: This method returns the HTTP [Response].
+  ///
+  /// Parameters:
+  ///
+  /// * [AssetFullSyncDto] assetFullSyncDto (required):
+  Future<Response> getFullSyncForUserWithHttpInfo(AssetFullSyncDto assetFullSyncDto,) async {
+    // ignore: prefer_const_declarations
+    final apiPath = r'/sync/full-sync';
+
+    // ignore: prefer_final_locals
+    Object? postBody = assetFullSyncDto;
+
+    final queryParams = <QueryParam>[];
+    final headerParams = <String, String>{};
+    final formParams = <String, String>{};
+
+    const contentTypes = <String>['application/json'];
+
+
+    return apiClient.invokeAPI(
+      apiPath,
+      'POST',
+      queryParams,
+      postBody,
+      headerParams,
+      formParams,
+      contentTypes.isEmpty ? null : contentTypes.first,
+    );
+  }
+
+  /// Get full sync for user
+  ///
+  /// Retrieve all assets for a full synchronization for the authenticated user.
+  ///
+  /// Parameters:
+  ///
+  /// * [AssetFullSyncDto] assetFullSyncDto (required):
+  Future<List<AssetResponseDto>?> getFullSyncForUser(AssetFullSyncDto assetFullSyncDto,) async {
+    final response = await getFullSyncForUserWithHttpInfo(assetFullSyncDto,);
+    if (response.statusCode >= HttpStatus.badRequest) {
+      throw ApiException(response.statusCode, await _decodeBodyBytes(response));
+    }
+    // When a remote server returns no body with a status of 204, we shall not decode it.
+    // At the time of writing this, `dart:convert` will throw an "Unexpected end of input"
+    // FormatException when trying to decode an empty string.
+    if (response.body.isNotEmpty && response.statusCode != HttpStatus.noContent) {
+      final responseBody = await _decodeBodyBytes(response);
+      return (await apiClient.deserializeAsync(responseBody, 'List<AssetResponseDto>') as List)
+        .cast<AssetResponseDto>()
+        .toList(growable: false);
+
+    }
+    return null;
+  }
+
+  /// Get random assets
+  ///
+  /// Retrieve a specified number of random assets for the authenticated user.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -105,7 +286,9 @@ class DeprecatedApi {
     );
   }
 
-  /// This property was deprecated in v1.116.0. This endpoint requires the `asset.read` permission.
+  /// Get random assets
+  ///
+  /// Retrieve a specified number of random assets for the authenticated user.
   ///
   /// Parameters:
   ///
@@ -128,9 +311,9 @@ class DeprecatedApi {
     return null;
   }
 
-  /// Replace the asset with new file, without changing its id
+  /// Replace asset
   ///
-  /// This property was deprecated in v1.142.0. Replace the asset with new file, without changing its id. This endpoint requires the `asset.replace` permission.
+  /// Replace the asset with new file, without changing its id.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -222,9 +405,9 @@ class DeprecatedApi {
     );
   }
 
-  /// Replace the asset with new file, without changing its id
+  /// Replace asset
   ///
-  /// This property was deprecated in v1.142.0. Replace the asset with new file, without changing its id. This endpoint requires the `asset.replace` permission.
+  /// Replace the asset with new file, without changing its id.
   ///
   /// Parameters:
   ///

mobile/openapi/lib/api/download_api.dart

@@ -16,7 +16,9 @@ class DownloadApi {
 
   final ApiClient apiClient;
 
-  /// This endpoint requires the `asset.download` permission.
+  /// Download asset archive
+  ///
+  /// Download a ZIP archive containing the specified assets. The assets must have been previously requested via the \"getDownloadInfo\" endpoint.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -59,7 +61,9 @@ class DownloadApi {
     );
   }
 
-  /// This endpoint requires the `asset.download` permission.
+  /// Download asset archive
+  ///
+  /// Download a ZIP archive containing the specified assets. The assets must have been previously requested via the \"getDownloadInfo\" endpoint.
   ///
   /// Parameters:
   ///
@@ -83,7 +87,9 @@ class DownloadApi {
     return null;
   }
 
-  /// This endpoint requires the `asset.download` permission.
+  /// Retrieve download information
+  ///
+  /// Retrieve information about how to request a download for the specified assets or album. The response includes groups of assets that can be downloaded together.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -126,7 +132,9 @@ class DownloadApi {
     );
   }
 
-  /// This endpoint requires the `asset.download` permission.
+  /// Retrieve download information
+  ///
+  /// Retrieve information about how to request a download for the specified assets or album. The response includes groups of assets that can be downloaded together.
   ///
   /// Parameters:
   ///

mobile/openapi/lib/api/duplicates_api.dart

@@ -16,7 +16,9 @@ class DuplicatesApi {
 
   final ApiClient apiClient;
 
-  /// This endpoint requires the `duplicate.delete` permission.
+  /// Delete a duplicate
+  ///
+  /// Delete a single duplicate asset specified by its ID.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -49,7 +51,9 @@ class DuplicatesApi {
     );
   }
 
-  /// This endpoint requires the `duplicate.delete` permission.
+  /// Delete a duplicate
+  ///
+  /// Delete a single duplicate asset specified by its ID.
   ///
   /// Parameters:
   ///
@@ -61,7 +65,9 @@ class DuplicatesApi {
     }
   }
 
-  /// This endpoint requires the `duplicate.delete` permission.
+  /// Delete duplicates
+  ///
+  /// Delete multiple duplicate assets specified by their IDs.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -93,7 +99,9 @@ class DuplicatesApi {
     );
   }
 
-  /// This endpoint requires the `duplicate.delete` permission.
+  /// Delete duplicates
+  ///
+  /// Delete multiple duplicate assets specified by their IDs.
   ///
   /// Parameters:
   ///
@@ -105,7 +113,9 @@ class DuplicatesApi {
     }
   }
 
-  /// This endpoint requires the `duplicate.read` permission.
+  /// Retrieve duplicates
+  ///
+  /// Retrieve a list of duplicate assets available to the authenticated user.
   ///
   /// Note: This method returns the HTTP [Response].
   Future<Response> getAssetDuplicatesWithHttpInfo() async {
@@ -133,7 +143,9 @@ class DuplicatesApi {
     );
   }
 
-  /// This endpoint requires the `duplicate.read` permission.
+  /// Retrieve duplicates
+  ///
+  /// Retrieve a list of duplicate assets available to the authenticated user.
   Future<List<DuplicateResponseDto>?> getAssetDuplicates() async {
     final response = await getAssetDuplicatesWithHttpInfo();
     if (response.statusCode >= HttpStatus.badRequest) {

mobile/openapi/lib/api/faces_api.dart

@@ -16,7 +16,9 @@ class FacesApi {
 
   final ApiClient apiClient;
 
-  /// This endpoint requires the `face.create` permission.
+  /// Create a face
+  ///
+  /// Create a new face that has not been discovered by facial recognition. The content of the bounding box is considered a face.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -48,7 +50,9 @@ class FacesApi {
     );
   }
 
-  /// This endpoint requires the `face.create` permission.
+  /// Create a face
+  ///
+  /// Create a new face that has not been discovered by facial recognition. The content of the bounding box is considered a face.
   ///
   /// Parameters:
   ///
@@ -60,7 +64,9 @@ class FacesApi {
     }
   }
 
-  /// This endpoint requires the `face.delete` permission.
+  /// Delete a face
+  ///
+  /// Delete a face identified by the id. Optionally can be force deleted.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -95,7 +101,9 @@ class FacesApi {
     );
   }
 
-  /// This endpoint requires the `face.delete` permission.
+  /// Delete a face
+  ///
+  /// Delete a face identified by the id. Optionally can be force deleted.
   ///
   /// Parameters:
   ///
@@ -109,7 +117,9 @@ class FacesApi {
     }
   }
 
-  /// This endpoint requires the `face.read` permission.
+  /// Retrieve faces for asset
+  ///
+  /// Retrieve all faces belonging to an asset.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -143,7 +153,9 @@ class FacesApi {
     );
   }
 
-  /// This endpoint requires the `face.read` permission.
+  /// Retrieve faces for asset
+  ///
+  /// Retrieve all faces belonging to an asset.
   ///
   /// Parameters:
   ///
@@ -166,7 +178,9 @@ class FacesApi {
     return null;
   }
 
-  /// This endpoint requires the `face.update` permission.
+  /// Re-assign a face to another person
+  ///
+  /// Re-assign the face provided in the body to the person identified by the id in the path parameter.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -201,7 +215,9 @@ class FacesApi {
     );
   }
 
-  /// This endpoint requires the `face.update` permission.
+  /// Re-assign a face to another person
+  ///
+  /// Re-assign the face provided in the body to the person identified by the id in the path parameter.
   ///
   /// Parameters:
   ///

mobile/openapi/lib/api/jobs_api.dart

@@ -16,7 +16,9 @@ class JobsApi {
 
   final ApiClient apiClient;
 
-  /// This endpoint is an admin-only route, and requires the `job.create` permission.
+  /// Create a manual job
+  ///
+  /// Run a specific job. Most jobs are queued automatically, but this endpoint allows for manual creation of a handful of jobs, including various cleanup tasks, as well as creating a new database backup.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -48,7 +50,9 @@ class JobsApi {
     );
   }
 
-  /// This endpoint is an admin-only route, and requires the `job.create` permission.
+  /// Create a manual job
+  ///
+  /// Run a specific job. Most jobs are queued automatically, but this endpoint allows for manual creation of a handful of jobs, including various cleanup tasks, as well as creating a new database backup.
   ///
   /// Parameters:
   ///
@@ -60,10 +64,12 @@ class JobsApi {
     }
   }
 
-  /// This endpoint is an admin-only route, and requires the `job.read` permission.
+  /// Retrieve queue counts and status
+  ///
+  /// Retrieve the counts of the current queue, as well as the current status.
   ///
   /// Note: This method returns the HTTP [Response].
-  Future<Response> getAllJobsStatusWithHttpInfo() async {
+  Future<Response> getQueuesLegacyWithHttpInfo() async {
     // ignore: prefer_const_declarations
     final apiPath = r'/jobs';
 
@@ -88,9 +94,11 @@ class JobsApi {
     );
   }
 
-  /// This endpoint is an admin-only route, and requires the `job.read` permission.
-  Future<AllJobStatusResponseDto?> getAllJobsStatus() async {
-    final response = await getAllJobsStatusWithHttpInfo();
+  /// Retrieve queue counts and status
+  ///
+  /// Retrieve the counts of the current queue, as well as the current status.
+  Future<QueuesResponseDto?> getQueuesLegacy() async {
+    final response = await getQueuesLegacyWithHttpInfo();
     if (response.statusCode >= HttpStatus.badRequest) {
       throw ApiException(response.statusCode, await _decodeBodyBytes(response));
     }
@@ -98,28 +106,30 @@ class JobsApi {
     // At the time of writing this, `dart:convert` will throw an "Unexpected end of input"
     // FormatException when trying to decode an empty string.
     if (response.body.isNotEmpty && response.statusCode != HttpStatus.noContent) {
-      return await apiClient.deserializeAsync(await _decodeBodyBytes(response), 'AllJobStatusResponseDto',) as AllJobStatusResponseDto;
+      return await apiClient.deserializeAsync(await _decodeBodyBytes(response), 'QueuesResponseDto',) as QueuesResponseDto;
     
     }
     return null;
   }
 
-  /// This endpoint is an admin-only route, and requires the `job.create` permission.
+  /// Run jobs
+  ///
+  /// Queue all assets for a specific job type. Defaults to only queueing assets that have not yet been processed, but the force command can be used to re-process all assets.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
   /// Parameters:
   ///
-  /// * [JobName] id (required):
+  /// * [QueueName] name (required):
   ///
-  /// * [JobCommandDto] jobCommandDto (required):
-  Future<Response> sendJobCommandWithHttpInfo(JobName id, JobCommandDto jobCommandDto,) async {
+  /// * [QueueCommandDto] queueCommandDto (required):
+  Future<Response> runQueueCommandLegacyWithHttpInfo(QueueName name, QueueCommandDto queueCommandDto,) async {
     // ignore: prefer_const_declarations
-    final apiPath = r'/jobs/{id}'
-      .replaceAll('{id}', id.toString());
+    final apiPath = r'/jobs/{name}'
+      .replaceAll('{name}', name.toString());
 
     // ignore: prefer_final_locals
-    Object? postBody = jobCommandDto;
+    Object? postBody = queueCommandDto;
 
     final queryParams = <QueryParam>[];
     final headerParams = <String, String>{};
@@ -139,15 +149,17 @@ class JobsApi {
     );
   }
 
-  /// This endpoint is an admin-only route, and requires the `job.create` permission.
+  /// Run jobs
+  ///
+  /// Queue all assets for a specific job type. Defaults to only queueing assets that have not yet been processed, but the force command can be used to re-process all assets.
   ///
   /// Parameters:
   ///
-  /// * [JobName] id (required):
+  /// * [QueueName] name (required):
   ///
-  /// * [JobCommandDto] jobCommandDto (required):
-  Future<JobStatusDto?> sendJobCommand(JobName id, JobCommandDto jobCommandDto,) async {
-    final response = await sendJobCommandWithHttpInfo(id, jobCommandDto,);
+  /// * [QueueCommandDto] queueCommandDto (required):
+  Future<QueueResponseDto?> runQueueCommandLegacy(QueueName name, QueueCommandDto queueCommandDto,) async {
+    final response = await runQueueCommandLegacyWithHttpInfo(name, queueCommandDto,);
     if (response.statusCode >= HttpStatus.badRequest) {
       throw ApiException(response.statusCode, await _decodeBodyBytes(response));
     }
@@ -155,7 +167,7 @@ class JobsApi {
     // At the time of writing this, `dart:convert` will throw an "Unexpected end of input"
     // FormatException when trying to decode an empty string.
     if (response.body.isNotEmpty && response.statusCode != HttpStatus.noContent) {
-      return await apiClient.deserializeAsync(await _decodeBodyBytes(response), 'JobStatusDto',) as JobStatusDto;
+      return await apiClient.deserializeAsync(await _decodeBodyBytes(response), 'QueueResponseDto',) as QueueResponseDto;
     
     }
     return null;

mobile/openapi/lib/api/libraries_api.dart

@@ -16,7 +16,9 @@ class LibrariesApi {
 
   final ApiClient apiClient;
 
-  /// This endpoint is an admin-only route, and requires the `library.create` permission.
+  /// Create a library
+  ///
+  /// Create a new external library.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -48,7 +50,9 @@ class LibrariesApi {
     );
   }
 
-  /// This endpoint is an admin-only route, and requires the `library.create` permission.
+  /// Create a library
+  ///
+  /// Create a new external library.
   ///
   /// Parameters:
   ///
@@ -68,7 +72,9 @@ class LibrariesApi {
     return null;
   }
 
-  /// This endpoint is an admin-only route, and requires the `library.delete` permission.
+  /// Delete a library
+  ///
+  /// Delete an external library by its ID.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -101,7 +107,9 @@ class LibrariesApi {
     );
   }
 
-  /// This endpoint is an admin-only route, and requires the `library.delete` permission.
+  /// Delete a library
+  ///
+  /// Delete an external library by its ID.
   ///
   /// Parameters:
   ///
@@ -113,7 +121,9 @@ class LibrariesApi {
     }
   }
 
-  /// This endpoint is an admin-only route, and requires the `library.read` permission.
+  /// Retrieve libraries
+  ///
+  /// Retrieve a list of external libraries.
   ///
   /// Note: This method returns the HTTP [Response].
   Future<Response> getAllLibrariesWithHttpInfo() async {
@@ -141,7 +151,9 @@ class LibrariesApi {
     );
   }
 
-  /// This endpoint is an admin-only route, and requires the `library.read` permission.
+  /// Retrieve libraries
+  ///
+  /// Retrieve a list of external libraries.
   Future<List<LibraryResponseDto>?> getAllLibraries() async {
     final response = await getAllLibrariesWithHttpInfo();
     if (response.statusCode >= HttpStatus.badRequest) {
@@ -160,7 +172,9 @@ class LibrariesApi {
     return null;
   }
 
-  /// This endpoint is an admin-only route, and requires the `library.read` permission.
+  /// Retrieve a library
+  ///
+  /// Retrieve an external library by its ID.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -193,7 +207,9 @@ class LibrariesApi {
     );
   }
 
-  /// This endpoint is an admin-only route, and requires the `library.read` permission.
+  /// Retrieve a library
+  ///
+  /// Retrieve an external library by its ID.
   ///
   /// Parameters:
   ///
@@ -213,7 +229,9 @@ class LibrariesApi {
     return null;
   }
 
-  /// This endpoint is an admin-only route, and requires the `library.statistics` permission.
+  /// Retrieve library statistics
+  ///
+  /// Retrieve statistics for a specific external library, including number of videos, images, and storage usage.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -246,7 +264,9 @@ class LibrariesApi {
     );
   }
 
-  /// This endpoint is an admin-only route, and requires the `library.statistics` permission.
+  /// Retrieve library statistics
+  ///
+  /// Retrieve statistics for a specific external library, including number of videos, images, and storage usage.
   ///
   /// Parameters:
   ///
@@ -266,7 +286,9 @@ class LibrariesApi {
     return null;
   }
 
-  /// This endpoint is an admin-only route, and requires the `library.update` permission.
+  /// Scan a library
+  ///
+  /// Queue a scan for the external library to find and import new assets.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -299,7 +321,9 @@ class LibrariesApi {
     );
   }
 
-  /// This endpoint is an admin-only route, and requires the `library.update` permission.
+  /// Scan a library
+  ///
+  /// Queue a scan for the external library to find and import new assets.
   ///
   /// Parameters:
   ///
@@ -311,7 +335,9 @@ class LibrariesApi {
     }
   }
 
-  /// This endpoint is an admin-only route, and requires the `library.update` permission.
+  /// Update a library
+  ///
+  /// Update an existing external library.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -346,7 +372,9 @@ class LibrariesApi {
     );
   }
 
-  /// This endpoint is an admin-only route, and requires the `library.update` permission.
+  /// Update a library
+  ///
+  /// Update an existing external library.
   ///
   /// Parameters:
   ///
@@ -368,7 +396,12 @@ class LibrariesApi {
     return null;
   }
 
-  /// Performs an HTTP 'POST /libraries/{id}/validate' operation and returns the [Response].
+  /// Validate library settings
+  ///
+  /// Validate the settings of an external library.
+  ///
+  /// Note: This method returns the HTTP [Response].
+  ///
   /// Parameters:
   ///
   /// * [String] id (required):
@@ -400,6 +433,10 @@ class LibrariesApi {
     );
   }
 
+  /// Validate library settings
+  ///
+  /// Validate the settings of an external library.
+  ///
   /// Parameters:
   ///
   /// * [String] id (required):

mobile/openapi/lib/api/maintenance_admin_api.dart

@@ -0,0 +1,122 @@
+//
+// AUTO-GENERATED FILE, DO NOT MODIFY!
+//
+// @dart=2.18
+
+// ignore_for_file: unused_element, unused_import
+// ignore_for_file: always_put_required_named_parameters_first
+// ignore_for_file: constant_identifier_names
+// ignore_for_file: lines_longer_than_80_chars
+
+part of openapi.api;
+
+
+class MaintenanceAdminApi {
+  MaintenanceAdminApi([ApiClient? apiClient]) : apiClient = apiClient ?? defaultApiClient;
+
+  final ApiClient apiClient;
+
+  /// Log into maintenance mode
+  ///
+  /// Login with maintenance token or cookie to receive current information and perform further actions.
+  ///
+  /// Note: This method returns the HTTP [Response].
+  ///
+  /// Parameters:
+  ///
+  /// * [MaintenanceLoginDto] maintenanceLoginDto (required):
+  Future<Response> maintenanceLoginWithHttpInfo(MaintenanceLoginDto maintenanceLoginDto,) async {
+    // ignore: prefer_const_declarations
+    final apiPath = r'/admin/maintenance/login';
+
+    // ignore: prefer_final_locals
+    Object? postBody = maintenanceLoginDto;
+
+    final queryParams = <QueryParam>[];
+    final headerParams = <String, String>{};
+    final formParams = <String, String>{};
+
+    const contentTypes = <String>['application/json'];
+
+
+    return apiClient.invokeAPI(
+      apiPath,
+      'POST',
+      queryParams,
+      postBody,
+      headerParams,
+      formParams,
+      contentTypes.isEmpty ? null : contentTypes.first,
+    );
+  }
+
+  /// Log into maintenance mode
+  ///
+  /// Login with maintenance token or cookie to receive current information and perform further actions.
+  ///
+  /// Parameters:
+  ///
+  /// * [MaintenanceLoginDto] maintenanceLoginDto (required):
+  Future<MaintenanceAuthDto?> maintenanceLogin(MaintenanceLoginDto maintenanceLoginDto,) async {
+    final response = await maintenanceLoginWithHttpInfo(maintenanceLoginDto,);
+    if (response.statusCode >= HttpStatus.badRequest) {
+      throw ApiException(response.statusCode, await _decodeBodyBytes(response));
+    }
+    // When a remote server returns no body with a status of 204, we shall not decode it.
+    // At the time of writing this, `dart:convert` will throw an "Unexpected end of input"
+    // FormatException when trying to decode an empty string.
+    if (response.body.isNotEmpty && response.statusCode != HttpStatus.noContent) {
+      return await apiClient.deserializeAsync(await _decodeBodyBytes(response), 'MaintenanceAuthDto',) as MaintenanceAuthDto;
+    
+    }
+    return null;
+  }
+
+  /// Set maintenance mode
+  ///
+  /// Put Immich into or take it out of maintenance mode
+  ///
+  /// Note: This method returns the HTTP [Response].
+  ///
+  /// Parameters:
+  ///
+  /// * [SetMaintenanceModeDto] setMaintenanceModeDto (required):
+  Future<Response> setMaintenanceModeWithHttpInfo(SetMaintenanceModeDto setMaintenanceModeDto,) async {
+    // ignore: prefer_const_declarations
+    final apiPath = r'/admin/maintenance';
+
+    // ignore: prefer_final_locals
+    Object? postBody = setMaintenanceModeDto;
+
+    final queryParams = <QueryParam>[];
+    final headerParams = <String, String>{};
+    final formParams = <String, String>{};
+
+    const contentTypes = <String>['application/json'];
+
+
+    return apiClient.invokeAPI(
+      apiPath,
+      'POST',
+      queryParams,
+      postBody,
+      headerParams,
+      formParams,
+      contentTypes.isEmpty ? null : contentTypes.first,
+    );
+  }
+
+  /// Set maintenance mode
+  ///
+  /// Put Immich into or take it out of maintenance mode
+  ///
+  /// Parameters:
+  ///
+  /// * [SetMaintenanceModeDto] setMaintenanceModeDto (required):
+  Future<void> setMaintenanceMode(SetMaintenanceModeDto setMaintenanceModeDto,) async {
+    final response = await setMaintenanceModeWithHttpInfo(setMaintenanceModeDto,);
+    if (response.statusCode >= HttpStatus.badRequest) {
+      throw ApiException(response.statusCode, await _decodeBodyBytes(response));
+    }
+  }
+}

mobile/openapi/lib/api/map_api.dart

@@ -16,21 +16,26 @@ class MapApi {
 
   final ApiClient apiClient;
 
-  /// Performs an HTTP 'GET /map/markers' operation and returns the [Response].
+  /// Retrieve map markers
+  ///
+  /// Retrieve a list of latitude and longitude coordinates for every asset with location data.
+  ///
+  /// Note: This method returns the HTTP [Response].
+  ///
   /// Parameters:
   ///
-  /// * [bool] isArchived:
-  ///
-  /// * [bool] isFavorite:
-  ///
   /// * [DateTime] fileCreatedAfter:
   ///
   /// * [DateTime] fileCreatedBefore:
   ///
+  /// * [bool] isArchived:
+  ///
+  /// * [bool] isFavorite:
+  ///
   /// * [bool] withPartners:
   ///
   /// * [bool] withSharedAlbums:
-  Future<Response> getMapMarkersWithHttpInfo({ bool? isArchived, bool? isFavorite, DateTime? fileCreatedAfter, DateTime? fileCreatedBefore, bool? withPartners, bool? withSharedAlbums, }) async {
+  Future<Response> getMapMarkersWithHttpInfo({ DateTime? fileCreatedAfter, DateTime? fileCreatedBefore, bool? isArchived, bool? isFavorite, bool? withPartners, bool? withSharedAlbums, }) async {
     // ignore: prefer_const_declarations
     final apiPath = r'/map/markers';
 
@@ -41,18 +46,18 @@ class MapApi {
     final headerParams = <String, String>{};
     final formParams = <String, String>{};
 
-    if (isArchived != null) {
-      queryParams.addAll(_queryParams('', 'isArchived', isArchived));
-    }
-    if (isFavorite != null) {
-      queryParams.addAll(_queryParams('', 'isFavorite', isFavorite));
-    }
     if (fileCreatedAfter != null) {
       queryParams.addAll(_queryParams('', 'fileCreatedAfter', fileCreatedAfter));
     }
     if (fileCreatedBefore != null) {
       queryParams.addAll(_queryParams('', 'fileCreatedBefore', fileCreatedBefore));
     }
+    if (isArchived != null) {
+      queryParams.addAll(_queryParams('', 'isArchived', isArchived));
+    }
+    if (isFavorite != null) {
+      queryParams.addAll(_queryParams('', 'isFavorite', isFavorite));
+    }
     if (withPartners != null) {
       queryParams.addAll(_queryParams('', 'withPartners', withPartners));
     }
@@ -74,21 +79,25 @@ class MapApi {
     );
   }
 
+  /// Retrieve map markers
+  ///
+  /// Retrieve a list of latitude and longitude coordinates for every asset with location data.
+  ///
   /// Parameters:
   ///
-  /// * [bool] isArchived:
-  ///
-  /// * [bool] isFavorite:
-  ///
   /// * [DateTime] fileCreatedAfter:
   ///
   /// * [DateTime] fileCreatedBefore:
   ///
+  /// * [bool] isArchived:
+  ///
+  /// * [bool] isFavorite:
+  ///
   /// * [bool] withPartners:
   ///
   /// * [bool] withSharedAlbums:
-  Future<List<MapMarkerResponseDto>?> getMapMarkers({ bool? isArchived, bool? isFavorite, DateTime? fileCreatedAfter, DateTime? fileCreatedBefore, bool? withPartners, bool? withSharedAlbums, }) async {
-    final response = await getMapMarkersWithHttpInfo( isArchived: isArchived, isFavorite: isFavorite, fileCreatedAfter: fileCreatedAfter, fileCreatedBefore: fileCreatedBefore, withPartners: withPartners, withSharedAlbums: withSharedAlbums, );
+  Future<List<MapMarkerResponseDto>?> getMapMarkers({ DateTime? fileCreatedAfter, DateTime? fileCreatedBefore, bool? isArchived, bool? isFavorite, bool? withPartners, bool? withSharedAlbums, }) async {
+    final response = await getMapMarkersWithHttpInfo( fileCreatedAfter: fileCreatedAfter, fileCreatedBefore: fileCreatedBefore, isArchived: isArchived, isFavorite: isFavorite, withPartners: withPartners, withSharedAlbums: withSharedAlbums, );
     if (response.statusCode >= HttpStatus.badRequest) {
       throw ApiException(response.statusCode, await _decodeBodyBytes(response));
     }
@@ -105,7 +114,12 @@ class MapApi {
     return null;
   }
 
-  /// Performs an HTTP 'GET /map/reverse-geocode' operation and returns the [Response].
+  /// Reverse geocode coordinates
+  ///
+  /// Retrieve location information (e.g., city, country) for given latitude and longitude coordinates.
+  ///
+  /// Note: This method returns the HTTP [Response].
+  ///
   /// Parameters:
   ///
   /// * [double] lat (required):
@@ -139,6 +153,10 @@ class MapApi {
     );
   }
 
+  /// Reverse geocode coordinates
+  ///
+  /// Retrieve location information (e.g., city, country) for given latitude and longitude coordinates.
+  ///
   /// Parameters:
   ///
   /// * [double] lat (required):

mobile/openapi/lib/api/memories_api.dart

@@ -16,7 +16,9 @@ class MemoriesApi {
 
   final ApiClient apiClient;
 
-  /// This endpoint requires the `memoryAsset.create` permission.
+  /// Add assets to a memory
+  ///
+  /// Add a list of asset IDs to a specific memory.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -51,7 +53,9 @@ class MemoriesApi {
     );
   }
 
-  /// This endpoint requires the `memoryAsset.create` permission.
+  /// Add assets to a memory
+  ///
+  /// Add a list of asset IDs to a specific memory.
   ///
   /// Parameters:
   ///
@@ -76,7 +80,9 @@ class MemoriesApi {
     return null;
   }
 
-  /// This endpoint requires the `memory.create` permission.
+  /// Create a memory
+  ///
+  /// Create a new memory by providing a name, description, and a list of asset IDs to include in the memory.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -108,7 +114,9 @@ class MemoriesApi {
     );
   }
 
-  /// This endpoint requires the `memory.create` permission.
+  /// Create a memory
+  ///
+  /// Create a new memory by providing a name, description, and a list of asset IDs to include in the memory.
   ///
   /// Parameters:
   ///
@@ -128,7 +136,9 @@ class MemoriesApi {
     return null;
   }
 
-  /// This endpoint requires the `memory.delete` permission.
+  /// Delete a memory
+  ///
+  /// Delete a specific memory by its ID.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -161,7 +171,9 @@ class MemoriesApi {
     );
   }
 
-  /// This endpoint requires the `memory.delete` permission.
+  /// Delete a memory
+  ///
+  /// Delete a specific memory by its ID.
   ///
   /// Parameters:
   ///
@@ -173,7 +185,9 @@ class MemoriesApi {
     }
   }
 
-  /// This endpoint requires the `memory.read` permission.
+  /// Retrieve a memory
+  ///
+  /// Retrieve a specific memory by its ID.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -206,7 +220,9 @@ class MemoriesApi {
     );
   }
 
-  /// This endpoint requires the `memory.read` permission.
+  /// Retrieve a memory
+  ///
+  /// Retrieve a specific memory by its ID.
   ///
   /// Parameters:
   ///
@@ -226,7 +242,9 @@ class MemoriesApi {
     return null;
   }
 
-  /// This endpoint requires the `memory.statistics` permission.
+  /// Retrieve memories statistics
+  ///
+  /// Retrieve statistics about memories, such as total count and other relevant metrics.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -288,7 +306,9 @@ class MemoriesApi {
     );
   }
 
-  /// This endpoint requires the `memory.statistics` permission.
+  /// Retrieve memories statistics
+  ///
+  /// Retrieve statistics about memories, such as total count and other relevant metrics.
   ///
   /// Parameters:
   ///
@@ -319,7 +339,9 @@ class MemoriesApi {
     return null;
   }
 
-  /// This endpoint requires the `memoryAsset.delete` permission.
+  /// Remove assets from a memory
+  ///
+  /// Remove a list of asset IDs from a specific memory.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -354,7 +376,9 @@ class MemoriesApi {
     );
   }
 
-  /// This endpoint requires the `memoryAsset.delete` permission.
+  /// Remove assets from a memory
+  ///
+  /// Remove a list of asset IDs from a specific memory.
   ///
   /// Parameters:
   ///
@@ -379,7 +403,9 @@ class MemoriesApi {
     return null;
   }
 
-  /// This endpoint requires the `memory.read` permission.
+  /// Retrieve memories
+  ///
+  /// Retrieve a list of memories. Memories are sorted descending by creation date by default, although they can also be sorted in ascending order, or randomly.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -441,7 +467,9 @@ class MemoriesApi {
     );
   }
 
-  /// This endpoint requires the `memory.read` permission.
+  /// Retrieve memories
+  ///
+  /// Retrieve a list of memories. Memories are sorted descending by creation date by default, although they can also be sorted in ascending order, or randomly.
   ///
   /// Parameters:
   ///
@@ -475,7 +503,9 @@ class MemoriesApi {
     return null;
   }
 
-  /// This endpoint requires the `memory.update` permission.
+  /// Update a memory
+  ///
+  /// Update an existing memory by its ID.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -510,7 +540,9 @@ class MemoriesApi {
     );
   }
 
-  /// This endpoint requires the `memory.update` permission.
+  /// Update a memory
+  ///
+  /// Update an existing memory by its ID.
   ///
   /// Parameters:
   ///

mobile/openapi/lib/api/notifications_admin_api.dart

@@ -16,7 +16,12 @@ class NotificationsAdminApi {
 
   final ApiClient apiClient;
 
-  /// Performs an HTTP 'POST /admin/notifications' operation and returns the [Response].
+  /// Create a notification
+  ///
+  /// Create a new notification for a specific user.
+  ///
+  /// Note: This method returns the HTTP [Response].
+  ///
   /// Parameters:
   ///
   /// * [NotificationCreateDto] notificationCreateDto (required):
@@ -45,6 +50,10 @@ class NotificationsAdminApi {
     );
   }
 
+  /// Create a notification
+  ///
+  /// Create a new notification for a specific user.
+  ///
   /// Parameters:
   ///
   /// * [NotificationCreateDto] notificationCreateDto (required):
@@ -63,7 +72,12 @@ class NotificationsAdminApi {
     return null;
   }
 
-  /// Performs an HTTP 'POST /admin/notifications/templates/{name}' operation and returns the [Response].
+  /// Render email template
+  ///
+  /// Retrieve a preview of the provided email template.
+  ///
+  /// Note: This method returns the HTTP [Response].
+  ///
   /// Parameters:
   ///
   /// * [String] name (required):
@@ -95,6 +109,10 @@ class NotificationsAdminApi {
     );
   }
 
+  /// Render email template
+  ///
+  /// Retrieve a preview of the provided email template.
+  ///
   /// Parameters:
   ///
   /// * [String] name (required):
@@ -115,7 +133,12 @@ class NotificationsAdminApi {
     return null;
   }
 
-  /// Performs an HTTP 'POST /admin/notifications/test-email' operation and returns the [Response].
+  /// Send test email
+  ///
+  /// Send a test email using the provided SMTP configuration.
+  ///
+  /// Note: This method returns the HTTP [Response].
+  ///
   /// Parameters:
   ///
   /// * [SystemConfigSmtpDto] systemConfigSmtpDto (required):
@@ -144,6 +167,10 @@ class NotificationsAdminApi {
     );
   }
 
+  /// Send test email
+  ///
+  /// Send a test email using the provided SMTP configuration.
+  ///
   /// Parameters:
   ///
   /// * [SystemConfigSmtpDto] systemConfigSmtpDto (required):

mobile/openapi/lib/api/notifications_api.dart

@@ -16,7 +16,9 @@ class NotificationsApi {
 
   final ApiClient apiClient;
 
-  /// This endpoint requires the `notification.delete` permission.
+  /// Delete a notification
+  ///
+  /// Delete a specific notification.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -49,7 +51,9 @@ class NotificationsApi {
     );
   }
 
-  /// This endpoint requires the `notification.delete` permission.
+  /// Delete a notification
+  ///
+  /// Delete a specific notification.
   ///
   /// Parameters:
   ///
@@ -61,7 +65,9 @@ class NotificationsApi {
     }
   }
 
-  /// This endpoint requires the `notification.delete` permission.
+  /// Delete notifications
+  ///
+  /// Delete a list of notifications at once.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -93,7 +99,9 @@ class NotificationsApi {
     );
   }
 
-  /// This endpoint requires the `notification.delete` permission.
+  /// Delete notifications
+  ///
+  /// Delete a list of notifications at once.
   ///
   /// Parameters:
   ///
@@ -105,7 +113,9 @@ class NotificationsApi {
     }
   }
 
-  /// This endpoint requires the `notification.read` permission.
+  /// Get a notification
+  ///
+  /// Retrieve a specific notification identified by id.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -138,7 +148,9 @@ class NotificationsApi {
     );
   }
 
-  /// This endpoint requires the `notification.read` permission.
+  /// Get a notification
+  ///
+  /// Retrieve a specific notification identified by id.
   ///
   /// Parameters:
   ///
@@ -158,7 +170,9 @@ class NotificationsApi {
     return null;
   }
 
-  /// This endpoint requires the `notification.read` permission.
+  /// Retrieve notifications
+  ///
+  /// Retrieve a list of notifications.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -209,7 +223,9 @@ class NotificationsApi {
     );
   }
 
-  /// This endpoint requires the `notification.read` permission.
+  /// Retrieve notifications
+  ///
+  /// Retrieve a list of notifications.
   ///
   /// Parameters:
   ///
@@ -238,7 +254,9 @@ class NotificationsApi {
     return null;
   }
 
-  /// This endpoint requires the `notification.update` permission.
+  /// Update a notification
+  ///
+  /// Update a specific notification to set its read status.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -273,7 +291,9 @@ class NotificationsApi {
     );
   }
 
-  /// This endpoint requires the `notification.update` permission.
+  /// Update a notification
+  ///
+  /// Update a specific notification to set its read status.
   ///
   /// Parameters:
   ///
@@ -295,7 +315,9 @@ class NotificationsApi {
     return null;
   }
 
-  /// This endpoint requires the `notification.update` permission.
+  /// Update notifications
+  ///
+  /// Update a list of notifications. Allows to bulk-set the read status of notifications.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -327,7 +349,9 @@ class NotificationsApi {
     );
   }
 
-  /// This endpoint requires the `notification.update` permission.
+  /// Update notifications
+  ///
+  /// Update a list of notifications. Allows to bulk-set the read status of notifications.
   ///
   /// Parameters:
   ///

mobile/openapi/lib/api/partners_api.dart

@@ -16,7 +16,9 @@ class PartnersApi {
 
   final ApiClient apiClient;
 
-  /// This endpoint requires the `partner.create` permission.
+  /// Create a partner
+  ///
+  /// Create a new partner to share assets with.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -48,7 +50,9 @@ class PartnersApi {
     );
   }
 
-  /// This endpoint requires the `partner.create` permission.
+  /// Create a partner
+  ///
+  /// Create a new partner to share assets with.
   ///
   /// Parameters:
   ///
@@ -68,7 +72,9 @@ class PartnersApi {
     return null;
   }
 
-  /// This property was deprecated in v1.141.0. This endpoint requires the `partner.create` permission.
+  /// Create a partner
+  ///
+  /// Create a new partner to share assets with.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -101,7 +107,9 @@ class PartnersApi {
     );
   }
 
-  /// This property was deprecated in v1.141.0. This endpoint requires the `partner.create` permission.
+  /// Create a partner
+  ///
+  /// Create a new partner to share assets with.
   ///
   /// Parameters:
   ///
@@ -121,7 +129,9 @@ class PartnersApi {
     return null;
   }
 
-  /// This endpoint requires the `partner.read` permission.
+  /// Retrieve partners
+  ///
+  /// Retrieve a list of partners with whom assets are shared.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -155,7 +165,9 @@ class PartnersApi {
     );
   }
 
-  /// This endpoint requires the `partner.read` permission.
+  /// Retrieve partners
+  ///
+  /// Retrieve a list of partners with whom assets are shared.
   ///
   /// Parameters:
   ///
@@ -178,7 +190,9 @@ class PartnersApi {
     return null;
   }
 
-  /// This endpoint requires the `partner.delete` permission.
+  /// Remove a partner
+  ///
+  /// Stop sharing assets with a partner.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -211,7 +225,9 @@ class PartnersApi {
     );
   }
 
-  /// This endpoint requires the `partner.delete` permission.
+  /// Remove a partner
+  ///
+  /// Stop sharing assets with a partner.
   ///
   /// Parameters:
   ///
@@ -223,7 +239,9 @@ class PartnersApi {
     }
   }
 
-  /// This endpoint requires the `partner.update` permission.
+  /// Update a partner
+  ///
+  /// Specify whether a partner's assets should appear in the user's timeline.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -258,7 +276,9 @@ class PartnersApi {
     );
   }
 
-  /// This endpoint requires the `partner.update` permission.
+  /// Update a partner
+  ///
+  /// Specify whether a partner's assets should appear in the user's timeline.
   ///
   /// Parameters:
   ///

mobile/openapi/lib/api/people_api.dart

@@ -16,7 +16,9 @@ class PeopleApi {
 
   final ApiClient apiClient;
 
-  /// This endpoint requires the `person.create` permission.
+  /// Create a person
+  ///
+  /// Create a new person that can have multiple faces assigned to them.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -48,7 +50,9 @@ class PeopleApi {
     );
   }
 
-  /// This endpoint requires the `person.create` permission.
+  /// Create a person
+  ///
+  /// Create a new person that can have multiple faces assigned to them.
   ///
   /// Parameters:
   ///
@@ -68,7 +72,9 @@ class PeopleApi {
     return null;
   }
 
-  /// This endpoint requires the `person.delete` permission.
+  /// Delete people
+  ///
+  /// Bulk delete a list of people at once.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -100,7 +106,9 @@ class PeopleApi {
     );
   }
 
-  /// This endpoint requires the `person.delete` permission.
+  /// Delete people
+  ///
+  /// Bulk delete a list of people at once.
   ///
   /// Parameters:
   ///
@@ -112,7 +120,9 @@ class PeopleApi {
     }
   }
 
-  /// This endpoint requires the `person.delete` permission.
+  /// Delete person
+  ///
+  /// Delete an individual person.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -145,7 +155,9 @@ class PeopleApi {
     );
   }
 
-  /// This endpoint requires the `person.delete` permission.
+  /// Delete person
+  ///
+  /// Delete an individual person.
   ///
   /// Parameters:
   ///
@@ -157,7 +169,9 @@ class PeopleApi {
     }
   }
 
-  /// This endpoint requires the `person.read` permission.
+  /// Get all people
+  ///
+  /// Retrieve a list of all people.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -215,7 +229,9 @@ class PeopleApi {
     );
   }
 
-  /// This endpoint requires the `person.read` permission.
+  /// Get all people
+  ///
+  /// Retrieve a list of all people.
   ///
   /// Parameters:
   ///
@@ -245,7 +261,9 @@ class PeopleApi {
     return null;
   }
 
-  /// This endpoint requires the `person.read` permission.
+  /// Get a person
+  ///
+  /// Retrieve a person by id.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -278,7 +296,9 @@ class PeopleApi {
     );
   }
 
-  /// This endpoint requires the `person.read` permission.
+  /// Get a person
+  ///
+  /// Retrieve a person by id.
   ///
   /// Parameters:
   ///
@@ -298,7 +318,9 @@ class PeopleApi {
     return null;
   }
 
-  /// This endpoint requires the `person.statistics` permission.
+  /// Get person statistics
+  ///
+  /// Retrieve statistics about a specific person.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -331,7 +353,9 @@ class PeopleApi {
     );
   }
 
-  /// This endpoint requires the `person.statistics` permission.
+  /// Get person statistics
+  ///
+  /// Retrieve statistics about a specific person.
   ///
   /// Parameters:
   ///
@@ -351,7 +375,9 @@ class PeopleApi {
     return null;
   }
 
-  /// This endpoint requires the `person.read` permission.
+  /// Get person thumbnail
+  ///
+  /// Retrieve the thumbnail file for a person.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -384,7 +410,9 @@ class PeopleApi {
     );
   }
 
-  /// This endpoint requires the `person.read` permission.
+  /// Get person thumbnail
+  ///
+  /// Retrieve the thumbnail file for a person.
   ///
   /// Parameters:
   ///
@@ -404,7 +432,9 @@ class PeopleApi {
     return null;
   }
 
-  /// This endpoint requires the `person.merge` permission.
+  /// Merge people
+  ///
+  /// Merge a list of people into the person specified in the path parameter.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -439,7 +469,9 @@ class PeopleApi {
     );
   }
 
-  /// This endpoint requires the `person.merge` permission.
+  /// Merge people
+  ///
+  /// Merge a list of people into the person specified in the path parameter.
   ///
   /// Parameters:
   ///
@@ -464,7 +496,9 @@ class PeopleApi {
     return null;
   }
 
-  /// This endpoint requires the `person.reassign` permission.
+  /// Reassign faces
+  ///
+  /// Bulk reassign a list of faces to a different person.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -499,7 +533,9 @@ class PeopleApi {
     );
   }
 
-  /// This endpoint requires the `person.reassign` permission.
+  /// Reassign faces
+  ///
+  /// Bulk reassign a list of faces to a different person.
   ///
   /// Parameters:
   ///
@@ -524,7 +560,9 @@ class PeopleApi {
     return null;
   }
 
-  /// This endpoint requires the `person.update` permission.
+  /// Update people
+  ///
+  /// Bulk update multiple people at once.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -556,7 +594,9 @@ class PeopleApi {
     );
   }
 
-  /// This endpoint requires the `person.update` permission.
+  /// Update people
+  ///
+  /// Bulk update multiple people at once.
   ///
   /// Parameters:
   ///
@@ -579,7 +619,9 @@ class PeopleApi {
     return null;
   }
 
-  /// This endpoint requires the `person.update` permission.
+  /// Update person
+  ///
+  /// Update an individual person.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -614,7 +656,9 @@ class PeopleApi {
     );
   }
 
-  /// This endpoint requires the `person.update` permission.
+  /// Update person
+  ///
+  /// Update an individual person.
   ///
   /// Parameters:
   ///

mobile/openapi/lib/api/plugins_api.dart

@@ -0,0 +1,126 @@
+//
+// AUTO-GENERATED FILE, DO NOT MODIFY!
+//
+// @dart=2.18
+
+// ignore_for_file: unused_element, unused_import
+// ignore_for_file: always_put_required_named_parameters_first
+// ignore_for_file: constant_identifier_names
+// ignore_for_file: lines_longer_than_80_chars
+
+part of openapi.api;
+
+
+class PluginsApi {
+  PluginsApi([ApiClient? apiClient]) : apiClient = apiClient ?? defaultApiClient;
+
+  final ApiClient apiClient;
+
+  /// Retrieve a plugin
+  ///
+  /// Retrieve information about a specific plugin by its ID.
+  ///
+  /// Note: This method returns the HTTP [Response].
+  ///
+  /// Parameters:
+  ///
+  /// * [String] id (required):
+  Future<Response> getPluginWithHttpInfo(String id,) async {
+    // ignore: prefer_const_declarations
+    final apiPath = r'/plugins/{id}'
+      .replaceAll('{id}', id);
+
+    // ignore: prefer_final_locals
+    Object? postBody;
+
+    final queryParams = <QueryParam>[];
+    final headerParams = <String, String>{};
+    final formParams = <String, String>{};
+
+    const contentTypes = <String>[];
+
+
+    return apiClient.invokeAPI(
+      apiPath,
+      'GET',
+      queryParams,
+      postBody,
+      headerParams,
+      formParams,
+      contentTypes.isEmpty ? null : contentTypes.first,
+    );
+  }
+
+  /// Retrieve a plugin
+  ///
+  /// Retrieve information about a specific plugin by its ID.
+  ///
+  /// Parameters:
+  ///
+  /// * [String] id (required):
+  Future<PluginResponseDto?> getPlugin(String id,) async {
+    final response = await getPluginWithHttpInfo(id,);
+    if (response.statusCode >= HttpStatus.badRequest) {
+      throw ApiException(response.statusCode, await _decodeBodyBytes(response));
+    }
+    // When a remote server returns no body with a status of 204, we shall not decode it.
+    // At the time of writing this, `dart:convert` will throw an "Unexpected end of input"
+    // FormatException when trying to decode an empty string.
+    if (response.body.isNotEmpty && response.statusCode != HttpStatus.noContent) {
+      return await apiClient.deserializeAsync(await _decodeBodyBytes(response), 'PluginResponseDto',) as PluginResponseDto;
+    
+    }
+    return null;
+  }
+
+  /// List all plugins
+  ///
+  /// Retrieve a list of plugins available to the authenticated user.
+  ///
+  /// Note: This method returns the HTTP [Response].
+  Future<Response> getPluginsWithHttpInfo() async {
+    // ignore: prefer_const_declarations
+    final apiPath = r'/plugins';
+
+    // ignore: prefer_final_locals
+    Object? postBody;
+
+    final queryParams = <QueryParam>[];
+    final headerParams = <String, String>{};
+    final formParams = <String, String>{};
+
+    const contentTypes = <String>[];
+
+
+    return apiClient.invokeAPI(
+      apiPath,
+      'GET',
+      queryParams,
+      postBody,
+      headerParams,
+      formParams,
+      contentTypes.isEmpty ? null : contentTypes.first,
+    );
+  }
+
+  /// List all plugins
+  ///
+  /// Retrieve a list of plugins available to the authenticated user.
+  Future<List<PluginResponseDto>?> getPlugins() async {
+    final response = await getPluginsWithHttpInfo();
+    if (response.statusCode >= HttpStatus.badRequest) {
+      throw ApiException(response.statusCode, await _decodeBodyBytes(response));
+    }
+    // When a remote server returns no body with a status of 204, we shall not decode it.
+    // At the time of writing this, `dart:convert` will throw an "Unexpected end of input"
+    // FormatException when trying to decode an empty string.
+    if (response.body.isNotEmpty && response.statusCode != HttpStatus.noContent) {
+      final responseBody = await _decodeBodyBytes(response);
+      return (await apiClient.deserializeAsync(responseBody, 'List<PluginResponseDto>') as List)
+        .cast<PluginResponseDto>()
+        .toList(growable: false);
+
+    }
+    return null;
+  }
+}

mobile/openapi/lib/api/search_api.dart

@@ -16,7 +16,9 @@ class SearchApi {
 
   final ApiClient apiClient;
 
-  /// This endpoint requires the `asset.read` permission.
+  /// Retrieve assets by city
+  ///
+  /// Retrieve a list of assets with each asset belonging to a different city. This endpoint is used on the places pages to show a single thumbnail for each city the user has assets in.
   ///
   /// Note: This method returns the HTTP [Response].
   Future<Response> getAssetsByCityWithHttpInfo() async {
@@ -44,7 +46,9 @@ class SearchApi {
     );
   }
 
-  /// This endpoint requires the `asset.read` permission.
+  /// Retrieve assets by city
+  ///
+  /// Retrieve a list of assets with each asset belonging to a different city. This endpoint is used on the places pages to show a single thumbnail for each city the user has assets in.
   Future<List<AssetResponseDto>?> getAssetsByCity() async {
     final response = await getAssetsByCityWithHttpInfo();
     if (response.statusCode >= HttpStatus.badRequest) {
@@ -63,7 +67,9 @@ class SearchApi {
     return null;
   }
 
-  /// This endpoint requires the `asset.read` permission.
+  /// Retrieve explore data
+  ///
+  /// Retrieve data for the explore section, such as popular people and places.
   ///
   /// Note: This method returns the HTTP [Response].
   Future<Response> getExploreDataWithHttpInfo() async {
@@ -91,7 +97,9 @@ class SearchApi {
     );
   }
 
-  /// This endpoint requires the `asset.read` permission.
+  /// Retrieve explore data
+  ///
+  /// Retrieve data for the explore section, such as popular people and places.
   Future<List<SearchExploreResponseDto>?> getExploreData() async {
     final response = await getExploreDataWithHttpInfo();
     if (response.statusCode >= HttpStatus.badRequest) {
@@ -110,7 +118,9 @@ class SearchApi {
     return null;
   }
 
-  /// This endpoint requires the `asset.read` permission.
+  /// Retrieve search suggestions
+  ///
+  /// Retrieve search suggestions based on partial input. This endpoint is used for typeahead search features.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -121,7 +131,6 @@ class SearchApi {
   /// * [String] country:
   ///
   /// * [bool] includeNull:
-  ///   This property was added in v111.0.0
   ///
   /// * [String] lensModel:
   ///
@@ -175,7 +184,9 @@ class SearchApi {
     );
   }
 
-  /// This endpoint requires the `asset.read` permission.
+  /// Retrieve search suggestions
+  ///
+  /// Retrieve search suggestions based on partial input. This endpoint is used for typeahead search features.
   ///
   /// Parameters:
   ///
@@ -184,7 +195,6 @@ class SearchApi {
   /// * [String] country:
   ///
   /// * [bool] includeNull:
-  ///   This property was added in v111.0.0
   ///
   /// * [String] lensModel:
   ///
@@ -211,7 +221,9 @@ class SearchApi {
     return null;
   }
 
-  /// This endpoint requires the `asset.statistics` permission.
+  /// Search asset statistics
+  ///
+  /// Retrieve statistical data about assets based on search criteria, such as the total matching count.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -243,7 +255,9 @@ class SearchApi {
     );
   }
 
-  /// This endpoint requires the `asset.statistics` permission.
+  /// Search asset statistics
+  ///
+  /// Retrieve statistical data about assets based on search criteria, such as the total matching count.
   ///
   /// Parameters:
   ///
@@ -263,7 +277,9 @@ class SearchApi {
     return null;
   }
 
-  /// This endpoint requires the `asset.read` permission.
+  /// Search assets by metadata
+  ///
+  /// Search for assets based on various metadata criteria.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -295,7 +311,9 @@ class SearchApi {
     );
   }
 
-  /// This endpoint requires the `asset.read` permission.
+  /// Search assets by metadata
+  ///
+  /// Search for assets based on various metadata criteria.
   ///
   /// Parameters:
   ///
@@ -315,7 +333,9 @@ class SearchApi {
     return null;
   }
 
-  /// This endpoint requires the `asset.read` permission.
+  /// Search large assets
+  ///
+  /// Search for assets that are considered large based on specified criteria.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -506,7 +526,9 @@ class SearchApi {
     );
   }
 
-  /// This endpoint requires the `asset.read` permission.
+  /// Search large assets
+  ///
+  /// Search for assets that are considered large based on specified criteria.
   ///
   /// Parameters:
   ///
@@ -591,7 +613,9 @@ class SearchApi {
     return null;
   }
 
-  /// This endpoint requires the `person.read` permission.
+  /// Search people
+  ///
+  /// Search for people by name.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -630,7 +654,9 @@ class SearchApi {
     );
   }
 
-  /// This endpoint requires the `person.read` permission.
+  /// Search people
+  ///
+  /// Search for people by name.
   ///
   /// Parameters:
   ///
@@ -655,7 +681,9 @@ class SearchApi {
     return null;
   }
 
-  /// This endpoint requires the `asset.read` permission.
+  /// Search places
+  ///
+  /// Search for places by name.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -689,7 +717,9 @@ class SearchApi {
     );
   }
 
-  /// This endpoint requires the `asset.read` permission.
+  /// Search places
+  ///
+  /// Search for places by name.
   ///
   /// Parameters:
   ///
@@ -712,7 +742,9 @@ class SearchApi {
     return null;
   }
 
-  /// This endpoint requires the `asset.read` permission.
+  /// Search random assets
+  ///
+  /// Retrieve a random selection of assets based on the provided criteria.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -744,7 +776,9 @@ class SearchApi {
     );
   }
 
-  /// This endpoint requires the `asset.read` permission.
+  /// Search random assets
+  ///
+  /// Retrieve a random selection of assets based on the provided criteria.
   ///
   /// Parameters:
   ///
@@ -767,7 +801,9 @@ class SearchApi {
     return null;
   }
 
-  /// This endpoint requires the `asset.read` permission.
+  /// Smart asset search
+  ///
+  /// Perform a smart search for assets by using machine learning vectors to determine relevance.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -799,7 +835,9 @@ class SearchApi {
     );
   }
 
-  /// This endpoint requires the `asset.read` permission.
+  /// Smart asset search
+  ///
+  /// Perform a smart search for assets by using machine learning vectors to determine relevance.
   ///
   /// Parameters:
   ///

mobile/openapi/lib/api/server_api.dart

@@ -16,7 +16,9 @@ class ServerApi {
 
   final ApiClient apiClient;
 
-  /// This endpoint is an admin-only route, and requires the `serverLicense.delete` permission.
+  /// Delete server product key
+  ///
+  /// Delete the currently set server product key.
   ///
   /// Note: This method returns the HTTP [Response].
   Future<Response> deleteServerLicenseWithHttpInfo() async {
@@ -44,7 +46,9 @@ class ServerApi {
     );
   }
 
-  /// This endpoint is an admin-only route, and requires the `serverLicense.delete` permission.
+  /// Delete server product key
+  ///
+  /// Delete the currently set server product key.
   Future<void> deleteServerLicense() async {
     final response = await deleteServerLicenseWithHttpInfo();
     if (response.statusCode >= HttpStatus.badRequest) {
@@ -52,7 +56,9 @@ class ServerApi {
     }
   }
 
-  /// This endpoint requires the `server.about` permission.
+  /// Get server information
+  ///
+  /// Retrieve a list of information about the server.
   ///
   /// Note: This method returns the HTTP [Response].
   Future<Response> getAboutInfoWithHttpInfo() async {
@@ -80,7 +86,9 @@ class ServerApi {
     );
   }
 
-  /// This endpoint requires the `server.about` permission.
+  /// Get server information
+  ///
+  /// Retrieve a list of information about the server.
   Future<ServerAboutResponseDto?> getAboutInfo() async {
     final response = await getAboutInfoWithHttpInfo();
     if (response.statusCode >= HttpStatus.badRequest) {
@@ -96,7 +104,9 @@ class ServerApi {
     return null;
   }
 
-  /// This endpoint requires the `server.apkLinks` permission.
+  /// Get APK links
+  ///
+  /// Retrieve links to the APKs for the current server version.
   ///
   /// Note: This method returns the HTTP [Response].
   Future<Response> getApkLinksWithHttpInfo() async {
@@ -124,7 +134,9 @@ class ServerApi {
     );
   }
 
-  /// This endpoint requires the `server.apkLinks` permission.
+  /// Get APK links
+  ///
+  /// Retrieve links to the APKs for the current server version.
   Future<ServerApkLinksDto?> getApkLinks() async {
     final response = await getApkLinksWithHttpInfo();
     if (response.statusCode >= HttpStatus.badRequest) {
@@ -140,7 +152,11 @@ class ServerApi {
     return null;
   }
 
-  /// Performs an HTTP 'GET /server/config' operation and returns the [Response].
+  /// Get config
+  ///
+  /// Retrieve the current server configuration.
+  ///
+  /// Note: This method returns the HTTP [Response].
   Future<Response> getServerConfigWithHttpInfo() async {
     // ignore: prefer_const_declarations
     final apiPath = r'/server/config';
@@ -166,6 +182,9 @@ class ServerApi {
     );
   }
 
+  /// Get config
+  ///
+  /// Retrieve the current server configuration.
   Future<ServerConfigDto?> getServerConfig() async {
     final response = await getServerConfigWithHttpInfo();
     if (response.statusCode >= HttpStatus.badRequest) {
@@ -181,7 +200,11 @@ class ServerApi {
     return null;
   }
 
-  /// Performs an HTTP 'GET /server/features' operation and returns the [Response].
+  /// Get features
+  ///
+  /// Retrieve available features supported by this server.
+  ///
+  /// Note: This method returns the HTTP [Response].
   Future<Response> getServerFeaturesWithHttpInfo() async {
     // ignore: prefer_const_declarations
     final apiPath = r'/server/features';
@@ -207,6 +230,9 @@ class ServerApi {
     );
   }
 
+  /// Get features
+  ///
+  /// Retrieve available features supported by this server.
   Future<ServerFeaturesDto?> getServerFeatures() async {
     final response = await getServerFeaturesWithHttpInfo();
     if (response.statusCode >= HttpStatus.badRequest) {
@@ -222,7 +248,9 @@ class ServerApi {
     return null;
   }
 
-  /// This endpoint is an admin-only route, and requires the `serverLicense.read` permission.
+  /// Get product key
+  ///
+  /// Retrieve information about whether the server currently has a product key registered.
   ///
   /// Note: This method returns the HTTP [Response].
   Future<Response> getServerLicenseWithHttpInfo() async {
@@ -250,7 +278,9 @@ class ServerApi {
     );
   }
 
-  /// This endpoint is an admin-only route, and requires the `serverLicense.read` permission.
+  /// Get product key
+  ///
+  /// Retrieve information about whether the server currently has a product key registered.
   Future<LicenseResponseDto?> getServerLicense() async {
     final response = await getServerLicenseWithHttpInfo();
     if (response.statusCode >= HttpStatus.badRequest) {
@@ -266,7 +296,9 @@ class ServerApi {
     return null;
   }
 
-  /// This endpoint is an admin-only route, and requires the `server.statistics` permission.
+  /// Get statistics
+  ///
+  /// Retrieve statistics about the entire Immich instance such as asset counts.
   ///
   /// Note: This method returns the HTTP [Response].
   Future<Response> getServerStatisticsWithHttpInfo() async {
@@ -294,7 +326,9 @@ class ServerApi {
     );
   }
 
-  /// This endpoint is an admin-only route, and requires the `server.statistics` permission.
+  /// Get statistics
+  ///
+  /// Retrieve statistics about the entire Immich instance such as asset counts.
   Future<ServerStatsResponseDto?> getServerStatistics() async {
     final response = await getServerStatisticsWithHttpInfo();
     if (response.statusCode >= HttpStatus.badRequest) {
@@ -310,7 +344,11 @@ class ServerApi {
     return null;
   }
 
-  /// Performs an HTTP 'GET /server/version' operation and returns the [Response].
+  /// Get server version
+  ///
+  /// Retrieve the current server version in semantic versioning (semver) format.
+  ///
+  /// Note: This method returns the HTTP [Response].
   Future<Response> getServerVersionWithHttpInfo() async {
     // ignore: prefer_const_declarations
     final apiPath = r'/server/version';
@@ -336,6 +374,9 @@ class ServerApi {
     );
   }
 
+  /// Get server version
+  ///
+  /// Retrieve the current server version in semantic versioning (semver) format.
   Future<ServerVersionResponseDto?> getServerVersion() async {
     final response = await getServerVersionWithHttpInfo();
     if (response.statusCode >= HttpStatus.badRequest) {
@@ -351,7 +392,9 @@ class ServerApi {
     return null;
   }
 
-  /// This endpoint requires the `server.storage` permission.
+  /// Get storage
+  ///
+  /// Retrieve the current storage utilization information of the server.
   ///
   /// Note: This method returns the HTTP [Response].
   Future<Response> getStorageWithHttpInfo() async {
@@ -379,7 +422,9 @@ class ServerApi {
     );
   }
 
-  /// This endpoint requires the `server.storage` permission.
+  /// Get storage
+  ///
+  /// Retrieve the current storage utilization information of the server.
   Future<ServerStorageResponseDto?> getStorage() async {
     final response = await getStorageWithHttpInfo();
     if (response.statusCode >= HttpStatus.badRequest) {
@@ -395,7 +440,11 @@ class ServerApi {
     return null;
   }
 
-  /// Performs an HTTP 'GET /server/media-types' operation and returns the [Response].
+  /// Get supported media types
+  ///
+  /// Retrieve all media types supported by the server.
+  ///
+  /// Note: This method returns the HTTP [Response].
   Future<Response> getSupportedMediaTypesWithHttpInfo() async {
     // ignore: prefer_const_declarations
     final apiPath = r'/server/media-types';
@@ -421,6 +470,9 @@ class ServerApi {
     );
   }
 
+  /// Get supported media types
+  ///
+  /// Retrieve all media types supported by the server.
   Future<ServerMediaTypesResponseDto?> getSupportedMediaTypes() async {
     final response = await getSupportedMediaTypesWithHttpInfo();
     if (response.statusCode >= HttpStatus.badRequest) {
@@ -436,7 +488,11 @@ class ServerApi {
     return null;
   }
 
-  /// Performs an HTTP 'GET /server/theme' operation and returns the [Response].
+  /// Get theme
+  ///
+  /// Retrieve the custom CSS, if existent.
+  ///
+  /// Note: This method returns the HTTP [Response].
   Future<Response> getThemeWithHttpInfo() async {
     // ignore: prefer_const_declarations
     final apiPath = r'/server/theme';
@@ -462,6 +518,9 @@ class ServerApi {
     );
   }
 
+  /// Get theme
+  ///
+  /// Retrieve the custom CSS, if existent.
   Future<ServerThemeDto?> getTheme() async {
     final response = await getThemeWithHttpInfo();
     if (response.statusCode >= HttpStatus.badRequest) {
@@ -477,7 +536,9 @@ class ServerApi {
     return null;
   }
 
-  /// This endpoint requires the `server.versionCheck` permission.
+  /// Get version check status
+  ///
+  /// Retrieve information about the last time the version check ran.
   ///
   /// Note: This method returns the HTTP [Response].
   Future<Response> getVersionCheckWithHttpInfo() async {
@@ -505,7 +566,9 @@ class ServerApi {
     );
   }
 
-  /// This endpoint requires the `server.versionCheck` permission.
+  /// Get version check status
+  ///
+  /// Retrieve information about the last time the version check ran.
   Future<VersionCheckStateResponseDto?> getVersionCheck() async {
     final response = await getVersionCheckWithHttpInfo();
     if (response.statusCode >= HttpStatus.badRequest) {
@@ -521,7 +584,11 @@ class ServerApi {
     return null;
   }
 
-  /// Performs an HTTP 'GET /server/version-history' operation and returns the [Response].
+  /// Get version history
+  ///
+  /// Retrieve a list of past versions the server has been on.
+  ///
+  /// Note: This method returns the HTTP [Response].
   Future<Response> getVersionHistoryWithHttpInfo() async {
     // ignore: prefer_const_declarations
     final apiPath = r'/server/version-history';
@@ -547,6 +614,9 @@ class ServerApi {
     );
   }
 
+  /// Get version history
+  ///
+  /// Retrieve a list of past versions the server has been on.
   Future<List<ServerVersionHistoryResponseDto>?> getVersionHistory() async {
     final response = await getVersionHistoryWithHttpInfo();
     if (response.statusCode >= HttpStatus.badRequest) {
@@ -565,7 +635,11 @@ class ServerApi {
     return null;
   }
 
-  /// Performs an HTTP 'GET /server/ping' operation and returns the [Response].
+  /// Ping
+  ///
+  /// Pong
+  ///
+  /// Note: This method returns the HTTP [Response].
   Future<Response> pingServerWithHttpInfo() async {
     // ignore: prefer_const_declarations
     final apiPath = r'/server/ping';
@@ -591,6 +665,9 @@ class ServerApi {
     );
   }
 
+  /// Ping
+  ///
+  /// Pong
   Future<ServerPingResponse?> pingServer() async {
     final response = await pingServerWithHttpInfo();
     if (response.statusCode >= HttpStatus.badRequest) {
@@ -606,7 +683,9 @@ class ServerApi {
     return null;
   }
 
-  /// This endpoint is an admin-only route, and requires the `serverLicense.update` permission.
+  /// Set server product key
+  ///
+  /// Validate and set the server product key if successful.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -638,7 +717,9 @@ class ServerApi {
     );
   }
 
-  /// This endpoint is an admin-only route, and requires the `serverLicense.update` permission.
+  /// Set server product key
+  ///
+  /// Validate and set the server product key if successful.
   ///
   /// Parameters:
   ///

mobile/openapi/lib/api/sessions_api.dart

@@ -16,7 +16,9 @@ class SessionsApi {
 
   final ApiClient apiClient;
 
-  /// This endpoint requires the `session.create` permission.
+  /// Create a session
+  ///
+  /// Create a session as a child to the current session. This endpoint is used for casting.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -48,7 +50,9 @@ class SessionsApi {
     );
   }
 
-  /// This endpoint requires the `session.create` permission.
+  /// Create a session
+  ///
+  /// Create a session as a child to the current session. This endpoint is used for casting.
   ///
   /// Parameters:
   ///
@@ -68,7 +72,9 @@ class SessionsApi {
     return null;
   }
 
-  /// This endpoint requires the `session.delete` permission.
+  /// Delete all sessions
+  ///
+  /// Delete all sessions for the user. This will not delete the current session.
   ///
   /// Note: This method returns the HTTP [Response].
   Future<Response> deleteAllSessionsWithHttpInfo() async {
@@ -96,7 +102,9 @@ class SessionsApi {
     );
   }
 
-  /// This endpoint requires the `session.delete` permission.
+  /// Delete all sessions
+  ///
+  /// Delete all sessions for the user. This will not delete the current session.
   Future<void> deleteAllSessions() async {
     final response = await deleteAllSessionsWithHttpInfo();
     if (response.statusCode >= HttpStatus.badRequest) {
@@ -104,7 +112,9 @@ class SessionsApi {
     }
   }
 
-  /// This endpoint requires the `session.delete` permission.
+  /// Delete a session
+  ///
+  /// Delete a specific session by id.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -137,7 +147,9 @@ class SessionsApi {
     );
   }
 
-  /// This endpoint requires the `session.delete` permission.
+  /// Delete a session
+  ///
+  /// Delete a specific session by id.
   ///
   /// Parameters:
   ///
@@ -149,7 +161,9 @@ class SessionsApi {
     }
   }
 
-  /// This endpoint requires the `session.read` permission.
+  /// Retrieve sessions
+  ///
+  /// Retrieve a list of sessions for the user.
   ///
   /// Note: This method returns the HTTP [Response].
   Future<Response> getSessionsWithHttpInfo() async {
@@ -177,7 +191,9 @@ class SessionsApi {
     );
   }
 
-  /// This endpoint requires the `session.read` permission.
+  /// Retrieve sessions
+  ///
+  /// Retrieve a list of sessions for the user.
   Future<List<SessionResponseDto>?> getSessions() async {
     final response = await getSessionsWithHttpInfo();
     if (response.statusCode >= HttpStatus.badRequest) {
@@ -196,7 +212,9 @@ class SessionsApi {
     return null;
   }
 
-  /// This endpoint requires the `session.lock` permission.
+  /// Lock a session
+  ///
+  /// Lock a specific session by id.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -229,7 +247,9 @@ class SessionsApi {
     );
   }
 
-  /// This endpoint requires the `session.lock` permission.
+  /// Lock a session
+  ///
+  /// Lock a specific session by id.
   ///
   /// Parameters:
   ///
@@ -241,7 +261,9 @@ class SessionsApi {
     }
   }
 
-  /// This endpoint requires the `session.update` permission.
+  /// Update a session
+  ///
+  /// Update a specific session identified by id.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -276,7 +298,9 @@ class SessionsApi {
     );
   }
 
-  /// This endpoint requires the `session.update` permission.
+  /// Update a session
+  ///
+  /// Update a specific session identified by id.
   ///
   /// Parameters:
   ///

mobile/openapi/lib/api/shared_links_api.dart

@@ -16,7 +16,12 @@ class SharedLinksApi {
 
   final ApiClient apiClient;
 
-  /// Performs an HTTP 'PUT /shared-links/{id}/assets' operation and returns the [Response].
+  /// Add assets to a shared link
+  ///
+  /// Add assets to a specific shared link by its ID. This endpoint is only relevant for shared link of type individual.
+  ///
+  /// Note: This method returns the HTTP [Response].
+  ///
   /// Parameters:
   ///
   /// * [String] id (required):
@@ -59,6 +64,10 @@ class SharedLinksApi {
     );
   }
 
+  /// Add assets to a shared link
+  ///
+  /// Add assets to a specific shared link by its ID. This endpoint is only relevant for shared link of type individual.
+  ///
   /// Parameters:
   ///
   /// * [String] id (required):
@@ -86,7 +95,9 @@ class SharedLinksApi {
     return null;
   }
 
-  /// This endpoint requires the `sharedLink.create` permission.
+  /// Create a shared link
+  ///
+  /// Create a new shared link.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -118,7 +129,9 @@ class SharedLinksApi {
     );
   }
 
-  /// This endpoint requires the `sharedLink.create` permission.
+  /// Create a shared link
+  ///
+  /// Create a new shared link.
   ///
   /// Parameters:
   ///
@@ -138,7 +151,9 @@ class SharedLinksApi {
     return null;
   }
 
-  /// This endpoint requires the `sharedLink.read` permission.
+  /// Retrieve all shared links
+  ///
+  /// Retrieve a list of all shared links.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -174,7 +189,9 @@ class SharedLinksApi {
     );
   }
 
-  /// This endpoint requires the `sharedLink.read` permission.
+  /// Retrieve all shared links
+  ///
+  /// Retrieve a list of all shared links.
   ///
   /// Parameters:
   ///
@@ -197,17 +214,22 @@ class SharedLinksApi {
     return null;
   }
 
-  /// Performs an HTTP 'GET /shared-links/me' operation and returns the [Response].
+  /// Retrieve current shared link
+  ///
+  /// Retrieve the current shared link associated with authentication method.
+  ///
+  /// Note: This method returns the HTTP [Response].
+  ///
   /// Parameters:
   ///
-  /// * [String] password:
-  ///
-  /// * [String] token:
-  ///
   /// * [String] key:
   ///
+  /// * [String] password:
+  ///
   /// * [String] slug:
-  Future<Response> getMySharedLinkWithHttpInfo({ String? password, String? token, String? key, String? slug, }) async {
+  ///
+  /// * [String] token:
+  Future<Response> getMySharedLinkWithHttpInfo({ String? key, String? password, String? slug, String? token, }) async {
     // ignore: prefer_const_declarations
     final apiPath = r'/shared-links/me';
 
@@ -218,18 +240,18 @@ class SharedLinksApi {
     final headerParams = <String, String>{};
     final formParams = <String, String>{};
 
-    if (password != null) {
-      queryParams.addAll(_queryParams('', 'password', password));
-    }
-    if (token != null) {
-      queryParams.addAll(_queryParams('', 'token', token));
-    }
     if (key != null) {
       queryParams.addAll(_queryParams('', 'key', key));
     }
+    if (password != null) {
+      queryParams.addAll(_queryParams('', 'password', password));
+    }
     if (slug != null) {
       queryParams.addAll(_queryParams('', 'slug', slug));
     }
+    if (token != null) {
+      queryParams.addAll(_queryParams('', 'token', token));
+    }
 
     const contentTypes = <String>[];
 
@@ -245,17 +267,21 @@ class SharedLinksApi {
     );
   }
 
+  /// Retrieve current shared link
+  ///
+  /// Retrieve the current shared link associated with authentication method.
+  ///
   /// Parameters:
   ///
-  /// * [String] password:
-  ///
-  /// * [String] token:
-  ///
   /// * [String] key:
   ///
+  /// * [String] password:
+  ///
   /// * [String] slug:
-  Future<SharedLinkResponseDto?> getMySharedLink({ String? password, String? token, String? key, String? slug, }) async {
-    final response = await getMySharedLinkWithHttpInfo( password: password, token: token, key: key, slug: slug, );
+  ///
+  /// * [String] token:
+  Future<SharedLinkResponseDto?> getMySharedLink({ String? key, String? password, String? slug, String? token, }) async {
+    final response = await getMySharedLinkWithHttpInfo( key: key, password: password, slug: slug, token: token, );
     if (response.statusCode >= HttpStatus.badRequest) {
       throw ApiException(response.statusCode, await _decodeBodyBytes(response));
     }
@@ -269,7 +295,9 @@ class SharedLinksApi {
     return null;
   }
 
-  /// This endpoint requires the `sharedLink.read` permission.
+  /// Retrieve a shared link
+  ///
+  /// Retrieve a specific shared link by its ID.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -302,7 +330,9 @@ class SharedLinksApi {
     );
   }
 
-  /// This endpoint requires the `sharedLink.read` permission.
+  /// Retrieve a shared link
+  ///
+  /// Retrieve a specific shared link by its ID.
   ///
   /// Parameters:
   ///
@@ -322,7 +352,9 @@ class SharedLinksApi {
     return null;
   }
 
-  /// This endpoint requires the `sharedLink.delete` permission.
+  /// Delete a shared link
+  ///
+  /// Delete a specific shared link by its ID.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -355,7 +387,9 @@ class SharedLinksApi {
     );
   }
 
-  /// This endpoint requires the `sharedLink.delete` permission.
+  /// Delete a shared link
+  ///
+  /// Delete a specific shared link by its ID.
   ///
   /// Parameters:
   ///
@@ -367,7 +401,12 @@ class SharedLinksApi {
     }
   }
 
-  /// Performs an HTTP 'DELETE /shared-links/{id}/assets' operation and returns the [Response].
+  /// Remove assets from a shared link
+  ///
+  /// Remove assets from a specific shared link by its ID. This endpoint is only relevant for shared link of type individual.
+  ///
+  /// Note: This method returns the HTTP [Response].
+  ///
   /// Parameters:
   ///
   /// * [String] id (required):
@@ -410,6 +449,10 @@ class SharedLinksApi {
     );
   }
 
+  /// Remove assets from a shared link
+  ///
+  /// Remove assets from a specific shared link by its ID. This endpoint is only relevant for shared link of type individual.
+  ///
   /// Parameters:
   ///
   /// * [String] id (required):
@@ -437,7 +480,9 @@ class SharedLinksApi {
     return null;
   }
 
-  /// This endpoint requires the `sharedLink.update` permission.
+  /// Update a shared link
+  ///
+  /// Update an existing shared link by its ID.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -472,7 +517,9 @@ class SharedLinksApi {
     );
   }
 
-  /// This endpoint requires the `sharedLink.update` permission.
+  /// Update a shared link
+  ///
+  /// Update an existing shared link by its ID.
   ///
   /// Parameters:
   ///

mobile/openapi/lib/api/stacks_api.dart

@@ -16,7 +16,9 @@ class StacksApi {
 
   final ApiClient apiClient;
 
-  /// This endpoint requires the `stack.create` permission.
+  /// Create a stack
+  ///
+  /// Create a new stack by providing a name and a list of asset IDs to include in the stack. If any of the provided asset IDs are primary assets of an existing stack, the existing stack will be merged into the newly created stack.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -48,7 +50,9 @@ class StacksApi {
     );
   }
 
-  /// This endpoint requires the `stack.create` permission.
+  /// Create a stack
+  ///
+  /// Create a new stack by providing a name and a list of asset IDs to include in the stack. If any of the provided asset IDs are primary assets of an existing stack, the existing stack will be merged into the newly created stack.
   ///
   /// Parameters:
   ///
@@ -68,7 +72,9 @@ class StacksApi {
     return null;
   }
 
-  /// This endpoint requires the `stack.delete` permission.
+  /// Delete a stack
+  ///
+  /// Delete a specific stack by its ID.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -101,7 +107,9 @@ class StacksApi {
     );
   }
 
-  /// This endpoint requires the `stack.delete` permission.
+  /// Delete a stack
+  ///
+  /// Delete a specific stack by its ID.
   ///
   /// Parameters:
   ///
@@ -113,7 +121,9 @@ class StacksApi {
     }
   }
 
-  /// This endpoint requires the `stack.delete` permission.
+  /// Delete stacks
+  ///
+  /// Delete multiple stacks by providing a list of stack IDs.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -145,7 +155,9 @@ class StacksApi {
     );
   }
 
-  /// This endpoint requires the `stack.delete` permission.
+  /// Delete stacks
+  ///
+  /// Delete multiple stacks by providing a list of stack IDs.
   ///
   /// Parameters:
   ///
@@ -157,7 +169,9 @@ class StacksApi {
     }
   }
 
-  /// This endpoint requires the `stack.read` permission.
+  /// Retrieve a stack
+  ///
+  /// Retrieve a specific stack by its ID.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -190,7 +204,9 @@ class StacksApi {
     );
   }
 
-  /// This endpoint requires the `stack.read` permission.
+  /// Retrieve a stack
+  ///
+  /// Retrieve a specific stack by its ID.
   ///
   /// Parameters:
   ///
@@ -210,7 +226,9 @@ class StacksApi {
     return null;
   }
 
-  /// This endpoint requires the `stack.update` permission.
+  /// Remove an asset from a stack
+  ///
+  /// Remove a specific asset from a stack by providing the stack ID and asset ID.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -246,7 +264,9 @@ class StacksApi {
     );
   }
 
-  /// This endpoint requires the `stack.update` permission.
+  /// Remove an asset from a stack
+  ///
+  /// Remove a specific asset from a stack by providing the stack ID and asset ID.
   ///
   /// Parameters:
   ///
@@ -260,7 +280,9 @@ class StacksApi {
     }
   }
 
-  /// This endpoint requires the `stack.read` permission.
+  /// Retrieve stacks
+  ///
+  /// Retrieve a list of stacks.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -296,7 +318,9 @@ class StacksApi {
     );
   }
 
-  /// This endpoint requires the `stack.read` permission.
+  /// Retrieve stacks
+  ///
+  /// Retrieve a list of stacks.
   ///
   /// Parameters:
   ///
@@ -319,7 +343,9 @@ class StacksApi {
     return null;
   }
 
-  /// This endpoint requires the `stack.update` permission.
+  /// Update a stack
+  ///
+  /// Update an existing stack by its ID.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -354,7 +380,9 @@ class StacksApi {
     );
   }
 
-  /// This endpoint requires the `stack.update` permission.
+  /// Update a stack
+  ///
+  /// Update an existing stack by its ID.
   ///
   /// Parameters:
   ///

mobile/openapi/lib/api/sync_api.dart

@@ -16,7 +16,9 @@ class SyncApi {
 
   final ApiClient apiClient;
 
-  /// This endpoint requires the `syncCheckpoint.delete` permission.
+  /// Delete acknowledgements
+  ///
+  /// Delete specific synchronization acknowledgments.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -48,7 +50,9 @@ class SyncApi {
     );
   }
 
-  /// This endpoint requires the `syncCheckpoint.delete` permission.
+  /// Delete acknowledgements
+  ///
+  /// Delete specific synchronization acknowledgments.
   ///
   /// Parameters:
   ///
@@ -60,7 +64,12 @@ class SyncApi {
     }
   }
 
-  /// Performs an HTTP 'POST /sync/delta-sync' operation and returns the [Response].
+  /// Get delta sync for user
+  ///
+  /// Retrieve changed assets since the last sync for the authenticated user.
+  ///
+  /// Note: This method returns the HTTP [Response].
+  ///
   /// Parameters:
   ///
   /// * [AssetDeltaSyncDto] assetDeltaSyncDto (required):
@@ -89,6 +98,10 @@ class SyncApi {
     );
   }
 
+  /// Get delta sync for user
+  ///
+  /// Retrieve changed assets since the last sync for the authenticated user.
+  ///
   /// Parameters:
   ///
   /// * [AssetDeltaSyncDto] assetDeltaSyncDto (required):
@@ -107,7 +120,12 @@ class SyncApi {
     return null;
   }
 
-  /// Performs an HTTP 'POST /sync/full-sync' operation and returns the [Response].
+  /// Get full sync for user
+  ///
+  /// Retrieve all assets for a full synchronization for the authenticated user.
+  ///
+  /// Note: This method returns the HTTP [Response].
+  ///
   /// Parameters:
   ///
   /// * [AssetFullSyncDto] assetFullSyncDto (required):
@@ -136,6 +154,10 @@ class SyncApi {
     );
   }
 
+  /// Get full sync for user
+  ///
+  /// Retrieve all assets for a full synchronization for the authenticated user.
+  ///
   /// Parameters:
   ///
   /// * [AssetFullSyncDto] assetFullSyncDto (required):
@@ -157,7 +179,9 @@ class SyncApi {
     return null;
   }
 
-  /// This endpoint requires the `syncCheckpoint.read` permission.
+  /// Retrieve acknowledgements
+  ///
+  /// Retrieve the synchronization acknowledgments for the current session.
   ///
   /// Note: This method returns the HTTP [Response].
   Future<Response> getSyncAckWithHttpInfo() async {
@@ -185,7 +209,9 @@ class SyncApi {
     );
   }
 
-  /// This endpoint requires the `syncCheckpoint.read` permission.
+  /// Retrieve acknowledgements
+  ///
+  /// Retrieve the synchronization acknowledgments for the current session.
   Future<List<SyncAckDto>?> getSyncAck() async {
     final response = await getSyncAckWithHttpInfo();
     if (response.statusCode >= HttpStatus.badRequest) {
@@ -204,7 +230,9 @@ class SyncApi {
     return null;
   }
 
-  /// This endpoint requires the `sync.stream` permission.
+  /// Stream sync changes
+  ///
+  /// Retrieve a JSON lines streamed response of changes for synchronization. This endpoint is used by the mobile app to efficiently stay up to date with changes.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -236,7 +264,9 @@ class SyncApi {
     );
   }
 
-  /// This endpoint requires the `sync.stream` permission.
+  /// Stream sync changes
+  ///
+  /// Retrieve a JSON lines streamed response of changes for synchronization. This endpoint is used by the mobile app to efficiently stay up to date with changes.
   ///
   /// Parameters:
   ///
@@ -248,7 +278,9 @@ class SyncApi {
     }
   }
 
-  /// This endpoint requires the `syncCheckpoint.update` permission.
+  /// Acknowledge changes
+  ///
+  /// Send a list of synchronization acknowledgements to confirm that the latest changes have been received.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -280,7 +312,9 @@ class SyncApi {
     );
   }
 
-  /// This endpoint requires the `syncCheckpoint.update` permission.
+  /// Acknowledge changes
+  ///
+  /// Send a list of synchronization acknowledgements to confirm that the latest changes have been received.
   ///
   /// Parameters:
   ///

mobile/openapi/lib/api/system_config_api.dart

@@ -16,7 +16,9 @@ class SystemConfigApi {
 
   final ApiClient apiClient;
 
-  /// This endpoint is an admin-only route, and requires the `systemConfig.read` permission.
+  /// Get system configuration
+  ///
+  /// Retrieve the current system configuration.
   ///
   /// Note: This method returns the HTTP [Response].
   Future<Response> getConfigWithHttpInfo() async {
@@ -44,7 +46,9 @@ class SystemConfigApi {
     );
   }
 
-  /// This endpoint is an admin-only route, and requires the `systemConfig.read` permission.
+  /// Get system configuration
+  ///
+  /// Retrieve the current system configuration.
   Future<SystemConfigDto?> getConfig() async {
     final response = await getConfigWithHttpInfo();
     if (response.statusCode >= HttpStatus.badRequest) {
@@ -60,7 +64,9 @@ class SystemConfigApi {
     return null;
   }
 
-  /// This endpoint is an admin-only route, and requires the `systemConfig.read` permission.
+  /// Get system configuration defaults
+  ///
+  /// Retrieve the default values for the system configuration.
   ///
   /// Note: This method returns the HTTP [Response].
   Future<Response> getConfigDefaultsWithHttpInfo() async {
@@ -88,7 +94,9 @@ class SystemConfigApi {
     );
   }
 
-  /// This endpoint is an admin-only route, and requires the `systemConfig.read` permission.
+  /// Get system configuration defaults
+  ///
+  /// Retrieve the default values for the system configuration.
   Future<SystemConfigDto?> getConfigDefaults() async {
     final response = await getConfigDefaultsWithHttpInfo();
     if (response.statusCode >= HttpStatus.badRequest) {
@@ -104,7 +112,9 @@ class SystemConfigApi {
     return null;
   }
 
-  /// This endpoint is an admin-only route, and requires the `systemConfig.read` permission.
+  /// Get storage template options
+  ///
+  /// Retrieve exemplary storage template options.
   ///
   /// Note: This method returns the HTTP [Response].
   Future<Response> getStorageTemplateOptionsWithHttpInfo() async {
@@ -132,7 +142,9 @@ class SystemConfigApi {
     );
   }
 
-  /// This endpoint is an admin-only route, and requires the `systemConfig.read` permission.
+  /// Get storage template options
+  ///
+  /// Retrieve exemplary storage template options.
   Future<SystemConfigTemplateStorageOptionDto?> getStorageTemplateOptions() async {
     final response = await getStorageTemplateOptionsWithHttpInfo();
     if (response.statusCode >= HttpStatus.badRequest) {
@@ -148,7 +160,9 @@ class SystemConfigApi {
     return null;
   }
 
-  /// This endpoint is an admin-only route, and requires the `systemConfig.update` permission.
+  /// Update system configuration
+  ///
+  /// Update the system configuration with a new system configuration.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -180,7 +194,9 @@ class SystemConfigApi {
     );
   }
 
-  /// This endpoint is an admin-only route, and requires the `systemConfig.update` permission.
+  /// Update system configuration
+  ///
+  /// Update the system configuration with a new system configuration.
   ///
   /// Parameters:
   ///

mobile/openapi/lib/api/system_metadata_api.dart

@@ -16,7 +16,9 @@ class SystemMetadataApi {
 
   final ApiClient apiClient;
 
-  /// This endpoint is an admin-only route, and requires the `systemMetadata.read` permission.
+  /// Retrieve admin onboarding
+  ///
+  /// Retrieve the current admin onboarding status.
   ///
   /// Note: This method returns the HTTP [Response].
   Future<Response> getAdminOnboardingWithHttpInfo() async {
@@ -44,7 +46,9 @@ class SystemMetadataApi {
     );
   }
 
-  /// This endpoint is an admin-only route, and requires the `systemMetadata.read` permission.
+  /// Retrieve admin onboarding
+  ///
+  /// Retrieve the current admin onboarding status.
   Future<AdminOnboardingUpdateDto?> getAdminOnboarding() async {
     final response = await getAdminOnboardingWithHttpInfo();
     if (response.statusCode >= HttpStatus.badRequest) {
@@ -60,7 +64,9 @@ class SystemMetadataApi {
     return null;
   }
 
-  /// This endpoint is an admin-only route, and requires the `systemMetadata.read` permission.
+  /// Retrieve reverse geocoding state
+  ///
+  /// Retrieve the current state of the reverse geocoding import.
   ///
   /// Note: This method returns the HTTP [Response].
   Future<Response> getReverseGeocodingStateWithHttpInfo() async {
@@ -88,7 +94,9 @@ class SystemMetadataApi {
     );
   }
 
-  /// This endpoint is an admin-only route, and requires the `systemMetadata.read` permission.
+  /// Retrieve reverse geocoding state
+  ///
+  /// Retrieve the current state of the reverse geocoding import.
   Future<ReverseGeocodingStateResponseDto?> getReverseGeocodingState() async {
     final response = await getReverseGeocodingStateWithHttpInfo();
     if (response.statusCode >= HttpStatus.badRequest) {
@@ -104,7 +112,9 @@ class SystemMetadataApi {
     return null;
   }
 
-  /// This endpoint is an admin-only route, and requires the `systemMetadata.read` permission.
+  /// Retrieve version check state
+  ///
+  /// Retrieve the current state of the version check process.
   ///
   /// Note: This method returns the HTTP [Response].
   Future<Response> getVersionCheckStateWithHttpInfo() async {
@@ -132,7 +142,9 @@ class SystemMetadataApi {
     );
   }
 
-  /// This endpoint is an admin-only route, and requires the `systemMetadata.read` permission.
+  /// Retrieve version check state
+  ///
+  /// Retrieve the current state of the version check process.
   Future<VersionCheckStateResponseDto?> getVersionCheckState() async {
     final response = await getVersionCheckStateWithHttpInfo();
     if (response.statusCode >= HttpStatus.badRequest) {
@@ -148,7 +160,9 @@ class SystemMetadataApi {
     return null;
   }
 
-  /// This endpoint is an admin-only route, and requires the `systemMetadata.update` permission.
+  /// Update admin onboarding
+  ///
+  /// Update the admin onboarding status.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -180,7 +194,9 @@ class SystemMetadataApi {
     );
   }
 
-  /// This endpoint is an admin-only route, and requires the `systemMetadata.update` permission.
+  /// Update admin onboarding
+  ///
+  /// Update the admin onboarding status.
   ///
   /// Parameters:
   ///

mobile/openapi/lib/api/tags_api.dart

@@ -16,7 +16,9 @@ class TagsApi {
 
   final ApiClient apiClient;
 
-  /// This endpoint requires the `tag.asset` permission.
+  /// Tag assets
+  ///
+  /// Add multiple tags to multiple assets in a single request.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -48,7 +50,9 @@ class TagsApi {
     );
   }
 
-  /// This endpoint requires the `tag.asset` permission.
+  /// Tag assets
+  ///
+  /// Add multiple tags to multiple assets in a single request.
   ///
   /// Parameters:
   ///
@@ -68,7 +72,9 @@ class TagsApi {
     return null;
   }
 
-  /// This endpoint requires the `tag.create` permission.
+  /// Create a tag
+  ///
+  /// Create a new tag by providing a name and optional color.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -100,7 +106,9 @@ class TagsApi {
     );
   }
 
-  /// This endpoint requires the `tag.create` permission.
+  /// Create a tag
+  ///
+  /// Create a new tag by providing a name and optional color.
   ///
   /// Parameters:
   ///
@@ -120,7 +128,9 @@ class TagsApi {
     return null;
   }
 
-  /// This endpoint requires the `tag.delete` permission.
+  /// Delete a tag
+  ///
+  /// Delete a specific tag by its ID.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -153,7 +163,9 @@ class TagsApi {
     );
   }
 
-  /// This endpoint requires the `tag.delete` permission.
+  /// Delete a tag
+  ///
+  /// Delete a specific tag by its ID.
   ///
   /// Parameters:
   ///
@@ -165,7 +177,9 @@ class TagsApi {
     }
   }
 
-  /// This endpoint requires the `tag.read` permission.
+  /// Retrieve tags
+  ///
+  /// Retrieve a list of all tags.
   ///
   /// Note: This method returns the HTTP [Response].
   Future<Response> getAllTagsWithHttpInfo() async {
@@ -193,7 +207,9 @@ class TagsApi {
     );
   }
 
-  /// This endpoint requires the `tag.read` permission.
+  /// Retrieve tags
+  ///
+  /// Retrieve a list of all tags.
   Future<List<TagResponseDto>?> getAllTags() async {
     final response = await getAllTagsWithHttpInfo();
     if (response.statusCode >= HttpStatus.badRequest) {
@@ -212,7 +228,9 @@ class TagsApi {
     return null;
   }
 
-  /// This endpoint requires the `tag.read` permission.
+  /// Retrieve a tag
+  ///
+  /// Retrieve a specific tag by its ID.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -245,7 +263,9 @@ class TagsApi {
     );
   }
 
-  /// This endpoint requires the `tag.read` permission.
+  /// Retrieve a tag
+  ///
+  /// Retrieve a specific tag by its ID.
   ///
   /// Parameters:
   ///
@@ -265,7 +285,9 @@ class TagsApi {
     return null;
   }
 
-  /// This endpoint requires the `tag.asset` permission.
+  /// Tag assets
+  ///
+  /// Add a tag to all the specified assets.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -300,7 +322,9 @@ class TagsApi {
     );
   }
 
-  /// This endpoint requires the `tag.asset` permission.
+  /// Tag assets
+  ///
+  /// Add a tag to all the specified assets.
   ///
   /// Parameters:
   ///
@@ -325,7 +349,9 @@ class TagsApi {
     return null;
   }
 
-  /// This endpoint requires the `tag.asset` permission.
+  /// Untag assets
+  ///
+  /// Remove a tag from all the specified assets.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -360,7 +386,9 @@ class TagsApi {
     );
   }
 
-  /// This endpoint requires the `tag.asset` permission.
+  /// Untag assets
+  ///
+  /// Remove a tag from all the specified assets.
   ///
   /// Parameters:
   ///
@@ -385,7 +413,9 @@ class TagsApi {
     return null;
   }
 
-  /// This endpoint requires the `tag.update` permission.
+  /// Update a tag
+  ///
+  /// Update an existing tag identified by its ID.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -420,7 +450,9 @@ class TagsApi {
     );
   }
 
-  /// This endpoint requires the `tag.update` permission.
+  /// Update a tag
+  ///
+  /// Update an existing tag identified by its ID.
   ///
   /// Parameters:
   ///
@@ -442,7 +474,9 @@ class TagsApi {
     return null;
   }
 
-  /// This endpoint requires the `tag.create` permission.
+  /// Upsert tags
+  ///
+  /// Create or update multiple tags in a single request.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -474,7 +508,9 @@ class TagsApi {
     );
   }
 
-  /// This endpoint requires the `tag.create` permission.
+  /// Upsert tags
+  ///
+  /// Create or update multiple tags in a single request.
   ///
   /// Parameters:
   ///

mobile/openapi/lib/api/timeline_api.dart

@@ -16,7 +16,9 @@ class TimelineApi {
 
   final ApiClient apiClient;
 
-  /// This endpoint requires the `asset.read` permission.
+  /// Get time bucket
+  ///
+  /// Retrieve a string of all asset ids in a given time bucket.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -127,7 +129,9 @@ class TimelineApi {
     );
   }
 
-  /// This endpoint requires the `asset.read` permission.
+  /// Get time bucket
+  ///
+  /// Retrieve a string of all asset ids in a given time bucket.
   ///
   /// Parameters:
   ///
@@ -185,7 +189,9 @@ class TimelineApi {
     return null;
   }
 
-  /// This endpoint requires the `asset.read` permission.
+  /// Get time buckets
+  ///
+  /// Retrieve a list of all minimal time buckets.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -292,7 +298,9 @@ class TimelineApi {
     );
   }
 
-  /// This endpoint requires the `asset.read` permission.
+  /// Get time buckets
+  ///
+  /// Retrieve a list of all minimal time buckets.
   ///
   /// Parameters:
   ///

mobile/openapi/lib/api/trash_api.dart

@@ -16,7 +16,9 @@ class TrashApi {
 
   final ApiClient apiClient;
 
-  /// This endpoint requires the `asset.delete` permission.
+  /// Empty trash
+  ///
+  /// Permanently delete all items in the trash.
   ///
   /// Note: This method returns the HTTP [Response].
   Future<Response> emptyTrashWithHttpInfo() async {
@@ -44,7 +46,9 @@ class TrashApi {
     );
   }
 
-  /// This endpoint requires the `asset.delete` permission.
+  /// Empty trash
+  ///
+  /// Permanently delete all items in the trash.
   Future<TrashResponseDto?> emptyTrash() async {
     final response = await emptyTrashWithHttpInfo();
     if (response.statusCode >= HttpStatus.badRequest) {
@@ -60,7 +64,9 @@ class TrashApi {
     return null;
   }
 
-  /// This endpoint requires the `asset.delete` permission.
+  /// Restore assets
+  ///
+  /// Restore specific assets from the trash.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -92,7 +98,9 @@ class TrashApi {
     );
   }
 
-  /// This endpoint requires the `asset.delete` permission.
+  /// Restore assets
+  ///
+  /// Restore specific assets from the trash.
   ///
   /// Parameters:
   ///
@@ -112,7 +120,9 @@ class TrashApi {
     return null;
   }
 
-  /// This endpoint requires the `asset.delete` permission.
+  /// Restore trash
+  ///
+  /// Restore all items in the trash.
   ///
   /// Note: This method returns the HTTP [Response].
   Future<Response> restoreTrashWithHttpInfo() async {
@@ -140,7 +150,9 @@ class TrashApi {
     );
   }
 
-  /// This endpoint requires the `asset.delete` permission.
+  /// Restore trash
+  ///
+  /// Restore all items in the trash.
   Future<TrashResponseDto?> restoreTrash() async {
     final response = await restoreTrashWithHttpInfo();
     if (response.statusCode >= HttpStatus.badRequest) {

mobile/openapi/lib/api/users_admin_api.dart

@@ -16,7 +16,9 @@ class UsersAdminApi {
 
   final ApiClient apiClient;
 
-  /// This endpoint is an admin-only route, and requires the `adminUser.create` permission.
+  /// Create a user
+  ///
+  /// Create a new user.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -48,7 +50,9 @@ class UsersAdminApi {
     );
   }
 
-  /// This endpoint is an admin-only route, and requires the `adminUser.create` permission.
+  /// Create a user
+  ///
+  /// Create a new user.
   ///
   /// Parameters:
   ///
@@ -68,7 +72,9 @@ class UsersAdminApi {
     return null;
   }
 
-  /// This endpoint is an admin-only route, and requires the `adminUser.delete` permission.
+  /// Delete a user
+  ///
+  /// Delete a user.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -103,7 +109,9 @@ class UsersAdminApi {
     );
   }
 
-  /// This endpoint is an admin-only route, and requires the `adminUser.delete` permission.
+  /// Delete a user
+  ///
+  /// Delete a user.
   ///
   /// Parameters:
   ///
@@ -125,7 +133,9 @@ class UsersAdminApi {
     return null;
   }
 
-  /// This endpoint is an admin-only route, and requires the `adminUser.read` permission.
+  /// Retrieve a user
+  ///
+  /// Retrieve  a specific user by their ID.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -158,7 +168,9 @@ class UsersAdminApi {
     );
   }
 
-  /// This endpoint is an admin-only route, and requires the `adminUser.read` permission.
+  /// Retrieve a user
+  ///
+  /// Retrieve  a specific user by their ID.
   ///
   /// Parameters:
   ///
@@ -178,7 +190,9 @@ class UsersAdminApi {
     return null;
   }
 
-  /// This endpoint is an admin-only route, and requires the `adminUser.read` permission.
+  /// Retrieve user preferences
+  ///
+  /// Retrieve the preferences of a specific user.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -211,7 +225,9 @@ class UsersAdminApi {
     );
   }
 
-  /// This endpoint is an admin-only route, and requires the `adminUser.read` permission.
+  /// Retrieve user preferences
+  ///
+  /// Retrieve the preferences of a specific user.
   ///
   /// Parameters:
   ///
@@ -231,7 +247,9 @@ class UsersAdminApi {
     return null;
   }
 
-  /// This endpoint is an admin-only route, and requires the `adminSession.read` permission.
+  /// Retrieve user sessions
+  ///
+  /// Retrieve all sessions for a specific user.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -264,7 +282,9 @@ class UsersAdminApi {
     );
   }
 
-  /// This endpoint is an admin-only route, and requires the `adminSession.read` permission.
+  /// Retrieve user sessions
+  ///
+  /// Retrieve all sessions for a specific user.
   ///
   /// Parameters:
   ///
@@ -287,7 +307,9 @@ class UsersAdminApi {
     return null;
   }
 
-  /// This endpoint is an admin-only route, and requires the `adminUser.read` permission.
+  /// Retrieve user statistics
+  ///
+  /// Retrieve asset statistics for a specific user.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -336,7 +358,9 @@ class UsersAdminApi {
     );
   }
 
-  /// This endpoint is an admin-only route, and requires the `adminUser.read` permission.
+  /// Retrieve user statistics
+  ///
+  /// Retrieve asset statistics for a specific user.
   ///
   /// Parameters:
   ///
@@ -362,7 +386,9 @@ class UsersAdminApi {
     return null;
   }
 
-  /// This endpoint is an admin-only route, and requires the `adminUser.delete` permission.
+  /// Restore a deleted user
+  ///
+  /// Restore a previously deleted user.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -395,7 +421,9 @@ class UsersAdminApi {
     );
   }
 
-  /// This endpoint is an admin-only route, and requires the `adminUser.delete` permission.
+  /// Restore a deleted user
+  ///
+  /// Restore a previously deleted user.
   ///
   /// Parameters:
   ///
@@ -415,7 +443,9 @@ class UsersAdminApi {
     return null;
   }
 
-  /// This endpoint is an admin-only route, and requires the `adminUser.read` permission.
+  /// Search users
+  ///
+  /// Search for users.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -456,7 +486,9 @@ class UsersAdminApi {
     );
   }
 
-  /// This endpoint is an admin-only route, and requires the `adminUser.read` permission.
+  /// Search users
+  ///
+  /// Search for users.
   ///
   /// Parameters:
   ///
@@ -481,7 +513,9 @@ class UsersAdminApi {
     return null;
   }
 
-  /// This endpoint is an admin-only route, and requires the `adminUser.update` permission.
+  /// Update a user
+  ///
+  /// Update an existing user.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -516,7 +550,9 @@ class UsersAdminApi {
     );
   }
 
-  /// This endpoint is an admin-only route, and requires the `adminUser.update` permission.
+  /// Update a user
+  ///
+  /// Update an existing user.
   ///
   /// Parameters:
   ///
@@ -538,7 +574,9 @@ class UsersAdminApi {
     return null;
   }
 
-  /// This endpoint is an admin-only route, and requires the `adminUser.update` permission.
+  /// Update user preferences
+  ///
+  /// Update the preferences of a specific user.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -573,7 +611,9 @@ class UsersAdminApi {
     );
   }
 
-  /// This endpoint is an admin-only route, and requires the `adminUser.update` permission.
+  /// Update user preferences
+  ///
+  /// Update the preferences of a specific user.
   ///
   /// Parameters:
   ///

mobile/openapi/lib/api/users_api.dart

@@ -16,7 +16,9 @@ class UsersApi {
 
   final ApiClient apiClient;
 
-  /// This endpoint requires the `userProfileImage.update` permission.
+  /// Create user profile image
+  ///
+  /// Upload and set a new profile image for the current user.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -58,7 +60,9 @@ class UsersApi {
     );
   }
 
-  /// This endpoint requires the `userProfileImage.update` permission.
+  /// Create user profile image
+  ///
+  /// Upload and set a new profile image for the current user.
   ///
   /// Parameters:
   ///
@@ -78,7 +82,9 @@ class UsersApi {
     return null;
   }
 
-  /// This endpoint requires the `userProfileImage.delete` permission.
+  /// Delete user profile image
+  ///
+  /// Delete the profile image of the current user.
   ///
   /// Note: This method returns the HTTP [Response].
   Future<Response> deleteProfileImageWithHttpInfo() async {
@@ -106,7 +112,9 @@ class UsersApi {
     );
   }
 
-  /// This endpoint requires the `userProfileImage.delete` permission.
+  /// Delete user profile image
+  ///
+  /// Delete the profile image of the current user.
   Future<void> deleteProfileImage() async {
     final response = await deleteProfileImageWithHttpInfo();
     if (response.statusCode >= HttpStatus.badRequest) {
@@ -114,7 +122,9 @@ class UsersApi {
     }
   }
 
-  /// This endpoint requires the `userLicense.delete` permission.
+  /// Delete user product key
+  ///
+  /// Delete the registered product key for the current user.
   ///
   /// Note: This method returns the HTTP [Response].
   Future<Response> deleteUserLicenseWithHttpInfo() async {
@@ -142,7 +152,9 @@ class UsersApi {
     );
   }
 
-  /// This endpoint requires the `userLicense.delete` permission.
+  /// Delete user product key
+  ///
+  /// Delete the registered product key for the current user.
   Future<void> deleteUserLicense() async {
     final response = await deleteUserLicenseWithHttpInfo();
     if (response.statusCode >= HttpStatus.badRequest) {
@@ -150,7 +162,9 @@ class UsersApi {
     }
   }
 
-  /// This endpoint requires the `userOnboarding.delete` permission.
+  /// Delete user onboarding
+  ///
+  /// Delete the onboarding status of the current user.
   ///
   /// Note: This method returns the HTTP [Response].
   Future<Response> deleteUserOnboardingWithHttpInfo() async {
@@ -178,7 +192,9 @@ class UsersApi {
     );
   }
 
-  /// This endpoint requires the `userOnboarding.delete` permission.
+  /// Delete user onboarding
+  ///
+  /// Delete the onboarding status of the current user.
   Future<void> deleteUserOnboarding() async {
     final response = await deleteUserOnboardingWithHttpInfo();
     if (response.statusCode >= HttpStatus.badRequest) {
@@ -186,7 +202,9 @@ class UsersApi {
     }
   }
 
-  /// This endpoint requires the `userPreference.read` permission.
+  /// Get my preferences
+  ///
+  /// Retrieve the preferences for the current user.
   ///
   /// Note: This method returns the HTTP [Response].
   Future<Response> getMyPreferencesWithHttpInfo() async {
@@ -214,7 +232,9 @@ class UsersApi {
     );
   }
 
-  /// This endpoint requires the `userPreference.read` permission.
+  /// Get my preferences
+  ///
+  /// Retrieve the preferences for the current user.
   Future<UserPreferencesResponseDto?> getMyPreferences() async {
     final response = await getMyPreferencesWithHttpInfo();
     if (response.statusCode >= HttpStatus.badRequest) {
@@ -230,7 +250,9 @@ class UsersApi {
     return null;
   }
 
-  /// This endpoint requires the `user.read` permission.
+  /// Get current user
+  ///
+  /// Retrieve information about the user making the API request.
   ///
   /// Note: This method returns the HTTP [Response].
   Future<Response> getMyUserWithHttpInfo() async {
@@ -258,7 +280,9 @@ class UsersApi {
     );
   }
 
-  /// This endpoint requires the `user.read` permission.
+  /// Get current user
+  ///
+  /// Retrieve information about the user making the API request.
   Future<UserAdminResponseDto?> getMyUser() async {
     final response = await getMyUserWithHttpInfo();
     if (response.statusCode >= HttpStatus.badRequest) {
@@ -274,7 +298,9 @@ class UsersApi {
     return null;
   }
 
-  /// This endpoint requires the `userProfileImage.read` permission.
+  /// Retrieve user profile image
+  ///
+  /// Retrieve the profile image file for a user.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -307,7 +333,9 @@ class UsersApi {
     );
   }
 
-  /// This endpoint requires the `userProfileImage.read` permission.
+  /// Retrieve user profile image
+  ///
+  /// Retrieve the profile image file for a user.
   ///
   /// Parameters:
   ///
@@ -327,7 +355,9 @@ class UsersApi {
     return null;
   }
 
-  /// This endpoint requires the `user.read` permission.
+  /// Retrieve a user
+  ///
+  /// Retrieve a specific user by their ID.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -360,7 +390,9 @@ class UsersApi {
     );
   }
 
-  /// This endpoint requires the `user.read` permission.
+  /// Retrieve a user
+  ///
+  /// Retrieve a specific user by their ID.
   ///
   /// Parameters:
   ///
@@ -380,7 +412,9 @@ class UsersApi {
     return null;
   }
 
-  /// This endpoint requires the `userLicense.read` permission.
+  /// Retrieve user product key
+  ///
+  /// Retrieve information about whether the current user has a registered product key.
   ///
   /// Note: This method returns the HTTP [Response].
   Future<Response> getUserLicenseWithHttpInfo() async {
@@ -408,7 +442,9 @@ class UsersApi {
     );
   }
 
-  /// This endpoint requires the `userLicense.read` permission.
+  /// Retrieve user product key
+  ///
+  /// Retrieve information about whether the current user has a registered product key.
   Future<LicenseResponseDto?> getUserLicense() async {
     final response = await getUserLicenseWithHttpInfo();
     if (response.statusCode >= HttpStatus.badRequest) {
@@ -424,7 +460,9 @@ class UsersApi {
     return null;
   }
 
-  /// This endpoint requires the `userOnboarding.read` permission.
+  /// Retrieve user onboarding
+  ///
+  /// Retrieve the onboarding status of the current user.
   ///
   /// Note: This method returns the HTTP [Response].
   Future<Response> getUserOnboardingWithHttpInfo() async {
@@ -452,7 +490,9 @@ class UsersApi {
     );
   }
 
-  /// This endpoint requires the `userOnboarding.read` permission.
+  /// Retrieve user onboarding
+  ///
+  /// Retrieve the onboarding status of the current user.
   Future<OnboardingResponseDto?> getUserOnboarding() async {
     final response = await getUserOnboardingWithHttpInfo();
     if (response.statusCode >= HttpStatus.badRequest) {
@@ -468,7 +508,9 @@ class UsersApi {
     return null;
   }
 
-  /// This endpoint requires the `user.read` permission.
+  /// Get all users
+  ///
+  /// Retrieve a list of all users on the server.
   ///
   /// Note: This method returns the HTTP [Response].
   Future<Response> searchUsersWithHttpInfo() async {
@@ -496,7 +538,9 @@ class UsersApi {
     );
   }
 
-  /// This endpoint requires the `user.read` permission.
+  /// Get all users
+  ///
+  /// Retrieve a list of all users on the server.
   Future<List<UserResponseDto>?> searchUsers() async {
     final response = await searchUsersWithHttpInfo();
     if (response.statusCode >= HttpStatus.badRequest) {
@@ -515,7 +559,9 @@ class UsersApi {
     return null;
   }
 
-  /// This endpoint requires the `userLicense.update` permission.
+  /// Set user product key
+  ///
+  /// Register a product key for the current user.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -547,7 +593,9 @@ class UsersApi {
     );
   }
 
-  /// This endpoint requires the `userLicense.update` permission.
+  /// Set user product key
+  ///
+  /// Register a product key for the current user.
   ///
   /// Parameters:
   ///
@@ -567,7 +615,9 @@ class UsersApi {
     return null;
   }
 
-  /// This endpoint requires the `userOnboarding.update` permission.
+  /// Update user onboarding
+  ///
+  /// Update the onboarding status of the current user.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -599,7 +649,9 @@ class UsersApi {
     );
   }
 
-  /// This endpoint requires the `userOnboarding.update` permission.
+  /// Update user onboarding
+  ///
+  /// Update the onboarding status of the current user.
   ///
   /// Parameters:
   ///
@@ -619,7 +671,9 @@ class UsersApi {
     return null;
   }
 
-  /// This endpoint requires the `userPreference.update` permission.
+  /// Update my preferences
+  ///
+  /// Update the preferences of the current user.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -651,7 +705,9 @@ class UsersApi {
     );
   }
 
-  /// This endpoint requires the `userPreference.update` permission.
+  /// Update my preferences
+  ///
+  /// Update the preferences of the current user.
   ///
   /// Parameters:
   ///
@@ -671,7 +727,9 @@ class UsersApi {
     return null;
   }
 
-  /// This endpoint requires the `user.update` permission.
+  /// Update current user
+  ///
+  /// Update the current user making teh API request.
   ///
   /// Note: This method returns the HTTP [Response].
   ///
@@ -703,7 +761,9 @@ class UsersApi {
     );
   }
 
-  /// This endpoint requires the `user.update` permission.
+  /// Update current user
+  ///
+  /// Update the current user making teh API request.
   ///
   /// Parameters:
   ///

mobile/openapi/lib/api/views_api.dart

@@ -11,12 +11,17 @@
 part of openapi.api;
 
 
-class ViewApi {
-  ViewApi([ApiClient? apiClient]) : apiClient = apiClient ?? defaultApiClient;
+class ViewsApi {
+  ViewsApi([ApiClient? apiClient]) : apiClient = apiClient ?? defaultApiClient;
 
   final ApiClient apiClient;
 
-  /// Performs an HTTP 'GET /view/folder' operation and returns the [Response].
+  /// Retrieve assets by original path
+  ///
+  /// Retrieve assets that are children of a specific folder.
+  ///
+  /// Note: This method returns the HTTP [Response].
+  ///
   /// Parameters:
   ///
   /// * [String] path (required):
@@ -47,6 +52,10 @@ class ViewApi {
     );
   }
 
+  /// Retrieve assets by original path
+  ///
+  /// Retrieve assets that are children of a specific folder.
+  ///
   /// Parameters:
   ///
   /// * [String] path (required):
@@ -68,7 +77,11 @@ class ViewApi {
     return null;
   }
 
-  /// Performs an HTTP 'GET /view/folder/unique-paths' operation and returns the [Response].
+  /// Retrieve unique paths
+  ///
+  /// Retrieve a list of unique folder paths from asset original paths.
+  ///
+  /// Note: This method returns the HTTP [Response].
   Future<Response> getUniqueOriginalPathsWithHttpInfo() async {
     // ignore: prefer_const_declarations
     final apiPath = r'/view/folder/unique-paths';
@@ -94,6 +107,9 @@ class ViewApi {
     );
   }
 
+  /// Retrieve unique paths
+  ///
+  /// Retrieve a list of unique folder paths from asset original paths.
   Future<List<String>?> getUniqueOriginalPaths() async {
     final response = await getUniqueOriginalPathsWithHttpInfo();
     if (response.statusCode >= HttpStatus.badRequest) {

mobile/openapi/lib/api/workflows_api.dart

@@ -11,21 +11,26 @@
 part of openapi.api;
 
 
-class OAuthApi {
-  OAuthApi([ApiClient? apiClient]) : apiClient = apiClient ?? defaultApiClient;
+class WorkflowsApi {
+  WorkflowsApi([ApiClient? apiClient]) : apiClient = apiClient ?? defaultApiClient;
 
   final ApiClient apiClient;
 
-  /// Performs an HTTP 'POST /oauth/callback' operation and returns the [Response].
+  /// Create a workflow
+  ///
+  /// Create a new workflow, the workflow can also be created with empty filters and actions.
+  ///
+  /// Note: This method returns the HTTP [Response].
+  ///
   /// Parameters:
   ///
-  /// * [OAuthCallbackDto] oAuthCallbackDto (required):
-  Future<Response> finishOAuthWithHttpInfo(OAuthCallbackDto oAuthCallbackDto,) async {
+  /// * [WorkflowCreateDto] workflowCreateDto (required):
+  Future<Response> createWorkflowWithHttpInfo(WorkflowCreateDto workflowCreateDto,) async {
     // ignore: prefer_const_declarations
-    final apiPath = r'/oauth/callback';
+    final apiPath = r'/workflows';
 
     // ignore: prefer_final_locals
-    Object? postBody = oAuthCallbackDto;
+    Object? postBody = workflowCreateDto;
 
     final queryParams = <QueryParam>[];
     final headerParams = <String, String>{};
@@ -45,11 +50,15 @@ class OAuthApi {
     );
   }
 
+  /// Create a workflow
+  ///
+  /// Create a new workflow, the workflow can also be created with empty filters and actions.
+  ///
   /// Parameters:
   ///
-  /// * [OAuthCallbackDto] oAuthCallbackDto (required):
-  Future<LoginResponseDto?> finishOAuth(OAuthCallbackDto oAuthCallbackDto,) async {
-    final response = await finishOAuthWithHttpInfo(oAuthCallbackDto,);
+  /// * [WorkflowCreateDto] workflowCreateDto (required):
+  Future<WorkflowResponseDto?> createWorkflow(WorkflowCreateDto workflowCreateDto,) async {
+    final response = await createWorkflowWithHttpInfo(workflowCreateDto,);
     if (response.statusCode >= HttpStatus.badRequest) {
       throw ApiException(response.statusCode, await _decodeBodyBytes(response));
     }
@@ -57,33 +66,39 @@ class OAuthApi {
     // At the time of writing this, `dart:convert` will throw an "Unexpected end of input"
     // FormatException when trying to decode an empty string.
     if (response.body.isNotEmpty && response.statusCode != HttpStatus.noContent) {
-      return await apiClient.deserializeAsync(await _decodeBodyBytes(response), 'LoginResponseDto',) as LoginResponseDto;
+      return await apiClient.deserializeAsync(await _decodeBodyBytes(response), 'WorkflowResponseDto',) as WorkflowResponseDto;
     
     }
     return null;
   }
 
-  /// Performs an HTTP 'POST /oauth/link' operation and returns the [Response].
+  /// Delete a workflow
+  ///
+  /// Delete a workflow by its ID.
+  ///
+  /// Note: This method returns the HTTP [Response].
+  ///
   /// Parameters:
   ///
-  /// * [OAuthCallbackDto] oAuthCallbackDto (required):
-  Future<Response> linkOAuthAccountWithHttpInfo(OAuthCallbackDto oAuthCallbackDto,) async {
+  /// * [String] id (required):
+  Future<Response> deleteWorkflowWithHttpInfo(String id,) async {
     // ignore: prefer_const_declarations
-    final apiPath = r'/oauth/link';
+    final apiPath = r'/workflows/{id}'
+      .replaceAll('{id}', id);
 
     // ignore: prefer_final_locals
-    Object? postBody = oAuthCallbackDto;
+    Object? postBody;
 
     final queryParams = <QueryParam>[];
     final headerParams = <String, String>{};
     final formParams = <String, String>{};
 
-    const contentTypes = <String>['application/json'];
+    const contentTypes = <String>[];
 
 
     return apiClient.invokeAPI(
       apiPath,
-      'POST',
+      'DELETE',
       queryParams,
       postBody,
       headerParams,
@@ -92,28 +107,33 @@ class OAuthApi {
     );
   }
 
+  /// Delete a workflow
+  ///
+  /// Delete a workflow by its ID.
+  ///
   /// Parameters:
   ///
-  /// * [OAuthCallbackDto] oAuthCallbackDto (required):
-  Future<UserAdminResponseDto?> linkOAuthAccount(OAuthCallbackDto oAuthCallbackDto,) async {
-    final response = await linkOAuthAccountWithHttpInfo(oAuthCallbackDto,);
+  /// * [String] id (required):
+  Future<void> deleteWorkflow(String id,) async {
+    final response = await deleteWorkflowWithHttpInfo(id,);
     if (response.statusCode >= HttpStatus.badRequest) {
       throw ApiException(response.statusCode, await _decodeBodyBytes(response));
     }
-    // When a remote server returns no body with a status of 204, we shall not decode it.
-    // At the time of writing this, `dart:convert` will throw an "Unexpected end of input"
-    // FormatException when trying to decode an empty string.
-    if (response.body.isNotEmpty && response.statusCode != HttpStatus.noContent) {
-      return await apiClient.deserializeAsync(await _decodeBodyBytes(response), 'UserAdminResponseDto',) as UserAdminResponseDto;
-    
-    }
-    return null;
   }
 
-  /// Performs an HTTP 'GET /oauth/mobile-redirect' operation and returns the [Response].
-  Future<Response> redirectOAuthToMobileWithHttpInfo() async {
+  /// Retrieve a workflow
+  ///
+  /// Retrieve information about a specific workflow by its ID.
+  ///
+  /// Note: This method returns the HTTP [Response].
+  ///
+  /// Parameters:
+  ///
+  /// * [String] id (required):
+  Future<Response> getWorkflowWithHttpInfo(String id,) async {
     // ignore: prefer_const_declarations
-    final apiPath = r'/oauth/mobile-redirect';
+    final apiPath = r'/workflows/{id}'
+      .replaceAll('{id}', id);
 
     // ignore: prefer_final_locals
     Object? postBody;
@@ -136,47 +156,15 @@ class OAuthApi {
     );
   }
 
-  Future<void> redirectOAuthToMobile() async {
-    final response = await redirectOAuthToMobileWithHttpInfo();
-    if (response.statusCode >= HttpStatus.badRequest) {
-      throw ApiException(response.statusCode, await _decodeBodyBytes(response));
-    }
-  }
-
-  /// Performs an HTTP 'POST /oauth/authorize' operation and returns the [Response].
+  /// Retrieve a workflow
+  ///
+  /// Retrieve information about a specific workflow by its ID.
+  ///
   /// Parameters:
   ///
-  /// * [OAuthConfigDto] oAuthConfigDto (required):
-  Future<Response> startOAuthWithHttpInfo(OAuthConfigDto oAuthConfigDto,) async {
-    // ignore: prefer_const_declarations
-    final apiPath = r'/oauth/authorize';
-
-    // ignore: prefer_final_locals
-    Object? postBody = oAuthConfigDto;
-
-    final queryParams = <QueryParam>[];
-    final headerParams = <String, String>{};
-    final formParams = <String, String>{};
-
-    const contentTypes = <String>['application/json'];
-
-
-    return apiClient.invokeAPI(
-      apiPath,
-      'POST',
-      queryParams,
-      postBody,
-      headerParams,
-      formParams,
-      contentTypes.isEmpty ? null : contentTypes.first,
-    );
-  }
-
-  /// Parameters:
-  ///
-  /// * [OAuthConfigDto] oAuthConfigDto (required):
-  Future<OAuthAuthorizeResponseDto?> startOAuth(OAuthConfigDto oAuthConfigDto,) async {
-    final response = await startOAuthWithHttpInfo(oAuthConfigDto,);
+  /// * [String] id (required):
+  Future<WorkflowResponseDto?> getWorkflow(String id,) async {
+    final response = await getWorkflowWithHttpInfo(id,);
     if (response.statusCode >= HttpStatus.badRequest) {
       throw ApiException(response.statusCode, await _decodeBodyBytes(response));
     }
@@ -184,16 +172,20 @@ class OAuthApi {
     // At the time of writing this, `dart:convert` will throw an "Unexpected end of input"
     // FormatException when trying to decode an empty string.
     if (response.body.isNotEmpty && response.statusCode != HttpStatus.noContent) {
-      return await apiClient.deserializeAsync(await _decodeBodyBytes(response), 'OAuthAuthorizeResponseDto',) as OAuthAuthorizeResponseDto;
+      return await apiClient.deserializeAsync(await _decodeBodyBytes(response), 'WorkflowResponseDto',) as WorkflowResponseDto;
     
     }
     return null;
   }
 
-  /// Performs an HTTP 'POST /oauth/unlink' operation and returns the [Response].
-  Future<Response> unlinkOAuthAccountWithHttpInfo() async {
+  /// List all workflows
+  ///
+  /// Retrieve a list of workflows available to the authenticated user.
+  ///
+  /// Note: This method returns the HTTP [Response].
+  Future<Response> getWorkflowsWithHttpInfo() async {
     // ignore: prefer_const_declarations
-    final apiPath = r'/oauth/unlink';
+    final apiPath = r'/workflows';
 
     // ignore: prefer_final_locals
     Object? postBody;
@@ -207,7 +199,7 @@ class OAuthApi {
 
     return apiClient.invokeAPI(
       apiPath,
-      'POST',
+      'GET',
       queryParams,
       postBody,
       headerParams,
@@ -216,8 +208,11 @@ class OAuthApi {
     );
   }
 
-  Future<UserAdminResponseDto?> unlinkOAuthAccount() async {
-    final response = await unlinkOAuthAccountWithHttpInfo();
+  /// List all workflows
+  ///
+  /// Retrieve a list of workflows available to the authenticated user.
+  Future<List<WorkflowResponseDto>?> getWorkflows() async {
+    final response = await getWorkflowsWithHttpInfo();
     if (response.statusCode >= HttpStatus.badRequest) {
       throw ApiException(response.statusCode, await _decodeBodyBytes(response));
     }
@@ -225,7 +220,71 @@ class OAuthApi {
     // At the time of writing this, `dart:convert` will throw an "Unexpected end of input"
     // FormatException when trying to decode an empty string.
     if (response.body.isNotEmpty && response.statusCode != HttpStatus.noContent) {
-      return await apiClient.deserializeAsync(await _decodeBodyBytes(response), 'UserAdminResponseDto',) as UserAdminResponseDto;
+      final responseBody = await _decodeBodyBytes(response);
+      return (await apiClient.deserializeAsync(responseBody, 'List<WorkflowResponseDto>') as List)
+        .cast<WorkflowResponseDto>()
+        .toList(growable: false);
+
+    }
+    return null;
+  }
+
+  /// Update a workflow
+  ///
+  /// Update the information of a specific workflow by its ID. This endpoint can be used to update the workflow name, description, trigger type, filters and actions order, etc.
+  ///
+  /// Note: This method returns the HTTP [Response].
+  ///
+  /// Parameters:
+  ///
+  /// * [String] id (required):
+  ///
+  /// * [WorkflowUpdateDto] workflowUpdateDto (required):
+  Future<Response> updateWorkflowWithHttpInfo(String id, WorkflowUpdateDto workflowUpdateDto,) async {
+    // ignore: prefer_const_declarations
+    final apiPath = r'/workflows/{id}'
+      .replaceAll('{id}', id);
+
+    // ignore: prefer_final_locals
+    Object? postBody = workflowUpdateDto;
+
+    final queryParams = <QueryParam>[];
+    final headerParams = <String, String>{};
+    final formParams = <String, String>{};
+
+    const contentTypes = <String>['application/json'];
+
+
+    return apiClient.invokeAPI(
+      apiPath,
+      'PUT',
+      queryParams,
+      postBody,
+      headerParams,
+      formParams,
+      contentTypes.isEmpty ? null : contentTypes.first,
+    );
+  }
+
+  /// Update a workflow
+  ///
+  /// Update the information of a specific workflow by its ID. This endpoint can be used to update the workflow name, description, trigger type, filters and actions order, etc.
+  ///
+  /// Parameters:
+  ///
+  /// * [String] id (required):
+  ///
+  /// * [WorkflowUpdateDto] workflowUpdateDto (required):
+  Future<WorkflowResponseDto?> updateWorkflow(String id, WorkflowUpdateDto workflowUpdateDto,) async {
+    final response = await updateWorkflowWithHttpInfo(id, workflowUpdateDto,);
+    if (response.statusCode >= HttpStatus.badRequest) {
+      throw ApiException(response.statusCode, await _decodeBodyBytes(response));
+    }
+    // When a remote server returns no body with a status of 204, we shall not decode it.
+    // At the time of writing this, `dart:convert` will throw an "Unexpected end of input"
+    // FormatException when trying to decode an empty string.
+    if (response.body.isNotEmpty && response.statusCode != HttpStatus.noContent) {
+      return await apiClient.deserializeAsync(await _decodeBodyBytes(response), 'WorkflowResponseDto',) as WorkflowResponseDto;
     
     }
     return null;

mobile/openapi/lib/api_client.dart

@@ -220,8 +220,6 @@ class ApiClient {
           return AlbumsResponse.fromJson(value);
         case 'AlbumsUpdate':
           return AlbumsUpdate.fromJson(value);
-        case 'AllJobStatusResponseDto':
-          return AllJobStatusResponseDto.fromJson(value);
         case 'AssetBulkDeleteDto':
           return AssetBulkDeleteDto.fromJson(value);
         case 'AssetBulkUpdateDto':
@@ -358,20 +356,10 @@ class ApiClient {
           return FoldersUpdate.fromJson(value);
         case 'ImageFormat':
           return ImageFormatTypeTransformer().decode(value);
-        case 'JobCommand':
-          return JobCommandTypeTransformer().decode(value);
-        case 'JobCommandDto':
-          return JobCommandDto.fromJson(value);
-        case 'JobCountsDto':
-          return JobCountsDto.fromJson(value);
         case 'JobCreateDto':
           return JobCreateDto.fromJson(value);
-        case 'JobName':
-          return JobNameTypeTransformer().decode(value);
         case 'JobSettingsDto':
           return JobSettingsDto.fromJson(value);
-        case 'JobStatusDto':
-          return JobStatusDto.fromJson(value);
         case 'LibraryResponseDto':
           return LibraryResponseDto.fromJson(value);
         case 'LibraryStatsResponseDto':
@@ -390,6 +378,12 @@ class ApiClient {
           return LogoutResponseDto.fromJson(value);
         case 'MachineLearningAvailabilityChecksDto':
           return MachineLearningAvailabilityChecksDto.fromJson(value);
+        case 'MaintenanceAction':
+          return MaintenanceActionTypeTransformer().decode(value);
+        case 'MaintenanceAuthDto':
+          return MaintenanceAuthDto.fromJson(value);
+        case 'MaintenanceLoginDto':
+          return MaintenanceLoginDto.fromJson(value);
         case 'ManualJobName':
           return ManualJobNameTypeTransformer().decode(value);
         case 'MapMarkerResponseDto':
@@ -484,12 +478,34 @@ class ApiClient {
           return PinCodeSetupDto.fromJson(value);
         case 'PlacesResponseDto':
           return PlacesResponseDto.fromJson(value);
+        case 'PluginActionResponseDto':
+          return PluginActionResponseDto.fromJson(value);
+        case 'PluginContext':
+          return PluginContextTypeTransformer().decode(value);
+        case 'PluginFilterResponseDto':
+          return PluginFilterResponseDto.fromJson(value);
+        case 'PluginResponseDto':
+          return PluginResponseDto.fromJson(value);
+        case 'PluginTriggerType':
+          return PluginTriggerTypeTypeTransformer().decode(value);
         case 'PurchaseResponse':
           return PurchaseResponse.fromJson(value);
         case 'PurchaseUpdate':
           return PurchaseUpdate.fromJson(value);
+        case 'QueueCommand':
+          return QueueCommandTypeTransformer().decode(value);
+        case 'QueueCommandDto':
+          return QueueCommandDto.fromJson(value);
+        case 'QueueName':
+          return QueueNameTypeTransformer().decode(value);
+        case 'QueueResponseDto':
+          return QueueResponseDto.fromJson(value);
+        case 'QueueStatisticsDto':
+          return QueueStatisticsDto.fromJson(value);
         case 'QueueStatusDto':
           return QueueStatusDto.fromJson(value);
+        case 'QueuesResponseDto':
+          return QueuesResponseDto.fromJson(value);
         case 'RandomSearchDto':
           return RandomSearchDto.fromJson(value);
         case 'RatingsResponse':
@@ -552,6 +568,8 @@ class ApiClient {
           return SessionUnlockDto.fromJson(value);
         case 'SessionUpdateDto':
           return SessionUpdateDto.fromJson(value);
+        case 'SetMaintenanceModeDto':
+          return SetMaintenanceModeDto.fromJson(value);
         case 'SharedLinkCreateDto':
           return SharedLinkCreateDto.fromJson(value);
         case 'SharedLinkEditDto':
@@ -790,6 +808,20 @@ class ApiClient {
           return VideoCodecTypeTransformer().decode(value);
         case 'VideoContainer':
           return VideoContainerTypeTransformer().decode(value);
+        case 'WorkflowActionItemDto':
+          return WorkflowActionItemDto.fromJson(value);
+        case 'WorkflowActionResponseDto':
+          return WorkflowActionResponseDto.fromJson(value);
+        case 'WorkflowCreateDto':
+          return WorkflowCreateDto.fromJson(value);
+        case 'WorkflowFilterItemDto':
+          return WorkflowFilterItemDto.fromJson(value);
+        case 'WorkflowFilterResponseDto':
+          return WorkflowFilterResponseDto.fromJson(value);
+        case 'WorkflowResponseDto':
+          return WorkflowResponseDto.fromJson(value);
+        case 'WorkflowUpdateDto':
+          return WorkflowUpdateDto.fromJson(value);
         default:
           dynamic match;
           if (value is List && (match = _regList.firstMatch(targetType)?.group(1)) != null) {

mobile/openapi/lib/api_helper.dart

@@ -94,15 +94,12 @@ String parameterToString(dynamic value) {
   if (value is ImageFormat) {
     return ImageFormatTypeTransformer().encode(value).toString();
   }
-  if (value is JobCommand) {
-    return JobCommandTypeTransformer().encode(value).toString();
-  }
-  if (value is JobName) {
-    return JobNameTypeTransformer().encode(value).toString();
-  }
   if (value is LogLevel) {
     return LogLevelTypeTransformer().encode(value).toString();
   }
+  if (value is MaintenanceAction) {
+    return MaintenanceActionTypeTransformer().encode(value).toString();
+  }
   if (value is ManualJobName) {
     return ManualJobNameTypeTransformer().encode(value).toString();
   }
@@ -127,6 +124,18 @@ String parameterToString(dynamic value) {
   if (value is Permission) {
     return PermissionTypeTransformer().encode(value).toString();
   }
+  if (value is PluginContext) {
+    return PluginContextTypeTransformer().encode(value).toString();
+  }
+  if (value is PluginTriggerType) {
+    return PluginTriggerTypeTypeTransformer().encode(value).toString();
+  }
+  if (value is QueueCommand) {
+    return QueueCommandTypeTransformer().encode(value).toString();
+  }
+  if (value is QueueName) {
+    return QueueNameTypeTransformer().encode(value).toString();
+  }
   if (value is ReactionLevel) {
     return ReactionLevelTypeTransformer().encode(value).toString();
   }

mobile/openapi/lib/model/asset_response_dto.dart

@@ -87,7 +87,6 @@ class AssetResponseDto {
 
   bool isTrashed;
 
-  /// This property was deprecated in v1.106.0
   String? libraryId;
 
   String? livePhotoVideoId;
@@ -119,7 +118,6 @@ class AssetResponseDto {
 
   List<PersonWithFacesResponseDto> people;
 
-  /// This property was deprecated in v1.113.0
   ///
   /// Please note: This property should have been non-nullable! Since the specification file
   /// does not include a default value (using the "default:" property), however, the generated

mobile/openapi/lib/model/job_command.dart

@@ -1,94 +0,0 @@
-//
-// AUTO-GENERATED FILE, DO NOT MODIFY!
-//
-// @dart=2.18
-
-// ignore_for_file: unused_element, unused_import
-// ignore_for_file: always_put_required_named_parameters_first
-// ignore_for_file: constant_identifier_names
-// ignore_for_file: lines_longer_than_80_chars
-
-part of openapi.api;
-
-
-class JobCommand {
-  /// Instantiate a new enum with the provided [value].
-  const JobCommand._(this.value);
-
-  /// The underlying value of this enum member.
-  final String value;
-
-  @override
-  String toString() => value;
-
-  String toJson() => value;
-
-  static const start = JobCommand._(r'start');
-  static const pause = JobCommand._(r'pause');
-  static const resume = JobCommand._(r'resume');
-  static const empty = JobCommand._(r'empty');
-  static const clearFailed = JobCommand._(r'clear-failed');
-
-  /// List of all possible values in this [enum][JobCommand].
-  static const values = <JobCommand>[
-    start,
-    pause,
-    resume,
-    empty,
-    clearFailed,
-  ];
-
-  static JobCommand? fromJson(dynamic value) => JobCommandTypeTransformer().decode(value);
-
-  static List<JobCommand> listFromJson(dynamic json, {bool growable = false,}) {
-    final result = <JobCommand>[];
-    if (json is List && json.isNotEmpty) {
-      for (final row in json) {
-        final value = JobCommand.fromJson(row);
-        if (value != null) {
-          result.add(value);
-        }
-      }
-    }
-    return result.toList(growable: growable);
-  }
-}
-
-/// Transformation class that can [encode] an instance of [JobCommand] to String,
-/// and [decode] dynamic data back to [JobCommand].
-class JobCommandTypeTransformer {
-  factory JobCommandTypeTransformer() => _instance ??= const JobCommandTypeTransformer._();
-
-  const JobCommandTypeTransformer._();
-
-  String encode(JobCommand data) => data.value;
-
-  /// Decodes a [dynamic value][data] to a JobCommand.
-  ///
-  /// If [allowNull] is true and the [dynamic value][data] cannot be decoded successfully,
-  /// then null is returned. However, if [allowNull] is false and the [dynamic value][data]
-  /// cannot be decoded successfully, then an [UnimplementedError] is thrown.
-  ///
-  /// The [allowNull] is very handy when an API changes and a new enum value is added or removed,
-  /// and users are still using an old app with the old code.
-  JobCommand? decode(dynamic data, {bool allowNull = true}) {
-    if (data != null) {
-      switch (data) {
-        case r'start': return JobCommand.start;
-        case r'pause': return JobCommand.pause;
-        case r'resume': return JobCommand.resume;
-        case r'empty': return JobCommand.empty;
-        case r'clear-failed': return JobCommand.clearFailed;
-        default:
-          if (!allowNull) {
-            throw ArgumentError('Unknown enum value to decode: $data');
-          }
-      }
-    }
-    return null;
-  }
-
-  /// Singleton [JobCommandTypeTransformer] instance.
-  static JobCommandTypeTransformer? _instance;
-}
-

mobile/openapi/lib/model/job_name.dart

@@ -1,127 +0,0 @@
-//
-// AUTO-GENERATED FILE, DO NOT MODIFY!
-//
-// @dart=2.18
-
-// ignore_for_file: unused_element, unused_import
-// ignore_for_file: always_put_required_named_parameters_first
-// ignore_for_file: constant_identifier_names
-// ignore_for_file: lines_longer_than_80_chars
-
-part of openapi.api;
-
-
-class JobName {
-  /// Instantiate a new enum with the provided [value].
-  const JobName._(this.value);
-
-  /// The underlying value of this enum member.
-  final String value;
-
-  @override
-  String toString() => value;
-
-  String toJson() => value;
-
-  static const thumbnailGeneration = JobName._(r'thumbnailGeneration');
-  static const metadataExtraction = JobName._(r'metadataExtraction');
-  static const videoConversion = JobName._(r'videoConversion');
-  static const faceDetection = JobName._(r'faceDetection');
-  static const facialRecognition = JobName._(r'facialRecognition');
-  static const smartSearch = JobName._(r'smartSearch');
-  static const duplicateDetection = JobName._(r'duplicateDetection');
-  static const backgroundTask = JobName._(r'backgroundTask');
-  static const storageTemplateMigration = JobName._(r'storageTemplateMigration');
-  static const migration = JobName._(r'migration');
-  static const search = JobName._(r'search');
-  static const sidecar = JobName._(r'sidecar');
-  static const library_ = JobName._(r'library');
-  static const notifications = JobName._(r'notifications');
-  static const backupDatabase = JobName._(r'backupDatabase');
-  static const ocr = JobName._(r'ocr');
-
-  /// List of all possible values in this [enum][JobName].
-  static const values = <JobName>[
-    thumbnailGeneration,
-    metadataExtraction,
-    videoConversion,
-    faceDetection,
-    facialRecognition,
-    smartSearch,
-    duplicateDetection,
-    backgroundTask,
-    storageTemplateMigration,
-    migration,
-    search,
-    sidecar,
-    library_,
-    notifications,
-    backupDatabase,
-    ocr,
-  ];
-
-  static JobName? fromJson(dynamic value) => JobNameTypeTransformer().decode(value);
-
-  static List<JobName> listFromJson(dynamic json, {bool growable = false,}) {
-    final result = <JobName>[];
-    if (json is List && json.isNotEmpty) {
-      for (final row in json) {
-        final value = JobName.fromJson(row);
-        if (value != null) {
-          result.add(value);
-        }
-      }
-    }
-    return result.toList(growable: growable);
-  }
-}
-
-/// Transformation class that can [encode] an instance of [JobName] to String,
-/// and [decode] dynamic data back to [JobName].
-class JobNameTypeTransformer {
-  factory JobNameTypeTransformer() => _instance ??= const JobNameTypeTransformer._();
-
-  const JobNameTypeTransformer._();
-
-  String encode(JobName data) => data.value;
-
-  /// Decodes a [dynamic value][data] to a JobName.
-  ///
-  /// If [allowNull] is true and the [dynamic value][data] cannot be decoded successfully,
-  /// then null is returned. However, if [allowNull] is false and the [dynamic value][data]
-  /// cannot be decoded successfully, then an [UnimplementedError] is thrown.
-  ///
-  /// The [allowNull] is very handy when an API changes and a new enum value is added or removed,
-  /// and users are still using an old app with the old code.
-  JobName? decode(dynamic data, {bool allowNull = true}) {
-    if (data != null) {
-      switch (data) {
-        case r'thumbnailGeneration': return JobName.thumbnailGeneration;
-        case r'metadataExtraction': return JobName.metadataExtraction;
-        case r'videoConversion': return JobName.videoConversion;
-        case r'faceDetection': return JobName.faceDetection;
-        case r'facialRecognition': return JobName.facialRecognition;
-        case r'smartSearch': return JobName.smartSearch;
-        case r'duplicateDetection': return JobName.duplicateDetection;
-        case r'backgroundTask': return JobName.backgroundTask;
-        case r'storageTemplateMigration': return JobName.storageTemplateMigration;
-        case r'migration': return JobName.migration;
-        case r'search': return JobName.search;
-        case r'sidecar': return JobName.sidecar;
-        case r'library': return JobName.library_;
-        case r'notifications': return JobName.notifications;
-        case r'backupDatabase': return JobName.backupDatabase;
-        case r'ocr': return JobName.ocr;
-        default:
-          if (!allowNull) {
-            throw ArgumentError('Unknown enum value to decode: $data');
-          }
-      }
-    }
-    return null;
-  }
-
-  /// Singleton [JobNameTypeTransformer] instance.
-  static JobNameTypeTransformer? _instance;
-}
-

mobile/openapi/lib/model/maintenance_action.dart

@@ -0,0 +1,85 @@
+//
+// AUTO-GENERATED FILE, DO NOT MODIFY!
+//
+// @dart=2.18
+
+// ignore_for_file: unused_element, unused_import
+// ignore_for_file: always_put_required_named_parameters_first
+// ignore_for_file: constant_identifier_names
+// ignore_for_file: lines_longer_than_80_chars
+
+part of openapi.api;
+
+
+class MaintenanceAction {
+  /// Instantiate a new enum with the provided [value].
+  const MaintenanceAction._(this.value);
+
+  /// The underlying value of this enum member.
+  final String value;
+
+  @override
+  String toString() => value;
+
+  String toJson() => value;
+
+  static const start = MaintenanceAction._(r'start');
+  static const end = MaintenanceAction._(r'end');
+
+  /// List of all possible values in this [enum][MaintenanceAction].
+  static const values = <MaintenanceAction>[
+    start,
+    end,
+  ];
+
+  static MaintenanceAction? fromJson(dynamic value) => MaintenanceActionTypeTransformer().decode(value);
+
+  static List<MaintenanceAction> listFromJson(dynamic json, {bool growable = false,}) {
+    final result = <MaintenanceAction>[];
+    if (json is List && json.isNotEmpty) {
+      for (final row in json) {
+        final value = MaintenanceAction.fromJson(row);
+        if (value != null) {
+          result.add(value);
+        }
+      }
+    }
+    return result.toList(growable: growable);
+  }
+}
+
+/// Transformation class that can [encode] an instance of [MaintenanceAction] to String,
+/// and [decode] dynamic data back to [MaintenanceAction].
+class MaintenanceActionTypeTransformer {
+  factory MaintenanceActionTypeTransformer() => _instance ??= const MaintenanceActionTypeTransformer._();
+
+  const MaintenanceActionTypeTransformer._();
+
+  String encode(MaintenanceAction data) => data.value;
+
+  /// Decodes a [dynamic value][data] to a MaintenanceAction.
+  ///
+  /// If [allowNull] is true and the [dynamic value][data] cannot be decoded successfully,
+  /// then null is returned. However, if [allowNull] is false and the [dynamic value][data]
+  /// cannot be decoded successfully, then an [UnimplementedError] is thrown.
+  ///
+  /// The [allowNull] is very handy when an API changes and a new enum value is added or removed,
+  /// and users are still using an old app with the old code.
+  MaintenanceAction? decode(dynamic data, {bool allowNull = true}) {
+    if (data != null) {
+      switch (data) {
+        case r'start': return MaintenanceAction.start;
+        case r'end': return MaintenanceAction.end;
+        default:
+          if (!allowNull) {
+            throw ArgumentError('Unknown enum value to decode: $data');
+          }
+      }
+    }
+    return null;
+  }
+
+  /// Singleton [MaintenanceActionTypeTransformer] instance.
+  static MaintenanceActionTypeTransformer? _instance;
+}
+

mobile/openapi/lib/model/maintenance_auth_dto.dart

@@ -0,0 +1,99 @@
+//
+// AUTO-GENERATED FILE, DO NOT MODIFY!
+//
+// @dart=2.18
+
+// ignore_for_file: unused_element, unused_import
+// ignore_for_file: always_put_required_named_parameters_first
+// ignore_for_file: constant_identifier_names
+// ignore_for_file: lines_longer_than_80_chars
+
+part of openapi.api;
+
+class MaintenanceAuthDto {
+  /// Returns a new [MaintenanceAuthDto] instance.
+  MaintenanceAuthDto({
+    required this.username,
+  });
+
+  String username;
+
+  @override
+  bool operator ==(Object other) => identical(this, other) || other is MaintenanceAuthDto &&
+    other.username == username;
+
+  @override
+  int get hashCode =>
+    // ignore: unnecessary_parenthesis
+    (username.hashCode);
+
+  @override
+  String toString() => 'MaintenanceAuthDto[username=$username]';
+
+  Map<String, dynamic> toJson() {
+    final json = <String, dynamic>{};
+      json[r'username'] = this.username;
+    return json;
+  }
+
+  /// Returns a new [MaintenanceAuthDto] instance and imports its values from
+  /// [value] if it's a [Map], null otherwise.
+  // ignore: prefer_constructors_over_static_methods
+  static MaintenanceAuthDto? fromJson(dynamic value) {
+    upgradeDto(value, "MaintenanceAuthDto");
+    if (value is Map) {
+      final json = value.cast<String, dynamic>();
+
+      return MaintenanceAuthDto(
+        username: mapValueOfType<String>(json, r'username')!,
+      );
+    }
+    return null;
+  }
+
+  static List<MaintenanceAuthDto> listFromJson(dynamic json, {bool growable = false,}) {
+    final result = <MaintenanceAuthDto>[];
+    if (json is List && json.isNotEmpty) {
+      for (final row in json) {
+        final value = MaintenanceAuthDto.fromJson(row);
+        if (value != null) {
+          result.add(value);
+        }
+      }
+    }
+    return result.toList(growable: growable);
+  }
+
+  static Map<String, MaintenanceAuthDto> mapFromJson(dynamic json) {
+    final map = <String, MaintenanceAuthDto>{};
+    if (json is Map && json.isNotEmpty) {
+      json = json.cast<String, dynamic>(); // ignore: parameter_assignments
+      for (final entry in json.entries) {
+        final value = MaintenanceAuthDto.fromJson(entry.value);
+        if (value != null) {
+          map[entry.key] = value;
+        }
+      }
+    }
+    return map;
+  }
+
+  // maps a json object with a list of MaintenanceAuthDto-objects as value to a dart map
+  static Map<String, List<MaintenanceAuthDto>> mapListFromJson(dynamic json, {bool growable = false,}) {
+    final map = <String, List<MaintenanceAuthDto>>{};
+    if (json is Map && json.isNotEmpty) {
+      // ignore: parameter_assignments
+      json = json.cast<String, dynamic>();
+      for (final entry in json.entries) {
+        map[entry.key] = MaintenanceAuthDto.listFromJson(entry.value, growable: growable,);
+      }
+    }
+    return map;
+  }
+
+  /// The list of required keys that must be present in a JSON.
+  static const requiredKeys = <String>{
+    'username',
+  };
+}
+

mobile/openapi/lib/model/maintenance_login_dto.dart

@@ -0,0 +1,108 @@
+//
+// AUTO-GENERATED FILE, DO NOT MODIFY!
+//
+// @dart=2.18
+
+// ignore_for_file: unused_element, unused_import
+// ignore_for_file: always_put_required_named_parameters_first
+// ignore_for_file: constant_identifier_names
+// ignore_for_file: lines_longer_than_80_chars
+
+part of openapi.api;
+
+class MaintenanceLoginDto {
+  /// Returns a new [MaintenanceLoginDto] instance.
+  MaintenanceLoginDto({
+    this.token,
+  });
+
+  ///
+  /// Please note: This property should have been non-nullable! Since the specification file
+  /// does not include a default value (using the "default:" property), however, the generated
+  /// source code must fall back to having a nullable type.
+  /// Consider adding a "default:" property in the specification file to hide this note.
+  ///
+  String? token;
+
+  @override
+  bool operator ==(Object other) => identical(this, other) || other is MaintenanceLoginDto &&
+    other.token == token;
+
+  @override
+  int get hashCode =>
+    // ignore: unnecessary_parenthesis
+    (token == null ? 0 : token!.hashCode);
+
+  @override
+  String toString() => 'MaintenanceLoginDto[token=$token]';
+
+  Map<String, dynamic> toJson() {
+    final json = <String, dynamic>{};
+    if (this.token != null) {
+      json[r'token'] = this.token;
+    } else {
+    //  json[r'token'] = null;
+    }
+    return json;
+  }
+
+  /// Returns a new [MaintenanceLoginDto] instance and imports its values from
+  /// [value] if it's a [Map], null otherwise.
+  // ignore: prefer_constructors_over_static_methods
+  static MaintenanceLoginDto? fromJson(dynamic value) {
+    upgradeDto(value, "MaintenanceLoginDto");
+    if (value is Map) {
+      final json = value.cast<String, dynamic>();
+
+      return MaintenanceLoginDto(
+        token: mapValueOfType<String>(json, r'token'),
+      );
+    }
+    return null;
+  }
+
+  static List<MaintenanceLoginDto> listFromJson(dynamic json, {bool growable = false,}) {
+    final result = <MaintenanceLoginDto>[];
+    if (json is List && json.isNotEmpty) {
+      for (final row in json) {
+        final value = MaintenanceLoginDto.fromJson(row);
+        if (value != null) {
+          result.add(value);
+        }
+      }
+    }
+    return result.toList(growable: growable);
+  }
+
+  static Map<String, MaintenanceLoginDto> mapFromJson(dynamic json) {
+    final map = <String, MaintenanceLoginDto>{};
+    if (json is Map && json.isNotEmpty) {
+      json = json.cast<String, dynamic>(); // ignore: parameter_assignments
+      for (final entry in json.entries) {
+        final value = MaintenanceLoginDto.fromJson(entry.value);
+        if (value != null) {
+          map[entry.key] = value;
+        }
+      }
+    }
+    return map;
+  }
+
+  // maps a json object with a list of MaintenanceLoginDto-objects as value to a dart map
+  static Map<String, List<MaintenanceLoginDto>> mapListFromJson(dynamic json, {bool growable = false,}) {
+    final map = <String, List<MaintenanceLoginDto>>{};
+    if (json is Map && json.isNotEmpty) {
+      // ignore: parameter_assignments
+      json = json.cast<String, dynamic>();
+      for (final entry in json.entries) {
+        map[entry.key] = MaintenanceLoginDto.listFromJson(entry.value, growable: growable,);
+      }
+    }
+    return map;
+  }
+
+  /// The list of required keys that must be present in a JSON.
+  static const requiredKeys = <String>{
+  };
+}
+

mobile/openapi/lib/model/people_response_dto.dart

@@ -19,7 +19,6 @@ class PeopleResponseDto {
     required this.total,
   });
 
-  /// This property was added in v1.110.0
   ///
   /// Please note: This property should have been non-nullable! Since the specification file
   /// does not include a default value (using the "default:" property), however, the generated

mobile/openapi/lib/model/permission.dart

@@ -73,6 +73,7 @@ class Permission {
   static const libraryPeriodStatistics = Permission._(r'library.statistics');
   static const timelinePeriodRead = Permission._(r'timeline.read');
   static const timelinePeriodDownload = Permission._(r'timeline.download');
+  static const maintenance = Permission._(r'maintenance');
   static const memoryPeriodCreate = Permission._(r'memory.create');
   static const memoryPeriodRead = Permission._(r'memory.read');
   static const memoryPeriodUpdate = Permission._(r'memory.update');
@@ -98,6 +99,10 @@ class Permission {
   static const pinCodePeriodCreate = Permission._(r'pinCode.create');
   static const pinCodePeriodUpdate = Permission._(r'pinCode.update');
   static const pinCodePeriodDelete = Permission._(r'pinCode.delete');
+  static const pluginPeriodCreate = Permission._(r'plugin.create');
+  static const pluginPeriodRead = Permission._(r'plugin.read');
+  static const pluginPeriodUpdate = Permission._(r'plugin.update');
+  static const pluginPeriodDelete = Permission._(r'plugin.delete');
   static const serverPeriodAbout = Permission._(r'server.about');
   static const serverPeriodApkLinks = Permission._(r'server.apkLinks');
   static const serverPeriodStorage = Permission._(r'server.storage');
@@ -147,6 +152,10 @@ class Permission {
   static const userProfileImagePeriodRead = Permission._(r'userProfileImage.read');
   static const userProfileImagePeriodUpdate = Permission._(r'userProfileImage.update');
   static const userProfileImagePeriodDelete = Permission._(r'userProfileImage.delete');
+  static const workflowPeriodCreate = Permission._(r'workflow.create');
+  static const workflowPeriodRead = Permission._(r'workflow.read');
+  static const workflowPeriodUpdate = Permission._(r'workflow.update');
+  static const workflowPeriodDelete = Permission._(r'workflow.delete');
   static const adminUserPeriodCreate = Permission._(r'adminUser.create');
   static const adminUserPeriodRead = Permission._(r'adminUser.read');
   static const adminUserPeriodUpdate = Permission._(r'adminUser.update');
@@ -206,6 +215,7 @@ class Permission {
     libraryPeriodStatistics,
     timelinePeriodRead,
     timelinePeriodDownload,
+    maintenance,
     memoryPeriodCreate,
     memoryPeriodRead,
     memoryPeriodUpdate,
@@ -231,6 +241,10 @@ class Permission {
     pinCodePeriodCreate,
     pinCodePeriodUpdate,
     pinCodePeriodDelete,
+    pluginPeriodCreate,
+    pluginPeriodRead,
+    pluginPeriodUpdate,
+    pluginPeriodDelete,
     serverPeriodAbout,
     serverPeriodApkLinks,
     serverPeriodStorage,
@@ -280,6 +294,10 @@ class Permission {
     userProfileImagePeriodRead,
     userProfileImagePeriodUpdate,
     userProfileImagePeriodDelete,
+    workflowPeriodCreate,
+    workflowPeriodRead,
+    workflowPeriodUpdate,
+    workflowPeriodDelete,
     adminUserPeriodCreate,
     adminUserPeriodRead,
     adminUserPeriodUpdate,
@@ -374,6 +392,7 @@ class PermissionTypeTransformer {
         case r'library.statistics': return Permission.libraryPeriodStatistics;
         case r'timeline.read': return Permission.timelinePeriodRead;
         case r'timeline.download': return Permission.timelinePeriodDownload;
+        case r'maintenance': return Permission.maintenance;
         case r'memory.create': return Permission.memoryPeriodCreate;
         case r'memory.read': return Permission.memoryPeriodRead;
         case r'memory.update': return Permission.memoryPeriodUpdate;
@@ -399,6 +418,10 @@ class PermissionTypeTransformer {
         case r'pinCode.create': return Permission.pinCodePeriodCreate;
         case r'pinCode.update': return Permission.pinCodePeriodUpdate;
         case r'pinCode.delete': return Permission.pinCodePeriodDelete;
+        case r'plugin.create': return Permission.pluginPeriodCreate;
+        case r'plugin.read': return Permission.pluginPeriodRead;
+        case r'plugin.update': return Permission.pluginPeriodUpdate;
+        case r'plugin.delete': return Permission.pluginPeriodDelete;
         case r'server.about': return Permission.serverPeriodAbout;
         case r'server.apkLinks': return Permission.serverPeriodApkLinks;
         case r'server.storage': return Permission.serverPeriodStorage;
@@ -448,6 +471,10 @@ class PermissionTypeTransformer {
         case r'userProfileImage.read': return Permission.userProfileImagePeriodRead;
         case r'userProfileImage.update': return Permission.userProfileImagePeriodUpdate;
         case r'userProfileImage.delete': return Permission.userProfileImagePeriodDelete;
+        case r'workflow.create': return Permission.workflowPeriodCreate;
+        case r'workflow.read': return Permission.workflowPeriodRead;
+        case r'workflow.update': return Permission.workflowPeriodUpdate;
+        case r'workflow.delete': return Permission.workflowPeriodDelete;
         case r'adminUser.create': return Permission.adminUserPeriodCreate;
         case r'adminUser.read': return Permission.adminUserPeriodRead;
         case r'adminUser.update': return Permission.adminUserPeriodUpdate;

mobile/openapi/lib/model/person_response_dto.dart

@@ -25,7 +25,6 @@ class PersonResponseDto {
 
   DateTime? birthDate;
 
-  /// This property was added in v1.126.0
   ///
   /// Please note: This property should have been non-nullable! Since the specification file
   /// does not include a default value (using the "default:" property), however, the generated
@@ -36,7 +35,6 @@ class PersonResponseDto {
 
   String id;
 
-  /// This property was added in v1.126.0
   ///
   /// Please note: This property should have been non-nullable! Since the specification file
   /// does not include a default value (using the "default:" property), however, the generated
@@ -51,7 +49,6 @@ class PersonResponseDto {
 
   String thumbnailPath;
 
-  /// This property was added in v1.107.0
   ///
   /// Please note: This property should have been non-nullable! Since the specification file
   /// does not include a default value (using the "default:" property), however, the generated

mobile/openapi/lib/model/person_with_faces_response_dto.dart

@@ -26,7 +26,6 @@ class PersonWithFacesResponseDto {
 
   DateTime? birthDate;
 
-  /// This property was added in v1.126.0
   ///
   /// Please note: This property should have been non-nullable! Since the specification file
   /// does not include a default value (using the "default:" property), however, the generated
@@ -39,7 +38,6 @@ class PersonWithFacesResponseDto {
 
   String id;
 
-  /// This property was added in v1.126.0
   ///
   /// Please note: This property should have been non-nullable! Since the specification file
   /// does not include a default value (using the "default:" property), however, the generated
@@ -54,7 +52,6 @@ class PersonWithFacesResponseDto {
 
   String thumbnailPath;
 
-  /// This property was added in v1.107.0
   ///
   /// Please note: This property should have been non-nullable! Since the specification file
   /// does not include a default value (using the "default:" property), however, the generated

mobile/openapi/lib/model/plugin_action_response_dto.dart

@@ -0,0 +1,151 @@
+//
+// AUTO-GENERATED FILE, DO NOT MODIFY!
+//
+// @dart=2.18
+
+// ignore_for_file: unused_element, unused_import
+// ignore_for_file: always_put_required_named_parameters_first
+// ignore_for_file: constant_identifier_names
+// ignore_for_file: lines_longer_than_80_chars
+
+part of openapi.api;
+
+class PluginActionResponseDto {
+  /// Returns a new [PluginActionResponseDto] instance.
+  PluginActionResponseDto({
+    required this.description,
+    required this.id,
+    required this.methodName,
+    required this.pluginId,
+    required this.schema,
+    this.supportedContexts = const [],
+    required this.title,
+  });
+
+  String description;
+
+  String id;
+
+  String methodName;
+
+  String pluginId;
+
+  Object? schema;
+
+  List<PluginContext> supportedContexts;
+
+  String title;
+
+  @override
+  bool operator ==(Object other) => identical(this, other) || other is PluginActionResponseDto &&
+    other.description == description &&
+    other.id == id &&
+    other.methodName == methodName &&
+    other.pluginId == pluginId &&
+    other.schema == schema &&
+    _deepEquality.equals(other.supportedContexts, supportedContexts) &&
+    other.title == title;
+
+  @override
+  int get hashCode =>
+    // ignore: unnecessary_parenthesis
+    (description.hashCode) +
+    (id.hashCode) +
+    (methodName.hashCode) +
+    (pluginId.hashCode) +
+    (schema == null ? 0 : schema!.hashCode) +
+    (supportedContexts.hashCode) +
+    (title.hashCode);
+
+  @override
+  String toString() => 'PluginActionResponseDto[description=$description, id=$id, methodName=$methodName, pluginId=$pluginId, schema=$schema, supportedContexts=$supportedContexts, title=$title]';
+
+  Map<String, dynamic> toJson() {
+    final json = <String, dynamic>{};
+      json[r'description'] = this.description;
+      json[r'id'] = this.id;
+      json[r'methodName'] = this.methodName;
+      json[r'pluginId'] = this.pluginId;
+    if (this.schema != null) {
+      json[r'schema'] = this.schema;
+    } else {
+    //  json[r'schema'] = null;
+    }
+      json[r'supportedContexts'] = this.supportedContexts;
+      json[r'title'] = this.title;
+    return json;
+  }
+
+  /// Returns a new [PluginActionResponseDto] instance and imports its values from
+  /// [value] if it's a [Map], null otherwise.
+  // ignore: prefer_constructors_over_static_methods
+  static PluginActionResponseDto? fromJson(dynamic value) {
+    upgradeDto(value, "PluginActionResponseDto");
+    if (value is Map) {
+      final json = value.cast<String, dynamic>();
+
+      return PluginActionResponseDto(
+        description: mapValueOfType<String>(json, r'description')!,
+        id: mapValueOfType<String>(json, r'id')!,
+        methodName: mapValueOfType<String>(json, r'methodName')!,
+        pluginId: mapValueOfType<String>(json, r'pluginId')!,
+        schema: mapValueOfType<Object>(json, r'schema'),
+        supportedContexts: PluginContext.listFromJson(json[r'supportedContexts']),
+        title: mapValueOfType<String>(json, r'title')!,
+      );
+    }
+    return null;
+  }
+
+  static List<PluginActionResponseDto> listFromJson(dynamic json, {bool growable = false,}) {
+    final result = <PluginActionResponseDto>[];
+    if (json is List && json.isNotEmpty) {
+      for (final row in json) {
+        final value = PluginActionResponseDto.fromJson(row);
+        if (value != null) {
+          result.add(value);
+        }
+      }
+    }
+    return result.toList(growable: growable);
+  }
+
+  static Map<String, PluginActionResponseDto> mapFromJson(dynamic json) {
+    final map = <String, PluginActionResponseDto>{};
+    if (json is Map && json.isNotEmpty) {
+      json = json.cast<String, dynamic>(); // ignore: parameter_assignments
+      for (final entry in json.entries) {
+        final value = PluginActionResponseDto.fromJson(entry.value);
+        if (value != null) {
+          map[entry.key] = value;
+        }
+      }
+    }
+    return map;
+  }
+
+  // maps a json object with a list of PluginActionResponseDto-objects as value to a dart map
+  static Map<String, List<PluginActionResponseDto>> mapListFromJson(dynamic json, {bool growable = false,}) {
+    final map = <String, List<PluginActionResponseDto>>{};
+    if (json is Map && json.isNotEmpty) {
+      // ignore: parameter_assignments
+      json = json.cast<String, dynamic>();
+      for (final entry in json.entries) {
+        map[entry.key] = PluginActionResponseDto.listFromJson(entry.value, growable: growable,);
+      }
+    }
+    return map;
+  }
+
+  /// The list of required keys that must be present in a JSON.
+  static const requiredKeys = <String>{
+    'description',
+    'id',
+    'methodName',
+    'pluginId',
+    'schema',
+    'supportedContexts',
+    'title',
+  };
+}
+

mobile/openapi/lib/model/plugin_context.dart

@@ -0,0 +1,88 @@
+//
+// AUTO-GENERATED FILE, DO NOT MODIFY!
+//
+// @dart=2.18
+
+// ignore_for_file: unused_element, unused_import
+// ignore_for_file: always_put_required_named_parameters_first
+// ignore_for_file: constant_identifier_names
+// ignore_for_file: lines_longer_than_80_chars
+
+part of openapi.api;
+
+
+class PluginContext {
+  /// Instantiate a new enum with the provided [value].
+  const PluginContext._(this.value);
+
+  /// The underlying value of this enum member.
+  final String value;
+
+  @override
+  String toString() => value;
+
+  String toJson() => value;
+
+  static const asset = PluginContext._(r'asset');
+  static const album = PluginContext._(r'album');
+  static const person = PluginContext._(r'person');
+
+  /// List of all possible values in this [enum][PluginContext].
+  static const values = <PluginContext>[
+    asset,
+    album,
+    person,
+  ];
+
+  static PluginContext? fromJson(dynamic value) => PluginContextTypeTransformer().decode(value);
+
+  static List<PluginContext> listFromJson(dynamic json, {bool growable = false,}) {
+    final result = <PluginContext>[];
+    if (json is List && json.isNotEmpty) {
+      for (final row in json) {
+        final value = PluginContext.fromJson(row);
+        if (value != null) {
+          result.add(value);
+        }
+      }
+    }
+    return result.toList(growable: growable);
+  }
+}
+
+/// Transformation class that can [encode] an instance of [PluginContext] to String,
+/// and [decode] dynamic data back to [PluginContext].
+class PluginContextTypeTransformer {
+  factory PluginContextTypeTransformer() => _instance ??= const PluginContextTypeTransformer._();
+
+  const PluginContextTypeTransformer._();
+
+  String encode(PluginContext data) => data.value;
+
+  /// Decodes a [dynamic value][data] to a PluginContext.
+  ///
+  /// If [allowNull] is true and the [dynamic value][data] cannot be decoded successfully,
+  /// then null is returned. However, if [allowNull] is false and the [dynamic value][data]
+  /// cannot be decoded successfully, then an [UnimplementedError] is thrown.
+  ///
+  /// The [allowNull] is very handy when an API changes and a new enum value is added or removed,
+  /// and users are still using an old app with the old code.
+  PluginContext? decode(dynamic data, {bool allowNull = true}) {
+    if (data != null) {
+      switch (data) {
+        case r'asset': return PluginContext.asset;
+        case r'album': return PluginContext.album;
+        case r'person': return PluginContext.person;
+        default:
+          if (!allowNull) {
+            throw ArgumentError('Unknown enum value to decode: $data');
+          }
+      }
+    }
+    return null;
+  }
+
+  /// Singleton [PluginContextTypeTransformer] instance.
+  static PluginContextTypeTransformer? _instance;
+}
+

mobile/openapi/lib/model/plugin_filter_response_dto.dart

@@ -0,0 +1,151 @@
+//
+// AUTO-GENERATED FILE, DO NOT MODIFY!
+//
+// @dart=2.18
+
+// ignore_for_file: unused_element, unused_import
+// ignore_for_file: always_put_required_named_parameters_first
+// ignore_for_file: constant_identifier_names
+// ignore_for_file: lines_longer_than_80_chars
+
+part of openapi.api;
+
+class PluginFilterResponseDto {
+  /// Returns a new [PluginFilterResponseDto] instance.
+  PluginFilterResponseDto({
+    required this.description,
+    required this.id,
+    required this.methodName,
+    required this.pluginId,
+    required this.schema,
+    this.supportedContexts = const [],
+    required this.title,
+  });
+
+  String description;
+
+  String id;
+
+  String methodName;
+
+  String pluginId;
+
+  Object? schema;
+
+  List<PluginContext> supportedContexts;
+
+  String title;
+
+  @override
+  bool operator ==(Object other) => identical(this, other) || other is PluginFilterResponseDto &&
+    other.description == description &&
+    other.id == id &&
+    other.methodName == methodName &&
+    other.pluginId == pluginId &&
+    other.schema == schema &&
+    _deepEquality.equals(other.supportedContexts, supportedContexts) &&
+    other.title == title;
+
+  @override
+  int get hashCode =>
+    // ignore: unnecessary_parenthesis
+    (description.hashCode) +
+    (id.hashCode) +
+    (methodName.hashCode) +
+    (pluginId.hashCode) +
+    (schema == null ? 0 : schema!.hashCode) +
+    (supportedContexts.hashCode) +
+    (title.hashCode);
+
+  @override
+  String toString() => 'PluginFilterResponseDto[description=$description, id=$id, methodName=$methodName, pluginId=$pluginId, schema=$schema, supportedContexts=$supportedContexts, title=$title]';
+
+  Map<String, dynamic> toJson() {
+    final json = <String, dynamic>{};
+      json[r'description'] = this.description;
+      json[r'id'] = this.id;
+      json[r'methodName'] = this.methodName;
+      json[r'pluginId'] = this.pluginId;
+    if (this.schema != null) {
+      json[r'schema'] = this.schema;
+    } else {
+    //  json[r'schema'] = null;
+    }
+      json[r'supportedContexts'] = this.supportedContexts;
+      json[r'title'] = this.title;
+    return json;
+  }
+
+  /// Returns a new [PluginFilterResponseDto] instance and imports its values from
+  /// [value] if it's a [Map], null otherwise.
+  // ignore: prefer_constructors_over_static_methods
+  static PluginFilterResponseDto? fromJson(dynamic value) {
+    upgradeDto(value, "PluginFilterResponseDto");
+    if (value is Map) {
+      final json = value.cast<String, dynamic>();
+
+      return PluginFilterResponseDto(
+        description: mapValueOfType<String>(json, r'description')!,
+        id: mapValueOfType<String>(json, r'id')!,
+        methodName: mapValueOfType<String>(json, r'methodName')!,
+        pluginId: mapValueOfType<String>(json, r'pluginId')!,
+        schema: mapValueOfType<Object>(json, r'schema'),
+        supportedContexts: PluginContext.listFromJson(json[r'supportedContexts']),
+        title: mapValueOfType<String>(json, r'title')!,
+      );
+    }
+    return null;
+  }
+
+  static List<PluginFilterResponseDto> listFromJson(dynamic json, {bool growable = false,}) {
+    final result = <PluginFilterResponseDto>[];
+    if (json is List && json.isNotEmpty) {
+      for (final row in json) {
+        final value = PluginFilterResponseDto.fromJson(row);
+        if (value != null) {
+          result.add(value);
+        }
+      }
+    }
+    return result.toList(growable: growable);
+  }
+
+  static Map<String, PluginFilterResponseDto> mapFromJson(dynamic json) {
+    final map = <String, PluginFilterResponseDto>{};
+    if (json is Map && json.isNotEmpty) {
+      json = json.cast<String, dynamic>(); // ignore: parameter_assignments
+      for (final entry in json.entries) {
+        final value = PluginFilterResponseDto.fromJson(entry.value);
+        if (value != null) {
+          map[entry.key] = value;
+        }
+      }
+    }
+    return map;
+  }
+
+  // maps a json object with a list of PluginFilterResponseDto-objects as value to a dart map
+  static Map<String, List<PluginFilterResponseDto>> mapListFromJson(dynamic json, {bool growable = false,}) {
+    final map = <String, List<PluginFilterResponseDto>>{};
+    if (json is Map && json.isNotEmpty) {
+      // ignore: parameter_assignments
+      json = json.cast<String, dynamic>();
+      for (final entry in json.entries) {
+        map[entry.key] = PluginFilterResponseDto.listFromJson(entry.value, growable: growable,);
+      }
+    }
+    return map;
+  }
+
+  /// The list of required keys that must be present in a JSON.
+  static const requiredKeys = <String>{
+    'description',
+    'id',
+    'methodName',
+    'pluginId',
+    'schema',
+    'supportedContexts',
+    'title',
+  };
+}
+

mobile/openapi/lib/model/plugin_response_dto.dart

@@ -0,0 +1,171 @@
+//
+// AUTO-GENERATED FILE, DO NOT MODIFY!
+//
+// @dart=2.18
+
+// ignore_for_file: unused_element, unused_import
+// ignore_for_file: always_put_required_named_parameters_first
+// ignore_for_file: constant_identifier_names
+// ignore_for_file: lines_longer_than_80_chars
+
+part of openapi.api;
+
+class PluginResponseDto {
+  /// Returns a new [PluginResponseDto] instance.
+  PluginResponseDto({
+    this.actions = const [],
+    required this.author,
+    required this.createdAt,
+    required this.description,
+    this.filters = const [],
+    required this.id,
+    required this.name,
+    required this.title,
+    required this.updatedAt,
+    required this.version,
+  });
+
+  List<PluginActionResponseDto> actions;
+
+  String author;
+
+  String createdAt;
+
+  String description;
+
+  List<PluginFilterResponseDto> filters;
+
+  String id;
+
+  String name;
+
+  String title;
+
+  String updatedAt;
+
+  String version;
+
+  @override
+  bool operator ==(Object other) => identical(this, other) || other is PluginResponseDto &&
+    _deepEquality.equals(other.actions, actions) &&
+    other.author == author &&
+    other.createdAt == createdAt &&
+    other.description == description &&
+    _deepEquality.equals(other.filters, filters) &&
+    other.id == id &&
+    other.name == name &&
+    other.title == title &&
+    other.updatedAt == updatedAt &&
+    other.version == version;
+
+  @override
+  int get hashCode =>
+    // ignore: unnecessary_parenthesis
+    (actions.hashCode) +
+    (author.hashCode) +
+    (createdAt.hashCode) +
+    (description.hashCode) +
+    (filters.hashCode) +
+    (id.hashCode) +
+    (name.hashCode) +
+    (title.hashCode) +
+    (updatedAt.hashCode) +
+    (version.hashCode);
+
+  @override
+  String toString() => 'PluginResponseDto[actions=$actions, author=$author, createdAt=$createdAt, description=$description, filters=$filters, id=$id, name=$name, title=$title, updatedAt=$updatedAt, version=$version]';
+
+  Map<String, dynamic> toJson() {
+    final json = <String, dynamic>{};
+      json[r'actions'] = this.actions;
+      json[r'author'] = this.author;
+      json[r'createdAt'] = this.createdAt;
+      json[r'description'] = this.description;
+      json[r'filters'] = this.filters;
+      json[r'id'] = this.id;
+      json[r'name'] = this.name;
+      json[r'title'] = this.title;
+      json[r'updatedAt'] = this.updatedAt;
+      json[r'version'] = this.version;
+    return json;
+  }
+
+  /// Returns a new [PluginResponseDto] instance and imports its values from
+  /// [value] if it's a [Map], null otherwise.
+  // ignore: prefer_constructors_over_static_methods
+  static PluginResponseDto? fromJson(dynamic value) {
+    upgradeDto(value, "PluginResponseDto");
+    if (value is Map) {
+      final json = value.cast<String, dynamic>();
+
+      return PluginResponseDto(
+        actions: PluginActionResponseDto.listFromJson(json[r'actions']),
+        author: mapValueOfType<String>(json, r'author')!,
+        createdAt: mapValueOfType<String>(json, r'createdAt')!,
+        description: mapValueOfType<String>(json, r'description')!,
+        filters: PluginFilterResponseDto.listFromJson(json[r'filters']),
+        id: mapValueOfType<String>(json, r'id')!,
+        name: mapValueOfType<String>(json, r'name')!,
+        title: mapValueOfType<String>(json, r'title')!,
+        updatedAt: mapValueOfType<String>(json, r'updatedAt')!,
+        version: mapValueOfType<String>(json, r'version')!,
+      );
+    }
+    return null;
+  }
+
+  static List<PluginResponseDto> listFromJson(dynamic json, {bool growable = false,}) {
+    final result = <PluginResponseDto>[];
+    if (json is List && json.isNotEmpty) {
+      for (final row in json) {
+        final value = PluginResponseDto.fromJson(row);
+        if (value != null) {
+          result.add(value);
+        }
+      }
+    }
+    return result.toList(growable: growable);
+  }
+
+  static Map<String, PluginResponseDto> mapFromJson(dynamic json) {
+    final map = <String, PluginResponseDto>{};
+    if (json is Map && json.isNotEmpty) {
+      json = json.cast<String, dynamic>(); // ignore: parameter_assignments
+      for (final entry in json.entries) {
+        final value = PluginResponseDto.fromJson(entry.value);
+        if (value != null) {
+          map[entry.key] = value;
+        }
+      }
+    }
+    return map;
+  }
+
+  // maps a json object with a list of PluginResponseDto-objects as value to a dart map
+  static Map<String, List<PluginResponseDto>> mapListFromJson(dynamic json, {bool growable = false,}) {
+    final map = <String, List<PluginResponseDto>>{};
+    if (json is Map && json.isNotEmpty) {
+      // ignore: parameter_assignments
+      json = json.cast<String, dynamic>();
+      for (final entry in json.entries) {
+        map[entry.key] = PluginResponseDto.listFromJson(entry.value, growable: growable,);
+      }
+    }
+    return map;
+  }
+
+  /// The list of required keys that must be present in a JSON.
+  static const requiredKeys = <String>{
+    'actions',
+    'author',
+    'createdAt',
+    'description',
+    'filters',
+    'id',
+    'name',
+    'title',
+    'updatedAt',
+    'version',
+  };
+}
+

mobile/openapi/lib/model/plugin_trigger_type.dart

@@ -0,0 +1,85 @@
+//
+// AUTO-GENERATED FILE, DO NOT MODIFY!
+//
+// @dart=2.18
+
+// ignore_for_file: unused_element, unused_import
+// ignore_for_file: always_put_required_named_parameters_first
+// ignore_for_file: constant_identifier_names
+// ignore_for_file: lines_longer_than_80_chars
+
+part of openapi.api;
+
+
+class PluginTriggerType {
+  /// Instantiate a new enum with the provided [value].
+  const PluginTriggerType._(this.value);
+
+  /// The underlying value of this enum member.
+  final String value;
+
+  @override
+  String toString() => value;
+
+  String toJson() => value;
+
+  static const assetCreate = PluginTriggerType._(r'AssetCreate');
+  static const personRecognized = PluginTriggerType._(r'PersonRecognized');
+
+  /// List of all possible values in this [enum][PluginTriggerType].
+  static const values = <PluginTriggerType>[
+    assetCreate,
+    personRecognized,
+  ];
+
+  static PluginTriggerType? fromJson(dynamic value) => PluginTriggerTypeTypeTransformer().decode(value);
+
+  static List<PluginTriggerType> listFromJson(dynamic json, {bool growable = false,}) {
+    final result = <PluginTriggerType>[];
+    if (json is List && json.isNotEmpty) {
+      for (final row in json) {
+        final value = PluginTriggerType.fromJson(row);
+        if (value != null) {
+          result.add(value);
+        }
+      }
+    }
+    return result.toList(growable: growable);
+  }
+}
+
+/// Transformation class that can [encode] an instance of [PluginTriggerType] to String,
+/// and [decode] dynamic data back to [PluginTriggerType].
+class PluginTriggerTypeTypeTransformer {
+  factory PluginTriggerTypeTypeTransformer() => _instance ??= const PluginTriggerTypeTypeTransformer._();
+
+  const PluginTriggerTypeTypeTransformer._();
+
+  String encode(PluginTriggerType data) => data.value;
+
+  /// Decodes a [dynamic value][data] to a PluginTriggerType.
+  ///
+  /// If [allowNull] is true and the [dynamic value][data] cannot be decoded successfully,
+  /// then null is returned. However, if [allowNull] is false and the [dynamic value][data]
+  /// cannot be decoded successfully, then an [UnimplementedError] is thrown.
+  ///
+  /// The [allowNull] is very handy when an API changes and a new enum value is added or removed,
+  /// and users are still using an old app with the old code.
+  PluginTriggerType? decode(dynamic data, {bool allowNull = true}) {
+    if (data != null) {
+      switch (data) {
+        case r'AssetCreate': return PluginTriggerType.assetCreate;
+        case r'PersonRecognized': return PluginTriggerType.personRecognized;
+        default:
+          if (!allowNull) {
+            throw ArgumentError('Unknown enum value to decode: $data');
+          }
+      }
+    }
+    return null;
+  }
+
+  /// Singleton [PluginTriggerTypeTypeTransformer] instance.
+  static PluginTriggerTypeTypeTransformer? _instance;
+}
+

mobile/openapi/lib/model/queue_command.dart

@@ -0,0 +1,94 @@
+//
+// AUTO-GENERATED FILE, DO NOT MODIFY!
+//
+// @dart=2.18
+
+// ignore_for_file: unused_element, unused_import
+// ignore_for_file: always_put_required_named_parameters_first
+// ignore_for_file: constant_identifier_names
+// ignore_for_file: lines_longer_than_80_chars
+
+part of openapi.api;
+
+
+class QueueCommand {
+  /// Instantiate a new enum with the provided [value].
+  const QueueCommand._(this.value);
+
+  /// The underlying value of this enum member.
+  final String value;
+
+  @override
+  String toString() => value;
+
+  String toJson() => value;
+
+  static const start = QueueCommand._(r'start');
+  static const pause = QueueCommand._(r'pause');
+  static const resume = QueueCommand._(r'resume');
+  static const empty = QueueCommand._(r'empty');
+  static const clearFailed = QueueCommand._(r'clear-failed');
+
+  /// List of all possible values in this [enum][QueueCommand].
+  static const values = <QueueCommand>[
+    start,
+    pause,
+    resume,
+    empty,
+    clearFailed,
+  ];
+
+  static QueueCommand? fromJson(dynamic value) => QueueCommandTypeTransformer().decode(value);
+
+  static List<QueueCommand> listFromJson(dynamic json, {bool growable = false,}) {
+    final result = <QueueCommand>[];
+    if (json is List && json.isNotEmpty) {
+      for (final row in json) {
+        final value = QueueCommand.fromJson(row);
+        if (value != null) {
+          result.add(value);
+        }
+      }
+    }
+    return result.toList(growable: growable);
+  }
+}
+
+/// Transformation class that can [encode] an instance of [QueueCommand] to String,
+/// and [decode] dynamic data back to [QueueCommand].
+class QueueCommandTypeTransformer {
+  factory QueueCommandTypeTransformer() => _instance ??= const QueueCommandTypeTransformer._();
+
+  const QueueCommandTypeTransformer._();
+
+  String encode(QueueCommand data) => data.value;
+
+  /// Decodes a [dynamic value][data] to a QueueCommand.
+  ///
+  /// If [allowNull] is true and the [dynamic value][data] cannot be decoded successfully,
+  /// then null is returned. However, if [allowNull] is false and the [dynamic value][data]
+  /// cannot be decoded successfully, then an [UnimplementedError] is thrown.
+  ///
+  /// The [allowNull] is very handy when an API changes and a new enum value is added or removed,
+  /// and users are still using an old app with the old code.
+  QueueCommand? decode(dynamic data, {bool allowNull = true}) {
+    if (data != null) {
+      switch (data) {
+        case r'start': return QueueCommand.start;
+        case r'pause': return QueueCommand.pause;
+        case r'resume': return QueueCommand.resume;
+        case r'empty': return QueueCommand.empty;
+        case r'clear-failed': return QueueCommand.clearFailed;
+        default:
+          if (!allowNull) {
+            throw ArgumentError('Unknown enum value to decode: $data');
+          }
+      }
+    }
+    return null;
+  }
+
+  /// Singleton [QueueCommandTypeTransformer] instance.
+  static QueueCommandTypeTransformer? _instance;
+}
+

mobile/openapi/lib/model/queue_command_dto.dart

@@ -10,14 +10,14 @@
 
 part of openapi.api;
 
-class JobCommandDto {
-  /// Returns a new [JobCommandDto] instance.
-  JobCommandDto({
+class QueueCommandDto {
+  /// Returns a new [QueueCommandDto] instance.
+  QueueCommandDto({
     required this.command,
     this.force,
   });
 
-  JobCommand command;
+  QueueCommand command;
 
   ///
   /// Please note: This property should have been non-nullable! Since the specification file
@@ -28,7 +28,7 @@ class JobCommandDto {
   bool? force;
 
   @override
-  bool operator ==(Object other) => identical(this, other) || other is JobCommandDto &&
+  bool operator ==(Object other) => identical(this, other) || other is QueueCommandDto &&
     other.command == command &&
     other.force == force;
 
@@ -39,7 +39,7 @@ class JobCommandDto {
     (force == null ? 0 : force!.hashCode);
 
   @override
-  String toString() => 'JobCommandDto[command=$command, force=$force]';
+  String toString() => 'QueueCommandDto[command=$command, force=$force]';
 
   Map<String, dynamic> toJson() {
     final json = <String, dynamic>{};
@@ -52,27 +52,27 @@ class JobCommandDto {
     return json;
   }
 
-  /// Returns a new [JobCommandDto] instance and imports its values from
+  /// Returns a new [QueueCommandDto] instance and imports its values from
   /// [value] if it's a [Map], null otherwise.
   // ignore: prefer_constructors_over_static_methods
-  static JobCommandDto? fromJson(dynamic value) {
-    upgradeDto(value, "JobCommandDto");
+  static QueueCommandDto? fromJson(dynamic value) {
+    upgradeDto(value, "QueueCommandDto");
     if (value is Map) {
       final json = value.cast<String, dynamic>();
 
-      return JobCommandDto(
-        command: JobCommand.fromJson(json[r'command'])!,
+      return QueueCommandDto(
+        command: QueueCommand.fromJson(json[r'command'])!,
         force: mapValueOfType<bool>(json, r'force'),
       );
     }
     return null;
   }
 
-  static List<JobCommandDto> listFromJson(dynamic json, {bool growable = false,}) {
-    final result = <JobCommandDto>[];
+  static List<QueueCommandDto> listFromJson(dynamic json, {bool growable = false,}) {
+    final result = <QueueCommandDto>[];
     if (json is List && json.isNotEmpty) {
       for (final row in json) {
-        final value = JobCommandDto.fromJson(row);
+        final value = QueueCommandDto.fromJson(row);
         if (value != null) {
           result.add(value);
         }
@@ -81,12 +81,12 @@ class JobCommandDto {
     return result.toList(growable: growable);
   }
 
-  static Map<String, JobCommandDto> mapFromJson(dynamic json) {
-    final map = <String, JobCommandDto>{};
+  static Map<String, QueueCommandDto> mapFromJson(dynamic json) {
+    final map = <String, QueueCommandDto>{};
     if (json is Map && json.isNotEmpty) {
       json = json.cast<String, dynamic>(); // ignore: parameter_assignments
       for (final entry in json.entries) {
-        final value = JobCommandDto.fromJson(entry.value);
+        final value = QueueCommandDto.fromJson(entry.value);
         if (value != null) {
           map[entry.key] = value;
         }
@@ -95,14 +95,14 @@ class JobCommandDto {
     return map;
   }
 
-  // maps a json object with a list of JobCommandDto-objects as value to a dart map
-  static Map<String, List<JobCommandDto>> mapListFromJson(dynamic json, {bool growable = false,}) {
-    final map = <String, List<JobCommandDto>>{};
+  // maps a json object with a list of QueueCommandDto-objects as value to a dart map
+  static Map<String, List<QueueCommandDto>> mapListFromJson(dynamic json, {bool growable = false,}) {
+    final map = <String, List<QueueCommandDto>>{};
     if (json is Map && json.isNotEmpty) {
       // ignore: parameter_assignments
       json = json.cast<String, dynamic>();
       for (final entry in json.entries) {
-        map[entry.key] = JobCommandDto.listFromJson(entry.value, growable: growable,);
+        map[entry.key] = QueueCommandDto.listFromJson(entry.value, growable: growable,);
       }
     }
     return map;