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
{
  "id": 123,
  "name": "get_customer_info",
  "display_name": "Customer Information Lookup",
  "description": "Look up customer information by phone number or email",
  "tool_type": "endpoint",
  "configuration": {
    "url": "https://api.yourcompany.com/customers/lookup",
    "method": "GET",
    "headers": {
      "Authorization": "Bearer [REDACTED]",
      "Content-Type": "application/json"
    },
    "timeout_seconds": 30,
    "follow_redirects": true,
    "verify_ssl": true
  },
  "function_definition": {
    "name": "get_customer_info",
    "description": "Look up customer information by phone number or email",
    "parameters": {
      "type": "object",
      "properties": {
        "phone_number": {
          "type": "string",
          "description": "Customer's phone number in E.164 format"
        },
        "email": {
          "type": "string",
          "description": "Customer's email address"
        }
      },
      "required": ["phone_number"]
    }
  },
  "is_active": true,
  "is_public": false,
  "timeout_seconds": 30,
  "retry_attempts": 1,
  "execution_count": 156,
  "success_rate": 94.2,
  "avg_execution_time": 1.24,
  "last_executed_at": "2024-01-15T15:30:00Z",
  "organization_id": 456,
  "created_by": 789,
  "created_at": "2024-01-15T10:30:00Z",
  "updated_at": "2024-01-15T15:45:00Z"
}

​
Error Responses

404 Not Found 
{
  "detail": "Tool with ID 123 not found"
}
403 Forbidden 
{
  "detail": "You don't have permission to access this tool"
}

​
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

const axios = require('axios');

async function getTool(toolId) {
  try {
    const response = await axios.get(`https://api.burki.dev/api/v1/tools/${toolId}`, {
      headers: {
        'Authorization': 'Bearer YOUR_API_KEY'
      }
    });
    
    return response.data;
  } catch (error) {
    if (error.response?.status === 404) {
      throw new Error(`Tool with ID ${toolId} not found`);
    }
    throw error;
  }
}

// Usage
const tool = await getTool(123);
console.log(`Tool: ${tool.display_name}`);
console.log(`Type: ${tool.tool_type}`);
console.log(`Success Rate: ${tool.success_rate}%`);

​
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