GET
/
v1
/
tools
curl --request GET \
  --url https://api.bland.ai/v1/tools \
  --header 'authorization: <authorization>'
{
    "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
        },
        ...
    ]
}

Headers

authorization
string
required

Your API key for authentication.

Response

status
string

Whether the requet succeeded or failed.

tools
array

An array of your available tools.

{
    "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
        },
        ...
    ]
}