> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bland.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Custom Tool Details

> Retrieve a Custom Tool you've created.

### Headers

**authorization** `string` *required*

Your API key for authentication.

### Path Parameters

**tool\_id** `string` *required*

The ID of the tool you want to retrieve (starting with `TL-`).

### Response

**status** `string`

Whether the requet succeeded or failed.

**tool** `array`

The tool you've created.

```json Response theme={null}
{
    "status": "success",
    "tool": {
        "tool_id": "TL-5da8347d-0ab7-415d-b156-a7fc5c6074dc",
        "label": null,
        "tool": {
            "name": "BookAppointment",
            "description": "Books the appointment. Can only be used once.",
            "speech": "Please wait while I book that appointment for you",
            "method": "POST",
            "timeout": 99999999,
            "url": "https://...",
            "body": {
                "slot": "{{input}}"
            },
            "input_schema": {
                "type": "object",
                "example": {
                    "date": "2024-03-16",
                    "time": "5:00 PM"
                },
                "required": [
                    "date",
                    "time"
                ],
                "properties": {
                    "date": "YYYY-MM-DD",
                    "time": "HH:MM (AM|PM)"
                }
            },
            "response": {
                "confirmation_message": "$.message"
            }
        },
        "public": false
    }
}
```

***

Docs for agents: [llms.txt](https://docs.bland.ai/llms.txt)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.