toolUseAgentActivity

Fetch a single ToolUse activity by id.

Examples

GraphQL

query ToolUseAgentActivity($input: AgentActivityByIdInput!) {
  toolUseAgentActivity(input: $input) {
    id
    createdAt
    activityType
    oxAction
    userEmail
    userRole
    source
    appName
    threadId
    toolName
    toolInput
    mcpServerName
    mcpIdentifier
    model
  }
}

Variables

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

{
  "input": {
    "id": "68b7c1f0a2e4d51234567890"
  }
}

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 ToolUseAgentActivity($input: AgentActivityByIdInput!) { toolUseAgentActivity(input: $input) { id createdAt activityType oxAction userEmail userRole source appName threadId toolName toolInput mcpServerName mcpIdentifier model } }",
 "variables": {
    "input": {
      "id": "68b7c1f0a2e4d51234567890"
    }
  }
}'

Node.js

const query = 'query ToolUseAgentActivity($input: AgentActivityByIdInput!) { toolUseAgentActivity(input: $input) { id createdAt activityType oxAction userEmail userRole source appName threadId toolName toolInput mcpServerName mcpIdentifier model } }';

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: {
        id: "68b7c1f0a2e4d51234567890"
      }
    }
  })
})
.then(response => response.json())
.then(result => console.log(JSON.stringify(result, null, 2)))
.catch(error => console.error('Error:', error));

Python

import requests

query = 'query ToolUseAgentActivity($input: AgentActivityByIdInput!) { toolUseAgentActivity(input: $input) { id createdAt activityType oxAction userEmail userRole source appName threadId toolName toolInput mcpServerName mcpIdentifier model } }'

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": {
        "id": "68b7c1f0a2e4d51234567890"
      }
    }
  }
)

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

Argument	Description	Supported fields
input AgentActivityByIdInput! required		id ID!

Fields

Return type: ToolUseAgentActivity

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

Field	Description	Supported fields
id ID!	Unique identifier of the activity record
createdAt DateTime	When the activity was recorded
activityType AgentActivityType!	Kind of agent activity this record represents
oxAction OxAction!	Action OX took on this activity
userEmail String	Email address of the developer who triggered the activity
userRole String	Role of the developer who triggered the activity
source VibeCodeSource!	Coding agent the activity originated from
appName String	Application the activity was attributed to
threadId String	Identifier of the agent conversation the activity belongs to
toolName String!	Name of the tool the agent invoked
toolInput String	Input the agent passed to the tool
mcpServerName String	MCP server that provided the tool
mcpIdentifier String	Stable identifier of the MCP server (URL or command)
model String	AI model that requested the tool call