diff --git a/docs/release.md b/docs/release.md
index 1563e2b..debd876 100644
--- a/docs/release.md
+++ b/docs/release.md
@@ -2,6 +2,8 @@
 
 The project follows a slightly modified version of [semantic versioning](https://semver.org/spec/v2.0.0.html). The SDK is still evolving and certain backwards-incompatible changes may be released as minor versions.
 
+For full release notes, see [https://github.com/openai/chatkit-python/releases](https://github.com/openai/chatkit-python/releases).
+
 ## Minor versions
 
 We will increase minor versions for **breaking changes** to any public interfaces. For example, going from `1.0.x` to `1.1.x` might include breaking changes.
@@ -18,6 +20,14 @@ We will increment patch versions for non-breaking changes:
 
 ## Breaking change changelog
 
+### 1.5.0
+
+Two-phase uploads:
+
+- `upload_url` was removed from `FileAttachment` and `ImageAttachment`; use `upload_descriptor` instead.
+- `ChatKitServer` now saves the created attachment metadata in the store when handling the `attachments.create` request; remove the store-write step in `AttachmentStore.create_attachment`.
+
+
 ### 1.4.0
 
 - Widget and action classes are still usable but marked as deprecated in favor of using `WidgetTemplate` to build widgets from `.widget` files.
diff --git a/pyproject.toml b/pyproject.toml
index a4ccb6b..d07742b 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -1,6 +1,6 @@
 [project]
 name = "openai-chatkit"
-version = "1.4.2"
+version = "1.5.0"
 description = "A ChatKit backend SDK."
 readme = "README.md"
 requires-python = ">=3.10"
diff --git a/uv.lock b/uv.lock
index 220eb83..94a0c7b 100644
--- a/uv.lock
+++ b/uv.lock
@@ -819,7 +819,7 @@ wheels = [
 
 [[package]]
 name = "openai-chatkit"
-version = "1.4.2"
+version = "1.5.0"
 source = { virtual = "." }
 dependencies = [
     { name = "jinja2" },