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

package/specs/domains/ai_services.json

@@ -3,7 +3,7 @@
   "info": {
     "title": "Ai Services",
     "description": "Query handling through inference routing with production and test modes. Positive and negative quality markers with detailed categorization capture assistant performance. Streaming connections support authenticated access, subscription lifecycles, and feature flags. IP provisioning services allocate infrastructure resources for model workloads across distributed systems.",
-    "version": "2.0.10",
+    "version": "2.0.19",
     "contact": {
       "name": "F5 Distributed Cloud",
       "url": "https://docs.cloud.f5.com"
@@ -13,7 +13,57 @@
       "url": "https://www.f5.com/company/policies/eula"
     },
     "summary": "Natural language processing with quality signals and anomaly monitoring. Token authentication for data stream subscriptions.",
-    "x-f5xc-cli-domain": "ai_services"
+    "x-f5xc-cli-domain": "ai_services",
+    "x-f5xc-best-practices": {
+      "common_errors": [
+        {
+          "code": 400,
+          "message": "Invalid request body",
+          "resolution": "Validate JSON structure and required fields before submission",
+          "prevention": "Use schema validation from OpenAPI spec"
+        },
+        {
+          "code": 401,
+          "message": "Authentication failed",
+          "resolution": "Verify API token is valid and not expired",
+          "prevention": "Use environment variables for token management"
+        },
+        {
+          "code": 403,
+          "message": "Permission denied",
+          "resolution": "Check user role and namespace permissions",
+          "prevention": "Verify RBAC policies before operations"
+        },
+        {
+          "code": 404,
+          "message": "Resource not found",
+          "resolution": "Verify resource name and namespace exist",
+          "prevention": "List resources before attempting operations"
+        },
+        {
+          "code": 409,
+          "message": "Resource already exists",
+          "resolution": "Use unique name or delete existing resource",
+          "prevention": "Check existence before creation"
+        },
+        {
+          "code": 429,
+          "message": "Rate limit exceeded",
+          "resolution": "Implement exponential backoff and retry logic",
+          "prevention": "Batch operations and add delays between requests"
+        }
+      ],
+      "security_notes": [
+        "Always use HTTPS for all API communications",
+        "Store API tokens securely, never in source code",
+        "Rotate API tokens regularly following security policies"
+      ],
+      "performance_tips": [
+        "Use pagination for large result sets",
+        "Batch related operations when possible",
+        "Cache read-only responses appropriately"
+      ]
+    }
   },
   "servers": [
     {
@@ -273,6 +323,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": "AI Assistant APIs.",
@@ -480,6 +537,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": "AI Assistant APIs.",
@@ -687,6 +751,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": "AI Assistant APIs.",
@@ -894,6 +965,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": "AI Assistant APIs.",
@@ -1094,6 +1172,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": "BFDP APIs",
@@ -1293,6 +1378,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": "BFDP APIs",
@@ -1492,6 +1584,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": "BFDP Subscription API.",
@@ -1691,6 +1790,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": "BFDP Subscription API.",
@@ -1890,6 +1996,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": "BFDP Subscription API.",
@@ -2087,6 +2200,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": "Global IP Allocator.",
@@ -2277,6 +2397,13 @@
             "latency": "low",
             "resource_usage": "low"
           }
+        },
+        "x-f5xc-discovered-response-time": {
+          "p50_ms": 500,
+          "p95_ms": 1500,
+          "p99_ms": 4000,
+          "sample_count": 0,
+          "source": "estimate"
         }
       },
       "x-displayname": "Global IP Allocator.",
@@ -2304,7 +2431,7 @@
         "properties": {
           "comment": {
             "type": "string",
-            "description": "",
+            "description": "Configuration parameter for comment",
             "title": "Comment",
             "maxLength": 4096,
             "x-displayname": "Comment",
@@ -2331,6 +2458,7 @@
             "x-displayname": "Namespace",
             "x-ves-example": "System",
             "x-f5xc-example": "system",
+            "x-f5xc-description-short": "Namespace of the HTTP Load Balancer for current request.",
             "minLength": 0,
             "maxLength": 6,
             "x-f5xc-required-for": {
@@ -2341,7 +2469,7 @@
             },
             "x-original-maxLength": 1024,
             "x-reconciled-from-discovery": true,
-            "x-reconciled-at": "2026-01-05T14:37:33.143462+00:00"
+            "x-reconciled-at": "2026-01-07T15:27:43.841215+00:00"
           },
           "negative_feedback": {
             "$ref": "#/components/schemas/ai_assistantNegativeFeedbackDetails"
@@ -2436,6 +2564,7 @@
             "x-displayname": "Namespace",
             "x-ves-example": "System",
             "x-f5xc-example": "system",
+            "x-f5xc-description-short": "Namespace of the HTTP Load Balancer for current request.",
             "minLength": 0,
             "maxLength": 6,
             "x-f5xc-required-for": {
@@ -2446,7 +2575,7 @@
             },
             "x-original-maxLength": 1024,
             "x-reconciled-from-discovery": true,
-            "x-reconciled-at": "2026-01-05T14:37:33.143483+00:00"
+            "x-reconciled-at": "2026-01-07T15:27:43.841235+00:00"
           }
         },
         "x-f5xc-minimum-configuration": {
@@ -2505,6 +2634,7 @@
             "x-validation-rules": {
               "ves.io.schema.rules.repeated.unique": "true"
             },
+            "x-f5xc-description-short": "Follow up Queries to be given as suggestion to users.",
             "x-f5xc-required-for": {
               "minimum_config": false,
               "create": false,
@@ -2580,7 +2710,7 @@
         "properties": {
           "remarks": {
             "type": "array",
-            "description": "",
+            "description": "Configuration parameter for remarks",
             "title": "Remarks",
             "items": {
               "$ref": "#/components/schemas/ai_assistantNegativeFeedbackType"
@@ -2630,6 +2760,8 @@
         "default": "OTHER",
         "x-displayname": "",
         "x-ves-proto-enum": "ves.io.schema.ai_assistant.NegativeFeedbackType",
+        "x-f5xc-description-short": "X-displayName \"Negative Feedback Type\" Type of Negative Feedback - OTHER: x-displayName \"Other\" Other - INACCURATE_DATA: x-displayName \"Inaccurate...",
+        "x-f5xc-description-medium": "X-displayName \"Negative Feedback Type\" Type of Negative Feedback - OTHER: x-displayName \"Other\" Other - INACCURATE_DATA: x-displayName \"Inaccurate data\" Inaccurate data - IRRELEVANT_CONTENT: x-displayName \"Irrelevant content\" Irrelevant content - POOR_FORMAT: x-displayName \"Poor format\" Poor...",
         "x-f5xc-minimum-configuration": {
           "description": "Minimum configuration for ai_assistantNegativeFeedbackType",
           "required_fields": [],
@@ -2653,6 +2785,8 @@
         "default": "UNIT_TYPE_NONE",
         "x-displayname": "Unit Type",
         "x-ves-proto-enum": "ves.io.schema.ai_assistant.common.UnitType",
+        "x-f5xc-description-short": "Unit Type defines the unit for each fields. - UNIT_TYPE_NONE: None None type - GB: GB - PERCENT: Percent - BYTE: Byte.",
+        "x-f5xc-description-medium": "Unit Type defines the unit for each fields. - UNIT_TYPE_NONE: None None type - GB: GB - PERCENT: Percent - BYTE: Byte.",
         "x-f5xc-minimum-configuration": {
           "description": "Minimum configuration for ai_assistantcommonUnitType",
           "required_fields": [],
@@ -2676,6 +2810,8 @@
         "default": "ACTION_NONE",
         "x-displayname": "Action",
         "x-ves-proto-enum": "ves.io.schema.ai_assistant.explain_log_record.Action",
+        "x-f5xc-description-short": "Action taken for the request - ACTION_NONE: None No action - ALLOW: Allow The request was allowed to pass - BLOCK: Block The request was blocked ...",
+        "x-f5xc-description-medium": "Action taken for the request - ACTION_NONE: None No action - ALLOW: Allow The request was allowed to pass - BLOCK: Block The request was blocked - REDIRECT: Redirect The request was redirected.",
         "x-f5xc-minimum-configuration": {
           "description": "Minimum configuration for ai_assistantexplain_log_recordAction",
           "required_fields": [],
@@ -2722,6 +2858,8 @@
         "default": "COLOUR_TYPE_NONE",
         "x-displayname": "Colour Type.",
         "x-ves-proto-enum": "ves.io.schema.ai_assistant.common.ColourType",
+        "x-f5xc-description-short": "Colour Type defines the colour of fields to be displayed. - COLOUR_TYPE_NONE: None No colour - DANGER: danger colour type red - INFO: info colour...",
+        "x-f5xc-description-medium": "Colour Type defines the colour of fields to be displayed. - COLOUR_TYPE_NONE: None No colour - DANGER: danger colour type red - INFO: info colour type blue - WARNING: warning colour type orange - AMBER: amber colour type yellow - SUCCESS: success colour type green - MALIBU: malibu colour type blue.",
         "x-f5xc-minimum-configuration": {
           "description": "Minimum configuration for commonColourType",
           "required_fields": [],
@@ -2746,6 +2884,8 @@
         "default": "COLUMN_TYPE_NONE",
         "x-displayname": "Column Type.",
         "x-ves-proto-enum": "ves.io.schema.ai_assistant.common.ColumnType",
+        "x-f5xc-description-short": "Column Type defines the data type for each column. - COLUMN_TYPE_NONE: None - STRING: string - INT: integer - FLOAT: float - BOOL: boolean.",
+        "x-f5xc-description-medium": "Column Type defines the data type for each column. - COLUMN_TYPE_NONE: None - STRING: string - INT: integer - FLOAT: float - BOOL: boolean.",
         "x-f5xc-minimum-configuration": {
           "description": "Minimum configuration for commonColumnType",
           "required_fields": [],
@@ -2777,6 +2917,7 @@
             "x-validation-rules": {
               "ves.io.schema.rules.message.required": "true"
             },
+            "x-f5xc-description-short": "Key will present a placeholder in a text field to insert the link. For",
             "minLength": 0,
             "maxLength": 16,
             "x-f5xc-required-for": {
@@ -2787,7 +2928,7 @@
             },
             "x-original-maxLength": 1024,
             "x-reconciled-from-discovery": true,
-            "x-reconciled-at": "2026-01-05T14:37:33.143510+00:00"
+            "x-reconciled-at": "2026-01-07T15:27:43.841261+00:00"
           },
           "log_filters": {
             "type": "array",
@@ -2821,7 +2962,7 @@
             },
             "x-original-maxLength": 1024,
             "x-reconciled-from-discovery": true,
-            "x-reconciled-at": "2026-01-05T14:37:33.143517+00:00"
+            "x-reconciled-at": "2026-01-07T15:27:43.841268+00:00"
           },
           "object_name": {
             "type": "string",
@@ -2872,12 +3013,13 @@
             },
             "x-original-maxLength": 1024,
             "x-reconciled-from-discovery": true,
-            "x-reconciled-at": "2026-01-05T14:37:33.143525+00:00"
+            "x-reconciled-at": "2026-01-07T15:27:43.841276+00:00"
           },
           "type": {
             "$ref": "#/components/schemas/commonDashboardLinkType"
           }
         },
+        "x-f5xc-description-short": "Dashboard link will present common fields like type, namespace, object, dateFilter, logFilter.",
         "x-f5xc-minimum-configuration": {
           "description": "Minimum configuration for commonDashboardLink",
           "required_fields": [
@@ -2919,6 +3061,8 @@
         "default": "SECURITY_ANALYTICS_EVENTS",
         "x-displayname": "Link Type",
         "x-ves-proto-enum": "ves.io.schema.ai_assistant.common.DashboardLinkType",
+        "x-f5xc-description-short": "Link Type to be presented - SECURITY_ANALYTICS_EVENTS: SECURITY_ANALYTICS_EVENTS Security analytics dashboard...",
+        "x-f5xc-description-medium": "Link Type to be presented - SECURITY_ANALYTICS_EVENTS: SECURITY_ANALYTICS_EVENTS Security analytics dashboard: /web/workspaces/web-app-and-API-protection/../dashboard/security-dashboard/../security_analytics/events - REQUESTS_EVENTS: REQUESTS_EVENTS Requests dashboard...",
         "x-f5xc-minimum-configuration": {
           "description": "Minimum configuration for commonDashboardLinkType",
           "required_fields": [],
@@ -2941,7 +3085,7 @@
           },
           "formats": {
             "type": "array",
-            "description": "",
+            "description": "Data format specification",
             "title": "Format",
             "items": {
               "$ref": "#/components/schemas/commonFormatType"
@@ -2993,6 +3137,8 @@
         "default": "DISPLAY_TYPE_NONE",
         "x-displayname": "DisplayType Type.",
         "x-ves-proto-enum": "ves.io.schema.ai_assistant.common.DisplayType",
+        "x-f5xc-description-short": "Render Type defines the format to which data has to be rendered on UI. - DISPLAY_TYPE_NONE: None None type - ICON: icon Value to be displayed as...",
+        "x-f5xc-description-medium": "Render Type defines the format to which data has to be rendered on UI. - DISPLAY_TYPE_NONE: None None type - ICON: icon Value to be displayed as ICON - PROGRESS_BAR: progress bar - DATE: date - DURATION: duration - PROVIDER_ICON: provider icon.",
         "x-f5xc-minimum-configuration": {
           "description": "Minimum configuration for commonDisplayType",
           "required_fields": [],
@@ -3015,7 +3161,7 @@
           },
           "name": {
             "type": "string",
-            "description": "",
+            "description": "Human-readable name for the resource",
             "title": "Name",
             "x-displayname": "Name",
             "x-ves-example": "Provider",
@@ -3030,11 +3176,11 @@
             },
             "x-original-maxLength": 1024,
             "x-reconciled-from-discovery": true,
-            "x-reconciled-at": "2026-01-05T14:37:33.143540+00:00"
+            "x-reconciled-at": "2026-01-07T15:27:43.841290+00:00"
           },
           "title": {
             "type": "string",
-            "description": "",
+            "description": "Human-readable title for the resource",
             "title": "Title",
             "x-displayname": "Title",
             "x-ves-example": "Site Name",
@@ -3049,7 +3195,7 @@
             },
             "x-original-maxLength": 1024,
             "x-reconciled-from-discovery": true,
-            "x-reconciled-at": "2026-01-05T14:37:33.143545+00:00"
+            "x-reconciled-at": "2026-01-07T15:27:43.841295+00:00"
           },
           "tooltip": {
             "type": "string",
@@ -3097,6 +3243,8 @@
         "default": "IN",
         "x-displayname": "Filter Operator.",
         "x-ves-proto-enum": "ves.io.schema.ai_assistant.common.FilterOperator",
+        "x-f5xc-description-short": "Operator for query filter - IN: Filter Operator Specifies that query result includes filter values - NOT_IN: Filter Operator Specifies that query...",
+        "x-f5xc-description-medium": "Operator for query filter - IN: Filter Operator Specifies that query result includes filter values - NOT_IN: Filter Operator Specifies that query result excludes filter values.",
         "x-f5xc-minimum-configuration": {
           "description": "Minimum configuration for commonFilterOperator",
           "required_fields": [],
@@ -3121,6 +3269,8 @@
         "default": "FORMAT_TYPE_NONE",
         "x-displayname": "Format Type.",
         "x-ves-proto-enum": "ves.io.schema.ai_assistant.common.FormatType",
+        "x-f5xc-description-short": "Format Type defines the format type for each fields. - FORMAT_TYPE_NONE: None No format - INLINE: Inline Key value to be displayed in inline...",
+        "x-f5xc-description-medium": "Format Type defines the format type for each fields. - FORMAT_TYPE_NONE: None No format - INLINE: Inline Key value to be displayed in inline format - BOLD: Bold Value to be displayed in bold format - REVERSE_KEY_VALUE_ORDER: ReverseKeyValueOrder Key value to be displayed in Reverse Key Value...",
         "x-f5xc-minimum-configuration": {
           "description": "Minimum configuration for commonFormatType",
           "required_fields": [],
@@ -3152,6 +3302,7 @@
             "x-validation-rules": {
               "ves.io.schema.rules.message.required": "true"
             },
+            "x-f5xc-description-short": "Key will present a placeholder in a text field to insert the link. For",
             "minLength": 0,
             "maxLength": 16,
             "x-f5xc-required-for": {
@@ -3162,7 +3313,7 @@
             },
             "x-original-maxLength": 1024,
             "x-reconciled-from-discovery": true,
-            "x-reconciled-at": "2026-01-05T14:37:33.143553+00:00"
+            "x-reconciled-at": "2026-01-07T15:27:43.841304+00:00"
           },
           "title": {
             "type": "string",
@@ -3181,7 +3332,7 @@
             },
             "x-original-maxLength": 1024,
             "x-reconciled-from-discovery": true,
-            "x-reconciled-at": "2026-01-05T14:37:33.143557+00:00"
+            "x-reconciled-at": "2026-01-07T15:27:43.841309+00:00"
           },
           "url": {
             "type": "string",
@@ -3201,6 +3352,7 @@
             }
           }
         },
+        "x-f5xc-description-short": "Generic link can have external link with full URL.",
         "x-f5xc-minimum-configuration": {
           "description": "Minimum configuration for commonGenericLink",
           "required_fields": [
@@ -3227,7 +3379,7 @@
           },
           "is_error": {
             "type": "boolean",
-            "description": "",
+            "description": "Configuration parameter for is error",
             "title": "Is_error",
             "format": "boolean",
             "x-displayname": "Is_error",
@@ -3242,7 +3394,7 @@
           },
           "summary": {
             "type": "string",
-            "description": "",
+            "description": "Configuration parameter for summary",
             "title": "Summary",
             "x-displayname": "Summary",
             "x-ves-example": "Query not supported.",
@@ -3323,7 +3475,7 @@
             },
             "x-original-maxLength": 1024,
             "x-reconciled-from-discovery": true,
-            "x-reconciled-at": "2026-01-05T14:37:33.143573+00:00"
+            "x-reconciled-at": "2026-01-07T15:27:43.841325+00:00"
           },
           "op": {
             "$ref": "#/components/schemas/commonFilterOperator"
@@ -3393,7 +3545,7 @@
             },
             "x-original-maxLength": 1024,
             "x-reconciled-from-discovery": true,
-            "x-reconciled-at": "2026-01-05T14:37:33.143582+00:00"
+            "x-reconciled-at": "2026-01-07T15:27:43.841335+00:00"
           },
           "type": {
             "$ref": "#/components/schemas/commonDashboardLinkType"
@@ -3517,6 +3669,7 @@
             }
           }
         },
+        "x-f5xc-description-short": "Overlay data for creating support ticket.",
         "x-f5xc-minimum-configuration": {
           "description": "Minimum configuration for commonOverlayData",
           "required_fields": [
@@ -3549,6 +3702,8 @@
         "default": "STATUS_STYLE_UNKNOWN",
         "x-displayname": "Status Style.",
         "x-ves-proto-enum": "ves.io.schema.ai_assistant.common.StatusStyle",
+        "x-f5xc-description-short": "Status Style defines the colour of status to be displayed. - STATUS_STYLE_UNKNOWN: Unknown No colour - STATUS_STYLE_SUCCESS: success colour type...",
+        "x-f5xc-description-medium": "Status Style defines the colour of status to be displayed. - STATUS_STYLE_UNKNOWN: Unknown No colour - STATUS_STYLE_SUCCESS: success colour type green - STATUS_STYLE_DANGER: danger colour type red - STATUS_STYLE_WARNING: warning colour type yellow - STATUS_STYLE_INACTIVE: inactive colour type...",
         "x-f5xc-minimum-configuration": {
           "description": "Minimum configuration for commonStatusStyle",
           "required_fields": [],
@@ -3575,6 +3730,8 @@
         "default": "WIDGET_TYPE_NONE",
         "x-displayname": "Widget Type.",
         "x-ves-proto-enum": "ves.io.schema.ai_assistant.common.WidgetType",
+        "x-f5xc-description-short": "Widget Type defines the data type for widget. - WIDGET_TYPE_NONE: None None type - TWO_VALUE: two_value Two Value type widget ...",
+        "x-f5xc-description-medium": "Widget Type defines the data type for widget. - WIDGET_TYPE_NONE: None None type - TWO_VALUE: two_value Two Value type widget - DISTRIBUTION_CHART: distribution_chart Distribution Chart type widget - TABLE: table Table type widget - LIST: list List type widget - GRID: grid Grid type widget ...",
         "x-f5xc-minimum-configuration": {
           "description": "Minimum configuration for commonWidgetType",
           "required_fields": [],
@@ -3598,6 +3755,8 @@
         "default": "ACCURACY_NONE",
         "x-displayname": "Accuracy",
         "x-ves-proto-enum": "ves.io.schema.ai_assistant.explain_log_record.Accuracy",
+        "x-f5xc-description-short": "Specifies accuracy of the signature - ACCURACY_NONE: None No accuracy - ACCURACY_LOW: Low Specifies low accuracy of the signature ...",
+        "x-f5xc-description-medium": "Specifies accuracy of the signature - ACCURACY_NONE: None No accuracy - ACCURACY_LOW: Low Specifies low accuracy of the signature - ACCURACY_MEDIUM: Medium Specifies medium accuracy of the signature - ACCURACY_HIGH: High Specifies high accuracy of the signature.",
         "x-f5xc-minimum-configuration": {
           "description": "Minimum configuration for explain_log_recordAccuracy",
           "required_fields": [],
@@ -3648,7 +3807,7 @@
             },
             "x-original-maxLength": 1024,
             "x-reconciled-from-discovery": true,
-            "x-reconciled-at": "2026-01-05T14:37:33.143600+00:00"
+            "x-reconciled-at": "2026-01-07T15:27:43.841352+00:00"
           },
           "type": {
             "type": "string",
@@ -3784,6 +3943,8 @@
         "default": "ENFORCEMENT_NONE",
         "x-displayname": "Enforcement Mode.",
         "x-ves-proto-enum": "ves.io.schema.ai_assistant.explain_log_record.EnforcementMode",
+        "x-f5xc-description-short": "Enforcement mode of WAF - ENFORCEMENT_NONE: None No enforcement - MONITORING: Monitoring Monitoring mode of WAF - BLOCKING: Blocking Blocking mode...",
+        "x-f5xc-description-medium": "Enforcement mode of WAF - ENFORCEMENT_NONE: None No enforcement - MONITORING: Monitoring Monitoring mode of WAF - BLOCKING: Blocking Blocking mode of WAF.",
         "x-f5xc-minimum-configuration": {
           "description": "Minimum configuration for explain_log_recordEnforcementMode",
           "required_fields": [],
@@ -3893,6 +4054,8 @@
         "default": "IP_REPUTATION_NONE",
         "x-displayname": "IP Reputation.",
         "x-ves-proto-enum": "ves.io.schema.ai_assistant.explain_log_record.IPReputation",
+        "x-f5xc-description-short": "Specifies IP risk/trustworthiness - IP_REPUTATION_NONE: None No IP reputation - IP_REPUTATION_LOW: Low Specifies low IP risk/trustworthiness ...",
+        "x-f5xc-description-medium": "Specifies IP risk/trustworthiness - IP_REPUTATION_NONE: None No IP reputation - IP_REPUTATION_LOW: Low Specifies low IP risk/trustworthiness - IP_REPUTATION_HIGH: High Specifies high IP risk/trustworthiness.",
         "x-f5xc-minimum-configuration": {
           "description": "Minimum configuration for explain_log_recordIPReputation",
           "required_fields": [],
@@ -3928,7 +4091,7 @@
             "x-original-maxLength": 1024,
             "format": "hostname",
             "x-reconciled-from-discovery": true,
-            "x-reconciled-at": "2026-01-05T14:37:33.143626+00:00"
+            "x-reconciled-at": "2026-01-07T15:27:43.841377+00:00"
           },
           "rsp_code": {
             "type": "integer",
@@ -4088,7 +4251,7 @@
             },
             "x-original-maxLength": 1024,
             "x-reconciled-from-discovery": true,
-            "x-reconciled-at": "2026-01-05T14:37:33.143644+00:00"
+            "x-reconciled-at": "2026-01-07T15:27:43.841395+00:00"
           },
           "state": {
             "type": "string",
@@ -4097,6 +4260,7 @@
             "x-displayname": "State",
             "x-ves-example": "Enabled",
             "x-f5xc-example": "Enabled",
+            "x-f5xc-description-short": "State of the signature, can be enabled, suppressed and etc.",
             "minLength": 0,
             "maxLength": 1024,
             "x-f5xc-required-for": {
@@ -4283,7 +4447,7 @@
             },
             "x-original-maxLength": 1024,
             "x-reconciled-from-discovery": true,
-            "x-reconciled-at": "2026-01-05T14:37:33.143664+00:00"
+            "x-reconciled-at": "2026-01-07T15:27:43.841414+00:00"
           }
         },
         "x-f5xc-minimum-configuration": {
@@ -4372,7 +4536,7 @@
             },
             "x-original-maxLength": 1024,
             "x-reconciled-from-discovery": true,
-            "x-reconciled-at": "2026-01-05T14:37:33.143673+00:00"
+            "x-reconciled-at": "2026-01-07T15:27:43.841423+00:00"
           },
           "state": {
             "type": "string",
@@ -4381,6 +4545,7 @@
             "x-displayname": "State",
             "x-ves-example": "Enabled",
             "x-f5xc-example": "Enabled",
+            "x-f5xc-description-short": "State of the violation, can be enabled, suppressed and etc.",
             "minLength": 0,
             "maxLength": 1024,
             "x-f5xc-required-for": {
@@ -4447,6 +4612,7 @@
               "$ref": "#/components/schemas/explain_log_recordSignature"
             },
             "x-displayname": "Signatures.",
+            "x-f5xc-description-short": "The signatures that were detected in the request.",
             "x-f5xc-required-for": {
               "minimum_config": false,
               "create": false,
@@ -4462,6 +4628,8 @@
               "$ref": "#/components/schemas/explain_log_recordThreatCampaign"
             },
             "x-displayname": "Threat Campaign.",
+            "x-f5xc-example": "{\"key\": \"value\"}",
+            "x-f5xc-description-short": "Threat campaigns that were detected in the request.",
             "x-f5xc-required-for": {
               "minimum_config": false,
               "create": false,
@@ -4477,6 +4645,7 @@
               "$ref": "#/components/schemas/explain_log_recordViolation"
             },
             "x-displayname": "Violations.",
+            "x-f5xc-description-short": "The violations that were detected in the request.",
             "x-f5xc-required-for": {
               "minimum_config": false,
               "create": false,
@@ -4534,6 +4703,7 @@
               "$ref": "#/components/schemas/commonLink"
             },
             "x-displayname": "Links",
+            "x-f5xc-description-short": "Links that will be presented to the user.",
             "x-f5xc-required-for": {
               "minimum_config": false,
               "create": false,
@@ -4615,11 +4785,11 @@
             "maxLength": 26,
             "minLength": 15,
             "x-reconciled-from-discovery": true,
-            "x-reconciled-at": "2026-01-05T14:37:33.143697+00:00"
+            "x-reconciled-at": "2026-01-07T15:27:43.841447+00:00"
           },
           "title": {
             "type": "string",
-            "description": "",
+            "description": "Human-readable title for the resource",
             "title": "Title",
             "x-displayname": "Title",
             "x-ves-example": "Cloud Sites.",
@@ -4634,7 +4804,7 @@
             },
             "x-original-maxLength": 1024,
             "x-reconciled-from-discovery": true,
-            "x-reconciled-at": "2026-01-05T14:37:33.143702+00:00"
+            "x-reconciled-at": "2026-01-07T15:27:43.841452+00:00"
           }
         },
         "x-f5xc-minimum-configuration": {
@@ -4673,6 +4843,7 @@
               "ves.io.schema.rules.repeated.unique": "true",
               "ves.io.schema.rules.string.max_len": "6"
             },
+            "x-f5xc-description-short": "External doc links, that will be presented to the user.",
             "x-f5xc-required-for": {
               "minimum_config": false,
               "create": false,
@@ -4688,6 +4859,7 @@
               "$ref": "#/components/schemas/listList"
             },
             "x-displayname": "List View",
+            "x-f5xc-example": "[\"item1\", \"item2\", \"item3\"]",
             "x-f5xc-required-for": {
               "minimum_config": false,
               "create": false,
@@ -4697,7 +4869,7 @@
           },
           "summary": {
             "type": "string",
-            "description": "",
+            "description": "Configuration parameter for summary",
             "title": "Summary",
             "x-displayname": "Summary",
             "x-ves-example": "This is summary of List response.",
@@ -4747,6 +4919,8 @@
         "default": "SPAM_SOURCES",
         "x-displayname": "IP Threat Category.",
         "x-ves-proto-enum": "ves.io.schema.policy.IPThreatCategory",
+        "x-f5xc-description-short": "The IP threat categories to use when a policy based IP threat category is configured. - SPAM_SOURCES: SPAM_SOURCES - WINDOWS_EXPLOITS...",
+        "x-f5xc-description-medium": "The IP threat categories to use when a policy based IP threat category is configured. - SPAM_SOURCES: SPAM_SOURCES - WINDOWS_EXPLOITS: WINDOWS_EXPLOITS - WEB_ATTACKS: WEB_ATTACKS - BOTNETS: BOTNETS - SCANNERS: SCANNERS - REPUTATION: REPUTATION - PHISHING: PHISHING - PROXY: PROXY ...",
         "x-f5xc-minimum-configuration": {
           "description": "Minimum configuration for policyIPThreatCategory",
           "required_fields": [],
@@ -4764,6 +4938,8 @@
           "type_url": {
             "type": "string",
             "description": "A URL/resource name that uniquely identifies the type of the serialized\nprotocol buffer message. This string must contain at least\none \"/\" character. The last segment of the URL's path must represent\nthe fully qualified name of the type (as in\n`path/google.protobuf.duration`). The name should be in a canonical form\n(e.g., leading \".\" is not accepted).\n\nIn practice, teams usually precompile into the binary all types that they\nexpect it to use in the context of Any. However, for URLs which use the\nscheme `HTTP`, `HTTPS`, or no scheme, one can optionally set up a type\nserver that maps type URLs to message definitions as follows:\n\n* If no scheme is provided, `HTTPS` is assumed.\n* An HTTP GET on the URL must yield a [google.protobuf.type][]\nvalue in binary format, or produce an error.\n* Applications are allowed to cache lookup results based on the\nURL, or have them precompiled into a binary to avoid any\nlookup. Therefore, binary compatibility needs to be preserved\non changes to types. (Use versioned type names to manage\nbreaking changes.)\n\nNote: this functionality is not currently available in the official\nprotobuf release, and it is not used for type URLs beginning with\ntype.googleapis.com.\n\nSchemes other than `HTTP`, `HTTPS` (or the empty scheme) might be\nused with implementation specific semantics.",
+            "x-f5xc-description-short": "URL identifying the protocol buffer message type.",
+            "x-f5xc-description-medium": "URL/resource name that uniquely identifies the type of the serialized protocol buffer message. This string must contain at least one \"/\" character. The last segment of the URL's path must represent the fully qualified name of the type (as in ).",
             "minLength": 0,
             "maxLength": 1024,
             "x-f5xc-required-for": {
@@ -4787,9 +4963,11 @@
             },
             "x-original-maxLength": 1024,
             "x-reconciled-from-discovery": true,
-            "x-reconciled-at": "2026-01-05T14:37:33.143714+00:00"
+            "x-reconciled-at": "2026-01-07T15:27:43.841464+00:00"
           }
         },
+        "x-f5xc-description-short": "Contains an arbitrary serialized protocol buffer message along with a URL that describes the type of the serialized message.",
+        "x-f5xc-description-medium": "Contains an arbitrary serialized protocol buffer message along with a URL that describes the type of the serialized message. Protobuf library provides support to pack/unpack Any values in the form of utility functions or additional generated methods of the Any type. Example 1: Pack and unpack a...",
         "x-f5xc-minimum-configuration": {
           "description": "Minimum configuration for protobufAny",
           "required_fields": [
@@ -4809,6 +4987,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": [],
@@ -4837,6 +5016,8 @@
         "default": "EOK",
         "x-displayname": "Error Code.",
         "x-ves-proto-enum": "ves.io.schema.ErrorCode",
+        "x-f5xc-description-short": "Union of all possible error-codes from system - EOK: No error - EPERMS: Permissions error - EBADINPUT: Input is not correct - ENOTFOUND: Not found...",
+        "x-f5xc-description-medium": "Union of all possible error-codes from system - EOK: No error - EPERMS: Permissions error - EBADINPUT: Input is not correct - ENOTFOUND: Not found - EEXISTS: Already exists - EUNKNOWN: Unknown/catchall error - ESERIALIZE: Error in serializing/de-serializing - EINTERNAL: Server error - EPARTIAL...",
         "x-f5xc-minimum-configuration": {
           "description": "Minimum configuration for schemaErrorCode",
           "required_fields": [],
@@ -4877,6 +5058,7 @@
             }
           }
         },
+        "x-f5xc-description-short": "Information about a error in API operation.",
         "x-f5xc-minimum-configuration": {
           "description": "Minimum configuration for schemaErrorType",
           "required_fields": [
@@ -4914,6 +5096,7 @@
               "ves.io.schema.rules.repeated.unique": "true",
               "ves.io.schema.rules.string.max_len": "6"
             },
+            "x-f5xc-description-short": "External doc links, that will be presented to the user.",
             "x-f5xc-required-for": {
               "minimum_config": false,
               "create": false,
@@ -4937,6 +5120,7 @@
               "ves.io.schema.rules.repeated.unique": "true",
               "ves.io.schema.rules.string.max_len": "6"
             },
+            "x-f5xc-description-short": "Internal Link like dashboard links, that will be presented to the user.",
             "x-f5xc-required-for": {
               "minimum_config": false,
               "create": false,
@@ -4949,7 +5133,7 @@
           },
           "summary": {
             "type": "string",
-            "description": "",
+            "description": "Configuration parameter for summary",
             "title": "Summary",
             "x-displayname": "Summary",
             "x-ves-example": "This site analysis response provides status of sites.",
@@ -4995,7 +5179,7 @@
           },
           "value": {
             "type": "string",
-            "description": "",
+            "description": "Configuration parameter for value",
             "title": "Value",
             "x-displayname": "Value",
             "x-ves-example": "Site1",
@@ -5010,7 +5194,7 @@
             },
             "x-original-maxLength": 1024,
             "x-reconciled-from-discovery": true,
-            "x-reconciled-at": "2026-01-05T14:37:33.143735+00:00"
+            "x-reconciled-at": "2026-01-07T15:27:43.841483+00:00"
           }
         },
         "x-f5xc-minimum-configuration": {
@@ -5036,7 +5220,7 @@
         "properties": {
           "cells": {
             "type": "array",
-            "description": "",
+            "description": "Configuration parameter for cells",
             "title": "Values",
             "items": {
               "$ref": "#/components/schemas/widgetCell"
@@ -5052,6 +5236,7 @@
             }
           }
         },
+        "x-f5xc-description-short": "Contains the value for each rows of table.",
         "x-f5xc-minimum-configuration": {
           "description": "Minimum configuration for widgetRow",
           "required_fields": [
@@ -5082,6 +5267,7 @@
             "x-validation-rules": {
               "ves.io.schema.rules.repeated.unique": "true"
             },
+            "x-f5xc-description-short": "Lists the name of the field & corresponding properties.",
             "x-f5xc-required-for": {
               "minimum_config": false,
               "create": false,
@@ -5139,6 +5325,7 @@
               "$ref": "#/components/schemas/commonLink"
             },
             "x-displayname": "Links",
+            "x-f5xc-description-short": "Links that will be presented to the user.",
             "x-f5xc-required-for": {
               "minimum_config": false,
               "create": false,
@@ -5154,6 +5341,8 @@
               "$ref": "#/components/schemas/widgetWidgetView"
             },
             "x-displayname": "Widget View.",
+            "x-f5xc-example": "[\"item1\", \"item2\", \"item3\"]",
+            "x-f5xc-description-short": "Response will have different types of widgets.",
             "x-f5xc-required-for": {
               "minimum_config": false,
               "create": false,
@@ -5163,7 +5352,7 @@
           },
           "summary": {
             "type": "string",
-            "description": "",
+            "description": "Configuration parameter for summary",
             "title": "Summary",
             "x-displayname": "Summary",
             "x-ves-example": "This is summary of widget response.",
@@ -5218,6 +5407,7 @@
         "title": "EnableFeatureRequest.",
         "x-displayname": "EnableFeature Request.",
         "x-ves-proto-message": "ves.io.schema.ai_data.bfdp.EnableFeatureRequest",
+        "x-f5xc-description-short": "Any payload to be passed on the GET Provision API.",
         "x-f5xc-minimum-configuration": {
           "description": "Minimum configuration for bfdpEnableFeatureRequest",
           "required_fields": [],
@@ -5234,6 +5424,7 @@
         "title": "EnableFeatureResponse.",
         "x-displayname": "EnableFeature Response.",
         "x-ves-proto-message": "ves.io.schema.ai_data.bfdp.EnableFeatureResponse",
+        "x-f5xc-description-short": "Any payload to be passed on the GET Provision API.",
         "x-f5xc-minimum-configuration": {
           "description": "Minimum configuration for bfdpEnableFeatureResponse",
           "required_fields": [],
@@ -5258,6 +5449,7 @@
             "x-displayname": "Product_name.",
             "x-ves-example": "Product_name.",
             "x-f5xc-example": "product_name",
+            "x-f5xc-description-short": "Product_name is a pipeline name for which token to be generated.",
             "minLength": 0,
             "maxLength": 1024,
             "x-f5xc-required-for": {
@@ -5268,6 +5460,7 @@
             }
           }
         },
+        "x-f5xc-description-short": "API to refresh token for a given pipeline.",
         "x-f5xc-minimum-configuration": {
           "description": "Minimum configuration for bfdpRefreshTokenRequest",
           "required_fields": [
@@ -5294,6 +5487,7 @@
             "x-displayname": "Result",
             "x-ves-example": "Result",
             "x-f5xc-example": "result",
+            "x-f5xc-description-short": "Result will be in JSON format having token in it.",
             "minLength": 0,
             "maxLength": 1024,
             "x-f5xc-required-for": {
@@ -5366,6 +5560,7 @@
             "x-displayname": "Configured_tenant_id.",
             "x-ves-example": "Configured Tenant.",
             "x-f5xc-example": "Configured Tenant",
+            "x-f5xc-description-short": "F5 product's pipeline configured tenant .",
             "minLength": 0,
             "maxLength": 1024,
             "x-f5xc-required-for": {
@@ -5383,6 +5578,7 @@
             "x-displayname": "Pipleine_id.",
             "x-ves-example": "Pipleine_id.",
             "x-f5xc-example": "pipleine_id",
+            "x-f5xc-description-short": "F5 product's pipeline ID for which this tenant is configured.",
             "minLength": 0,
             "maxLength": 1024,
             "x-f5xc-required-for": {
@@ -5400,6 +5596,7 @@
             "x-displayname": "Pipeline_name.",
             "x-ves-example": "Pipeline_name.",
             "x-f5xc-example": "pipeline_name",
+            "x-f5xc-description-short": "F5 product's pipeline name for which this tenant is configured.",
             "minLength": 0,
             "maxLength": 1024,
             "x-f5xc-required-for": {
@@ -5416,6 +5613,7 @@
             "x-displayname": "Token",
             "x-ves-example": "Token name.",
             "x-f5xc-example": "token name",
+            "x-f5xc-description-short": "F5 product's pipeline token to ingest data .",
             "minLength": 0,
             "maxLength": 1024,
             "x-f5xc-required-for": {
@@ -5579,6 +5777,8 @@
             "x-displayname": "Context",
             "x-ves-example": "App-VIP-pool-1.",
             "x-f5xc-example": "app-vip-pool-1",
+            "x-f5xc-description-short": "Global IP allocator context from which IP allocation will happen Optional: If not specified, gia will try to allocate IP from default IP range.",
+            "x-f5xc-description-medium": "Global IP allocator context from which IP allocation will happen Optional: If not specified, gia will try to allocate IP from default IP range.",
             "minLength": 0,
             "maxLength": 1024,
             "x-f5xc-required-for": {
@@ -5595,6 +5795,7 @@
             "format": "boolean",
             "x-displayname": "Use IPv6 Range.",
             "x-f5xc-example": "false",
+            "x-f5xc-description-short": "Optional: If not specified, v4 range for this tenant will be used.",
             "x-f5xc-required-for": {
               "minimum_config": false,
               "create": false,
@@ -5641,11 +5842,12 @@
           },
           "ip": {
             "type": "string",
-            "description": "",
+            "description": "IPv4 address in dotted decimal notation (e.g., 192.0.2.1)",
             "title": "IP address.",
             "x-displayname": "IP Address allocated.",
             "x-ves-example": "192.168.0.1.",
             "x-f5xc-example": "192.168.0.1",
+            "x-f5xc-description-short": "IPv4 address in dotted decimal notation (e.g., 192.0.2.1).",
             "minLength": 0,
             "maxLength": 1024,
             "x-f5xc-required-for": {
@@ -5683,6 +5885,8 @@
             "x-displayname": "Context",
             "x-ves-example": "App-VIP-pool-1.",
             "x-f5xc-example": "app-vip-pool-1",
+            "x-f5xc-description-short": "Global IP allocator context from which IP deallocation will happen Optional: If not specified, gia will try to deallocate given IP from default IP...",
+            "x-f5xc-description-medium": "Global IP allocator context from which IP deallocation will happen Optional: If not specified, gia will try to deallocate given IP from default IP range.",
             "minLength": 0,
             "maxLength": 1024,
             "x-f5xc-required-for": {
@@ -5715,6 +5919,7 @@
             }
           }
         },
+        "x-f5xc-description-short": "Input message of the 'DeAllocateIP' RPC.",
         "x-f5xc-minimum-configuration": {
           "description": "Minimum configuration for giaDeallocateIPRequest",
           "required_fields": [
@@ -5752,6 +5957,7 @@
             }
           }
         },
+        "x-f5xc-description-short": "Output message of the 'DeAllocateIP' RPC.",
         "x-f5xc-minimum-configuration": {
           "description": "Minimum configuration for giaDeallocateIPResponse",
           "required_fields": [