# Tool

Endpoints for managing tools

## List all available tools

 - [GET /core/v1/tools](https://api.docs.wabee.ai/openapi/tool/list_tools_core_v1_tools_get.md): Returns a list of all available tools that the agent has access to.

    Each tool entry includes:
    - Name: Unique identifier for the tool
    - Description: What the tool does and how it can be used
    - Status: Current initialization status (ready, initializing, error)
    - Schema: JSON schema defining the input parameters for the tool

    Use this endpoint to discover available tools and their required parameters
    before using the /tool/execute endpoint.

    ## Authentication
    Requires API key via x-wabee-access header.

## Execute a specific tool directly

 - [POST /core/v1/tool/execute](https://api.docs.wabee.ai/openapi/tool/execute_tool_core_v1_tool_execute_post.md): This endpoint allows direct execution of a specific tool with given parameters.

    The tool is executed outside the normal agent conversation flow, allowing users to:
    - Invoke tools programmatically
    - Test tool functionality independently
    - Access tool capabilities without engaging the full agent

    Each tool has different input parameters. Refer to tool documentation for specific input schemas.

    ## Authentication
    Requires API key via x-wabee-access header.

    ## Example Tool Inputs

    Web Search:
    json
    {
        "tool_name": "web_search",
        "tool_input": {
            "query": "Latest market trends in AI"
        }
    }
    

    CSV Search:
    json
    {
        "tool_name": "csv_search",
        "tool_input": {
            "file_path": "data/sales.csv",
            "query": "Find total sales in Q1"
        }
    }