retell-sdk 1.15.11 → 1.15.15

package/README.md

@@ -2,20 +2,8 @@
 
 <div align="left">
     <a href="https://speakeasyapi.dev/"><img src="https://custom-icon-badges.demolab.com/badge/-Built%20By%20Speakeasy-212015?style=for-the-badge&logoColor=FBE331&logo=speakeasy&labelColor=545454" /></a>
-    <a href="https://opensource.org/licenses/MIT">
-        <img src="https://img.shields.io/badge/License-MIT-blue.svg" style="width: 100px; height: 28px;" />
-    </a>
 </div>
 
-
-## 🏗 **Welcome to your new SDK!** 🏗
-
-It has been generated successfully based on your OpenAPI spec. However, it is not yet ready for production use. Here are some next steps:
-- [ ] 🛠 Make your SDK feel handcrafted by [customizing it](https://www.speakeasyapi.dev/docs/customize-sdks)
-- [ ] ♻️ Refine your SDK quickly by iterating locally with the [Speakeasy CLI](https://github.com/speakeasy-api/speakeasy)
-- [ ] 🎁 Publish your SDK to package managers by [configuring automatic publishing](https://www.speakeasyapi.dev/docs/productionize-sdks/publish-sdks)
-- [ ] ✨ When ready to productionize, delete this section from the README
-
 <!-- Start SDK Installation [installation] -->
 ## SDK Installation
 
@@ -44,7 +32,7 @@ import { RetellClient } from "retell-sdk";
 
 async function run() {
     const sdk = new RetellClient({
-        apiKey: "<YOUR_API_KEY_HERE>",
+        apiKey: "",
     });
 
     const res = await sdk.createAgent({
@@ -58,11 +46,9 @@ async function run() {
         voiceId: "elevenlabs-xxcrwXReTKMHWjqi7Q27",
     });
 
-    if (res?.statusCode !== 200) {
-        throw new Error("Unexpected status code: " + res?.statusCode || "-");
+    if (res.statusCode == 200) {
+        // handle response
     }
-
-    // handle response
 }
 
 run();
@@ -78,7 +64,7 @@ import { RetellClient } from "retell-sdk";
 
 async function run() {
     const sdk = new RetellClient({
-        apiKey: "<YOUR_API_KEY_HERE>",
+        apiKey: "",
     });
 
     const res = await sdk.createPhoneCall({
@@ -94,11 +80,9 @@ async function run() {
         },
     });
 
-    if (res?.statusCode !== 200) {
-        throw new Error("Unexpected status code: " + res?.statusCode || "-");
+    if (res.statusCode == 200) {
+        // handle response
     }
-
-    // handle response
 }
 
 run();
@@ -114,7 +98,7 @@ import { RetellClient } from "retell-sdk";
 
 async function run() {
     const sdk = new RetellClient({
-        apiKey: "<YOUR_API_KEY_HERE>",
+        apiKey: "",
     });
 
     const res = await sdk.createPhoneNumber({
@@ -122,11 +106,9 @@ async function run() {
         areaCode: 415,
     });
 
-    if (res?.statusCode !== 200) {
-        throw new Error("Unexpected status code: " + res?.statusCode || "-");
+    if (res.statusCode == 200) {
+        // handle response
     }
-
-    // handle response
 }
 
 run();
@@ -139,21 +121,19 @@ Delete an existing agent
 
 ```typescript
 import { RetellClient } from "retell-sdk";
+import { DeleteAgentRequest } from "retell-sdk/dist/models/operations";
 
 async function run() {
     const sdk = new RetellClient({
-        apiKey: "<YOUR_API_KEY_HERE>",
+        apiKey: "",
     });
-
-    const agentId = "oBeDLoLOeuAbiuaMFXRtDOLriTJ5tSxD";
+    const agentId: string = "oBeDLoLOeuAbiuaMFXRtDOLriTJ5tSxD";
 
     const res = await sdk.deleteAgent(agentId);
 
-    if (res?.statusCode !== 200) {
-        throw new Error("Unexpected status code: " + res?.statusCode || "-");
+    if (res.statusCode == 200) {
+        // handle response
     }
-
-    // handle response
 }
 
 run();
@@ -166,21 +146,19 @@ Delete a specific phone number
 
 ```typescript
 import { RetellClient } from "retell-sdk";
+import { DeletePhoneNumberRequest } from "retell-sdk/dist/models/operations";
 
 async function run() {
     const sdk = new RetellClient({
-        apiKey: "<YOUR_API_KEY_HERE>",
+        apiKey: "",
     });
-
-    const phoneNumber = "string";
+    const phoneNumber: string = "string";
 
     const res = await sdk.deletePhoneNumber(phoneNumber);
 
-    if (res?.statusCode !== 200) {
-        throw new Error("Unexpected status code: " + res?.statusCode || "-");
+    if (res.statusCode == 200) {
+        // handle response
     }
-
-    // handle response
 }
 
 run();
@@ -193,21 +171,19 @@ Retrieve details of a specific agent
 
 ```typescript
 import { RetellClient } from "retell-sdk";
+import { GetAgentRequest } from "retell-sdk/dist/models/operations";
 
 async function run() {
     const sdk = new RetellClient({
-        apiKey: "<YOUR_API_KEY_HERE>",
+        apiKey: "",
     });
-
-    const agentId = "16b980523634a6dc504898cda492e939";
+    const agentId: string = "16b980523634a6dc504898cda492e939";
 
     const res = await sdk.getAgent(agentId);
 
-    if (res?.statusCode !== 200) {
-        throw new Error("Unexpected status code: " + res?.statusCode || "-");
+    if (res.statusCode == 200) {
+        // handle response
     }
-
-    // handle response
 }
 
 run();
@@ -220,21 +196,19 @@ Retrieve details of a specific call
 
 ```typescript
 import { RetellClient } from "retell-sdk";
+import { GetCallRequest } from "retell-sdk/dist/models/operations";
 
 async function run() {
     const sdk = new RetellClient({
-        apiKey: "<YOUR_API_KEY_HERE>",
+        apiKey: "",
     });
-
-    const callId = "119c3f8e47135a29e65947eeb34cf12d";
+    const callId: string = "119c3f8e47135a29e65947eeb34cf12d";
 
     const res = await sdk.getCall(callId);
 
-    if (res?.statusCode !== 200) {
-        throw new Error("Unexpected status code: " + res?.statusCode || "-");
+    if (res.statusCode == 200) {
+        // handle response
     }
-
-    // handle response
 }
 
 run();
@@ -247,21 +221,19 @@ Retrieve info about a specific number
 
 ```typescript
 import { RetellClient } from "retell-sdk";
+import { GetPhoneNumberRequest } from "retell-sdk/dist/models/operations";
 
 async function run() {
     const sdk = new RetellClient({
-        apiKey: "<YOUR_API_KEY_HERE>",
+        apiKey: "",
     });
-
-    const phoneNumber = "+14159095857";
+    const phoneNumber: string = "+14159095857";
 
     const res = await sdk.getPhoneNumber(phoneNumber);
 
-    if (res?.statusCode !== 200) {
-        throw new Error("Unexpected status code: " + res?.statusCode || "-");
+    if (res.statusCode == 200) {
+        // handle response
     }
-
-    // handle response
 }
 
 run();
@@ -277,16 +249,14 @@ import { RetellClient } from "retell-sdk";
 
 async function run() {
     const sdk = new RetellClient({
-        apiKey: "<YOUR_API_KEY_HERE>",
+        apiKey: "",
     });
 
     const res = await sdk.listAgents();
 
-    if (res?.statusCode !== 200) {
-        throw new Error("Unexpected status code: " + res?.statusCode || "-");
+    if (res.statusCode == 200) {
+        // handle response
     }
-
-    // handle response
 }
 
 run();
@@ -299,15 +269,18 @@ Retrieve call details
 
 ```typescript
 import { RetellClient } from "retell-sdk";
-import {} from "retell-sdk/models";
-import { SortOrder } from "retell-sdk/models/operations";
+import {
+    CallType,
+    FilterCriteria,
+    ListCallsRequest,
+    SortOrder,
+} from "retell-sdk/dist/models/operations";
 
 async function run() {
     const sdk = new RetellClient({
-        apiKey: "<YOUR_API_KEY_HERE>",
+        apiKey: "",
     });
-
-    const filterCriteria = {
+    const filterCriteria: FilterCriteria = {
         afterEndTimestamp: 1703302428800,
         afterStartTimestamp: 1703302407300,
         agentId: ["oBeDLoLOeuAbiuaMFXRtDOLriTJ5tSxD"],
@@ -315,16 +288,14 @@ async function run() {
         beforeStartTimestamp: 1703302407399,
         callType: [CallType.InboundPhoneCall, CallType.OutboundPhoneCall],
     };
-    const limit = 666195;
-    const sortOrder = SortOrder.Descending;
+    const limit: number = 666195;
+    const sortOrder: SortOrder = SortOrder.Descending;
 
     const res = await sdk.listCalls(filterCriteria, limit, sortOrder);
 
-    if (res?.statusCode !== 200) {
-        throw new Error("Unexpected status code: " + res?.statusCode || "-");
+    if (res.statusCode == 200) {
+        // handle response
     }
-
-    // handle response
 }
 
 run();
@@ -340,16 +311,14 @@ import { RetellClient } from "retell-sdk";
 
 async function run() {
     const sdk = new RetellClient({
-        apiKey: "<YOUR_API_KEY_HERE>",
+        apiKey: "",
     });
 
     const res = await sdk.listPhoneNumbers();
 
-    if (res?.statusCode !== 200) {
-        throw new Error("Unexpected status code: " + res?.statusCode || "-");
+    if (res.statusCode == 200) {
+        // handle response
     }
-
-    // handle response
 }
 
 run();
@@ -362,13 +331,14 @@ Update an existing agent
 
 ```typescript
 import { RetellClient } from "retell-sdk";
+import { AgentNoDefaultNoRequired } from "retell-sdk/dist/models/components";
+import { UpdateAgentRequest } from "retell-sdk/dist/models/operations";
 
 async function run() {
     const sdk = new RetellClient({
-        apiKey: "<YOUR_API_KEY_HERE>",
+        apiKey: "",
     });
-
-    const agentNoDefaultNoRequired = {
+    const agentNoDefaultNoRequired: AgentNoDefaultNoRequired = {
         agentName: "Jarvis",
         beginMessage: "Hello there, how can I help you.",
         enableBeginMessage: true,
@@ -378,15 +348,13 @@ async function run() {
         prompt: "You are a marketing assistant. You help come up with creative content ideas and content like marketing emails, blog posts, tweets, ad copy and product descriptions. You respond concisely, with filler words in it.",
         voiceId: "elevenlabs-xxcrwXReTKMHWjqi7Q27",
     };
-    const agentId = "16b980523634a6dc504898cda492e939";
+    const agentId: string = "16b980523634a6dc504898cda492e939";
 
     const res = await sdk.updateAgent(agentNoDefaultNoRequired, agentId);
 
-    if (res?.statusCode !== 200) {
-        throw new Error("Unexpected status code: " + res?.statusCode || "-");
+    if (res.statusCode == 200) {
+        // handle response
     }
-
-    // handle response
 }
 
 run();
@@ -399,24 +367,25 @@ Update an existing phone number
 
 ```typescript
 import { RetellClient } from "retell-sdk";
+import {
+    UpdatePhoneAgentRequest,
+    UpdatePhoneAgentRequestBody,
+} from "retell-sdk/dist/models/operations";
 
 async function run() {
     const sdk = new RetellClient({
-        apiKey: "<YOUR_API_KEY_HERE>",
+        apiKey: "",
     });
-
-    const requestBody = {
+    const requestBody: UpdatePhoneAgentRequestBody = {
         agentId: "oBeDLoLOeuAbiuaMFXRtDOLriTJ5tSxD",
     };
-    const phoneNumber = "+14159095857";
+    const phoneNumber: string = "+14159095857";
 
     const res = await sdk.updatePhoneAgent(requestBody, phoneNumber);
 
-    if (res?.statusCode !== 200) {
-        throw new Error("Unexpected status code: " + res?.statusCode || "-");
+    if (res.statusCode == 200) {
+        // handle response
     }
-
-    // handle response
 }
 
 run();
@@ -447,7 +416,7 @@ run();
 <!-- Start Error Handling [errors] -->
 ## Error Handling
 
-All SDK methods return a response object or throw an error. If Error objects are specified in your OpenAPI Spec, the SDK will throw the appropriate Error type.
+Handling errors in this SDK should largely match your expectations.  All operations return a response object or throw an error.  If Error objects are specified in your OpenAPI Spec, the SDK will throw the appropriate Error type.
 
 | Error Object                              | Status Code                               | Content Type                              |
 | ----------------------------------------- | ----------------------------------------- | ----------------------------------------- |
@@ -455,21 +424,21 @@ All SDK methods return a response object or throw an error. If Error objects are
 | errors.CreateAgentResponseResponseBody    | 401                                       | application/json                          |
 | errors.CreateAgentResponse422ResponseBody | 422                                       | application/json                          |
 | errors.CreateAgentResponse500ResponseBody | 500                                       | application/json                          |
-| errors.SDKError                           | 4xx-5xx                                   | */*                                       |
+| errors.SDKError                           | 400-600                                   | */*                                       |
 
 Example
 
 ```typescript
 import { RetellClient } from "retell-sdk";
-import * as errors from "retell-sdk/models/errors";
 
 async function run() {
     const sdk = new RetellClient({
-        apiKey: "<YOUR_API_KEY_HERE>",
+        apiKey: "",
     });
 
-    const res = await sdk
-        .createAgent({
+    let res;
+    try {
+        res = await sdk.createAgent({
             agentName: "Jarvis",
             beginMessage: "Hello there, how can I help you?",
             enableBeginMessage: true,
@@ -478,30 +447,29 @@ async function run() {
             endMessage: "Hope you have a good day, goodbye.",
             prompt: "You are a marketing assistant. You help come up with creative content ideas and content like marketing emails, blog posts, tweets, ad copy and product descriptions. You respond concisely, with filler words in it.",
             voiceId: "elevenlabs-xxcrwXReTKMHWjqi7Q27",
-        })
-        .catch((err) => {
-            if (err instanceof errors.CreateAgentResponseBody) {
-                console.error(err); // handle exception
-                return null;
-            } else if (err instanceof errors.CreateAgentResponseResponseBody) {
-                console.error(err); // handle exception
-                return null;
-            } else if (err instanceof errors.CreateAgentResponse422ResponseBody) {
-                console.error(err); // handle exception
-                return null;
-            } else if (err instanceof errors.CreateAgentResponse500ResponseBody) {
-                console.error(err); // handle exception
-                return null;
-            } else {
-                throw err;
-            }
         });
-
-    if (res?.statusCode !== 200) {
-        throw new Error("Unexpected status code: " + res?.statusCode || "-");
+    } catch (err) {
+        if (err instanceof errors.CreateAgentResponseBody) {
+            console.error(err); // handle exception
+            throw err;
+        } else if (err instanceof errors.CreateAgentResponseResponseBody) {
+            console.error(err); // handle exception
+            throw err;
+        } else if (err instanceof errors.CreateAgentResponse422ResponseBody) {
+            console.error(err); // handle exception
+            throw err;
+        } else if (err instanceof errors.CreateAgentResponse500ResponseBody) {
+            console.error(err); // handle exception
+            throw err;
+        } else if (err instanceof errors.SDKError) {
+            console.error(err); // handle exception
+            throw err;
+        }
     }
 
-    // handle response
+    if (res.statusCode == 200) {
+        // handle response
+    }
 }
 
 run();
@@ -520,60 +488,87 @@ You can override the default server globally by passing a server index to the `s
 | - | ------ | --------- |
 | 0 | `https://api.re-tell.ai` | None |
 
+#### Example
 
+```typescript
+import { RetellClient } from "retell-sdk";
 
+async function run() {
+    const sdk = new RetellClient({
+        serverIdx: 0,
+        apiKey: "",
+    });
 
-### Override Server URL Per-Client
+    const res = await sdk.createAgent({
+        agentName: "Jarvis",
+        beginMessage: "Hello there, how can I help you?",
+        enableBeginMessage: true,
+        enableEndCall: true,
+        enableEndMessage: false,
+        endMessage: "Hope you have a good day, goodbye.",
+        prompt: "You are a marketing assistant. You help come up with creative content ideas and content like marketing emails, blog posts, tweets, ad copy and product descriptions. You respond concisely, with filler words in it.",
+        voiceId: "elevenlabs-xxcrwXReTKMHWjqi7Q27",
+    });
 
-The default server can also be overridden globally by passing a URL to the `serverURL: str` optional parameter when initializing the SDK client instance. For example:
-<!-- End Server Selection [server] -->
+    if (res.statusCode == 200) {
+        // handle response
+    }
+}
 
-<!-- Start Custom HTTP Client [http-client] -->
-## Custom HTTP Client
+run();
 
-The TypeScript SDK makes API calls using an `HTTPClient` that wraps the native
-[Fetch API](https://developer.mozilla.org/en-US/docs/Web/API/Fetch_API). This
-client is a thin wrapper around `fetch` and provides the ability to attach hooks
-around the request lifecycle that can be used to modify the request or handle
-errors and response.
+```
 
-The `HTTPClient` constructor takes an optional `fetcher` argument that can be
-used to integrate a third-party HTTP client or when writing tests to mock out
-the HTTP client and feed in fixtures.
 
-The following example shows how to use the `"beforeRequest"` hook to to add a
-custom header and a timeout to requests and how to use the `"requestError"` hook
-to log errors:
+### Override Server URL Per-Client
 
+The default server can also be overridden globally by passing a URL to the `serverURL: str` optional parameter when initializing the SDK client instance. For example:
 ```typescript
 import { RetellClient } from "retell-sdk";
-import { HTTPClient } from "retell-sdk/lib/http";
 
-const httpClient = new HTTPClient({
-  // fetcher takes a function that has the same signature as native `fetch`.
-  fetcher: (request) => {
-    return fetch(request);
-  }
-});
+async function run() {
+    const sdk = new RetellClient({
+        serverURL: "https://api.re-tell.ai",
+        apiKey: "",
+    });
+
+    const res = await sdk.createAgent({
+        agentName: "Jarvis",
+        beginMessage: "Hello there, how can I help you?",
+        enableBeginMessage: true,
+        enableEndCall: true,
+        enableEndMessage: false,
+        endMessage: "Hope you have a good day, goodbye.",
+        prompt: "You are a marketing assistant. You help come up with creative content ideas and content like marketing emails, blog posts, tweets, ad copy and product descriptions. You respond concisely, with filler words in it.",
+        voiceId: "elevenlabs-xxcrwXReTKMHWjqi7Q27",
+    });
+
+    if (res.statusCode == 200) {
+        // handle response
+    }
+}
+
+run();
+
+```
+<!-- End Server Selection [server] -->
+
+<!-- Start Custom HTTP Client [http-client] -->
+## Custom HTTP Client
 
-httpClient.addHook("beforeRequest", (request) => {
-  const nextRequest = new Request(request, {
-    signal: request.signal || AbortSignal.timeout(5000);
-  });
+The Typescript SDK makes API calls using the [axios](https://axios-http.com/docs/intro) HTTP library.  In order to provide a convenient way to configure timeouts, cookies, proxies, custom headers, and other low-level configuration, you can initialize the SDK client with a custom `AxiosInstance` object.
 
-  nextRequest.headers.set("x-custom-header", "custom value");
+For example, you could specify a header for every request that your sdk makes as follows:
 
-  return nextRequest;
-});
+```typescript
+import { retell-sdk } from "RetellClient";
+import axios from "axios";
 
-httpClient.addHook("requestError", (error, request) => {
-  console.group("Request Error");
-  console.log("Reason:", `${error}`);
-  console.log("Endpoint:", `${request.method} ${request.url}`);
-  console.groupEnd();
-});
+const httpClient = axios.create({
+    headers: {'x-custom-header': 'someValue'}
+})
 
-const sdk = new RetellClient({ httpClient });
+const sdk = new RetellClient({defaultClient: httpClient});
 ```
 <!-- End Custom HTTP Client [http-client] -->
 
@@ -584,9 +579,9 @@ const sdk = new RetellClient({ httpClient });
 
 This SDK supports the following security scheme globally:
 
-| Name     | Type     | Scheme   |
-| -------- | -------- | -------- |
-| `apiKey` | apiKey   | API key  |
+| Name        | Type        | Scheme      |
+| ----------- | ----------- | ----------- |
+| `apiKey`    | http        | HTTP Bearer |
 
 To authenticate with the API the `apiKey` parameter must be set when initializing the SDK client instance. For example:
 ```typescript
@@ -594,7 +589,7 @@ import { RetellClient } from "retell-sdk";
 
 async function run() {
     const sdk = new RetellClient({
-        apiKey: "<YOUR_API_KEY_HERE>",
+        apiKey: "",
     });
 
     const res = await sdk.createAgent({
@@ -608,11 +603,9 @@ async function run() {
         voiceId: "elevenlabs-xxcrwXReTKMHWjqi7Q27",
     });
 
-    if (res?.statusCode !== 200) {
-        throw new Error("Unexpected status code: " + res?.statusCode || "-");
+    if (res.statusCode == 200) {
+        // handle response
     }
-
-    // handle response
 }
 
 run();
@@ -620,6 +613,589 @@ run();
 ```
 <!-- End Authentication [security] -->
 
+
+
+<!-- Start SDK Installation -->
+## SDK Installation
+
+### NPM
+
+```bash
+npm add retell-sdk
+```
+
+### Yarn
+
+```bash
+yarn add retell-sdk
+```
+<!-- End SDK Installation -->
+
+
+
+## SDK Example Usage
+<!-- Start SDK Example Usage -->
+### Create a new voice AI agent
+
+Create a new agent
+
+```typescript
+import { RetellClient } from "retell-sdk";
+
+(async () => {
+    const sdk = new RetellClient({
+        apiKey: "",
+    });
+
+    const res = await sdk.createAgent({
+        agentName: "Jarvis",
+        beginMessage: "Hello there, how can I help you?",
+        enableBeginMessage: true,
+        enableEndCall: true,
+        enableEndMessage: false,
+        endMessage: "Hope you have a good day, goodbye.",
+        prompt: "You are a marketing assistant. You help come up with creative content ideas and content like marketing emails, blog posts, tweets, ad copy and product descriptions. You respond concisely, with filler words in it.",
+        voiceId: "elevenlabs-xxcrwXReTKMHWjqi7Q27",
+    });
+
+    if (res.statusCode == 200) {
+        // handle response
+    }
+})();
+
+```
+
+### Create an outbound phone call
+
+Initiate an outbound phone call.
+
+```typescript
+import { RetellClient } from "retell-sdk";
+
+(async () => {
+    const sdk = new RetellClient({
+        apiKey: "",
+    });
+
+    const res = await sdk.createPhoneCall({
+        agentPromptParams: [
+            {
+                name: "username",
+                value: "Adam",
+            },
+        ],
+        phoneNumber: {
+            from: "+14159095857",
+            to: "+14159095858",
+        },
+    });
+
+    if (res.statusCode == 200) {
+        // handle response
+    }
+})();
+
+```
+
+### Create a new phone number
+
+Create a new phone number
+
+```typescript
+import { RetellClient } from "retell-sdk";
+
+(async () => {
+    const sdk = new RetellClient({
+        apiKey: "",
+    });
+
+    const res = await sdk.createPhoneNumber({
+        agentId: "oBeDLoLOeuAbiuaMFXRtDOLriTJ5tSxD",
+        areaCode: 415,
+    });
+
+    if (res.statusCode == 200) {
+        // handle response
+    }
+})();
+
+```
+
+### Delete an existing agent
+
+Delete an existing agent
+
+```typescript
+import { RetellClient } from "retell-sdk";
+import { DeleteAgentRequest } from "retell-sdk/dist/models/operations";
+
+(async () => {
+    const sdk = new RetellClient({
+        apiKey: "",
+    });
+    const agentId: string = "oBeDLoLOeuAbiuaMFXRtDOLriTJ5tSxD";
+
+    const res = await sdk.deleteAgent(agentId);
+
+    if (res.statusCode == 200) {
+        // handle response
+    }
+})();
+
+```
+
+### Delete a specific phone number
+
+Delete a specific phone number
+
+```typescript
+import { RetellClient } from "retell-sdk";
+import { DeletePhoneNumberRequest } from "retell-sdk/dist/models/operations";
+
+(async () => {
+    const sdk = new RetellClient({
+        apiKey: "",
+    });
+    const phoneNumber: string = "string";
+
+    const res = await sdk.deletePhoneNumber(phoneNumber);
+
+    if (res.statusCode == 200) {
+        // handle response
+    }
+})();
+
+```
+
+### Retrieve details of an agent
+
+Retrieve details of a specific agent
+
+```typescript
+import { RetellClient } from "retell-sdk";
+import { GetAgentRequest } from "retell-sdk/dist/models/operations";
+
+(async () => {
+    const sdk = new RetellClient({
+        apiKey: "",
+    });
+    const agentId: string = "16b980523634a6dc504898cda492e939";
+
+    const res = await sdk.getAgent(agentId);
+
+    if (res.statusCode == 200) {
+        // handle response
+    }
+})();
+
+```
+
+### Retrieve a on-going or finished call
+
+Retrieve details of a specific call
+
+```typescript
+import { RetellClient } from "retell-sdk";
+import { GetCallRequest } from "retell-sdk/dist/models/operations";
+
+(async () => {
+    const sdk = new RetellClient({
+        apiKey: "",
+    });
+    const callId: string = "119c3f8e47135a29e65947eeb34cf12d";
+
+    const res = await sdk.getCall(callId);
+
+    if (res.statusCode == 200) {
+        // handle response
+    }
+})();
+
+```
+
+### Retrieve info about a specific number
+
+Retrieve info about a specific number
+
+```typescript
+import { RetellClient } from "retell-sdk";
+import { GetPhoneNumberRequest } from "retell-sdk/dist/models/operations";
+
+(async () => {
+    const sdk = new RetellClient({
+        apiKey: "",
+    });
+    const phoneNumber: string = "+14159095857";
+
+    const res = await sdk.getPhoneNumber(phoneNumber);
+
+    if (res.statusCode == 200) {
+        // handle response
+    }
+})();
+
+```
+
+### List all agents
+
+List all agents
+
+```typescript
+import { RetellClient } from "retell-sdk";
+
+(async () => {
+    const sdk = new RetellClient({
+        apiKey: "",
+    });
+
+    const res = await sdk.listAgents();
+
+    if (res.statusCode == 200) {
+        // handle response
+    }
+})();
+
+```
+
+### List all web or phone calls
+
+Retrieve call details
+
+```typescript
+import { RetellClient } from "retell-sdk";
+import {
+    CallType,
+    FilterCriteria,
+    ListCallsRequest,
+    SortOrder,
+} from "retell-sdk/dist/models/operations";
+
+(async () => {
+    const sdk = new RetellClient({
+        apiKey: "",
+    });
+    const filterCriteria: FilterCriteria = {
+        afterEndTimestamp: 1703302428800,
+        afterStartTimestamp: 1703302407300,
+        agentId: ["oBeDLoLOeuAbiuaMFXRtDOLriTJ5tSxD"],
+        beforeEndTimestamp: 1703302428899,
+        beforeStartTimestamp: 1703302407399,
+        callType: [CallType.InboundPhoneCall, CallType.OutboundPhoneCall],
+    };
+    const limit: number = 666195;
+    const sortOrder: SortOrder = SortOrder.Descending;
+
+    const res = await sdk.listCalls(filterCriteria, limit, sortOrder);
+
+    if (res.statusCode == 200) {
+        // handle response
+    }
+})();
+
+```
+
+### List all purchased and active phone numbers
+
+List all purchased and active phone numbers
+
+```typescript
+import { RetellClient } from "retell-sdk";
+
+(async () => {
+    const sdk = new RetellClient({
+        apiKey: "",
+    });
+
+    const res = await sdk.listPhoneNumbers();
+
+    if (res.statusCode == 200) {
+        // handle response
+    }
+})();
+
+```
+
+### Update an existing agent
+
+Update an existing agent
+
+```typescript
+import { RetellClient } from "retell-sdk";
+import { AgentNoDefaultNoRequired } from "retell-sdk/dist/models/components";
+import { UpdateAgentRequest } from "retell-sdk/dist/models/operations";
+
+(async () => {
+    const sdk = new RetellClient({
+        apiKey: "",
+    });
+    const agentNoDefaultNoRequired: AgentNoDefaultNoRequired = {
+        agentName: "Jarvis",
+        beginMessage: "Hello there, how can I help you.",
+        enableBeginMessage: true,
+        enableEndCall: true,
+        enableEndMessage: false,
+        endMessage: "Hope you have a good day, goodbye.",
+        prompt: "You are a marketing assistant. You help come up with creative content ideas and content like marketing emails, blog posts, tweets, ad copy and product descriptions. You respond concisely, with filler words in it.",
+        voiceId: "elevenlabs-xxcrwXReTKMHWjqi7Q27",
+    };
+    const agentId: string = "16b980523634a6dc504898cda492e939";
+
+    const res = await sdk.updateAgent(agentNoDefaultNoRequired, agentId);
+
+    if (res.statusCode == 200) {
+        // handle response
+    }
+})();
+
+```
+
+### Update an existing phone number
+
+Update an existing phone number
+
+```typescript
+import { RetellClient } from "retell-sdk";
+import {
+    UpdatePhoneAgentRequest,
+    UpdatePhoneAgentRequestBody,
+} from "retell-sdk/dist/models/operations";
+
+(async () => {
+    const sdk = new RetellClient({
+        apiKey: "",
+    });
+    const requestBody: UpdatePhoneAgentRequestBody = {
+        agentId: "oBeDLoLOeuAbiuaMFXRtDOLriTJ5tSxD",
+    };
+    const phoneNumber: string = "+14159095857";
+
+    const res = await sdk.updatePhoneAgent(requestBody, phoneNumber);
+
+    if (res.statusCode == 200) {
+        // handle response
+    }
+})();
+
+```
+<!-- End SDK Example Usage -->
+
+
+
+<!-- Start SDK Available Operations -->
+## Available Resources and Operations
+
+### [RetellClient SDK](docs/sdks/retellclient/README.md)
+
+* [createAgent](docs/sdks/retellclient/README.md#createagent) - Create a new agent
+* [createPhoneCall](docs/sdks/retellclient/README.md#createphonecall) - Initiate an outbound phone call.
+* [createPhoneNumber](docs/sdks/retellclient/README.md#createphonenumber) - Create a new phone number
+* [deleteAgent](docs/sdks/retellclient/README.md#deleteagent) - Delete an existing agent
+* [deletePhoneNumber](docs/sdks/retellclient/README.md#deletephonenumber) - Delete a specific phone number
+* [getAgent](docs/sdks/retellclient/README.md#getagent) - Retrieve details of a specific agent
+* [getCall](docs/sdks/retellclient/README.md#getcall) - Retrieve details of a specific call
+* [getPhoneNumber](docs/sdks/retellclient/README.md#getphonenumber) - Retrieve info about a specific number
+* [listAgents](docs/sdks/retellclient/README.md#listagents) - List all agents
+* [listCalls](docs/sdks/retellclient/README.md#listcalls) - Retrieve call details
+* [listPhoneNumbers](docs/sdks/retellclient/README.md#listphonenumbers) - List all purchased and active phone numbers
+* [updateAgent](docs/sdks/retellclient/README.md#updateagent) - Update an existing agent
+* [updatePhoneAgent](docs/sdks/retellclient/README.md#updatephoneagent) - Update an existing phone number
+<!-- End SDK Available Operations -->
+
+
+
+<!-- Start Error Handling -->
+## Error Handling
+
+Handling errors in this SDK should largely match your expectations.  All operations return a response object or throw an error.  If Error objects are specified in your OpenAPI Spec, the SDK will throw the appropriate Error type.
+
+| Error Object                              | Status Code                               | Content Type                              |
+| ----------------------------------------- | ----------------------------------------- | ----------------------------------------- |
+| errors.CreateAgentResponseBody            | 400                                       | application/json                          |
+| errors.CreateAgentResponseResponseBody    | 401                                       | application/json                          |
+| errors.CreateAgentResponse422ResponseBody | 422                                       | application/json                          |
+| errors.CreateAgentResponse500ResponseBody | 500                                       | application/json                          |
+| errors.SDKError                           | 400-600                                   | */*                                       |
+
+Example
+
+```typescript
+import { RetellClient } from "retell-sdk";
+
+(async () => {
+    const sdk = new RetellClient({
+        apiKey: "",
+    });
+
+    let res;
+    try {
+        res = await sdk.createAgent({
+            agentName: "Jarvis",
+            beginMessage: "Hello there, how can I help you?",
+            enableBeginMessage: true,
+            enableEndCall: true,
+            enableEndMessage: false,
+            endMessage: "Hope you have a good day, goodbye.",
+            prompt: "You are a marketing assistant. You help come up with creative content ideas and content like marketing emails, blog posts, tweets, ad copy and product descriptions. You respond concisely, with filler words in it.",
+            voiceId: "elevenlabs-xxcrwXReTKMHWjqi7Q27",
+        });
+    } catch (e) {
+        if (e instanceof errors.CreateAgentResponseBody) {
+            console.error(e); // handle exception
+        } else if (e instanceof errors.CreateAgentResponseResponseBody) {
+            console.error(e); // handle exception
+        } else if (e instanceof errors.CreateAgentResponse422ResponseBody) {
+            console.error(e); // handle exception
+        } else if (e instanceof errors.CreateAgentResponse500ResponseBody) {
+            console.error(e); // handle exception
+        } else if (e instanceof errors.SDKError) {
+            console.error(e); // handle exception
+        }
+    }
+
+    if (res.statusCode == 200) {
+        // handle response
+    }
+})();
+
+```
+<!-- End Error Handling -->
+
+
+
+<!-- Start Server Selection -->
+## Server Selection
+
+### Select Server by Index
+
+You can override the default server globally by passing a server index to the `serverIdx: number` optional parameter when initializing the SDK client instance. The selected server will then be used as the default on the operations that use it. This table lists the indexes associated with the available servers:
+
+| # | Server | Variables |
+| - | ------ | --------- |
+| 0 | `https://api.re-tell.ai` | None |
+
+#### Example
+
+```typescript
+import { RetellClient } from "retell-sdk";
+
+(async () => {
+    const sdk = new RetellClient({
+        serverIdx: 0,
+        apiKey: "",
+    });
+
+    const res = await sdk.createAgent({
+        agentName: "Jarvis",
+        beginMessage: "Hello there, how can I help you?",
+        enableBeginMessage: true,
+        enableEndCall: true,
+        enableEndMessage: false,
+        endMessage: "Hope you have a good day, goodbye.",
+        prompt: "You are a marketing assistant. You help come up with creative content ideas and content like marketing emails, blog posts, tweets, ad copy and product descriptions. You respond concisely, with filler words in it.",
+        voiceId: "elevenlabs-xxcrwXReTKMHWjqi7Q27",
+    });
+
+    if (res.statusCode == 200) {
+        // handle response
+    }
+})();
+
+```
+
+
+### Override Server URL Per-Client
+
+The default server can also be overridden globally by passing a URL to the `serverURL: str` optional parameter when initializing the SDK client instance. For example:
+```typescript
+import { RetellClient } from "retell-sdk";
+
+(async () => {
+    const sdk = new RetellClient({
+        serverURL: "https://api.re-tell.ai",
+        apiKey: "",
+    });
+
+    const res = await sdk.createAgent({
+        agentName: "Jarvis",
+        beginMessage: "Hello there, how can I help you?",
+        enableBeginMessage: true,
+        enableEndCall: true,
+        enableEndMessage: false,
+        endMessage: "Hope you have a good day, goodbye.",
+        prompt: "You are a marketing assistant. You help come up with creative content ideas and content like marketing emails, blog posts, tweets, ad copy and product descriptions. You respond concisely, with filler words in it.",
+        voiceId: "elevenlabs-xxcrwXReTKMHWjqi7Q27",
+    });
+
+    if (res.statusCode == 200) {
+        // handle response
+    }
+})();
+
+```
+<!-- End Server Selection -->
+
+
+
+<!-- Start Custom HTTP Client -->
+## Custom HTTP Client
+
+The Typescript SDK makes API calls using the (axios)[https://axios-http.com/docs/intro] HTTP library.  In order to provide a convenient way to configure timeouts, cookies, proxies, custom headers, and other low-level configuration, you can initialize the SDK client with a custom `AxiosInstance` object.
+
+For example, you could specify a header for every request that your sdk makes as follows:
+
+```typescript
+from retell-sdk import RetellClient;
+import axios;
+
+const httpClient = axios.create({
+    headers: {'x-custom-header': 'someValue'}
+})
+
+const sdk = new RetellClient({defaultClient: httpClient});
+```
+<!-- End Custom HTTP Client -->
+
+
+
+<!-- Start Authentication -->
+## Authentication
+
+### Per-Client Security Schemes
+
+This SDK supports the following security scheme globally:
+
+| Name        | Type        | Scheme      |
+| ----------- | ----------- | ----------- |
+| `apiKey`    | http        | HTTP Bearer |
+
+To authenticate with the API the `apiKey` parameter must be set when initializing the SDK client instance. For example:
+```typescript
+import { RetellClient } from "retell-sdk";
+
+(async () => {
+    const sdk = new RetellClient({
+        apiKey: "",
+    });
+
+    const res = await sdk.createAgent({
+        agentName: "Jarvis",
+        beginMessage: "Hello there, how can I help you?",
+        enableBeginMessage: true,
+        enableEndCall: true,
+        enableEndMessage: false,
+        endMessage: "Hope you have a good day, goodbye.",
+        prompt: "You are a marketing assistant. You help come up with creative content ideas and content like marketing emails, blog posts, tweets, ad copy and product descriptions. You respond concisely, with filler words in it.",
+        voiceId: "elevenlabs-xxcrwXReTKMHWjqi7Q27",
+    });
+
+    if (res.statusCode == 200) {
+        // handle response
+    }
+})();
+
+```
+<!-- End Authentication -->
+
 <!-- Placeholder for Future Speakeasy SDK Sections -->
 
 # Development