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

# List mid call tools

> Retrieve all mid call tools

This endpoint allows you to retrieve all mid call tools. Mid call tools enable your AI assistants to interact with external APIs during a call.

### Headers

**Authorization** `string` *required*

Bearer token for authentication

**Content-Type** `string` *required*

Must be `application/json`

**Accept** `string` *required*

Must be `application/json`

### Response fields

**data** `array`

Array of mid call tools

**properties**

**id** `integer`

The unique identifier of the tool

**name** `string`

The name of the tool

**description** `string`

Detailed explanation of when and how the AI should use this tool

**type** `string`

Tool type: `http` or `automation`

**endpoint** `string`

The API endpoint URL that will be called

**method** `string`

HTTP method (GET, POST, PUT, PATCH, DELETE)

**body\_format** `string`

Request body encoding: `json` or `form`

**timeout** `integer`

Request timeout in seconds (1-30)

**headers** `array`

HTTP headers to send with the request

**header properties**

**name** `string`

Header name

**value** `string`

Header value

**static\_fields** `array`

Fixed key/value pairs always sent with the request

**static\_fields properties**

**key** `string`

Field key

**value** `string`

Field value

**schema** `array`

Parameters that the AI will extract and send to the endpoint

**schema properties**

**name** `string`

Parameter name

**type** `string`

Parameter type (string, number, float, boolean)

**description** `string`

Description to help AI understand how to extract this parameter

**required** `boolean`

Whether the AI must collect this parameter

**created\_at** `string`

ISO 8601 timestamp when the tool was created

**updated\_at** `string`

ISO 8601 timestamp when the tool was last updated

```json 200 Response theme={null}
[
  {
    "id": 1,
    "name": "get_weather",
    "description": "Use this tool to get the current weather in a specific city. Call this when the customer asks about weather conditions.",
    "type": "http",
    "endpoint": "https://api.openweathermap.org/data/2.5/weather?city={city}",
    "method": "GET",
    "body_format": "json",
    "timeout": 10,
    "headers": [
      {
        "name": "Content-Type",
        "value": "application/json"
      },
      {
        "name": "Authorization",
        "value": "Bearer sk_..."
      }
    ],
    "static_fields": [],
    "schema": [
      {
        "name": "city",
        "type": "string",
        "description": "The city name to get weather for",
        "required": true
      },
      {
        "name": "days",
        "type": "number",
        "description": "Number of forecast days",
        "required": false
      }
    ],
    "created_at": "2025-10-10T12:00:00.000000Z",
    "updated_at": "2025-10-10T12:00:00.000000Z"
  },
  {
    "id": 2,
    "name": "send_notification",
    "description": "Use this tool to send a notification to the customer. Call this when customer requests updates.",
    "type": "http",
    "endpoint": "https://api.yourcompany.com/notifications/send",
    "method": "POST",
    "body_format": "json",
    "timeout": 15,
    "headers": [
      {
        "name": "Content-Type",
        "value": "application/json"
      }
    ],
    "static_fields": [
      {
        "key": "caller",
        "value": "{{customer_phone}}"
      }
    ],
    "schema": [
      {
        "name": "message",
        "type": "string",
        "description": "The notification message to send",
        "required": true
      },
      {
        "name": "send_sms",
        "type": "boolean",
        "description": "Whether to also send SMS notification",
        "required": false
      }
    ],
    "created_at": "2025-10-09T14:30:00.000000Z",
    "updated_at": "2025-10-10T09:15:00.000000Z"
  }
]
```

### Assigning Tools to Assistants

To use these tools with assistants, see:

* **[Create Assistant](https://docs.receptonic.com/api-reference/assistants/create-assistant.md)** - Attach tools using the `tool_ids` parameter
* **[Update Assistant](https://docs.receptonic.com/api-reference/assistants/update-assistant.md)** - Manage tool assignments using the `tool_ids` parameter


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