diff --git a/.speakeasy/in.openapi.yaml b/.speakeasy/in.openapi.yaml
index 9d4b8135..e3a3a92b 100644
--- a/.speakeasy/in.openapi.yaml
+++ b/.speakeasy/in.openapi.yaml
@@ -5302,7 +5302,7 @@ components:
         trace:
           $ref: '#/components/schemas/TraceConfig'
         user:
-          description: 'Unique user identifier'
+          description: 'Per-end-user identifier for abuse isolation. Use a stable ID, hash, or pseudonym. When a provider requires a user identity, OpenRouter folds it into the hashed identity sent upstream and never forwards it raw. If omitted, requests use an account-level identity, so provider policy blocks can affect the whole account.'
           example: 'user-123'
           type: 'string'
       required:
@@ -20590,6 +20590,8 @@ components:
         route:
           $ref: '#/components/schemas/DeprecatedRoute'
         safety_identifier:
+          description: 'Recommended per-end-user identifier for abuse isolation. Use a stable ID, hash, or pseudonym. When a provider requires a user identity, OpenRouter folds it into the hashed identity sent upstream and never forwards it raw. If omitted, requests use an account-level identity, so provider policy blocks can affect the whole account.'
+          example: 'user-123'
           type:
             - 'string'
             - 'null'