@robinmordasiewicz/f5xc-api-mcp 2.0.10-2601051503 → 2.0.19-2601071557

package/specs/domains/authentication.json

@@ -3,7 +3,7 @@
   "info": {
     "title": "Authentication",
     "description": "F5 Distributed Cloud Authentication API specifications",
-    "version": "2.0.10",
+    "version": "2.0.19",
     "contact": {
       "name": "F5 Distributed Cloud",
       "url": "https://docs.cloud.f5.com"
@@ -12,7 +12,33 @@
       "name": "Proprietary",
       "url": "https://www.f5.com/company/policies/eula"
     },
-    "x-f5xc-cli-domain": "authentication"
+    "x-f5xc-cli-domain": "authentication",
+    "x-f5xc-best-practices": {
+      "common_errors": [
+        {
+          "code": 401,
+          "message": "Token expired",
+          "resolution": "Refresh token or re-authenticate",
+          "prevention": "Implement automatic token refresh"
+        },
+        {
+          "code": 403,
+          "message": "Insufficient permissions",
+          "resolution": "Request additional role assignments",
+          "prevention": "Verify permissions before operations"
+        }
+      ],
+      "security_notes": [
+        "Use short-lived tokens with refresh capability",
+        "Enable MFA for administrative access",
+        "Implement least privilege access policies"
+      ],
+      "performance_tips": [
+        "Cache authentication tokens appropriately",
+        "Use service accounts for automation",
+        "Implement token pooling for high-volume scenarios"
+      ]
+    }
   },
   "servers": [
     {
@@ -253,6 +279,13 @@
             "latency": "high",
             "resource_usage": "high"
           }
+        },
+        "x-f5xc-discovered-response-time": {
+          "p50_ms": 1000,
+          "p95_ms": 3000,
+          "p99_ms": 8000,
+          "sample_count": 0,
+          "source": "estimate"
         }
       },
       "x-displayname": "API/Service Credentials.",
@@ -445,6 +478,13 @@
             "latency": "high",
             "resource_usage": "high"
           }
+        },
+        "x-f5xc-discovered-response-time": {
+          "p50_ms": 1000,
+          "p95_ms": 3000,
+          "p99_ms": 8000,
+          "sample_count": 0,
+          "source": "estimate"
         }
       },
       "x-displayname": "API/Service Credentials.",
@@ -652,6 +692,13 @@
             "latency": "low",
             "resource_usage": "low"
           }
+        },
+        "x-f5xc-discovered-response-time": {
+          "p50_ms": 1000,
+          "p95_ms": 3000,
+          "p99_ms": 8000,
+          "sample_count": 0,
+          "source": "estimate"
         }
       },
       "x-displayname": "API/Service Credentials.",
@@ -859,6 +906,13 @@
             "latency": "low",
             "resource_usage": "low"
           }
+        },
+        "x-f5xc-discovered-response-time": {
+          "p50_ms": 1000,
+          "p95_ms": 3000,
+          "p99_ms": 8000,
+          "sample_count": 0,
+          "source": "estimate"
         }
       },
       "x-displayname": "API/Service Credentials.",
@@ -1047,6 +1101,13 @@
             "latency": "moderate",
             "resource_usage": "moderate"
           }
+        },
+        "x-f5xc-discovered-response-time": {
+          "p50_ms": 200,
+          "p95_ms": 800,
+          "p99_ms": 2000,
+          "sample_count": 0,
+          "source": "estimate"
         }
       },
       "post": {
@@ -1256,6 +1317,13 @@
             "latency": "low",
             "resource_usage": "low"
           }
+        },
+        "x-f5xc-discovered-response-time": {
+          "p50_ms": 1000,
+          "p95_ms": 3000,
+          "p99_ms": 8000,
+          "sample_count": 0,
+          "source": "estimate"
         }
       },
       "x-displayname": "API/Service Credentials.",
@@ -1457,6 +1525,13 @@
             "latency": "low",
             "resource_usage": "low"
           }
+        },
+        "x-f5xc-discovered-response-time": {
+          "p50_ms": 200,
+          "p95_ms": 800,
+          "p99_ms": 2000,
+          "sample_count": 0,
+          "source": "estimate"
         }
       },
       "x-displayname": "API/Service Credentials.",
@@ -1664,6 +1739,13 @@
             "latency": "low",
             "resource_usage": "low"
           }
+        },
+        "x-f5xc-discovered-response-time": {
+          "p50_ms": 1000,
+          "p95_ms": 3000,
+          "p99_ms": 8000,
+          "sample_count": 0,
+          "source": "estimate"
         }
       },
       "x-displayname": "API/Service Credentials.",
@@ -1871,6 +1953,13 @@
             "latency": "low",
             "resource_usage": "low"
           }
+        },
+        "x-f5xc-discovered-response-time": {
+          "p50_ms": 1000,
+          "p95_ms": 3000,
+          "p99_ms": 8000,
+          "sample_count": 0,
+          "source": "estimate"
         }
       },
       "x-displayname": "API/Service Credentials.",
@@ -2078,6 +2167,13 @@
             "latency": "low",
             "resource_usage": "low"
           }
+        },
+        "x-f5xc-discovered-response-time": {
+          "p50_ms": 1000,
+          "p95_ms": 3000,
+          "p99_ms": 8000,
+          "sample_count": 0,
+          "source": "estimate"
         }
       },
       "x-displayname": "API/Service Credentials.",
@@ -2292,6 +2388,13 @@
             "latency": "low",
             "resource_usage": "low"
           }
+        },
+        "x-f5xc-discovered-response-time": {
+          "p50_ms": 1000,
+          "p95_ms": 3000,
+          "p99_ms": 8000,
+          "sample_count": 0,
+          "source": "estimate"
         }
       },
       "x-displayname": "API/Service Credentials.",
@@ -2499,6 +2602,13 @@
             "latency": "low",
             "resource_usage": "low"
           }
+        },
+        "x-f5xc-discovered-response-time": {
+          "p50_ms": 1000,
+          "p95_ms": 3000,
+          "p99_ms": 8000,
+          "sample_count": 0,
+          "source": "estimate"
         }
       },
       "x-displayname": "API/Service Credentials.",
@@ -2687,6 +2797,13 @@
             "latency": "moderate",
             "resource_usage": "moderate"
           }
+        },
+        "x-f5xc-discovered-response-time": {
+          "p50_ms": 200,
+          "p95_ms": 800,
+          "p99_ms": 2000,
+          "sample_count": 0,
+          "source": "estimate"
         }
       },
       "post": {
@@ -2896,6 +3013,13 @@
             "latency": "low",
             "resource_usage": "low"
           }
+        },
+        "x-f5xc-discovered-response-time": {
+          "p50_ms": 1000,
+          "p95_ms": 3000,
+          "p99_ms": 8000,
+          "sample_count": 0,
+          "source": "estimate"
         }
       },
       "x-displayname": "API/Service Credentials.",
@@ -3084,6 +3208,13 @@
             "latency": "moderate",
             "resource_usage": "moderate"
           }
+        },
+        "x-f5xc-discovered-response-time": {
+          "p50_ms": 200,
+          "p95_ms": 800,
+          "p99_ms": 2000,
+          "sample_count": 0,
+          "source": "estimate"
         }
       },
       "post": {
@@ -3293,6 +3424,13 @@
             "latency": "low",
             "resource_usage": "low"
           }
+        },
+        "x-f5xc-discovered-response-time": {
+          "p50_ms": 1000,
+          "p95_ms": 3000,
+          "p99_ms": 8000,
+          "sample_count": 0,
+          "source": "estimate"
         }
       },
       "x-displayname": "API/Service Credentials.",
@@ -3494,6 +3632,13 @@
             "latency": "low",
             "resource_usage": "low"
           }
+        },
+        "x-f5xc-discovered-response-time": {
+          "p50_ms": 200,
+          "p95_ms": 800,
+          "p99_ms": 2000,
+          "sample_count": 0,
+          "source": "estimate"
         }
       },
       "put": {
@@ -3711,6 +3856,13 @@
             "latency": "low",
             "resource_usage": "low"
           }
+        },
+        "x-f5xc-discovered-response-time": {
+          "p50_ms": 800,
+          "p95_ms": 2500,
+          "p99_ms": 6000,
+          "sample_count": 0,
+          "source": "estimate"
         }
       },
       "x-displayname": "API/Service Credentials.",
@@ -3746,6 +3898,8 @@
         "default": "API_CERTIFICATE",
         "x-displayname": "Credential Type.",
         "x-ves-proto-enum": "ves.io.schema.api_credential.APICredentialType",
+        "x-f5xc-description-short": "Types of API credential given when requesting credentials from F5 Distributed Cloud F5XC user certificate to access F5XC public API using mTLS...",
+        "x-f5xc-description-medium": "Types of API credential given when requesting credentials from F5 Distributed Cloud F5XC user certificate to access F5XC public API using mTLS using self credential (my credential) Kubernetes config file to access Virtual Kubernetes API in F5 Distributed Cloud using self credential (my...",
         "x-f5xc-minimum-configuration": {
           "description": "Minimum configuration for api_credentialAPICredentialType",
           "required_fields": [],
@@ -3783,6 +3937,8 @@
               "ves.io.schema.rules.string.max_bytes": "50",
               "ves.io.schema.rules.string.min_bytes": "6"
             },
+            "x-f5xc-description-short": "Password is used for generating an API certificate P12 bundle user can use to protect access to it.",
+            "x-f5xc-description-medium": "Password is used for generating an API certificate P12 bundle user can use to protect access to it. This password will not be saved/persisted anywhere in the system. Applicable for credential type API_CERTIFICATE Users have to use this password when they use the certificate, e.g.",
             "x-f5xc-required-for": {
               "minimum_config": false,
               "create": false,
@@ -3818,6 +3974,7 @@
             "$ref": "#/components/schemas/api_credentialNameSelector"
           }
         },
+        "x-f5xc-description-short": "Request format for revoking multiple API credentials.",
         "x-f5xc-minimum-configuration": {
           "description": "Minimum configuration for api_credentialBulkRevokeRequest",
           "required_fields": [
@@ -3846,6 +4003,7 @@
               "type": "string"
             },
             "x-displayname": "Credentials Failed.",
+            "x-f5xc-description-short": "Names of credentials that are not marked as DELETE due to some error.",
             "x-f5xc-required-for": {
               "minimum_config": false,
               "create": false,
@@ -3861,6 +4019,7 @@
               "type": "string"
             },
             "x-displayname": "Credentials Success.",
+            "x-f5xc-description-short": "Names of credentials that are successfully marked for deletion.",
             "x-f5xc-required-for": {
               "minimum_config": false,
               "create": false,
@@ -3873,6 +4032,7 @@
             "description": "Error message about the failures of bulk revoke of credentials.",
             "title": "Error message.",
             "x-displayname": "Error Message.",
+            "x-f5xc-description-short": "Error message about the failures of bulk revoke of credentials.",
             "minLength": 0,
             "maxLength": 1024,
             "x-f5xc-required-for": {
@@ -3883,6 +4043,7 @@
             }
           }
         },
+        "x-f5xc-description-short": "Response format for revoking multiple API credentials.",
         "x-f5xc-minimum-configuration": {
           "description": "Minimum configuration for api_credentialBulkRevokeResponse",
           "required_fields": [
@@ -3913,6 +4074,7 @@
             "x-displayname": "Expiry in days.",
             "x-ves-example": "Value",
             "x-f5xc-example": "value",
+            "x-f5xc-description-short": "Qty of days of service credential expiration.",
             "minimum": 0,
             "maximum": 2147483647,
             "x-f5xc-required-for": {
@@ -3929,6 +4091,7 @@
             "x-displayname": "Name",
             "x-ves-example": "Value",
             "x-f5xc-example": "value",
+            "x-f5xc-description-short": "Name of API credential record. It will be saved in metadata.",
             "minLength": 0,
             "maxLength": 16,
             "x-f5xc-required-for": {
@@ -3939,7 +4102,7 @@
             },
             "x-original-maxLength": 1024,
             "x-reconciled-from-discovery": true,
-            "x-reconciled-at": "2026-01-05T14:37:35.878958+00:00"
+            "x-reconciled-at": "2026-01-07T15:27:46.954169+00:00"
           },
           "namespace": {
             "type": "string",
@@ -3958,12 +4121,13 @@
             },
             "x-original-maxLength": 1024,
             "x-reconciled-from-discovery": true,
-            "x-reconciled-at": "2026-01-05T14:37:35.878964+00:00"
+            "x-reconciled-at": "2026-01-07T15:27:46.954182+00:00"
           },
           "spec": {
             "$ref": "#/components/schemas/api_credentialCustomCreateSpecType"
           }
         },
+        "x-f5xc-description-short": "CreateRequest is the request format for generating API credential.",
         "x-f5xc-minimum-configuration": {
           "description": "Minimum configuration for api_credentialCreateRequest",
           "required_fields": [
@@ -3990,6 +4154,8 @@
           "active": {
             "type": "boolean",
             "format": "boolean",
+            "description": "Indicates if the resource is active",
+            "x-f5xc-example": "True",
             "x-f5xc-required-for": {
               "minimum_config": false,
               "create": false,
@@ -4004,6 +4170,8 @@
             "x-displayname": "Credentials.",
             "x-ves-example": "Value",
             "x-f5xc-example": "value",
+            "x-f5xc-description-short": "Data is the response format based on the API credential type.",
+            "x-f5xc-description-medium": "Data is the response format based on the API credential type. In case of API_CERTIFICATES, the response is the base64 encoded value of certificate in PKCS12 format. In case of KUBE_CONFIG, the response is the base64 encoded value of the K8s kubeconfig file with contents as requested ...",
             "minLength": 0,
             "maxLength": 1024,
             "x-f5xc-required-for": {
@@ -4016,6 +4184,8 @@
           "expiration_timestamp": {
             "type": "string",
             "format": "date-time",
+            "description": "Configuration parameter for expiration timestamp",
+            "x-f5xc-description-short": "Configuration parameter for expiration timestamp.",
             "minLength": 0,
             "maxLength": 1024,
             "x-f5xc-required-for": {
@@ -4039,9 +4209,10 @@
             },
             "x-original-maxLength": 1024,
             "x-reconciled-from-discovery": true,
-            "x-reconciled-at": "2026-01-05T14:37:35.878977+00:00"
+            "x-reconciled-at": "2026-01-07T15:27:46.954202+00:00"
           }
         },
+        "x-f5xc-description-short": "CreateResponse is the response format for the credential's create request.",
         "x-f5xc-minimum-configuration": {
           "description": "Minimum configuration for api_credentialCreateResponse",
           "required_fields": [
@@ -4079,6 +4250,7 @@
             "x-displayname": "Expiry in days.",
             "x-ves-example": "Value",
             "x-f5xc-example": "value",
+            "x-f5xc-description-short": "Qty of days of service credential expiration.",
             "minimum": 0,
             "maximum": 2147483647,
             "x-f5xc-required-for": {
@@ -4095,6 +4267,7 @@
             "x-displayname": "Name",
             "x-ves-example": "Svc-cred-app1.",
             "x-f5xc-example": "svc-cred-app1",
+            "x-f5xc-description-short": "Name of API credential record. It will be saved in metadata.",
             "minLength": 0,
             "maxLength": 16,
             "x-f5xc-required-for": {
@@ -4105,7 +4278,7 @@
             },
             "x-original-maxLength": 1024,
             "x-reconciled-from-discovery": true,
-            "x-reconciled-at": "2026-01-05T14:37:35.878986+00:00"
+            "x-reconciled-at": "2026-01-07T15:27:46.954219+00:00"
           },
           "namespace": {
             "type": "string",
@@ -4124,7 +4297,7 @@
             },
             "x-original-maxLength": 1024,
             "x-reconciled-from-discovery": true,
-            "x-reconciled-at": "2026-01-05T14:37:35.878991+00:00"
+            "x-reconciled-at": "2026-01-07T15:27:46.954228+00:00"
           },
           "namespace_roles": {
             "type": "array",
@@ -4136,6 +4309,7 @@
             "x-displayname": "List of roles.",
             "x-ves-example": "Value",
             "x-f5xc-example": "value",
+            "x-f5xc-description-short": "List of roles per namespace to be assigned to service credentials.",
             "x-f5xc-required-for": {
               "minimum_config": false,
               "create": false,
@@ -4157,6 +4331,8 @@
             "x-validation-rules": {
               "ves.io.schema.rules.message.required": "true"
             },
+            "x-f5xc-description-short": "Password is used for generating an API certificate P12 bundle user can use to protect access to it.",
+            "x-f5xc-description-medium": "Password is used for generating an API certificate P12 bundle user can use to protect access to it. This password will not be saved/persisted anywhere in the system. Applicable for credential type API_CERTIFICATE Users have to use this password when they use the certificate, e.g.",
             "minLength": 0,
             "maxLength": 1024,
             "x-f5xc-required-for": {
@@ -4182,6 +4358,7 @@
             "x-displayname": "Groups",
             "x-ves-example": "[\"dev-group-1\"]",
             "x-f5xc-example": "\"[\"dev-group-1\"]\"",
+            "x-f5xc-description-short": "List of user_groups assigned to this service credential.",
             "x-f5xc-required-for": {
               "minimum_config": false,
               "create": false,
@@ -4196,6 +4373,7 @@
             "x-displayname": "VK8s Cluster.",
             "x-ves-example": "Vk8s-product-app1.",
             "x-f5xc-example": "vk8s-product-app1",
+            "x-f5xc-description-short": "Name of virtual_k8s cluster. Applicable for KUBE_CONFIG.",
             "minLength": 0,
             "maxLength": 1024,
             "x-f5xc-required-for": {
@@ -4212,6 +4390,7 @@
             "x-displayname": "VK8s Namespace.",
             "x-ves-example": "App-ns1",
             "x-f5xc-example": "app-ns1",
+            "x-f5xc-description-short": "Namespace of virtual_k8s cluster. Applicable for KUBE_CONFIG.",
             "minLength": 0,
             "maxLength": 1024,
             "x-f5xc-required-for": {
@@ -4225,6 +4404,7 @@
             "$ref": "#/components/schemas/api_credentialVk8sKubeconfigType"
           }
         },
+        "x-f5xc-description-short": "CreateServiceCredentialsRequest is the request format for creating service credentials.",
         "x-f5xc-minimum-configuration": {
           "description": "Minimum configuration for api_credentialCreateServiceCredentialsRequest",
           "required_fields": [
@@ -4271,6 +4451,8 @@
             "x-validation-rules": {
               "ves.io.schema.rules.message.required": "true"
             },
+            "x-f5xc-description-short": "Password is used for generating an API certificate P12 bundle user can use to protect access to it.",
+            "x-f5xc-description-medium": "Password is used for generating an API certificate P12 bundle user can use to protect access to it. This password will not be saved/persisted anywhere in the system. Applicable for credential type API_CERTIFICATE Users have to use this password when they use the certificate, e.g.",
             "minLength": 0,
             "maxLength": 1024,
             "x-f5xc-required-for": {
@@ -4290,6 +4472,7 @@
             "x-displayname": "VK8s Cluster.",
             "x-ves-example": "Vk8s-product-app1.",
             "x-f5xc-example": "vk8s-product-app1",
+            "x-f5xc-description-short": "Name of virtual K8s cluster. Applicable for KUBE_CONFIG.",
             "minLength": 0,
             "maxLength": 1024,
             "x-f5xc-required-for": {
@@ -4306,6 +4489,7 @@
             "x-displayname": "VK8s Namespace.",
             "x-ves-example": "App-ns1",
             "x-f5xc-example": "app-ns1",
+            "x-f5xc-description-short": "Namespace of virtual K8s cluster. Applicable for KUBE_CONFIG.",
             "minLength": 0,
             "maxLength": 1024,
             "x-f5xc-required-for": {
@@ -4346,6 +4530,7 @@
             "$ref": "#/components/schemas/api_credentialAPICredentialType"
           }
         },
+        "x-f5xc-description-short": "It specifies which expired credentials needs to be deleted.",
         "x-f5xc-minimum-configuration": {
           "description": "Minimum configuration for api_credentialExpiredSelector",
           "required_fields": [
@@ -4390,7 +4575,7 @@
             },
             "x-original-maxLength": 1024,
             "x-reconciled-from-discovery": true,
-            "x-reconciled-at": "2026-01-05T14:37:35.879017+00:00"
+            "x-reconciled-at": "2026-01-07T15:27:46.954273+00:00"
           },
           "namespace": {
             "type": "string",
@@ -4406,6 +4591,7 @@
             "x-validation-rules": {
               "ves.io.schema.rules.message.required": "true"
             },
+            "x-f5xc-description-short": "Value of namespace is always \"system\". Required: YES.",
             "minLength": 0,
             "maxLength": 6,
             "x-f5xc-required-for": {
@@ -4416,9 +4602,10 @@
             },
             "x-original-maxLength": 1024,
             "x-reconciled-from-discovery": true,
-            "x-reconciled-at": "2026-01-05T14:37:35.879021+00:00"
+            "x-reconciled-at": "2026-01-07T15:27:46.954284+00:00"
           }
         },
+        "x-f5xc-description-short": "GET credential object with a given name.",
         "x-f5xc-minimum-configuration": {
           "description": "Minimum configuration for api_credentialGetRequest",
           "required_fields": [
@@ -4443,6 +4630,7 @@
             "$ref": "#/components/schemas/api_credentialObject"
           }
         },
+        "x-f5xc-description-short": "Response of GET credential request with a given name.",
         "x-f5xc-minimum-configuration": {
           "description": "Minimum configuration for api_credentialGetResponse",
           "required_fields": [
@@ -4470,6 +4658,7 @@
             "x-displayname": "Active",
             "x-ves-example": "True",
             "x-f5xc-example": "true",
+            "x-f5xc-description-short": "Possibility to deactivate credential with no deletion.",
             "x-f5xc-required-for": {
               "minimum_config": false,
               "create": false,
@@ -4524,7 +4713,7 @@
             },
             "x-original-maxLength": 1024,
             "x-reconciled-from-discovery": true,
-            "x-reconciled-at": "2026-01-05T14:37:35.879033+00:00"
+            "x-reconciled-at": "2026-01-07T15:27:46.954302+00:00"
           },
           "namespace": {
             "type": "string",
@@ -4543,7 +4732,7 @@
             },
             "x-original-maxLength": 1024,
             "x-reconciled-from-discovery": true,
-            "x-reconciled-at": "2026-01-05T14:37:35.879037+00:00"
+            "x-reconciled-at": "2026-01-07T15:27:46.954311+00:00"
           },
           "namespace_access": {
             "$ref": "#/components/schemas/schemaNamespaceAccessType"
@@ -4570,7 +4759,7 @@
             "x-original-maxLength": 1024,
             "format": "uuid",
             "x-reconciled-from-discovery": true,
-            "x-reconciled-at": "2026-01-05T14:37:35.879046+00:00"
+            "x-reconciled-at": "2026-01-07T15:27:46.954326+00:00"
           },
           "user_email": {
             "type": "string",
@@ -4579,6 +4768,7 @@
             "x-displayname": "User",
             "x-ves-example": "Admin@example-corp.com.",
             "x-f5xc-example": "admin@example-corp.com",
+            "x-f5xc-description-short": "Email of the service user attached to service credential .",
             "minLength": 0,
             "maxLength": 1024,
             "x-f5xc-required-for": {
@@ -4598,6 +4788,7 @@
             "x-displayname": "User Groups.",
             "x-ves-example": "[\"dev-group-1\"]",
             "x-f5xc-example": "\"[\"dev-group-1\"]\"",
+            "x-f5xc-description-short": "User group list associated to this service credential.",
             "x-f5xc-required-for": {
               "minimum_config": false,
               "create": false,
@@ -4606,6 +4797,7 @@
             }
           }
         },
+        "x-f5xc-description-short": "Response of GET service credentials request with a given name.",
         "x-f5xc-minimum-configuration": {
           "description": "Minimum configuration for api_credentialGetServiceCredentialsResponse",
           "required_fields": [
@@ -4640,6 +4832,8 @@
             "title": "Active",
             "format": "boolean",
             "x-displayname": "Active",
+            "x-f5xc-example": "True",
+            "x-f5xc-description-short": "Possibility to deactivate/activate credential with no deletion.",
             "x-f5xc-required-for": {
               "minimum_config": false,
               "create": false,
@@ -4659,6 +4853,7 @@
             "x-validation-rules": {
               "ves.io.schema.rules.string.max_len": "32"
             },
+            "x-f5xc-description-short": "Serial number of the client certificate part of credential type API Certificate or Kubeconfig.",
             "minLength": 0,
             "x-f5xc-required-for": {
               "minimum_config": false,
@@ -4716,6 +4911,8 @@
             "description": "Site name when global kubeconfig is issued for physical K8s site.",
             "title": "Site Name",
             "x-displayname": "Site Name",
+            "x-f5xc-example": "example-resource",
+            "x-f5xc-description-short": "Site name when global kubeconfig is issued for physical K8s site.",
             "minLength": 0,
             "maxLength": 1024,
             "x-f5xc-required-for": {
@@ -4743,6 +4940,7 @@
             "x-validation-rules": {
               "ves.io.schema.rules.repeated.max_items": "1"
             },
+            "x-f5xc-description-short": "Reference to user for whom API credential is created.",
             "x-f5xc-required-for": {
               "minimum_config": false,
               "create": false,
@@ -4755,6 +4953,7 @@
             "description": "Name of virtual K8s cluster.",
             "title": "Virtual K8s.",
             "x-displayname": "Virtual K8s.",
+            "x-f5xc-example": "example-resource",
             "minLength": 0,
             "maxLength": 1024,
             "x-f5xc-required-for": {
@@ -4769,6 +4968,7 @@
             "description": "Namespace of virtual_k8s.",
             "title": "Virtual K8s namespace.",
             "x-displayname": "Namespace",
+            "x-f5xc-example": "example-resource",
             "minLength": 0,
             "maxLength": 1024,
             "x-f5xc-required-for": {
@@ -4779,6 +4979,7 @@
             }
           }
         },
+        "x-f5xc-description-short": "Keeps track of user requested API credentials.",
         "x-f5xc-minimum-configuration": {
           "description": "Minimum configuration for api_credentialGlobalSpecType",
           "required_fields": [
@@ -4815,6 +5016,7 @@
               "$ref": "#/components/schemas/api_credentialListResponseItem"
             },
             "x-displayname": "Credentials.",
+            "x-f5xc-example": "[\"item1\", \"item2\", \"item3\"]",
             "x-f5xc-required-for": {
               "minimum_config": false,
               "create": false,
@@ -4823,6 +5025,7 @@
             }
           }
         },
+        "x-f5xc-description-short": "Response of request to list all of users credential objects.",
         "x-f5xc-minimum-configuration": {
           "description": "Minimum configuration for api_credentialListResponse",
           "required_fields": [
@@ -4850,6 +5053,7 @@
             "x-displayname": "Active",
             "x-ves-example": "True",
             "x-f5xc-example": "true",
+            "x-f5xc-description-short": "Possibility to deactivate credential with no deletion.",
             "x-f5xc-required-for": {
               "minimum_config": false,
               "create": false,
@@ -4904,7 +5108,7 @@
             },
             "x-original-maxLength": 1024,
             "x-reconciled-from-discovery": true,
-            "x-reconciled-at": "2026-01-05T14:37:35.879077+00:00"
+            "x-reconciled-at": "2026-01-07T15:27:46.954376+00:00"
           },
           "namespace": {
             "type": "string",
@@ -4923,7 +5127,7 @@
             },
             "x-original-maxLength": 1024,
             "x-reconciled-from-discovery": true,
-            "x-reconciled-at": "2026-01-05T14:37:35.879081+00:00"
+            "x-reconciled-at": "2026-01-07T15:27:46.954385+00:00"
           },
           "type": {
             "$ref": "#/components/schemas/api_credentialAPICredentialType"
@@ -4947,7 +5151,7 @@
             "x-original-maxLength": 1024,
             "format": "uuid",
             "x-reconciled-from-discovery": true,
-            "x-reconciled-at": "2026-01-05T14:37:35.879088+00:00"
+            "x-reconciled-at": "2026-01-07T15:27:46.954397+00:00"
           },
           "user_email": {
             "type": "string",
@@ -4956,6 +5160,7 @@
             "x-displayname": "User",
             "x-ves-example": "Admin@example-corp.com.",
             "x-f5xc-example": "admin@example-corp.com",
+            "x-f5xc-description-short": "User email of user that requested credential .",
             "minLength": 0,
             "maxLength": 1024,
             "x-f5xc-required-for": {
@@ -5000,6 +5205,7 @@
               "$ref": "#/components/schemas/api_credentialListServiceCredentialsResponseItem"
             },
             "x-displayname": "Service Credentials.",
+            "x-f5xc-example": "[\"item1\", \"item2\", \"item3\"]",
             "x-f5xc-required-for": {
               "minimum_config": false,
               "create": false,
@@ -5008,6 +5214,7 @@
             }
           }
         },
+        "x-f5xc-description-short": "Response of request to list all of service credential objects.",
         "x-f5xc-minimum-configuration": {
           "description": "Minimum configuration for api_credentialListServiceCredentialsResponse",
           "required_fields": [
@@ -5035,6 +5242,7 @@
             "x-displayname": "Active",
             "x-ves-example": "True",
             "x-f5xc-example": "true",
+            "x-f5xc-description-short": "Possibility to deactivate credential with no deletion.",
             "x-f5xc-required-for": {
               "minimum_config": false,
               "create": false,
@@ -5089,7 +5297,7 @@
             },
             "x-original-maxLength": 1024,
             "x-reconciled-from-discovery": true,
-            "x-reconciled-at": "2026-01-05T14:37:35.879101+00:00"
+            "x-reconciled-at": "2026-01-07T15:27:46.954419+00:00"
           },
           "namespace": {
             "type": "string",
@@ -5108,7 +5316,7 @@
             },
             "x-original-maxLength": 1024,
             "x-reconciled-from-discovery": true,
-            "x-reconciled-at": "2026-01-05T14:37:35.879106+00:00"
+            "x-reconciled-at": "2026-01-07T15:27:46.954427+00:00"
           },
           "namespace_access": {
             "$ref": "#/components/schemas/schemaNamespaceAccessType"
@@ -5135,7 +5343,7 @@
             "x-original-maxLength": 1024,
             "format": "uuid",
             "x-reconciled-from-discovery": true,
-            "x-reconciled-at": "2026-01-05T14:37:35.879114+00:00"
+            "x-reconciled-at": "2026-01-07T15:27:46.954440+00:00"
           },
           "user_email": {
             "type": "string",
@@ -5144,6 +5352,7 @@
             "x-displayname": "User",
             "x-ves-example": "Admin@example-corp.com.",
             "x-f5xc-example": "admin@example-corp.com",
+            "x-f5xc-description-short": "User email of user that requested credential .",
             "minLength": 0,
             "maxLength": 1024,
             "x-f5xc-required-for": {
@@ -5163,6 +5372,7 @@
             "x-displayname": "User Groups.",
             "x-ves-example": "[\"dev-group-1\"]",
             "x-f5xc-example": "\"[\"dev-group-1\"]\"",
+            "x-f5xc-description-short": "User group list associated to this service credential.",
             "x-f5xc-required-for": {
               "minimum_config": false,
               "create": false,
@@ -5171,6 +5381,7 @@
             }
           }
         },
+        "x-f5xc-description-short": "Each item of service credential list request.",
         "x-f5xc-minimum-configuration": {
           "description": "Minimum configuration for api_credentialListServiceCredentialsResponseItem",
           "required_fields": [
@@ -5222,6 +5433,8 @@
               "ves.io.schema.rules.repeated.min_items": "1",
               "ves.io.schema.rules.repeated.unique": "true"
             },
+            "x-f5xc-example": "example-resource",
+            "x-f5xc-description-short": "It contains the names of credentials which needs to be deleted. Required: YES.",
             "x-f5xc-required-for": {
               "minimum_config": false,
               "create": false,
@@ -5259,6 +5472,7 @@
             "$ref": "#/components/schemas/schemaSystemObjectMetaType"
           }
         },
+        "x-f5xc-description-short": "API Credential object represents the user request to create a certificate.",
         "x-f5xc-minimum-configuration": {
           "description": "Minimum configuration for api_credentialObject",
           "required_fields": [
@@ -5296,6 +5510,8 @@
               "ves.io.schema.rules.uint32.gte": "1",
               "ves.io.schema.rules.uint32.lte": "730"
             },
+            "x-f5xc-description-short": "Qty of days of service credential expiration. Default value is 180.",
+            "x-f5xc-description-medium": "Qty of days of service credential expiration. Default value is 180. Expiration days value can range between 1 and 730.",
             "minimum": 0,
             "maximum": 2147483647,
             "x-f5xc-required-for": {
@@ -5322,9 +5538,10 @@
             },
             "x-original-maxLength": 1024,
             "x-reconciled-from-discovery": true,
-            "x-reconciled-at": "2026-01-05T14:37:35.879130+00:00"
+            "x-reconciled-at": "2026-01-07T15:27:46.954466+00:00"
           }
         },
+        "x-f5xc-description-short": "RecreateScimTokenRequest is the request format for generating SCIM API credential.",
         "x-f5xc-minimum-configuration": {
           "description": "Minimum configuration for api_credentialRecreateScimTokenRequest",
           "required_fields": [
@@ -5353,6 +5570,7 @@
             "x-displayname": "Expiry in days.",
             "x-ves-example": "Value",
             "x-f5xc-example": "value",
+            "x-f5xc-description-short": "Qty of days of service credential expiration.",
             "minimum": 0,
             "maximum": 2147483647,
             "x-f5xc-required-for": {
@@ -5376,6 +5594,7 @@
             "x-validation-rules": {
               "ves.io.schema.rules.message.required": "true"
             },
+            "x-f5xc-description-short": "Name of API credential object. Required: YES.",
             "minLength": 0,
             "maxLength": 16,
             "x-f5xc-required-for": {
@@ -5386,7 +5605,7 @@
             },
             "x-original-maxLength": 1024,
             "x-reconciled-from-discovery": true,
-            "x-reconciled-at": "2026-01-05T14:37:35.879137+00:00"
+            "x-reconciled-at": "2026-01-07T15:27:46.954479+00:00"
           },
           "namespace": {
             "type": "string",
@@ -5402,6 +5621,7 @@
             "x-validation-rules": {
               "ves.io.schema.rules.message.required": "true"
             },
+            "x-f5xc-description-short": "Value of namespace is always \"system\" . Required: YES.",
             "minLength": 0,
             "maxLength": 6,
             "x-f5xc-required-for": {
@@ -5412,7 +5632,7 @@
             },
             "x-original-maxLength": 1024,
             "x-reconciled-from-discovery": true,
-            "x-reconciled-at": "2026-01-05T14:37:35.879141+00:00"
+            "x-reconciled-at": "2026-01-07T15:27:46.954484+00:00"
           }
         },
         "x-f5xc-minimum-configuration": {
@@ -5450,6 +5670,7 @@
             "x-validation-rules": {
               "ves.io.schema.rules.message.required": "true"
             },
+            "x-f5xc-description-short": "Name of service credential object. Required: YES.",
             "minLength": 0,
             "maxLength": 16,
             "x-f5xc-required-for": {
@@ -5460,7 +5681,7 @@
             },
             "x-original-maxLength": 1024,
             "x-reconciled-from-discovery": true,
-            "x-reconciled-at": "2026-01-05T14:37:35.879146+00:00"
+            "x-reconciled-at": "2026-01-07T15:27:46.954489+00:00"
           },
           "namespace": {
             "type": "string",
@@ -5469,6 +5690,7 @@
             "x-displayname": "Namespace",
             "x-ves-example": "System",
             "x-f5xc-example": "system",
+            "x-f5xc-description-short": "Namespace of the service credential user. Value of namespace is always \"system\".",
             "minLength": 0,
             "maxLength": 6,
             "x-f5xc-required-for": {
@@ -5479,7 +5701,7 @@
             },
             "x-original-maxLength": 1024,
             "x-reconciled-from-discovery": true,
-            "x-reconciled-at": "2026-01-05T14:37:35.879150+00:00"
+            "x-reconciled-at": "2026-01-07T15:27:46.954493+00:00"
           },
           "namespace_access": {
             "$ref": "#/components/schemas/schemaNamespaceAccessType"
@@ -5494,6 +5716,7 @@
             "x-displayname": "Groups",
             "x-ves-example": "[\"dev-group-1\"]",
             "x-f5xc-example": "\"[\"dev-group-1\"]\"",
+            "x-f5xc-description-short": "List of user_groups to be replaced for this service credentials.",
             "x-f5xc-required-for": {
               "minimum_config": false,
               "create": false,
@@ -5502,6 +5725,7 @@
             }
           }
         },
+        "x-f5xc-description-short": "Request format for replacing service credentials.",
         "x-f5xc-minimum-configuration": {
           "description": "Minimum configuration for api_credentialReplaceServiceCredentialsRequest",
           "required_fields": [
@@ -5532,6 +5756,7 @@
             "x-displayname": "Active",
             "x-ves-example": "True",
             "x-f5xc-example": "true",
+            "x-f5xc-description-short": "Specifies if service credential is active or not.",
             "x-f5xc-required-for": {
               "minimum_config": false,
               "create": false,
@@ -5571,9 +5796,10 @@
             },
             "x-original-maxLength": 1024,
             "x-reconciled-from-discovery": true,
-            "x-reconciled-at": "2026-01-05T14:37:35.879161+00:00"
+            "x-reconciled-at": "2026-01-07T15:27:46.954518+00:00"
           }
         },
+        "x-f5xc-description-short": "Response format for the credential's replace request.",
         "x-f5xc-minimum-configuration": {
           "description": "Minimum configuration for api_credentialReplaceServiceCredentialsResponse",
           "required_fields": [
@@ -5609,6 +5835,7 @@
             "x-validation-rules": {
               "ves.io.schema.rules.message.required": "true"
             },
+            "x-f5xc-description-short": "Value of namespace is always \"system\". Required: YES.",
             "minLength": 0,
             "maxLength": 6,
             "x-f5xc-required-for": {
@@ -5619,9 +5846,10 @@
             },
             "x-original-maxLength": 1024,
             "x-reconciled-from-discovery": true,
-            "x-reconciled-at": "2026-01-05T14:37:35.879166+00:00"
+            "x-reconciled-at": "2026-01-07T15:27:46.954524+00:00"
           }
         },
+        "x-f5xc-description-short": "ScimTokenRequest is used for fetching or revoking scim token.",
         "x-f5xc-minimum-configuration": {
           "description": "Minimum configuration for api_credentialScimTokenRequest",
           "required_fields": [
@@ -5661,6 +5889,7 @@
               "ves.io.schema.rules.string.max_bytes": "64",
               "ves.io.schema.rules.string.min_bytes": "1"
             },
+            "x-f5xc-description-short": "Name of the site for which kubeconfig is being requested. Required: YES.",
             "x-f5xc-required-for": {
               "minimum_config": false,
               "create": false,
@@ -5692,6 +5921,7 @@
             "$ref": "#/components/schemas/api_credentialGlobalSpecType"
           }
         },
+        "x-f5xc-description-short": "Shape of the API credential specification.",
         "x-f5xc-minimum-configuration": {
           "description": "Minimum configuration for api_credentialSpecType",
           "required_fields": [
@@ -5728,7 +5958,7 @@
             "maxLength": 17,
             "minLength": 17,
             "x-reconciled-from-discovery": true,
-            "x-reconciled-at": "2026-01-05T14:37:35.879175+00:00"
+            "x-reconciled-at": "2026-01-07T15:27:46.954534+00:00"
           }
         },
         "x-f5xc-minimum-configuration": {
@@ -5785,6 +6015,7 @@
             "x-validation-rules": {
               "ves.io.schema.rules.string.ves_object_name": "true"
             },
+            "x-f5xc-description-short": "Namespace of virtual K8s cluster. Applicable for KUBE_CONFIG.",
             "minLength": 0,
             "maxLength": 1024,
             "x-f5xc-required-for": {
@@ -5814,6 +6045,7 @@
         "title": "Empty",
         "x-displayname": "Empty",
         "x-ves-proto-message": "ves.io.schema.Empty",
+        "x-f5xc-description-short": "Can be used for messages where no values are needed.",
         "x-f5xc-minimum-configuration": {
           "description": "Minimum configuration for schemaEmpty",
           "required_fields": [],
@@ -5837,6 +6069,7 @@
             "title": "Name",
             "x-displayname": "Name",
             "x-f5xc-example": "example-resource",
+            "x-f5xc-description-short": "Name of the service that is responsible for initializing this object.",
             "minLength": 0,
             "maxLength": 16,
             "x-f5xc-required-for": {
@@ -5847,9 +6080,10 @@
             },
             "x-original-maxLength": 1024,
             "x-reconciled-from-discovery": true,
-            "x-reconciled-at": "2026-01-05T14:37:35.879185+00:00"
+            "x-reconciled-at": "2026-01-07T15:27:46.954544+00:00"
           }
         },
+        "x-f5xc-description-short": "Initializer is information about an initializer that has not yet completed.",
         "x-f5xc-minimum-configuration": {
           "description": "Minimum configuration for schemaInitializerType",
           "required_fields": [
@@ -5877,6 +6111,8 @@
               "$ref": "#/components/schemas/schemaInitializerType"
             },
             "x-displayname": "Pending",
+            "x-f5xc-description-short": "Pending is a list of initializers that must execute in order before this object is initialized.",
+            "x-f5xc-description-medium": "Pending is a list of initializers that must execute in order before this object is initialized. When the last pending initializer is removed, and no failing result is set, the initializers struct will be set to nil and the object is considered as initialized and visible to all clients.",
             "x-f5xc-required-for": {
               "minimum_config": false,
               "create": false,
@@ -5888,6 +6124,7 @@
             "$ref": "#/components/schemas/schemaStatusType"
           }
         },
+        "x-f5xc-description-short": "Initializers tracks the progress of initialization of a configuration object.",
         "x-f5xc-minimum-configuration": {
           "description": "Minimum configuration for schemaInitializersType",
           "required_fields": [
@@ -5923,6 +6160,7 @@
               "ves.io.schema.rules.map.keys.string.max_len": "256",
               "ves.io.schema.rules.message.required": "true"
             },
+            "x-f5xc-description-short": "List of all the roles for the entity in the namespaces Required: YES.",
             "x-f5xc-required-for": {
               "minimum_config": false,
               "create": false,
@@ -5931,6 +6169,7 @@
             }
           }
         },
+        "x-f5xc-description-short": "Access info in the namespaces for the entity.",
         "x-f5xc-minimum-configuration": {
           "description": "Minimum configuration for schemaNamespaceAccessType",
           "required_fields": [
@@ -5967,6 +6206,7 @@
               "ves.io.schema.rules.message.required": "true",
               "ves.io.schema.rules.string.max_len": "256"
             },
+            "x-f5xc-description-short": "Namespace the role applies to '*' value implies all namespaces Required: YES.",
             "minLength": 0,
             "x-f5xc-required-for": {
               "minimum_config": false,
@@ -5976,7 +6216,7 @@
             },
             "x-original-maxLength": 256,
             "x-reconciled-from-discovery": true,
-            "x-reconciled-at": "2026-01-05T14:37:35.879196+00:00"
+            "x-reconciled-at": "2026-01-07T15:27:46.954555+00:00"
           },
           "role": {
             "type": "string",
@@ -5997,6 +6237,7 @@
               "ves.io.schema.rules.string.max_len": "256",
               "ves.io.schema.rules.string.ves_object_name": "true"
             },
+            "x-f5xc-description-short": "Users role for this namespace Required: YES.",
             "minLength": 0,
             "x-f5xc-required-for": {
               "minimum_config": false,
@@ -6045,6 +6286,8 @@
               "ves.io.schema.rules.map.values.string.max_len": "1024",
               "ves.io.schema.rules.map.values.string.min_len": "1"
             },
+            "x-f5xc-description-short": "Annotations is an unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata.",
+            "x-f5xc-description-medium": "Annotations is an unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects.",
             "x-f5xc-required-for": {
               "minimum_config": false,
               "create": false,
@@ -6066,6 +6309,7 @@
             "x-validation-rules": {
               "ves.io.schema.rules.string.max_bytes": "1200"
             },
+            "x-f5xc-description-short": "Human readable description for the object.",
             "minLength": 0,
             "x-f5xc-required-for": {
               "minimum_config": false,
@@ -6075,7 +6319,7 @@
             },
             "x-original-maxLength": 1200,
             "x-reconciled-from-discovery": true,
-            "x-reconciled-at": "2026-01-05T14:37:35.879205+00:00"
+            "x-reconciled-at": "2026-01-07T15:27:46.954564+00:00"
           },
           "disable": {
             "type": "boolean",
@@ -6085,6 +6329,7 @@
             "x-displayname": "Disable",
             "x-ves-example": "True",
             "x-f5xc-example": "true",
+            "x-f5xc-description-short": "Value of true will administratively disable the object.",
             "x-f5xc-required-for": {
               "minimum_config": false,
               "create": false,
@@ -6099,6 +6344,8 @@
             "x-displayname": "Labels",
             "x-ves-example": "Value",
             "x-f5xc-example": "value",
+            "x-f5xc-description-short": "Map of string keys and values that can be used to organize and categorize (scope and select) objects as chosen by the user.",
+            "x-f5xc-description-medium": "Map of string keys and values that can be used to organize and categorize (scope and select) objects as chosen by the user. Values specified here will be used by selector expression.",
             "x-f5xc-required-for": {
               "minimum_config": false,
               "create": false,
@@ -6120,6 +6367,8 @@
             "x-validation-rules": {
               "ves.io.schema.rules.message.required": "true"
             },
+            "x-f5xc-description-short": "Name of configuration object. It has to be unique within the namespace.",
+            "x-f5xc-description-medium": "Name of configuration object. It has to be unique within the namespace. It can only be specified during create API and cannot be changed during replace API.",
             "minLength": 0,
             "maxLength": 16,
             "x-f5xc-required-for": {
@@ -6130,7 +6379,7 @@
             },
             "x-original-maxLength": 1024,
             "x-reconciled-from-discovery": true,
-            "x-reconciled-at": "2026-01-05T14:37:35.879213+00:00"
+            "x-reconciled-at": "2026-01-07T15:27:46.954572+00:00"
           },
           "namespace": {
             "type": "string",
@@ -6139,6 +6388,8 @@
             "x-displayname": "Namespace",
             "x-ves-example": "Staging",
             "x-f5xc-example": "staging",
+            "x-f5xc-description-short": "Defines the workspace within which each the configuration object is to be created.",
+            "x-f5xc-description-medium": "Defines the workspace within which each the configuration object is to be created. Must be a DNS_LABEL format. For a namespace object itself, namespace value will be \"\".",
             "minLength": 0,
             "maxLength": 6,
             "x-f5xc-required-for": {
@@ -6149,7 +6400,7 @@
             },
             "x-original-maxLength": 1024,
             "x-reconciled-from-discovery": true,
-            "x-reconciled-at": "2026-01-05T14:37:35.879218+00:00"
+            "x-reconciled-at": "2026-01-07T15:27:46.954577+00:00"
           },
           "uid": {
             "type": "string",
@@ -6158,6 +6409,8 @@
             "x-displayname": "UID",
             "x-ves-example": "D15f1fad-4d37-48c0-8706-df1824d76d31.",
             "x-f5xc-example": "d15f1fad-4d37-48c0-8706-df1824d76d31",
+            "x-f5xc-description-short": "Uid is the unique in time and space value for this object. Object create will fail if provided by the client and the value exists in the system.",
+            "x-f5xc-description-medium": "Uid is the unique in time and space value for this object. Object create will fail if provided by the client and the value exists in the system. Typically generated by the server on successful creation of an object and is not allowed to change once populated.",
             "minLength": 0,
             "maxLength": 36,
             "x-f5xc-required-for": {
@@ -6171,9 +6424,11 @@
             "x-original-maxLength": 1024,
             "format": "uuid",
             "x-reconciled-from-discovery": true,
-            "x-reconciled-at": "2026-01-05T14:37:35.879223+00:00"
+            "x-reconciled-at": "2026-01-07T15:27:46.954582+00:00"
           }
         },
+        "x-f5xc-description-short": "ObjectMetaType is metadata(common attributes) of an object that all configuration objects will have.",
+        "x-f5xc-description-medium": "ObjectMetaType is metadata(common attributes) of an object that all configuration objects will have. The information in this type can be specified by user during create and replace APIs.",
         "x-f5xc-minimum-configuration": {
           "description": "Minimum configuration for schemaObjectMetaType",
           "required_fields": [
@@ -6206,6 +6461,8 @@
             "x-displayname": "Kind",
             "x-ves-example": "Virtual_site.",
             "x-f5xc-example": "virtual_site",
+            "x-f5xc-description-short": "When a configuration object(e.g. Virtual_host) refers to another(e.g route) then kind will hold the referred object's kind (e.g. \"route\")",
+            "x-f5xc-description-medium": "When a configuration object(e.g. Virtual_host) refers to another(e.g route) then kind will hold the referred object's kind (e.g. \"route\").",
             "minLength": 0,
             "maxLength": 14,
             "x-f5xc-required-for": {
@@ -6217,7 +6474,7 @@
             "readOnly": true,
             "x-original-maxLength": 1024,
             "x-reconciled-from-discovery": true,
-            "x-reconciled-at": "2026-01-05T14:37:35.879228+00:00"
+            "x-reconciled-at": "2026-01-07T15:27:46.954587+00:00"
           },
           "name": {
             "type": "string",
@@ -6226,6 +6483,8 @@
             "x-displayname": "Name",
             "x-ves-example": "Contactus-route.",
             "x-f5xc-example": "contactus-route",
+            "x-f5xc-description-short": "When a configuration object(e.g. Virtual_host) refers to another(e.g route) then name will hold the referred object's(e.g.",
+            "x-f5xc-description-medium": "When a configuration object(e.g. Virtual_host) refers to another(e.g route) then name will hold the referred object's(e.g. Route's) name.",
             "minLength": 0,
             "maxLength": 16,
             "x-f5xc-required-for": {
@@ -6236,7 +6495,7 @@
             },
             "x-original-maxLength": 1024,
             "x-reconciled-from-discovery": true,
-            "x-reconciled-at": "2026-01-05T14:37:35.879232+00:00"
+            "x-reconciled-at": "2026-01-07T15:27:46.954591+00:00"
           },
           "namespace": {
             "type": "string",
@@ -6245,6 +6504,8 @@
             "x-displayname": "Namespace",
             "x-ves-example": "Ns1",
             "x-f5xc-example": "ns1",
+            "x-f5xc-description-short": "When a configuration object(e.g. Virtual_host) refers to another(e.g route) then namespace will hold the referred object's(e.g.",
+            "x-f5xc-description-medium": "When a configuration object(e.g. Virtual_host) refers to another(e.g route) then namespace will hold the referred object's(e.g. Route's) namespace.",
             "minLength": 0,
             "maxLength": 6,
             "x-f5xc-required-for": {
@@ -6255,7 +6516,7 @@
             },
             "x-original-maxLength": 1024,
             "x-reconciled-from-discovery": true,
-            "x-reconciled-at": "2026-01-05T14:37:35.879237+00:00"
+            "x-reconciled-at": "2026-01-07T15:27:46.954595+00:00"
           },
           "tenant": {
             "type": "string",
@@ -6264,6 +6525,8 @@
             "x-displayname": "Tenant",
             "x-ves-example": "Example-corp.",
             "x-f5xc-example": "example-corp",
+            "x-f5xc-description-short": "When a configuration object(e.g. Virtual_host) refers to another(e.g route) then tenant will hold the referred object's(e.g.",
+            "x-f5xc-description-medium": "When a configuration object(e.g. Virtual_host) refers to another(e.g route) then tenant will hold the referred object's(e.g. Route's) tenant.",
             "minLength": 0,
             "maxLength": 18,
             "x-f5xc-required-for": {
@@ -6276,7 +6539,7 @@
             "x-field-mutability": "read-only",
             "x-original-maxLength": 1024,
             "x-reconciled-from-discovery": true,
-            "x-reconciled-at": "2026-01-05T14:37:35.879241+00:00"
+            "x-reconciled-at": "2026-01-07T15:27:46.954599+00:00"
           },
           "uid": {
             "type": "string",
@@ -6285,6 +6548,8 @@
             "x-displayname": "UID",
             "x-ves-example": "D15f1fad-4d37-48c0-8706-df1824d76d31.",
             "x-f5xc-example": "d15f1fad-4d37-48c0-8706-df1824d76d31",
+            "x-f5xc-description-short": "When a configuration object(e.g. Virtual_host) refers to another(e.g route) then uid will hold the referred object's(e.g.",
+            "x-f5xc-description-medium": "When a configuration object(e.g. Virtual_host) refers to another(e.g route) then uid will hold the referred object's(e.g. Route's) uid.",
             "minLength": 0,
             "maxLength": 36,
             "x-f5xc-required-for": {
@@ -6298,9 +6563,11 @@
             "x-original-maxLength": 1024,
             "format": "uuid",
             "x-reconciled-from-discovery": true,
-            "x-reconciled-at": "2026-01-05T14:37:35.879246+00:00"
+            "x-reconciled-at": "2026-01-07T15:27:46.954604+00:00"
           }
         },
+        "x-f5xc-description-short": "Type establishes a 'direct reference' from one object(the referrer) to another(the referred).",
+        "x-f5xc-description-medium": "Type establishes a 'direct reference' from one object(the referrer) to another(the referred). Such a reference is in form of tenant/namespace/name for public API and Uid for private API This type of reference is called direct because the relation is explicit and concrete (as opposed to selector...",
         "x-f5xc-minimum-configuration": {
           "description": "Minimum configuration for schemaObjectRefType",
           "required_fields": [
@@ -6329,6 +6596,7 @@
             "items": {
               "type": "string"
             },
+            "x-f5xc-example": "example-resource",
             "x-f5xc-required-for": {
               "minimum_config": false,
               "create": false,
@@ -6364,6 +6632,7 @@
             "x-displayname": "Code",
             "x-ves-example": "0",
             "x-f5xc-example": "0",
+            "x-f5xc-description-short": "Suggested HTTP return code for this status, 0 if not set.",
             "minimum": 0,
             "maximum": 2147483647,
             "x-f5xc-required-for": {
@@ -6380,6 +6649,8 @@
             "x-displayname": "Reason",
             "x-ves-example": "Value",
             "x-f5xc-example": "value",
+            "x-f5xc-description-short": "Human-readable description of why this operation is in the \"Failure\" status. If this value is empty there is no information available.",
+            "x-f5xc-description-medium": "Human-readable description of why this operation is in the \"Failure\" status. If this value is empty there is no information available.",
             "minLength": 0,
             "maxLength": 43,
             "x-f5xc-required-for": {
@@ -6390,7 +6661,7 @@
             },
             "x-original-maxLength": 1024,
             "x-reconciled-from-discovery": true,
-            "x-reconciled-at": "2026-01-05T14:37:35.879255+00:00"
+            "x-reconciled-at": "2026-01-07T15:27:46.954613+00:00"
           },
           "status": {
             "type": "string",
@@ -6399,6 +6670,7 @@
             "x-displayname": "Status",
             "x-ves-example": "Value",
             "x-f5xc-example": "value",
+            "x-f5xc-description-short": "Status of the operation. One of: \"Success\" or \"Failure\".",
             "minLength": 0,
             "maxLength": 17,
             "x-f5xc-required-for": {
@@ -6409,9 +6681,10 @@
             },
             "x-original-maxLength": 1024,
             "x-reconciled-from-discovery": true,
-            "x-reconciled-at": "2026-01-05T14:37:35.879259+00:00"
+            "x-reconciled-at": "2026-01-07T15:27:46.954617+00:00"
           }
         },
+        "x-f5xc-description-short": "Status is a return value for calls that don't return other objects.",
         "x-f5xc-minimum-configuration": {
           "description": "Minimum configuration for schemaStatusType",
           "required_fields": [
@@ -6439,6 +6712,8 @@
             "title": "Creation_timestamp.",
             "format": "date-time",
             "x-displayname": "Creation Timestamp.",
+            "x-f5xc-description-short": "CreationTimestamp is a timestamp representing the server time when this object was created.",
+            "x-f5xc-description-medium": "CreationTimestamp is a timestamp representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this value.",
             "minLength": 0,
             "maxLength": 1024,
             "x-f5xc-required-for": {
@@ -6457,6 +6732,7 @@
             "x-displayname": "Creator Class.",
             "x-ves-example": "Value",
             "x-f5xc-example": "value",
+            "x-f5xc-description-short": "Value identifying the class of the user or service which created this configuration object.",
             "minLength": 0,
             "maxLength": 1024,
             "x-f5xc-required-for": {
@@ -6475,6 +6751,8 @@
             "x-displayname": "Creator Cookie.",
             "x-ves-example": "Value",
             "x-f5xc-example": "value",
+            "x-f5xc-description-short": "Can used by the creator of the object for later audit for e.g.",
+            "x-f5xc-description-medium": "Can used by the creator of the object for later audit for e.g. By storing the version identifying information of the object so at future it can be determined if version present at remote end is current or stale.",
             "minLength": 0,
             "maxLength": 1024,
             "x-f5xc-required-for": {
@@ -6492,6 +6770,7 @@
             "x-displayname": "Creator ID.",
             "x-ves-example": "Value",
             "x-f5xc-example": "value",
+            "x-f5xc-description-short": "Value identifying the exact user or service that created this configuration object.",
             "minLength": 0,
             "maxLength": 1024,
             "x-f5xc-required-for": {
@@ -6509,6 +6788,8 @@
             "title": "Deletion_timestamp.",
             "format": "date-time",
             "x-displayname": "Deletion Timestamp.",
+            "x-f5xc-description-short": "DeletionTimestamp is RFC 3339 date and time at which this resource will be deleted.",
+            "x-f5xc-description-medium": "DeletionTimestamp is RFC 3339 date and time at which this resource will be deleted. This field is set by the server when a graceful deletion is requested by the user, and is not directly settable by a client. The resource is expected to be deleted (no longer visible from resource lists, and not...",
             "minLength": 0,
             "maxLength": 1024,
             "x-f5xc-required-for": {
@@ -6523,6 +6804,8 @@
             "description": "A hash of the UIDs of direct references on this object. This can be used to determine if\nthis object hash has had references become resolved/unresolved.",
             "title": "Direct_ref_hash.",
             "x-displayname": "Direct Reference Hash.",
+            "x-f5xc-description-short": "Hash of the UIDs of direct references on this object. This can be used to determine if this object hash has had references become resolved/unresolved.",
+            "x-f5xc-description-medium": "Hash of the UIDs of direct references on this object. This can be used to determine if this object hash has had references become resolved/unresolved.",
             "minLength": 0,
             "maxLength": 1024,
             "x-f5xc-required-for": {
@@ -6542,6 +6825,8 @@
             "x-displayname": "Finalizers.",
             "x-ves-example": "Value",
             "x-f5xc-example": "value",
+            "x-f5xc-description-short": "Must be empty before the object is deleted from the registry.",
+            "x-f5xc-description-medium": "Must be empty before the object is deleted from the registry. Each entry is an identifier for the responsible component that will remove the entry from the list. If the deletionTimestamp of the object is non-nil, entries in this list can only be removed.",
             "x-f5xc-required-for": {
               "minimum_config": false,
               "create": false,
@@ -6559,6 +6844,8 @@
             "x-displayname": "Labels",
             "x-ves-example": "'VES.I/O/soft-deleted': 'true'",
             "x-f5xc-example": "'F5 XC/soft-deleted''true'",
+            "x-f5xc-description-short": "Map of string keys and values that can be used to organize and categorize (scope and select) objects as chosen by the operator or software.",
+            "x-f5xc-description-medium": "Map of string keys and values that can be used to organize and categorize (scope and select) objects as chosen by the operator or software. Values here can be interpreted by software(backend or frontend) to enable certain behavior e.g. Things marked as soft-deleted(restorable).",
             "x-f5xc-required-for": {
               "minimum_config": false,
               "create": false,
@@ -6572,6 +6859,8 @@
             "title": "Modification_timestamp.",
             "format": "date-time",
             "x-displayname": "Modification Timestamp.",
+            "x-f5xc-description-short": "ModificationTimestamp is a timestamp representing the server time when this object was last modified.",
+            "x-f5xc-description-medium": "ModificationTimestamp is a timestamp representing the server time when this object was last modified.",
             "minLength": 0,
             "maxLength": 1024,
             "x-f5xc-required-for": {
@@ -6598,6 +6887,9 @@
             "x-validation-rules": {
               "ves.io.schema.rules.repeated.max_items": "1"
             },
+            "x-f5xc-example": "example-resource",
+            "x-f5xc-description-short": "The namespace this object belongs to. This is populated by the service based on the metadata.namespace field when an object is created.",
+            "x-f5xc-description-medium": "The namespace this object belongs to. This is populated by the service based on the metadata.namespace field when an object is created.",
             "x-f5xc-required-for": {
               "minimum_config": false,
               "create": false,
@@ -6607,7 +6899,7 @@
             "maxLength": 6,
             "minLength": 6,
             "x-reconciled-from-discovery": true,
-            "x-reconciled-at": "2026-01-05T14:37:35.879281+00:00"
+            "x-reconciled-at": "2026-01-07T15:27:46.954638+00:00"
           },
           "object_index": {
             "type": "integer",
@@ -6617,6 +6909,8 @@
             "x-displayname": "Object Index.",
             "x-ves-example": "0",
             "x-f5xc-example": "0",
+            "x-f5xc-description-short": "Unique index for the object. Some objects need a unique integer index to be allocated for each object type.",
+            "x-f5xc-description-medium": "Unique index for the object. Some objects need a unique integer index to be allocated for each object type. This field will be populated for all objects that need it and will be zero otherwise.",
             "minimum": 0,
             "maximum": 2147483647,
             "x-f5xc-required-for": {
@@ -6637,6 +6931,8 @@
             "title": "Revision",
             "format": "int64",
             "x-displayname": "Revision",
+            "x-f5xc-description-short": "Revision number which always increases with each modification of the object in storage This doesn't necessarily increase sequentially, but should...",
+            "x-f5xc-description-medium": "Revision number which always increases with each modification of the object in storage This doesn't necessarily increase sequentially, but should always increase. This will be 0 when first created, and before any modifications.",
             "minLength": 0,
             "maxLength": 1024,
             "x-f5xc-required-for": {
@@ -6654,6 +6950,8 @@
             "x-displayname": "SRE Disable.",
             "x-ves-example": "True",
             "x-f5xc-example": "true",
+            "x-f5xc-description-short": "Should be set to true If F5XC/SRE operator wants to suppress an object from being presented to business-logic of a daemon(e.g.",
+            "x-f5xc-description-medium": "Should be set to true If F5XC/SRE operator wants to suppress an object from being presented to business-logic of a daemon(e.g. Due to bad-form/issue-causing Object). This is meant only to be used in temporary situations for operational continuity till a fix is rolled out in business-logic.",
             "x-f5xc-required-for": {
               "minimum_config": false,
               "create": false,
@@ -6668,6 +6966,8 @@
             "x-displayname": "Tenant",
             "x-ves-example": "Example-corp.",
             "x-f5xc-example": "example-corp",
+            "x-f5xc-description-short": "Tenant to which this configuration object belongs to. The value for this is found from presented credentials.",
+            "x-f5xc-description-medium": "Tenant to which this configuration object belongs to. The value for this is found from presented credentials.",
             "minLength": 0,
             "maxLength": 18,
             "x-f5xc-required-for": {
@@ -6680,7 +6980,7 @@
             "x-field-mutability": "read-only",
             "x-original-maxLength": 1024,
             "x-reconciled-from-discovery": true,
-            "x-reconciled-at": "2026-01-05T14:37:35.879291+00:00"
+            "x-reconciled-at": "2026-01-07T15:27:46.954647+00:00"
           },
           "trace_info": {
             "type": "string",
@@ -6689,6 +6989,8 @@
             "x-displayname": "Trace Info.",
             "x-ves-example": "Value",
             "x-f5xc-example": "value",
+            "x-f5xc-description-short": "Trace_info holds information(<trace-ID>:<span-ID>:<parent-span-ID>) of the request doing the object modification.",
+            "x-f5xc-description-medium": "Trace_info holds information(<trace-ID>:<span-ID>:<parent-span-ID>) of the request doing the object modification. This can be used on the watch side to create subsequent spans. This information can be used to co-relate activities across services (modulo state compression) for a synchronous API.",
             "minLength": 0,
             "maxLength": 1024,
             "x-f5xc-required-for": {
@@ -6705,6 +7007,8 @@
             "x-displayname": "UID",
             "x-ves-example": "D15f1fad-4d37-48c0-8706-df1824d76d31.",
             "x-f5xc-example": "d15f1fad-4d37-48c0-8706-df1824d76d31",
+            "x-f5xc-description-short": "Uid is the unique in time and space value for this object.",
+            "x-f5xc-description-medium": "Uid is the unique in time and space value for this object. It is generated by the server on successful creation of an object and is not allowed to change on Replace API. The value of is taken from uid field of ObjectMetaType, if provided.",
             "minLength": 0,
             "maxLength": 36,
             "x-f5xc-required-for": {
@@ -6718,7 +7022,7 @@
             "x-original-maxLength": 1024,
             "format": "uuid",
             "x-reconciled-from-discovery": true,
-            "x-reconciled-at": "2026-01-05T14:37:35.879298+00:00"
+            "x-reconciled-at": "2026-01-07T15:27:46.954654+00:00"
           },
           "vtrp_id": {
             "type": "string",
@@ -6741,6 +7045,7 @@
             "title": "Vtrp_stale.",
             "format": "boolean",
             "x-displayname": "VTRP Stale.",
+            "x-f5xc-description-short": "Indicate whether mars deems this object to be stale via graceful restart timer information.",
             "x-f5xc-required-for": {
               "minimum_config": false,
               "create": false,
@@ -6749,6 +7054,8 @@
             }
           }
         },
+        "x-f5xc-description-short": "SystemObjectMetaType is metadata generated or populated by the system for all persisted objects and cannot be updated directly by users.",
+        "x-f5xc-description-medium": "SystemObjectMetaType is metadata generated or populated by the system for all persisted objects and cannot be updated directly by users.",
         "x-f5xc-minimum-configuration": {
           "description": "Minimum configuration for schemaSystemObjectMetaType",
           "required_fields": [
@@ -6804,7 +7111,7 @@
             },
             "x-original-maxLength": 1024,
             "x-reconciled-from-discovery": true,
-            "x-reconciled-at": "2026-01-05T14:37:35.879306+00:00"
+            "x-reconciled-at": "2026-01-07T15:27:46.954662+00:00"
           },
           "name": {
             "type": "string",
@@ -6813,6 +7120,8 @@
             "x-displayname": "Name",
             "x-ves-example": "Contactus-route.",
             "x-f5xc-example": "contactus-route",
+            "x-f5xc-description-short": "When a configuration object(e.g. Virtual_host) refers to another(e.g route) then name will hold the referred object's(e.g.",
+            "x-f5xc-description-medium": "When a configuration object(e.g. Virtual_host) refers to another(e.g route) then name will hold the referred object's(e.g. Route's) name.",
             "minLength": 0,
             "maxLength": 16,
             "x-f5xc-required-for": {
@@ -6823,7 +7132,7 @@
             },
             "x-original-maxLength": 1024,
             "x-reconciled-from-discovery": true,
-            "x-reconciled-at": "2026-01-05T14:37:35.879311+00:00"
+            "x-reconciled-at": "2026-01-07T15:27:46.954666+00:00"
           },
           "namespace": {
             "type": "string",
@@ -6832,6 +7141,8 @@
             "x-displayname": "Namespace",
             "x-ves-example": "Ns1",
             "x-f5xc-example": "ns1",
+            "x-f5xc-description-short": "When a configuration object(e.g. Virtual_host) refers to another(e.g route) then namespace will hold the referred object's(e.g.",
+            "x-f5xc-description-medium": "When a configuration object(e.g. Virtual_host) refers to another(e.g route) then namespace will hold the referred object's(e.g. Route's) namespace.",
             "minLength": 0,
             "maxLength": 6,
             "x-f5xc-required-for": {
@@ -6842,7 +7153,7 @@
             },
             "x-original-maxLength": 1024,
             "x-reconciled-from-discovery": true,
-            "x-reconciled-at": "2026-01-05T14:37:35.879315+00:00"
+            "x-reconciled-at": "2026-01-07T15:27:46.954670+00:00"
           },
           "uid": {
             "type": "string",
@@ -6863,9 +7174,10 @@
             "x-original-maxLength": 1024,
             "format": "uuid",
             "x-reconciled-from-discovery": true,
-            "x-reconciled-at": "2026-01-05T14:37:35.879320+00:00"
+            "x-reconciled-at": "2026-01-07T15:27:46.954675+00:00"
           }
         },
+        "x-f5xc-description-short": "ViewRefType represents a reference to a view.",
         "x-f5xc-minimum-configuration": {
           "description": "Minimum configuration for schemaViewRefType",
           "required_fields": [