diff --git a/mintlify/openapi.yaml b/mintlify/openapi.yaml
index 75833f86e..0242db2b6 100644
--- a/mintlify/openapi.yaml
+++ b/mintlify/openapi.yaml
@@ -4394,7 +4394,7 @@ paths:
               $ref: '#/components/schemas/CancelTransactionRequest'
       responses:
         '200':
-          description: Cancellation requested successfully
+          description: The banking partner accepted the cancellation request. The transfer reaches its cancelled state once the partner confirms it, so the transaction returned here may still report its pre-cancellation status.
           content:
             application/json:
               schema:
@@ -4429,6 +4429,12 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/Error500'
+        '501':
+          description: Cancellation is not yet available for the payment rail settling this transfer. Support is being rolled out per rail and per banking partner; transfers on a rail that is not covered yet return `501 NOT_IMPLEMENTED`. Track availability in the Grid changelog.
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Error501'
   /crypto/estimate-withdrawal-fee:
     post:
       summary: Estimate crypto withdrawal fee
diff --git a/openapi.yaml b/openapi.yaml
index 75833f86e..0242db2b6 100644
--- a/openapi.yaml
+++ b/openapi.yaml
@@ -4394,7 +4394,7 @@ paths:
               $ref: '#/components/schemas/CancelTransactionRequest'
       responses:
         '200':
-          description: Cancellation requested successfully
+          description: The banking partner accepted the cancellation request. The transfer reaches its cancelled state once the partner confirms it, so the transaction returned here may still report its pre-cancellation status.
           content:
             application/json:
               schema:
@@ -4429,6 +4429,12 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/Error500'
+        '501':
+          description: Cancellation is not yet available for the payment rail settling this transfer. Support is being rolled out per rail and per banking partner; transfers on a rail that is not covered yet return `501 NOT_IMPLEMENTED`. Track availability in the Grid changelog.
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Error501'
   /crypto/estimate-withdrawal-fee:
     post:
       summary: Estimate crypto withdrawal fee
diff --git a/openapi/paths/transactions/transactions_{transactionId}_cancel.yaml b/openapi/paths/transactions/transactions_{transactionId}_cancel.yaml
index 7d2899ee5..180e0f33b 100644
--- a/openapi/paths/transactions/transactions_{transactionId}_cancel.yaml
+++ b/openapi/paths/transactions/transactions_{transactionId}_cancel.yaml
@@ -31,7 +31,10 @@ post:
           $ref: ../../components/schemas/transactions/CancelTransactionRequest.yaml
   responses:
     '200':
-      description: Cancellation requested successfully
+      description: >-
+        The banking partner accepted the cancellation request. The transfer
+        reaches its cancelled state once the partner confirms it, so the
+        transaction returned here may still report its pre-cancellation status.
       content:
         application/json:
           schema:
@@ -68,3 +71,13 @@ post:
         application/json:
           schema:
             $ref: ../../components/schemas/errors/Error500.yaml
+    '501':
+      description: >-
+        Cancellation is not yet available for the payment rail settling this
+        transfer. Support is being rolled out per rail and per banking partner;
+        transfers on a rail that is not covered yet return
+        `501 NOT_IMPLEMENTED`. Track availability in the Grid changelog.
+      content:
+        application/json:
+          schema:
+            $ref: ../../components/schemas/errors/Error501.yaml