From 1a9aada2e68cb00b08f13d9fbc6112cb6ec5c0ec Mon Sep 17 00:00:00 2001
From: qiaoshanglong <118095595+qiaoshanglong@users.noreply.github.com>
Date: Sun, 23 Aug 2026 18:44:17 +0800
Subject: [PATCH] docs: document valid endpoint_id formats

---
 google/cloud/aiplatform/models.py | 16 ++++++++++++----
 1 file changed, 12 insertions(+), 4 deletions(-)

diff --git a/google/cloud/aiplatform/models.py b/google/cloud/aiplatform/models.py
index 02e56d0cb7..60c82de3a7 100644
--- a/google/cloud/aiplatform/models.py
+++ b/google/cloud/aiplatform/models.py
@@ -889,8 +889,12 @@ def create(
                 not provided, Vertex AI will generate a value for this
                 ID.
 
-                This value should be 1-10 characters, and valid
-                characters are /[0-9]/. When using HTTP/JSON, this field
+                This value can contain lowercase letters, digits, and hyphens.
+                If the first character is a letter, the last character must be
+                a letter or digit and the value can be up to 63 characters. If
+                the first character is a digit, all characters must be digits,
+                with no leading zeros, and the value can be up to 10 characters.
+                When using HTTP/JSON, this field
                 is populated based on a query string argument, such as
                 ``?endpoint_id=12345``. This is the fallback for fields
                 that are not included in either the URI or the body.
@@ -1049,8 +1053,12 @@ def _create(
                 not provided, Vertex AI will generate a value for this
                 ID.
 
-                This value should be 1-10 characters, and valid
-                characters are /[0-9]/. When using HTTP/JSON, this field
+                This value can contain lowercase letters, digits, and hyphens.
+                If the first character is a letter, the last character must be
+                a letter or digit and the value can be up to 63 characters. If
+                the first character is a digit, all characters must be digits,
+                with no leading zeros, and the value can be up to 10 characters.
+                When using HTTP/JSON, this field
                 is populated based on a query string argument, such as
                 ``?endpoint_id=12345``. This is the fallback for fields
                 that are not included in either the URI or the body.