Skip to main content
This endpoint retrieves a specific tool by its unique ID, including full configuration details and usage statistics.

Path Parameters

  • tool_id (integer, required): The unique identifier of the tool to retrieve

Response

A successful request returns the complete tool object:
Response

Error Responses

404 Not Found
403 Forbidden

Tool Type Specific Fields

Usage Statistics

The response includes detailed usage statistics:
  • execution_count: Total number of times the tool has been executed
  • success_rate: Percentage of successful executions (0-100)
  • avg_execution_time: Average execution time in seconds
  • last_executed_at: Timestamp of the most recent execution

Integration Examples

Security Notes

  • Sensitive Data: Configuration fields containing sensitive information (API keys, passwords) are redacted in responses
  • Access Control: Users can only access tools within their organization
  • Audit Trail: Tool access is logged for security monitoring