getAiBomTopUsedItems

Get most used AI BOM entities by usage events, highest first.

Examples

GraphQL

query GetAiBomTopUsedItems($input: AiBomTopUsedInput) {
  getAiBomTopUsedItems(input: $input) {
    name
    entityType
    identifier
    count
  }
}

Variables

This is an example input showing all available input fields. Only fields marked as required in the schema are mandatory.

{
  "input": {
    "dateRange": {
      "from": 1749000000000,
      "to": 1749900000000
    },
    "entityType": "McpServer",
    "limit": 100,
    "offset": 0
  }
}

cURL

curl -X POST \
https://api.cloud.ox.security/api/apollo-gateway \
-H 'Content-Type: application/json' \
-H 'Authorization: YOUR_API_TOKEN' \
-d '{
 "query": "query GetAiBomTopUsedItems($input: AiBomTopUsedInput) { getAiBomTopUsedItems(input: $input) { name entityType identifier count } }",
 "variables": {
    "input": {
      "dateRange": {
        "from": 1749000000000,
        "to": 1749900000000
      },
      "entityType": "McpServer",
      "limit": 100,
      "offset": 0
    }
  }
}'

Node.js

const query = 'query GetAiBomTopUsedItems($input: AiBomTopUsedInput) { getAiBomTopUsedItems(input: $input) { name entityType identifier count } }';

fetch("https://api.cloud.ox.security/api/apollo-gateway", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "YOUR_API_TOKEN"
  },
  body: JSON.stringify({
    query: query,
    // This is an example input showing all available input fields. Only fields marked as required in the schema are mandatory.
    variables: {
      input: {
        dateRange: {
          from: 1749000000000,
          to: 1749900000000
        },
        entityType: "McpServer",
        limit: 100,
        offset: 0
      }
    }
  })
})
.then(response => response.json())
.then(result => console.log(JSON.stringify(result, null, 2)))
.catch(error => console.error('Error:', error));

Python

import requests

query = 'query GetAiBomTopUsedItems($input: AiBomTopUsedInput) { getAiBomTopUsedItems(input: $input) { name entityType identifier count } }'

response = requests.post(
  "https://api.cloud.ox.security/api/apollo-gateway",
  headers={
    "Content-Type": "application/json",
    "Authorization": "YOUR_API_TOKEN"
  },
  json={
    "query": query,
    # This is an example input showing all available input fields. Only fields marked as required in the schema are mandatory.
    "variables": {
      "input": {
        "dateRange": {
          "from": 1749000000000,
          "to": 1749900000000
        },
        "entityType": "McpServer",
        "limit": 100,
        "offset": 0
      }
    }
  }
)

if response.status_code == 200:
    result = response.json()
    print(result)
else:
    print(f"Error: {response.status_code}")
    print(response.text)

Arguments

You can use the following argument(s) to customize your getAiBomTopUsedItems query.

Argument	Description	Supported fields
input AiBomTopUsedInput	Optional date range, entity type filter, limit, and offset	dateRange VibeSecDateRange entityType String limit Int offset Int

Fields

Return type: [AiBomTopUsedItem!]!

You can use the following field(s) to specify what information your getAiBomTopUsedItems query will return. Please note that some fields may have their own subfields.

Field	Description	Supported fields
name String!	Display name of the AI BOM entity
entityType String!	AI BOM entity type (McpServer, ExternalSaas, AiModel, Skill)
identifier String	Stable identifier for deep links (skill content hash); null when name suffices
count Int!	Number of usage events in the selected period