Skip to content
/
Get usage stats
Last updated

Get Personal Connector Usage Statistics

🔨 In Development — This section is still being developed and may change.
Retrieve usage statistics and billing information for a personal connector configuration. This endpoint provides detailed insights into how often tools are being used and how many neurons are being consumed.
GEThttps://api.freddy.aitronos.com/v1/personal-connectors/configurations/{config_id}/usage

This endpoint returns usage statistics for a specific personal connector configuration, including tool execution counts, neuron costs, execution times, and error rates. You can filter by date range and aggregate by different time periods.

Path Parameters

config_id string required The ID of the personal connector configuration (e.g., pconf_abc123).

Query Parameters

startDate string optional Start date for the usage period (ISO 8601 format). Defaults to 30 days ago.

endDate string optional End date for the usage period (ISO 8601 format). Defaults to now.

aggregation string optional · Defaults to day Time period for aggregation. Values: hour, day, week, month.

toolName string optional Filter by specific tool name (e.g., clickup_create_task).

Bash
curl https://api.freddy.aitronos.com/v1/personal-connectors/configurations/pconf_abc123/usage \
  -H "Authorization: Bearer $FREDDY_API_KEY"

Response

{
  "configurationId": "pconf_abc123",
  "configurationName": "My ClickUp Tasks",
  "personalConnectorId": "pcon_clickup",
  "period": {
    "startDate": "2025-09-07T00:00:00Z",
    "endDate": "2025-10-07T23:59:59Z",
    "aggregation": "day"
  },
  "summary": {
    "totalExecutions": 245,
    "successfulExecutions": 238,
    "failedExecutions": 7,
    "totalNeuronsCharged": 1837500,
    "averageExecutionTimeMs": 1450,
    "successRate": 0.971
  },
  "billing": {
    "baseFeeNeurons": 5000,
    "neuronsPerInterval": 100,
    "intervalSeconds": 0.1,
    "totalCost": 1837500,
    "estimatedMonthlyCost": 5512500
  },
  "toolBreakdown": [
    {
      "toolName": "clickup_create_task",
      "executions": 156,
      "successfulExecutions": 152,
      "failedExecutions": 4,
      "neuronsCharged": 1170000,
      "averageExecutionTimeMs": 1500,
      "successRate": 0.974
    },
    {
      "toolName": "clickup_list_tasks",
      "executions": 67,
      "successfulExecutions": 65,
      "failedExecutions": 2,
      "neuronsCharged": 502500,
      "averageExecutionTimeMs": 1250,
      "successRate": 0.970
    },
    {
      "toolName": "clickup_update_task",
      "executions": 22,
      "successfulExecutions": 21,
      "failedExecutions": 1,
      "neuronsCharged": 165000,
      "averageExecutionTimeMs": 1500,
      "successRate": 0.955
    }
  ],
  "timeSeries": [
    {
      "date": "2025-10-01",
      "executions": 34,
      "neuronsCharged": 255000,
      "averageExecutionTimeMs": 1420
    },
    {
      "date": "2025-10-02",
      "executions": 28,
      "neuronsCharged": 210000,
      "averageExecutionTimeMs": 1500
    },
    {
      "date": "2025-10-03",
      "executions": 41,
      "neuronsCharged": 307500,
      "averageExecutionTimeMs": 1500
    }
  ],
  "errors": [
    {
      "errorCode": "invalid_list_id",
      "errorMessage": "The specified list ID does not exist.",
      "count": 4,
      "lastOccurrence": "2025-10-07T14:30:00Z"
    },
    {
      "errorCode": "rate_limit_exceeded",
      "errorMessage": "ClickUp API rate limit exceeded.",
      "count": 3,
      "lastOccurrence": "2025-10-06T16:45:00Z"
    }
  ]
}

Response Fields

Summary

  • totalExecutions - Total number of tool executions in the period
  • successfulExecutions - Number of successful executions
  • failedExecutions - Number of failed executions
  • totalNeuronsCharged - Total neurons consumed
  • averageExecutionTimeMs - Average execution time across all tools
  • successRate - Success rate (0.0 to 1.0)

Billing

  • baseFeeNeurons - Base fee per tool execution
  • neuronsPerInterval - Neurons charged per time interval
  • intervalSeconds - Time interval for billing (e.g., 0.1 seconds)
  • totalCost - Total neurons charged in the period
  • estimatedMonthlyCost - Projected monthly cost based on current usage

Tool Breakdown

Per-tool statistics showing which tools are used most frequently and their individual costs.

Time Series

Usage data aggregated by the specified time period (hour, day, week, or month).

Errors

Common errors encountered during tool executions, including error codes, messages, counts, and last occurrence timestamps.

Use Cases

  • Cost Monitoring: Track neuron consumption and estimate monthly costs
  • Usage Analytics: Understand which tools are used most frequently
  • Performance Monitoring: Identify slow-performing tools
  • Error Tracking: Identify and troubleshoot recurring errors
  • Capacity Planning: Plan for future usage based on trends
  • Budget Management: Set alerts based on usage thresholds
Previous page
Next page