---
name: retell
description: Base class for applications interacting with RESTful HTTP APIs. Extends `BaseApplication` to provide functionalities specific to API-based integrations. This includes managing an `httpx.Client` for making HTTP requests, handling authentication headers, processing responses, and offering convenient methods for common HTTP verbs (GET, POST, PUT, DELETE, PATCH). Attributes: name (str): The name of the application. integration (Integration | None): An optional Integration object responsible for managing authentication and credentials. default_timeout (int): The default timeout in seconds for HTTP requests. base_url (str): The base URL for the API endpoint. This should be set by the subclass. _client (httpx.Client | None): The internal httpx client instance.
---

# Retell Integration

Base class for applications interacting with RESTful HTTP APIs. Extends `BaseApplication` to provide functionalities specific to API-based integrations. This includes managing an `httpx.Client` for making HTTP requests, handling authentication headers, processing responses, and offering convenient methods for common HTTP verbs (GET, POST, PUT, DELETE, PATCH). Attributes: name (str): The name of the application. integration (Integration | None): An optional Integration object responsible for managing authentication and credentials. default_timeout (int): The default timeout in seconds for HTTP requests. base_url (str): The base URL for the API endpoint. This should be set by the subclass. _client (httpx.Client | None): The internal httpx client instance.

## Available Tools

| Tool | Description |
|------|-------------|
| `get_v2_get_call_by_call_id` | Retrieve detailed information about a specific call using its call ID. |
| `post_v2_create_phone_call` | Initiates a phone call using a JSON payload with specified parameters. |
| `post_v2_create_web_call` | Creates a web call via a POST request to the v2 endpoint with specified agent ID and optional metadata or dynamic variables. |
| `get_get_voice_by_voice_id` | Fetches voice details based on the provided voice ID. |
| `post_v2_list_calls` | Sends a POST request to list call records with optional filtering, sorting, pagination, and limits. |
| `post_create_phone_number` | Creates a phone number with the specified area code and optional parameters. |
| `get_get_phone_number_by_phone_number` | Retrieves phone number details by making a GET request to the API endpoint using the provided phone number. |
| `get_list_phone_numbers` | Retrieves a list of phone numbers from the remote API. |
| `patch_update_phone_number_by_phone_number` | Updates the information of a phone number by its number, allowing optional modification of inbound and outbound agent IDs and nickname. |
| `delete_delete_phone_number_by_phone_number` | Deletes a phone number resource by its phone number identifier via an HTTP DELETE request. |
