getUserToolUsage

Per-AI-tool prompt counts (and last usage) for a single user; sums to the user's total prompts.

Examples

GraphQL

query GetUserToolUsage($user: String!, $dateRange: VibeSecDateRange) {
  getUserToolUsage(user: $user, dateRange: $dateRange) {
    tool
    lastUsedAt
    totalCalls
  }
}

Variables

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

{
  "user": "example",
  "dateRange": {
    "from": 1749000000000,
    "to": 1749900000000
  }
}

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 GetUserToolUsage($user: String!, $dateRange: VibeSecDateRange) { getUserToolUsage(user: $user, dateRange: $dateRange) { tool lastUsedAt totalCalls } }",
 "variables": {
    "user": "example",
    "dateRange": {
      "from": 1749000000000,
      "to": 1749900000000
    }
  }
}'

Node.js

const query = 'query GetUserToolUsage($user: String!, $dateRange: VibeSecDateRange) { getUserToolUsage(user: $user, dateRange: $dateRange) { tool lastUsedAt totalCalls } }';

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: {
      user: "example",
      dateRange: {
        from: 1749000000000,
        to: 1749900000000
      }
    }
  })
})
.then(response => response.json())
.then(result => console.log(JSON.stringify(result, null, 2)))
.catch(error => console.error('Error:', error));

Python

import requests

query = 'query GetUserToolUsage($user: String!, $dateRange: VibeSecDateRange) { getUserToolUsage(user: $user, dateRange: $dateRange) { tool lastUsedAt totalCalls } }'

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": {
      "user": "example",
      "dateRange": {
        "from": 1749000000000,
        "to": 1749900000000
      }
    }
  }
)

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 getUserToolUsage query.

Argument	Description	Supported fields
user String! required
dateRange VibeSecDateRange		from Float to Float

Fields

Return type: [UserToolUsageItem!]!

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

Field	Description	Supported fields
tool String!	AI tool / coding agent (VibeCode source) the user used
lastUsedAt DateTime	The user's most recent usage timestamp with this tool
totalCalls Int!	The user's total prompt count made through this tool