> ## Documentation Index > Fetch the complete documentation index at: https://docs.tryopencomputer.com/llms.txt > Use this file to discover all available pages before exploring further. # Get Tool Activity > Recent calls that used this tool, newest first, with the result, failure cause and duration. Filter by `days`, `failed_only` and `workflow_id`. ## OpenAPI ````yaml /api-reference/openapi.json get /api/v1/tools/{tool_uuid}/activity openapi: 3.1.0 info: title: Athena API version: 1.0.0 description: >- Hosted Athena customer API. Authenticate backend management and call-trigger requests with X-API-Key. Website embeds and artifact playback use their own scoped tokens. Provider availability, feature settings, and verification limits are described in the guides. servers: - url: https://athena.tryopencomputer.com description: Hosted Athena API security: [] paths: /api/v1/tools/{tool_uuid}/activity: get: tags: - Tools summary: Get Tool Activity description: >- Recent calls that used this tool, newest first, with the result, failure cause and duration. Filter by `days`, `failed_only` and `workflow_id`. operationId: get_tool_activity_api_v1_tools__tool_uuid__activity_get parameters: - name: tool_uuid in: path required: true schema: type: string title: Tool Uuid - name: days in: query required: false schema: type: integer maximum: 30 minimum: 1 default: 7 title: Days - name: failed_only in: query required: false schema: type: boolean default: false title: Failed Only - name: workflow_id in: query required: false schema: anyOf: - type: integer - type: 'null' title: Workflow Id - name: limit in: query required: false schema: type: integer maximum: 1000 minimum: 1 default: 200 title: Limit - name: authorization in: header required: false schema: anyOf: - type: string - type: 'null' title: Authorization - name: X-API-Key in: header required: false schema: anyOf: - type: string - type: 'null' title: X-Api-Key responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/ToolActivityResponse' '401': description: Authentication is missing or invalid. '404': description: Not found '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' security: - ApiKeyAuth: [] - BearerAuth: [] components: schemas: ToolActivityResponse: properties: window_days: type: integer title: Window Days since: type: string format: date-time title: Since runs_scanned: type: integer title: Runs Scanned truncated: type: boolean title: Truncated description: True when more runs matched than were read (oldest left out). health: $ref: '#/components/schemas/ToolHealth' causes: additionalProperties: type: integer type: object title: Causes description: Failed calls by cause. rows: items: $ref: '#/components/schemas/ToolCallRow' type: array title: Rows description: Newest first. total_rows: type: integer title: Total Rows description: Rows matching the filters before the limit. type: object required: - window_days - since - runs_scanned - truncated - health - total_rows title: ToolActivityResponse description: GET /tools/{uuid}/activity. HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError ToolHealth: properties: calls: type: integer title: Calls default: 0 failed: type: integer title: Failed default: 0 unknown: type: integer title: Unknown description: Calls with no stored result to pair (no result or duration). default: 0 median_ms: anyOf: - type: integer - type: 'null' title: Median Ms p95_ms: anyOf: - type: integer - type: 'null' title: P95 Ms last_used_at: anyOf: - type: string format: date-time - type: 'null' title: Last Used At daily: items: type: integer type: array title: Daily description: >- Calls per 24 hours, oldest first, ending now (one entry per day of the window). type: object title: ToolHealth description: >- A tool's calls over a time window, rebuilt read-only from the runs' stored logs. Each call is a ``tool.invocation`` log event whose ``executorRef`` names the tool (``tool::``). Result and duration come from the ``native.tool_record`` event stored when that call's result went back to the voice model (the same pairing as the run's Activity view). Native voice path only. ToolCallRow: properties: at: type: string format: date-time title: At run_id: type: integer title: Run Id workflow_id: type: integer title: Workflow Id workflow_name: type: string title: Workflow Name duration_ms: anyOf: - type: integer - type: 'null' title: Duration Ms result: type: string enum: - ok - failed - unknown title: Result cause: anyOf: - type: string enum: - timeout - http_5xx - auth - http_4xx - other - type: 'null' title: Cause http_status: anyOf: - type: integer - type: 'null' title: Http Status type: object required: - at - run_id - workflow_id - workflow_name - result title: ToolCallRow description: >- One call of the tool. Timing and result only: what was sent and received stays in the run's own logs. ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type input: title: Input ctx: type: object title: Context type: object required: - loc - msg - type title: ValidationError securitySchemes: ApiKeyAuth: type: apiKey in: header name: X-API-Key BearerAuth: type: http scheme: bearer ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.