• 3.0.1latestno API changesDocs2026-10-12 13:23
• feat(web): recently added link in sidebar (#29039)6Docs237734b2026-07-01 23:12

  Change detail

  6 changes across 4 operations

  AllBreakingWarningInfo

  • PUT/admin/users/{id}/preferences
    • info

      added the new optional request property recentlyAdded

    • info

      added the required property recentlyAdded to the response with the 200 status

  • PUT/users/me/preferences
    • info

      added the new optional request property recentlyAdded

    • info

      added the required property recentlyAdded to the response with the 200 status

  • GET/admin/users/{id}/preferences
    • info

      added the required property recentlyAdded to the response with the 200 status

  • GET/users/me/preferences
    • info

      added the required property recentlyAdded to the response with the 200 status

• chore: version v3.0.0no API changesDocs05d838b2026-06-30 20:03
• chore: version v3.0.0-rc.4no API changesDocsac74bca2026-06-27 13:14
• chore: version v3.0.0-rc.3no API changesDocs09d4a682026-06-26 16:49
• fix: small typo in openapi-spec (#29308)no API changesDocsa876d4a2026-06-26 10:28
• refactor(server): describe check upload id as string (#29274)12Docsf22836e2026-06-23 10:42

  Change detail

  3 changes across 1 operation

  AllBreakingWarningInfo

  • POST/assets/bulk-upload-check
    • breaking

      the results/items/id response's property format changed from uuid to no format for status 200

    • info

      the results/items/assetId response's property pattern ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$ was added for the status 200

    • info

      the results/items/id response's property pattern ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$ was removed for the status 200

• chore: version v3.0.0-rc.2no API changesDocs38920fc2026-06-18 23:20
• refactor(server): use zod time validation (#29189)13Docs09d03802026-06-18 11:56

  Change detail

  4 changes across 3 operations

  AllBreakingWarningInfo

  • PUT/system-config
    • warning

      changed the pattern of the request property nightlyTasks/startTime from ^([01]\d|2[0-3]):[0-5]\d$ to ^(?:[01]\d|2[0-3]):[0-5]\d$

    • info

      the nightlyTasks/startTime response's property pattern was changed from ^([01]\d|2[0-3]):[0-5]\d$ to ^(?:[01]\d|2[0-3]):[0-5]\d$ for the status 200

  • GET/system-config/defaults
    • info

      the nightlyTasks/startTime response's property pattern was changed from ^([01]\d|2[0-3]):[0-5]\d$ to ^(?:[01]\d|2[0-3]):[0-5]\d$ for the status 200

  • GET/system-config
    • info

      the nightlyTasks/startTime response's property pattern was changed from ^([01]\d|2[0-3]):[0-5]\d$ to ^(?:[01]\d|2[0-3]):[0-5]\d$ for the status 200

• fix(server): allow non-utc datetime offsets (#29186)57126Docs83091d22026-06-18 11:27

  Change detail

  183 changes across 52 operations

  AllBreakingWarningInfo

  • POST/memories
    • warning

      changed the pattern of the request property hideAt from ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$ to ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$

    • warning

      changed the pattern of the request property memoryAt from ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$ to ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$

    • warning

      changed the pattern of the request property seenAt from ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$ to ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$

    • warning

      changed the pattern of the request property showAt from ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$ to ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$

    • info

      the createdAt response's property pattern was changed from ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$ to ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$ for the status 201

    • info

      the deletedAt response's property pattern was changed from ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$ to ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$ for the status 201

    • info

      the hideAt response's property pattern was changed from ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$ to ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$ for the status 201

  View all changes (183)
• feat(server): add hls playlist hint (#29150)1Docs7ef2de62026-06-17 23:02

  Change detail

  1 change across 1 operation

  AllBreakingWarningInfo

  • GET/assets/{id}/video/stream/{sessionId}/{variantIndex}/playlist.m3u8
    • info

      added the new optional header request parameter x-immich-hls-pos

• refactor(server): use uuids in schemas (#29140)2300Docs3f2e51c2026-06-17 12:50
• chore: version v3.0.0-rc.1no API changesDocsc9aa9ba2026-06-16 19:50
• fix: update datetimeRelative description to minutes instead of seconds (#29137)no API changesDocsd307ab62026-06-16 14:09
• docs(server): clarify AssetBulkUploadCheckItem.id is a correlation token (#29141)no API changesDocsce59cc92026-06-16 14:07
• fix: too strict cron expression validation (#29138)20Docse70a1162026-06-16 13:20
• chore: version v3.0.0-rc.0no API changesDocse4dbe772026-06-12 14:55
• fix(server): add hint header for segment after init.mp4 (#28867)1Docsaa126e32026-06-10 23:18
• feat: integrity check jobs (missing files, untracked files, checksums) (#24205)21326Docs74878622026-06-10 19:02
• chore: remove person workflow elements (#28974)511Docsfb798a82026-06-10 16:49
• refactor(server): allow -1 rating again (#28886)2Docs5c383732026-06-10 08:55
• refactor(server): deprecate PUT routes in favor of PATCH (#28859)28Docs9e453442026-06-07 13:40
• feat(mobile): ocr support (#26523)23Docs733373c2026-06-04 22:59
• feat: user upload heatmap (#28593)2Docsb3d49042026-06-04 19:36
• refactor!: disallow star rating < 1 (#27896)7Docs99281de2026-06-04 17:06
• refactor(server)!: remove changeExpiryTime (#28816)1Docse2de8c72026-06-04 08:35
• feat: minimum face count per user (#27452)7Docs368cb7a2026-06-02 16:05
• feat(web): hls player (#28312)1Docs138e2d92026-06-01 19:49
• feat(server): hls with real-time transcoding (#28230)117Docs7eabac62026-06-01 18:52
• feat: release candidate support (#28665)14Docsc8a1d0e2026-06-01 14:10
• feat: more plugin triggers and methods (#28690)74Docsda8505f2026-05-29 18:02
• refactor: plugin manifest (#28673)12Docs87831802026-05-28 21:23
• feat: search by album name and id (#28672)2Docs134c0d42026-05-28 21:01
• fix: strip metadata from timeline responses for shared links without exif sharing (#28644)2Docs452e8822026-05-27 15:29
• feat: workflow template (#28553)1Docs8682be42026-05-26 20:47
• chore(server): deprecate total field of asset search response (#28551)no API changesDocs073dcc12026-05-26 14:20
• fix: cleanup nestjs-zod properties (#28447)no API changesDocs43834732026-05-18 19:31
• feat: workflows & plugins (#26727)26754Docs3d075f22026-05-18 15:09
• feat: recently added assets page (#28272)3Docse142e3a2026-05-11 21:35
• refactor!: remove asset faces from AssetResponseDto (#27779)24242Docs38438c82026-05-11 21:05
• fix: mobile upload duration type (#28362)1Docsa278c102026-05-11 20:46
• chore(server)!: remove libopus enum (#28325)26Docsd7881692026-05-11 12:02
• feat(server)!: add isOwned filter to albums API (#28213)12Docs1fcc2b72026-05-07 16:13
• chore: pump version (#28231)no API changesDocsdafe9d72026-05-05 21:27
• fix(server): validate duplicate group ownership before dismissal (#28221)no API changesDocsd4f29ab2026-05-04 10:51
• chore!: duration in milliseconds (#28003)2689Docsb5546642026-04-30 13:44
• refactor!: change number to integer types (#27912)2516Docs013ea372026-04-28 15:25
• chore!: migrate album owner to album_user (#27467)26145Docs4bfb8b32026-04-22 14:52
• chore(web): sort imports (#27922)1Docsa16d2332026-04-21 18:51
• fix(deps): update typescript-projects (#28008)Docsc2786972026-04-21 13:29

Revisions go back to the API's first capture.