backport of commit acf0736590 (#23530)

Co-authored-by: Max Coulombe <109547106+maxcoulombe@users.noreply.github.com>

website/content/api-docs/system/secrets-sync.mdx

@@ -403,8 +403,12 @@ $ curl \
 
 ## Set Association
 
-This endpoint sets a new association for a given destination. If an equivalent association already exists, this request
+The set endpoint links a secret to an existing destination using the secret name
-does not create a duplicate but will trigger a sync operation and refresh the secret value on the external system.
+and mount path and triggers a sync operation. If the secret is already
+associated with the destination, Vault performs a refresh without recreating the
+link. Triggering a refresh is useful to push the secret to external systems
+or retry a failed sync operation if the underlying problem that caused the
+failure has been resolved.
 
 <Note>
 
@@ -474,8 +478,11 @@ $ curl \
 
 ## Remove Association
 
-This endpoint removes an existing association for a given destination. If an equivalent association already exists, this request
+The remove endpoint unlinks a secret from an existing destination based on the
-does not create a duplicate but will trigger a sync operation and refresh the secret value on the external system.
+secret name and mount path, and triggers an unsync operation. Unsync
+operations delete the secret from the external system. The unsync operation
+reports success if the targeted association is removed, does not exist, or the
+secret was already removed from the external system.
 
 | Method | Path                                                  |
 |:-------|:------------------------------------------------------|