> ## 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.

# List Custom Tools

> Retrieve Custom Tools you've created.

### Headers

<ParamField header="authorization" type="string" required>
  Your API key for authentication.
</ParamField>

### Response

<ResponseField name="status" type="string">
  Whether the requet succeeded or failed.
</ResponseField>

<ResponseField name="tools" type="array">
  An array of your available tools.
</ResponseField>

<ResponseExample>
  ```json Response theme={null}
  {
      "status": "success",
      "tools": [
          {
              "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
          },
          ...
      ]
  }
  ```
</ResponseExample>

***

Docs for agents: [llms.txt](/llms.txt)