diff --git a/openapi-specs/ai-runtime-security/scan/ScanService.yaml b/openapi-specs/ai-runtime-security/scan/ScanService.yaml
index 6d4b56cdf..21ede3119 100644
--- a/openapi-specs/ai-runtime-security/scan/ScanService.yaml
+++ b/openapi-specs/ai-runtime-security/scan/ScanService.yaml
@@ -37,7 +37,7 @@ paths:
       tags:
         - Scans
       parameters:
-        - description: API key token
+        - description: API key token genereated during [onboarding AI Runtime Security API intercept](https://docs.paloaltonetworks.com/ai-runtime-security/activation-and-onboarding/ai-runtime-security-api-intercept-overview/onboard-api-runtime-security-api-intercept-in-scm) in SCM.
           required: true
           in: header
           name: x-pan-token
@@ -93,7 +93,7 @@ paths:
       tags:
         - Scans
       parameters:
-        - description: API key token
+        - description: API key token genereated during [onboarding AI Runtime Security API intercept](https://docs.paloaltonetworks.com/ai-runtime-security/activation-and-onboarding/ai-runtime-security-api-intercept-overview/onboard-api-runtime-security-api-intercept-in-scm) in SCM.
           required: true
           in: header
           name: x-pan-token
@@ -146,7 +146,7 @@ paths:
       tags:
         - Scan Results
       parameters:
-        - description: API key token
+        - description: API key token genereated during [onboarding AI Runtime Security API intercept](https://docs.paloaltonetworks.com/ai-runtime-security/activation-and-onboarding/ai-runtime-security-api-intercept-overview/onboard-api-runtime-security-api-intercept-in-scm) in SCM.
           required: true
           in: header
           name: x-pan-token
@@ -206,7 +206,7 @@ paths:
         - Scan Reports
       operationId: GetThreatScanReports
       parameters:
-        - description: API key token
+        - description: API key token genereated during [onboarding AI Runtime Security API intercept](https://docs.paloaltonetworks.com/ai-runtime-security/activation-and-onboarding/ai-runtime-security-api-intercept-overview/onboard-api-runtime-security-api-intercept-in-scm) in SCM.
           required: true
           in: header
           name: x-pan-token
@@ -262,7 +262,7 @@ components:
       properties:
         tr_id:
           type: string
-          description: Unique identifier for the transaction correlating prompt and response
+          description: Provide any unique identifier string for correlating the prompt and response transactions. This is an optional field. The tr_id value received for scan request is returned in the scan response along with the scan ID.
         ai_profile:
           $ref: '#/components/schemas/AiProfile'
           description: AI profile to use for the scan. You can specify one of the following - profile_id or profile_name  
diff --git a/static/swfw/manage-api-security-profiles.png b/static/swfw/manage-api-security-profiles.png
index cc1999741..919b4a5da 100644
Binary files a/static/swfw/manage-api-security-profiles.png and b/static/swfw/manage-api-security-profiles.png differ