API activity, discovery, and security analytics
Endpoint inventory, calls, activity rankings, sensitive data, schemas, and vulnerabilities. Required resource or feature: API discovery or imported API definitions on a virtual host.
Metric families and dimensions
Section titled “Metric families and dimensions”Select the virtual host and API endpoint identity required by each contract. Analytics can group or filter activity by endpoint, method, response status, time, and security classification where supported. Inventory, schema discovery, and existing security reports serve separate purposes. See API activity for measured queries.
Use Query concepts for shared request guidance and table conventions.
Statistics and analytics queries
Section titled “Statistics and analytics queries”| Method and exact path | Information returned | Scope and principal filters | Specification reference |
|---|---|---|---|
POST /api/ml/data/namespaces/system/api_endpoints/all_ns_stats | Api Endpoints Stats for All Namespaces; returns agg_apiep_stats, discovered, inventory, per_vhost_type_apiep_stats, pii_detected | Tenant; system only; include_per_vhost_stats | Operation · Request schema · Response schema |
POST /api/ml/data/namespaces/{namespace}/api_endpoints/stats | Api Endpoints Stats for Namespace; returns agg_apiep_stats, discovered, inventory, per_vhost_type_apiep_stats, pii_detected | Selected namespace; include_per_vhost_stats, vhosts_filter, vhosts_types_filter | Operation · Request schema · Response schema |
POST /api/ml/data/namespaces/{namespace}/app_api_groups/stats | API group endpoint changes and update counts | Selected namespace; No additional selector | Operation · Request schema · Response schema |
GET /api/ml/data/namespaces/{namespace}/app_settings/{name}/suspicious_users | Suspicious user status and top users | Selected namespace; name, query, start_time, end_time, topn | Operation · Request schema · Response schema |
GET /api/ml/data/namespaces/{namespace}/app_types/{app_type_name}/api_endpoint/pdf | Probability density of request/response sizes and latency | Selected namespace; endpoint collapsed_url and method; app_type_name, collapsed_url, method | Operation · Request schema · Response schema |
POST /api/ml/data/namespaces/{namespace}/app_types/{app_type_name}/services/{service_name}/api_endpoint/pdf | Probability density of request/response sizes and latency | Selected namespace; endpoint collapsed_url and method; app_type_name, service_name, collapsed_url, method | Operation · Request schema · Response schema |
GET /api/ml/data/namespaces/{namespace}/virtual_hosts/{name}/api_endpoint/pdf | Probability density of request/response sizes and latency | Selected namespace; endpoint collapsed_url and method; name, collapsed_url, method | Operation · Request schema · Response schema |
GET /api/ml/data/namespaces/{namespace}/virtual_hosts/{name}/api_endpoints/stats | Api Endpoints Stats for Virtual Host; returns discovered, inventory, pii_detected, shadow, total_endpoints | Selected namespace; name | Operation · Request schema · Response schema |
POST /api/ml/data/namespaces/{namespace}/virtual_hosts/{name}/api_endpoints/summary/calls_by_response_code | Total API Calls for Virtual Host; returns request_count_per_rsp_code, total_calls | Selected namespace; name, apiep_summary_filter | Operation · Request schema · Response schema |
POST /api/ml/data/namespaces/{namespace}/virtual_hosts/{name}/api_endpoints/summary/top_active | Top APIs Endpoints for Virtual Host; returns top_apieps | Selected namespace; name, apiep_summary_filter, top_by_metric, topk | Operation · Request schema · Response schema |
POST /api/ml/data/namespaces/{namespace}/virtual_hosts/{name}/api_endpoints/summary/top_sensitive_data | Sensitive Data Summary for Virtual Host; returns top_sensitive_data | Selected namespace; name, apiep_category, domains, topk | Operation · Request schema · Response schema |
POST /api/ml/data/namespaces/{namespace}/virtual_hosts/{name}/vulnerabilities | Vulnerabilities for Virtual Host; returns vulnerabilities | Selected namespace; name, api_endpoint, domains | Operation · Request schema · Response schema |
Related discovery and status
Section titled “Related discovery and status”| Method and exact path | Information returned | Scope and principal filters | Specification reference |
|---|---|---|---|
POST /api/ml/data/namespaces/{namespace}/app_api_groups/evaluate | Evaluate API Group; returns api_group, apieps_timestamp, matching_api_endpoints | Selected namespace; api_group | Operation · Request schema · Response schema |
POST /api/ml/data/namespaces/{namespace}/app_types/{app_type_name}/api_endpoint/learnt_schema | Learnt Schema per API endpoint; returns api_specs, discovered_schema, inventory_openapi_spec, pdf_info, sensitive_data | Selected namespace; app_type_name, api_endpoint_info_request, collapsed_url, method | Operation · Request schema · Response schema |
GET /api/ml/data/namespaces/{namespace}/app_types/{app_type_name}/api_endpoints | API endpoints; returns apiep_list | Selected namespace; app_type_name, api_endpoint_info_request | Operation · Request schema · Response schema |
GET /api/ml/data/namespaces/{namespace}/app_types/{app_type_name}/api_endpoints/swagger_spec | Swagger Spec for App Type; returns content_type, data, extensions | Selected namespace; app_type_name | Operation · Request schema · Response schema |
POST /api/ml/data/namespaces/{namespace}/app_types/{app_type_name}/services/{service_name}/api_endpoints | Service API Endpoints; returns apiep_list | Selected namespace; app_type_name, service_name, api_endpoint_info_request | Operation · Request schema · Response schema |
POST /api/ml/data/namespaces/{namespace}/http_loadbalancers/{name}/api_endpoints | API Endpoints; returns api_endpoints, apieps_timestamp; source marks deprecated | Selected namespace; name | Operation · Request schema · Response schema; corrected source |
GET /api/ml/data/namespaces/{namespace}/http_loadbalancers/{name}/api_endpoints/swagger_spec | Swagger Spec for Http Load Balancer; returns content_type, data, extensions | Selected namespace; name | Operation · Request schema · Response schema |
POST /api/ml/data/namespaces/{namespace}/http_loadbalancers/{name}/api_inventory/api_endpoints/get_schema_updates | API Endpoints Schema Updates; returns api_endpoints_current_schemas, api_endpoints_updated_schemas; source marks deprecated | Selected namespace; name, api_endpoints_filter, query_type | Operation · Request schema · Response schema; corrected source |
POST /api/ml/data/namespaces/{namespace}/virtual_hosts/{name}/api_endpoint | API Endpoint; returns apiep | Selected namespace; name, api_endpoint_info_request, collapsed_url, domains, method | Operation · Request schema · Response schema |
GET /api/ml/data/namespaces/{namespace}/virtual_hosts/{name}/api_endpoint/learnt_schema | Get Learnt Schema per API endpoint; returns api_specs, authentication, discovered_schema, inventory_openapi_spec, pdf_info | Selected namespace; name, collapsed_url, method, domains, api_endpoint_info_request | Operation · Request schema · Response schema |
GET /api/ml/data/namespaces/{namespace}/virtual_hosts/{name}/api_endpoint/sources_openapi_schema | relevant source OpenAPI schema per API endpoint; returns api_specs | Selected namespace; name, id, discovery_source_types | Operation · Request schema · Response schema |
GET /api/ml/data/namespaces/{namespace}/virtual_hosts/{name}/api_endpoints | API Endpoints; returns apiep_list, last_update | Selected namespace; name, api_endpoint_info_request, domains, start_time, end_time, apiep_category | Operation · Request schema · Response schema |
GET /api/ml/data/namespaces/{namespace}/virtual_hosts/{name}/api_endpoints/swagger_spec | Swagger Spec for App Type; returns content_type, data, extensions | Selected namespace; name, domains | Operation · Request schema · Response schema |
POST /api/ml/data/namespaces/{namespace}/virtual_hosts/{name}/api_inventory/api_endpoints/get_schema_updates | API Endpoints Schema Updates; returns api_endpoints_current_schemas, api_endpoints_updated_schemas | Selected namespace; name, api_endpoints_filter, query_type | Operation · Request schema · Response schema |