diff --git a/.changeset/gentle-ghosts-love.md b/.changeset/gentle-ghosts-love.md
index b0727512d6..34efebad84 100644
--- a/.changeset/gentle-ghosts-love.md
+++ b/.changeset/gentle-ghosts-love.md
@@ -2,4 +2,18 @@
 '@backstage/plugin-scaffolder-backend': minor
 ---
 
-breaking
+- **BREAKING** - `DatabaseTaskStore()` constructor is now removed. Please use the `DatabaseTaskStore.create()` method instead.
+
+- **BREAKING** - `TaskStore.createTask()` method now only takes one argument of type `TaskStoreCreateTaskOptions` which encapsulates the `spec` and `secrets`
+
+```diff
+- TaskStore.createTask(spec, secrets)
++ TaskStore.createTask({ spec, secrets})
+```
+
+- **BREAKING** - `TaskBroker.dispatch()` method now only takes one argument of type `TaskBrokerDispatchOptions` which encapsulates the `spec` and `secrets`
+
+```diff
+- TaskBroker.dispatch(spec, secrets)
++ TaskBroker.dispatch({ spec, secrets})
+```
diff --git a/.changeset/tender-apricots-fetch.md b/.changeset/tender-apricots-fetch.md
index fe52e688da..5fe8bda4ef 100644
--- a/.changeset/tender-apricots-fetch.md
+++ b/.changeset/tender-apricots-fetch.md
@@ -2,4 +2,6 @@
 '@backstage/plugin-scaffolder-backend': patch
 ---
 
-smaller
+- **DEPRECATED** - `Status` has been deprecated in favour of `TaskStatus`
+- **DEPRECATED** - `CompletedTaskState` has been deprecated in favour of `TaskCompletionState`
+- **DEPRECATED** - `DispatchResult` has been deprecated in favour of `TaskBrokerDispatchResult`