From 2eb5541313994f9362cdddcf548d0c5c388fec5f Mon Sep 17 00:00:00 2001
From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com>
Date: Mon, 20 Jul 2026 18:34:35 +0000
Subject: [PATCH 1/2] docs: add July 20 platform changelog entry for suggestion
payload changes
---
release-notes/version-6/sdk-changelog.mdx | 12 ++++++++++++
1 file changed, 12 insertions(+)
diff --git a/release-notes/version-6/sdk-changelog.mdx b/release-notes/version-6/sdk-changelog.mdx
index e0296c04..f39759de 100644
--- a/release-notes/version-6/sdk-changelog.mdx
+++ b/release-notes/version-6/sdk-changelog.mdx
@@ -10,6 +10,18 @@ description: Release Notes of changes added to the core Velt SDK
- `@veltdev/sdk`
- `@veltdev/types`
+
+
+### New Features
+
+- [**Suggestions**]: V2 comment annotations now accept and persist a full caller-supplied `suggestion` payload — `targetId`, `targetType`, `oldValue`, `newValue`, `summary`, `driftDetected`, plus arbitrary custom fields — on both the add and update paths. `status` remains server-owned (defaulted to `pending` at create). [Learn more →](/async-collaboration/suggestions/overview)
+
+### Bug Fixes
+
+- [**Suggestions**]: Accepting an agent suggestion no longer clobbers the payload — [`acceptSuggestion()`](/api-reference/sdk/api/api-methods#acceptsuggestion) now preserves `targetId`, `oldValue`, `newValue`, `driftDetected`, and any custom fields, and only flips `suggestion.status` to `accepted`.
+
+
+
### New Features
From 8ad4c2fba1616ae246df5a951e5eaf2763001837 Mon Sep 17 00:00:00 2001
From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com>
Date: Mon, 20 Jul 2026 18:35:45 +0000
Subject: [PATCH 2/2] docs: tighten July 20 changelog entry wording
---
release-notes/version-6/sdk-changelog.mdx | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/release-notes/version-6/sdk-changelog.mdx b/release-notes/version-6/sdk-changelog.mdx
index f39759de..2c7a5d8a 100644
--- a/release-notes/version-6/sdk-changelog.mdx
+++ b/release-notes/version-6/sdk-changelog.mdx
@@ -14,11 +14,11 @@ description: Release Notes of changes added to the core Velt SDK
### New Features
-- [**Suggestions**]: V2 comment annotations now accept and persist a full caller-supplied `suggestion` payload — `targetId`, `targetType`, `oldValue`, `newValue`, `summary`, `driftDetected`, plus arbitrary custom fields — on both the add and update paths. `status` remains server-owned (defaulted to `pending` at create). [Learn more →](/async-collaboration/suggestions/overview)
+- [**Suggestions**]: V2 comment annotations now persist a caller-supplied `suggestion` payload on the add and update paths. Supported fields include `targetId`, `targetType`, `oldValue`, `newValue`, `summary`, `driftDetected`, plus arbitrary custom fields. `status` remains server-owned and defaults to `pending` at create. [Learn more →](/async-collaboration/suggestions/overview)
### Bug Fixes
-- [**Suggestions**]: Accepting an agent suggestion no longer clobbers the payload — [`acceptSuggestion()`](/api-reference/sdk/api/api-methods#acceptsuggestion) now preserves `targetId`, `oldValue`, `newValue`, `driftDetected`, and any custom fields, and only flips `suggestion.status` to `accepted`.
+- [**Suggestions**]: [`acceptSuggestion()`](/api-reference/sdk/api/api-methods#acceptsuggestion) now preserves the full `suggestion` payload — including `targetId`, `oldValue`, `newValue`, `driftDetected`, and custom fields — and only flips `suggestion.status` to `accepted`.