diff --git a/core-services/prompt-registry/src/main/java/com/sap/ai/sdk/prompt/registry/model/LLMModelDetails.java b/core-services/prompt-registry/src/main/java/com/sap/ai/sdk/prompt/registry/model/LLMModelDetails.java
index 507b8d16a..eb44c7949 100644
--- a/core-services/prompt-registry/src/main/java/com/sap/ai/sdk/prompt/registry/model/LLMModelDetails.java
+++ b/core-services/prompt-registry/src/main/java/com/sap/ai/sdk/prompt/registry/model/LLMModelDetails.java
@@ -169,7 +169,9 @@ public void setParams(@Nullable final Map<String, Object> params) {
    * Set the timeout of this {@link LLMModelDetails} instance and return the same instance.
    *
    * @param timeout Timeout for the LLM request in seconds. This parameter is currently ignored for
-   *     Vertex AI models. Minimum: 1 Maximum: 1200
+   *     Vertex AI models. Values above 600s may not be honored due to infrastructure connection
+   *     limits; in practice this primarily affects non-streaming calls where the connection may be
+   *     idle while waiting for a response. Minimum: 1 Maximum: 1200
    * @return The same instance of this {@link LLMModelDetails} class
    */
   @Nonnull
@@ -180,7 +182,9 @@ public LLMModelDetails timeout(@Nullable final Integer timeout) {
 
   /**
    * Timeout for the LLM request in seconds. This parameter is currently ignored for Vertex AI
-   * models. minimum: 1 maximum: 1200
+   * models. Values above 600s may not be honored due to infrastructure connection limits; in
+   * practice this primarily affects non-streaming calls where the connection may be idle while
+   * waiting for a response. minimum: 1 maximum: 1200
    *
    * @return timeout The timeout of this {@link LLMModelDetails} instance.
    */
@@ -193,7 +197,9 @@ public Integer getTimeout() {
    * Set the timeout of this {@link LLMModelDetails} instance.
    *
    * @param timeout Timeout for the LLM request in seconds. This parameter is currently ignored for
-   *     Vertex AI models. Minimum: 1 Maximum: 1200
+   *     Vertex AI models. Values above 600s may not be honored due to infrastructure connection
+   *     limits; in practice this primarily affects non-streaming calls where the connection may be
+   *     idle while waiting for a response. Minimum: 1 Maximum: 1200
    */
   public void setTimeout(@Nullable final Integer timeout) {
     this.timeout = timeout;
diff --git a/core-services/prompt-registry/src/main/java/com/sap/ai/sdk/prompt/registry/model/LlamaGuard38b.java b/core-services/prompt-registry/src/main/java/com/sap/ai/sdk/prompt/registry/model/LlamaGuard38b.java
index 682d4dcb1..5ddb9cf21 100644
--- a/core-services/prompt-registry/src/main/java/com/sap/ai/sdk/prompt/registry/model/LlamaGuard38b.java
+++ b/core-services/prompt-registry/src/main/java/com/sap/ai/sdk/prompt/registry/model/LlamaGuard38b.java
@@ -23,7 +23,12 @@
 import javax.annotation.Nonnull;
 import javax.annotation.Nullable;
 
-/** Filter configuration for Llama Guard 3 8B */
+/**
+ * Filter configuration for Llama Guard 3 8B **DEPRECATED**: will be removed 2027-09-20.
+ *
+ * @deprecated
+ */
+@Deprecated
 // CHECKSTYLE:OFF
 public class LlamaGuard38b
 // CHECKSTYLE:ON
diff --git a/core-services/prompt-registry/src/main/java/com/sap/ai/sdk/prompt/registry/model/LlamaGuard38bFilterConfig.java b/core-services/prompt-registry/src/main/java/com/sap/ai/sdk/prompt/registry/model/LlamaGuard38bFilterConfig.java
index 11948a983..71daecc86 100644
--- a/core-services/prompt-registry/src/main/java/com/sap/ai/sdk/prompt/registry/model/LlamaGuard38bFilterConfig.java
+++ b/core-services/prompt-registry/src/main/java/com/sap/ai/sdk/prompt/registry/model/LlamaGuard38bFilterConfig.java
@@ -25,7 +25,12 @@
 import javax.annotation.Nonnull;
 import javax.annotation.Nullable;
 
-/** LlamaGuard38bFilterConfig */
+/**
+ * Filter configuration for Llama Guard 3 8B **DEPRECATED**: will be removed 2027-09-20.
+ *
+ * @deprecated
+ */
+@Deprecated
 // CHECKSTYLE:OFF
 public class LlamaGuard38bFilterConfig implements InputFilterConfig, OutputFilterConfig
 // CHECKSTYLE:ON
@@ -143,7 +148,9 @@ public LlamaGuard38bFilterConfig config(@Nonnull final LlamaGuard38b config) {
    * Get config
    *
    * @return config The config of this {@link LlamaGuard38bFilterConfig} instance.
+   * @deprecated
    */
+  @Deprecated
   @Nonnull
   public LlamaGuard38b getConfig() {
     return config;
diff --git a/core-services/prompt-registry/src/main/resources/spec/prompt-registry.yaml b/core-services/prompt-registry/src/main/resources/spec/prompt-registry.yaml
index 7b2e71edf..faa4c8151 100644
--- a/core-services/prompt-registry/src/main/resources/spec/prompt-registry.yaml
+++ b/core-services/prompt-registry/src/main/resources/spec/prompt-registry.yaml
@@ -1452,7 +1452,7 @@ components:
             stream_options:
               include_usage: true
         timeout:
-          description: Timeout for the LLM request in seconds. This parameter is currently ignored for Vertex AI models.
+          description: Timeout for the LLM request in seconds. This parameter is currently ignored for Vertex AI models. Values above 600s may not be honored due to infrastructure connection limits; in practice this primarily affects non-streaming calls where the connection may be idle while waiting for a response.
           type: integer
           default: 600
           minimum: 1
@@ -1517,7 +1517,8 @@ components:
         config:
           $ref: '#/components/schemas/AzureContentSafetyInput'
     LlamaGuard38b:
-      description: Filter configuration for Llama Guard 3 8B
+      deprecated: true
+      description: 'Filter configuration for Llama Guard 3 8B **DEPRECATED**: will be removed 2027-09-20.'
       type: object
       additionalProperties: false
       minProperties: 1
@@ -1551,6 +1552,8 @@ components:
         code_interpreter_abuse:
           type: boolean
     LlamaGuard38bFilterConfig:
+      deprecated: true
+      description: 'Filter configuration for Llama Guard 3 8B **DEPRECATED**: will be removed 2027-09-20.'
       type: object
       required:
         - type