rcs-js 2.0.0-rc.9 → 2.0.1-rc.1

package/reference.md

@@ -112,7 +112,7 @@ await client.brands.upsert({
     description: "A developer-friendly, compliant API for SMS, MMS, and RCS, built to scale real conversations.",
     ein: "88-1234567",
     email: "founders@trypinnacle.app",
-    id: 1,
+    id: "b_1234567890",
     name: "Pinnacle",
     sector: "TECHNOLOGY",
     type: "PRIVATE_PROFIT",
@@ -180,7 +180,7 @@ Retrieve detailed information for a specific brand in your account by ID.
 <dd>
 
 ```typescript
-await client.brands.get(1);
+await client.brands.get("b_1234567890");
 ```
 
 </dd>
@@ -196,7 +196,10 @@ await client.brands.get(1);
 <dl>
 <dd>
 
-**id:** `number` — ID of an existing brand in your account that you want to retrieve.
+**id:** `string`
+
+The unique identifier of the brand you want to retrieve from your account.
+<br><br> This identifier is a string that always begins with the prefix `b_`, for example: `b_1234567890`.
 
 </dd>
 </dl>
@@ -251,7 +254,7 @@ Submit your brand for review and approval by the compliance team.
 <dd>
 
 ```typescript
-await client.brands.submit(1);
+await client.brands.submit("b_1234567890");
 ```
 
 </dd>
@@ -267,11 +270,10 @@ await client.brands.submit(1);
 <dl>
 <dd>
 
-**brandId:** `number`
-
-The unique identifier of the brand you want to submit for review. <br>
+**brandId:** `string`
 
-Must correspond to an existing brand in your account that is ready for submission.
+The unique identifier of the brand you want to submit for review. <br><br>
+This identifier is a string that always begins with the prefix `b_`, for example: `b_1234567890` and must correspond to an existing brand in your account that is ready for submission.
 
 </dd>
 </dl>
@@ -397,7 +399,7 @@ Submit a brand for external vetting verification to enhance your brand's trust s
 <dd>
 
 ```typescript
-await client.brands.vet(1, {});
+await client.brands.vet("b_1234567890", {});
 ```
 
 </dd>
@@ -413,11 +415,11 @@ await client.brands.vet(1, {});
 <dl>
 <dd>
 
-**brandId:** `number`
+**brandId:** `string`
 
 The unique identifier of the brand to vet. <br>
 
-The brand must be already registered before it can be vetted.
+This identifier is a string that always begins with the prefix `b_`, for example: `b_1234567890` and must correspond to an existing brand in your account that is ready for vetting.
 
 </dd>
 </dl>
@@ -474,7 +476,9 @@ Retrieve contact information for a given number.
 <dd>
 
 ```typescript
-await client.contacts.get();
+await client.contacts.get({
+    id: "co_1234567890",
+});
 ```
 
 </dd>
@@ -607,7 +611,7 @@ await client.contacts.update({
     email: "alvaroopedtech@pinnacle.sh",
     name: "Retired Bestie",
     tags: ["friend"],
-    id: 137,
+    id: "co_1234567890",
 });
 ```
 
@@ -645,7 +649,7 @@ await client.contacts.update({
 
 ## Conversations
 
-<details><summary><code>client.conversations.<a href="/src/api/resources/conversations/client/Client.ts">get</a>({ ...params }) -> (Pinnacle.Conversation | null) | undefined</code></summary>
+<details><summary><code>client.conversations.<a href="/src/api/resources/conversations/client/Client.ts">get</a>({ ...params }) -> Pinnacle.Conversation | null</code></summary>
 <dl>
 <dd>
 
@@ -674,7 +678,7 @@ Fetch a specific conversation using either its unique identifier or by matching
 
 ```typescript
 await client.conversations.get({
-    id: 1,
+    id: "conv_1234567890",
 });
 ```
 
@@ -739,8 +743,8 @@ Retrieves conversations by page with optional filtering based off provided param
 
 ```typescript
 await client.conversations.list({
-    brandId: 101,
-    campaignId: 136,
+    brandId: "b_1234567890",
+    campaignId: "tf_1234567890",
     campaignType: "TOLL_FREE",
     pageIndex: 0,
     pageSize: 20,
@@ -810,7 +814,7 @@ Update the notes associated with a specific conversation.
 
 ```typescript
 await client.conversations.update({
-    id: 123,
+    id: "conv_1234567890",
     notes: "Follow-up completed. Customer satisfied with resolution.",
 });
 ```
@@ -847,6 +851,77 @@ await client.conversations.update({
 </dl>
 </details>
 
+<details><summary><code>client.conversations.<a href="/src/api/resources/conversations/client/Client.ts">listMessages</a>(id, { ...params }) -> Pinnacle.MessageList</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Retrieve a paginated and filtered list of messages for a specific conversation.
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.conversations.listMessages("id");
+```
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**id:** `string` — Unique identifier of the conversation. This identifier is a string that always begins with the prefix `conv_`, for example: `conv_1234567890`.
+
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**request:** `Pinnacle.ConversationsListMessagesRequest`
+
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `Conversations.RequestOptions`
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+</dd>
+</dl>
+</details>
+
 ## Messages
 
 <details><summary><code>client.messages.<a href="/src/api/resources/messages/client/Client.ts">get</a>(id) -> Pinnacle.Message</code></summary>
@@ -877,7 +952,7 @@ Retrieve a previously sent message.
 <dd>
 
 ```typescript
-await client.messages.get(1240);
+await client.messages.get("msg_1234567890");
 ```
 
 </dd>
@@ -893,7 +968,7 @@ await client.messages.get(1240);
 <dl>
 <dd>
 
-**id:** `number` — Unique identifier of the message.
+**id:** `string` — Unique identifier of the message. This identifier is a string that always begins with the prefix `msg_`, for example: `msg_1234567890`.
 
 </dd>
 </dl>
@@ -941,7 +1016,7 @@ Add or remove an emoji reaction to a previously sent message.
 
 ```typescript
 await client.messages.react({
-    messageId: 1410,
+    messageId: "msg_1234567890",
     options: {
         force: true,
     },
@@ -1199,6 +1274,235 @@ await client.phoneNumbers.get({
 </dl>
 </details>
 
+## RCS
+
+<details><summary><code>client.rcs.<a href="/src/api/resources/rcs/client/Client.ts">getCapabilities</a>({ ...params }) -> Pinnacle.RcsCapabilitiesResult</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Check RCS capabilities for one or more phone numbers.
+
+This endpoint allows you to verify which RCS features (cards, buttons, etc.) are supported
+on specific phone numbers before sending RCS messages to them.
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.rcs.getCapabilities({
+    phoneNumbers: ["+12345678901", "+19876543210"],
+});
+```
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `Pinnacle.RcsCapabilitiesQuery`
+
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `Rcs.RequestOptions`
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.rcs.<a href="/src/api/resources/rcs/client/Client.ts">whitelist</a>({ ...params }) -> Pinnacle.RcsWhitelistResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Whitelist a phone number for testing with your test RCS agent.
+
+## Overview
+
+During development and testing, RCS agents can only send messages to whitelisted phone numbers.
+Use this endpoint to add test devices to your agent's whitelist before sending test messages.
+
+## Verification Process
+
+After whitelisting a number, you'll need to complete verification:
+
+1. Check the test device for an "RBM Tester Management" request
+2. Accept the request on the device
+3. Enter the 4-digit verification code in the Pinnacle dashboard at:
+    ```
+    https://app.pinnacle.sh/dashboard/brands/{brandId}?campaignId={campaignId}&campaignType=RCS
+    ```
+
+> **Important Notes**
+>
+> - **Testing only:** This is only required for test agents. Production agents can message any RCS-enabled number
+> - **AT&T limitation:** Whitelisting may currently fail for AT&T numbers
+> - **Verification required:** The whitelist request isn't complete until you verify the device.
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.rcs.whitelist({
+    agentId: "agent_XXXXXXXXXXXX",
+    phoneNumber: "+12345678901",
+});
+```
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `Pinnacle.RcsWhitelistRequest`
+
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `Rcs.RequestOptions`
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.rcs.<a href="/src/api/resources/rcs/client/Client.ts">getLink</a>({ ...params }) -> Pinnacle.RcsLinkResult</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Generate a link for initiating an RCS conversation with your agent.
+
+Users can click these links to start conversations with your RCS agent directly
+from websites, emails, or other applications.
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.rcs.getLink({
+    agentId: "agent_XXXXXXXXXXXX",
+    testMode: false,
+    phoneNumber: "+12345678901",
+    body: "Hello, I need help with my order",
+});
+```
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `Pinnacle.RcsLinkRequest`
+
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `Rcs.RequestOptions`
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+</dd>
+</dl>
+</details>
+
 ## Webhooks
 
 <details><summary><code>client.webhooks.<a href="/src/api/resources/webhooks/client/Client.ts">get</a>({ ...params }) -> Pinnacle.WebhookResult</code></summary>
@@ -1302,8 +1606,8 @@ Generate campaign details based off existing campaign and the brand it's connect
 
 ```typescript
 await client.campaigns.dlc.autofill({
-    additionalInfo: "Please autofill missing DLC campaign fields using my brand profile",
-    campaignId: 161,
+    additionalInfo: "Please autofill missing campaign fields using my brand profile",
+    campaignId: "dlc_1234567890",
 });
 ```
 
@@ -1351,7 +1655,7 @@ await client.campaigns.dlc.autofill({
 <dl>
 <dd>
 
-Retrieve DLC campaign.
+Retrieve 10DLC campaign.
 
 </dd>
 </dl>
@@ -1367,7 +1671,7 @@ Retrieve DLC campaign.
 <dd>
 
 ```typescript
-await client.campaigns.dlc.get(28);
+await client.campaigns.dlc.get("dlc_1234567890");
 ```
 
 </dd>
@@ -1383,7 +1687,7 @@ await client.campaigns.dlc.get(28);
 <dl>
 <dd>
 
-**campaignId:** `number` — Unique identifier of the DLC campaign.
+**campaignId:** `string` — Unique identifier of the 10DLC campaign. This identifier is a string that always begins with the prefix `dlc_`, for example: `dlc_1234567890`.
 
 </dd>
 </dl>
@@ -1414,7 +1718,7 @@ await client.campaigns.dlc.get(28);
 <dl>
 <dd>
 
-Submit your DLC campaign for approval and activation with carriers.
+Submit your 10DLC campaign for approval and activation with carriers.
 
 </dd>
 </dl>
@@ -1430,7 +1734,7 @@ Submit your DLC campaign for approval and activation with carriers.
 <dd>
 
 ```typescript
-await client.campaigns.dlc.submit(161);
+await client.campaigns.dlc.submit("dlc_1234567890");
 ```
 
 </dd>
@@ -1446,7 +1750,10 @@ await client.campaigns.dlc.submit(161);
 <dl>
 <dd>
 
-**campaignId:** `number` — Unique identifier of the DLC campaign to submit.
+**campaignId:** `string`
+
+Unique identifier of the 10DLC campaign to submit.
+<br><br> This identifier is a string that always begins with the prefix `dlc_`, for example: `dlc_1234567890`.
 
 </dd>
 </dl>
@@ -1477,7 +1784,7 @@ await client.campaigns.dlc.submit(161);
 <dl>
 <dd>
 
-Create a new DLC campaign or updates an existing one. <br>
+Create a new 10DLC campaign or updates an existing one. <br>
 
 Omit campaignId to create a campaign.
 
@@ -1497,19 +1804,19 @@ Omit campaignId to create a campaign.
 ```typescript
 await client.campaigns.dlc.upsert({
     autoRenew: true,
-    brand: 1,
-    campaignId: 161,
+    brand: "b_1234567890",
+    campaignId: "dlc_1234567890",
     keywords: {
         HELP: {
             message: "Reply HELP for assistance, STOP to opt-out",
             values: ["HELP", "INFO", "SUPPORT"],
         },
         OPT_IN: {
-            message: "Welcome! You're now subscribed to Pinnacle.",
+            message: "Welcome. You are now subscribed to Pinnacle.",
             values: ["JOIN", "START", "SUBSCRIBE"],
         },
         OPT_OUT: {
-            message: "You've been unsubscribed. Reply START to rejoin.",
+            message: "You have been unsubscribed. Reply START to rejoin.",
             values: ["STOP", "QUIT", "UNSUBSCRIBE"],
         },
     },
@@ -1579,7 +1886,7 @@ await client.campaigns.dlc.upsert({
 <dl>
 <dd>
 
-Validate your DLC campaign configuration against carrier requirements and compliance rules.
+Validate your 10DLC campaign configuration against carrier requirements and compliance rules.
 
 </dd>
 </dl>
@@ -1597,7 +1904,7 @@ Validate your DLC campaign configuration against carrier requirements and compli
 ```typescript
 await client.campaigns.dlc.validate({
     additionalInfo: "Please validate this DLC campaign for 10DLC compliance",
-    campaignId: 161,
+    campaignId: "dlc_1234567890",
 });
 ```
 
@@ -1664,8 +1971,8 @@ Generate campaign details based off existing campaign and the brand it's connect
 
 ```typescript
 await client.campaigns.tollFree.autofill({
-    additionalInfo: "Please autofill missing DLC campaign fields using my brand profile",
-    campaignId: 161,
+    additionalInfo: "Please autofill missing campaign fields using my brand profile",
+    campaignId: "dlc_1234567890",
 });
 ```
 
@@ -1729,7 +2036,7 @@ Retrieve Toll-Free campaign.
 <dd>
 
 ```typescript
-await client.campaigns.tollFree.get(161);
+await client.campaigns.tollFree.get("tf_1234567890");
 ```
 
 </dd>
@@ -1745,7 +2052,7 @@ await client.campaigns.tollFree.get(161);
 <dl>
 <dd>
 
-**campaignId:** `number` — Unique identifier of toll-free campaign.
+**campaignId:** `string` — Unique identifier of toll-free campaign. Must begin with the prefix `tf_`.
 
 </dd>
 </dl>
@@ -1792,7 +2099,7 @@ Submit your toll-free campaign for approval and activation with carriers.
 <dd>
 
 ```typescript
-await client.campaigns.tollFree.submit(161);
+await client.campaigns.tollFree.submit("tf_1234567890");
 ```
 
 </dd>
@@ -1808,7 +2115,7 @@ await client.campaigns.tollFree.submit(161);
 <dl>
 <dd>
 
-**campaignId:** `number` — Unique identifier of the toll-free campaign to submit.
+**campaignId:** `string` — Unique identifier of the toll-free campaign to submit. Must begin with the prefix `tf_`.
 
 </dd>
 </dl>
@@ -1858,8 +2165,8 @@ Omit campaignId to create a campaign.
 
 ```typescript
 await client.campaigns.tollFree.upsert({
-    brand: 2,
-    campaignId: 161,
+    brand: "b_1234567890",
+    campaignId: "tf_1234567890",
     monthlyVolume: "1,000",
     name: "Pinnacle",
     optIn: {
@@ -1867,7 +2174,7 @@ await client.campaigns.tollFree.upsert({
         url: "https://www.pinnacle.sh/",
         workflowDescription: "Visit https://www.pinnacle.sh/",
     },
-    productionMessageContent: "Join Pinnacle's workshop tomorrow and send your first RCS!",
+    productionMessageContent: "Join the Pinnacle workshop tomorrow and send your first RCS!",
     useCase: {
         summary: "Alerts clients about any Pinnacle hosted workshops.",
         value: "WORKSHOP_ALERTS",
@@ -1937,7 +2244,7 @@ Validate your toll-free campaign configuration against carrier requirements and
 ```typescript
 await client.campaigns.tollFree.validate({
     additionalInfo: "Please validate this DLC campaign for 10DLC compliance",
-    campaignId: 161,
+    campaignId: "dlc_1234567890",
 });
 ```
 
@@ -2004,8 +2311,8 @@ Generate campaign details based off existing campaign and the brand it's connect
 
 ```typescript
 await client.campaigns.rcs.autofill({
-    additionalInfo: "Please autofill missing DLC campaign fields using my brand profile",
-    campaignId: 161,
+    additionalInfo: "Please autofill missing campaign fields using my brand profile",
+    campaignId: "dlc_1234567890",
 });
 ```
 
@@ -2069,7 +2376,7 @@ Retrieve RCS campaign.
 <dd>
 
 ```typescript
-await client.campaigns.rcs.get(161);
+await client.campaigns.rcs.get("rcs_1234567890");
 ```
 
 </dd>
@@ -2085,7 +2392,7 @@ await client.campaigns.rcs.get(161);
 <dl>
 <dd>
 
-**campaignId:** `number` — Unique identifier of the RCS campaign.
+**campaignId:** `string` — Unique identifier of the RCS campaign. Must begin with the prefix `rcs_`.
 
 </dd>
 </dl>
@@ -2132,7 +2439,7 @@ Submit your RCS campaign for approval and activation with carriers.
 <dd>
 
 ```typescript
-await client.campaigns.rcs.submit(161);
+await client.campaigns.rcs.submit("rcs_1234567890");
 ```
 
 </dd>
@@ -2148,7 +2455,7 @@ await client.campaigns.rcs.submit(161);
 <dl>
 <dd>
 
-**campaignId:** `number` — Unique identifier of the RCS campaign to retrieve.
+**campaignId:** `string` — Unique identifier of the RCS campaign to retrieve. Must begin with the prefix `rcs_`.
 
 </dd>
 </dl>
@@ -2224,7 +2531,9 @@ await client.campaigns.rcs.upsert({
             },
         ],
     },
-    brand: 2,
+    brandVerificationUrl: "https://www.pinnacle.sh/articles-of-incorporation.pdf",
+    brand: "b_1234567890",
+    campaignId: "rcs_1234567890",
     expectedAgentResponses: [
         "Here are the things I can help you with.",
         "I can assist you with booking an appointment, or you may choose to book manually.",
@@ -2312,7 +2621,7 @@ Validate your RCS campaign configuration against carrier requirements and compli
 ```typescript
 await client.campaigns.rcs.validate({
     additionalInfo: "Please validate this DLC campaign for 10DLC compliance",
-    campaignId: 161,
+    campaignId: "dlc_1234567890",
 });
 ```
 
@@ -2685,7 +2994,7 @@ await client.messages.rcs.send({
 <dl>
 <dd>
 
-**request:** `Pinnacle.Rcs`
+**request:** `Pinnacle.RichMessage`
 
 </dd>
 </dl>
@@ -2807,7 +3116,8 @@ Connect a webhook to your phone number to receive real-time notifications for in
 
 ```typescript
 await client.phoneNumbers.webhook.attach("%2B14155551234", {
-    webhookId: 1,
+    webhookId: "wh_1234567890",
+    event: "MESSAGE.STATUS",
 });
 ```
 
@@ -2828,7 +3138,7 @@ await client.phoneNumbers.webhook.attach("%2B14155551234", {
 
 The phone number you want to attach the webhook to in E.164 format. Make sure it is url encoded (i.e. replace the leading + with %2B). <br>
 
-Must be a phone number that you own and have already [purchased](./buy) through the API.
+Must be a phone number that you own and have already [purchased](./buy) through the API. A phone number can have multiple webhooks attached to it.
 
 </dd>
 </dl>
@@ -2885,7 +3195,7 @@ The webhook configuration itself remains intact and available for use with other
 <dd>
 
 ```typescript
-await client.phoneNumbers.webhook.detach("+14155551234", 123);
+await client.phoneNumbers.webhook.detach("+14155551234", "wh_1234567890");
 ```
 
 </dd>
@@ -2913,11 +3223,11 @@ Must be a phone number that you own and currently has the specified webhook atta
 <dl>
 <dd>
 
-**webhookId:** `number`
+**webhookId:** `string`
 
 The unique identifier of the webhook you want to detach from the phone number. <br>
 
-This must be a valid webhook ID that is currently attached to the specified phone number.
+This must be a valid webhook ID that is currently attached to the specified phone number. This identifier is a string that always begins with the prefix `wh_`, for example: `wh_1234567890`.
 
 </dd>
 </dl>
@@ -2950,7 +3260,7 @@ This must be a valid webhook ID that is currently attached to the specified phon
 <dl>
 <dd>
 
-Link a phone number to a specific campaign.
+Link a phone number to a specific campaign. Phone numbers must be linked to a campaign to send messages.
 
 </dd>
 </dl>
@@ -2969,7 +3279,7 @@ Link a phone number to a specific campaign.
 await client.phoneNumbers.campaign.attach({
     phones: ["+14155550123", "+14155559876", "+14155550111"],
     campaignType: "TOLL_FREE",
-    campaignId: 101,
+    campaignId: "tf_1234567890",
 });
 ```
 
@@ -3100,7 +3410,7 @@ Retrieve a brand's status.
 <dd>
 
 ```typescript
-await client.status.get.brand(28);
+await client.status.get.brand("b_1234567890");
 ```
 
 </dd>
@@ -3116,7 +3426,7 @@ await client.status.get.brand(28);
 <dl>
 <dd>
 
-**brandId:** `number` — ID of the brand.
+**brandId:** `string` — The unique identifier of the brand you want to retrieve the status for. This identifier is a string that always begins with the prefix `b_`, for example: `b_1234567890`.
 
 </dd>
 </dl>
@@ -3163,7 +3473,7 @@ Retrieve a toll-free campaign's status.
 <dd>
 
 ```typescript
-await client.status.get.tollFree(28);
+await client.status.get.tollFree("tf_1234567890");
 ```
 
 </dd>
@@ -3179,7 +3489,7 @@ await client.status.get.tollFree(28);
 <dl>
 <dd>
 
-**campaignId:** `number` — ID of the toll-free campaign.
+**campaignId:** `string` — The unique identifier of the toll-free campaign you want to retrieve the status for. This identifier is a string that always begins with the prefix `tf_`, for example: `tf_1234567890`.
 
 </dd>
 </dl>
@@ -3210,7 +3520,7 @@ await client.status.get.tollFree(28);
 <dl>
 <dd>
 
-Retrieve a DLC campaign's status.
+Retrieve a 10DLC campaign's status.
 
 </dd>
 </dl>
@@ -3226,7 +3536,7 @@ Retrieve a DLC campaign's status.
 <dd>
 
 ```typescript
-await client.status.get.dlc(28);
+await client.status.get.dlc("dlc_1234567890");
 ```
 
 </dd>
@@ -3242,7 +3552,7 @@ await client.status.get.dlc(28);
 <dl>
 <dd>
 
-**campaignId:** `number` — ID of the DLC campaign.
+**campaignId:** `string` — The unique identifier of the 10DLC campaign you want to retrieve the status for. This identifier is a string that always begins with the prefix `dlc_`, for example: `dlc_1234567890`.
 
 </dd>
 </dl>
@@ -3289,7 +3599,7 @@ Retrieve a RCS campaign's status.
 <dd>
 
 ```typescript
-await client.status.get.rcs(28);
+await client.status.get.rcs("rcs_1234567890");
 ```
 
 </dd>
@@ -3305,7 +3615,7 @@ await client.status.get.rcs(28);
 <dl>
 <dd>
 
-**campaignId:** `number` — ID of the campaign.
+**campaignId:** `string` — The unique identifier of the RCS campaign you want to retrieve the status for. This identifier is a string that always begins with the prefix `rcs_`, for example: `rcs_1234567890`.
 
 </dd>
 </dl>
@@ -3538,7 +3848,7 @@ See the response of [Create Shortened URL](./create-url) for more information.
 <dl>
 <dd>
 
-Update the destination or configuration of an existing shortened URL.
+Update the destination or expiration date of an existing shortened URL. Expiring links cannot be updated into a permalink.
 
 </dd>
 </dl>
@@ -3677,6 +3987,79 @@ await client.tools.file.upload({
 </dl>
 </details>
 
+<details><summary><code>client.tools.file.<a href="/src/api/resources/tools/resources/file/client/Client.ts">refresh</a>({ ...params }) -> Pinnacle.RefreshedFile[]</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Refresh expiring presigned URLs for Pinnacle-hosted files to extend their access time.
+
+<Callout type="info">
+  This only works for presigned download URLs. At this moment, you cannot refresh a presigned upload URL, generate a new one instead.
+</Callout>
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.tools.file.refresh({
+    urls: [
+        "https://server.trypinnacle.app/storage/v1/object/sign/vault/3/test.jpg?token=oldtoken",
+        "https://server.trypinnacle.app/storage/v1/object/sign/vault/3/document.pdf?token=oldtoken2",
+        "invalid/url",
+        "https://google.com",
+    ],
+});
+```
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `Pinnacle.tools.RefreshFileParams`
+
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `File_.RequestOptions`
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+</dd>
+</dl>
+</details>
+
 ## Tools ContactCard
 
 <details><summary><code>client.tools.contactCard.<a href="/src/api/resources/tools/resources/contactCard/client/Client.ts">get</a>({ ...params }) -> Pinnacle.VCardData</code></summary>
@@ -3691,7 +4074,7 @@ await client.tools.file.upload({
 <dl>
 <dd>
 
-Retrieve contact information as a vCard and get a presigned URL to download the file.
+Retrieve contact information as a vCard and get a presigned URL to download the file. Contact cards can be sent [via MMS](/api-reference/messages/send-mms) as a media file.
 
 </dd>
 </dl>
@@ -3708,7 +4091,7 @@ Retrieve contact information as a vCard and get a presigned URL to download the
 
 ```typescript
 await client.tools.contactCard.get({
-    id: 33,
+    id: "cc_1234567890",
 });
 ```
 
@@ -3756,7 +4139,7 @@ await client.tools.contactCard.get({
 <dl>
 <dd>
 
-Create a new contact card or updates an existing one with full vCard data.
+Create a new contact card or updates an existing one with full vCard data. Contact cards can be sent [via MMS](/api-reference/messages/send-mms) as a media file.
 
 </dd>
 </dl>
@@ -3773,7 +4156,7 @@ Create a new contact card or updates an existing one with full vCard data.
 
 ```typescript
 await client.tools.contactCard.upsert({
-    id: 34,
+    id: "cc_1234567890",
     formattedName: "Jane Smith",
     name: {
         familyName: "Smith",