loops_sdk 2.3.0 → 2.6.0

data/README.md

@@ -120,28 +120,54 @@ You can use custom contact properties in API calls. Please make sure to [add cus
 - [Transactional.update()](#transactionalupdate)
 - [Transactional.ensure_draft()](#transactionalensure_draft)
 - [Transactional.publish()](#transactionalpublish)
+- [Transactional.metrics()](#transactionalmetrics)
 - [Transactional.send()](#transactionalsend)
 - [DedicatedSendingIps.list()](#dedicatedsendingipslist)
 - [Themes.list()](#themeslist)
 - [Themes.get()](#themesget)
+- [Themes.create()](#themescreate)
+- [Themes.update()](#themesupdate)
 - [Components.list()](#componentslist)
 - [Components.get()](#componentsget)
+- [Components.create()](#componentscreate)
+- [Components.update()](#componentsupdate)
 - [Campaigns.list()](#campaignslist)
 - [Campaigns.create()](#campaignscreate)
 - [Campaigns.get()](#campaignsget)
 - [Campaigns.update()](#campaignsupdate)
+- [Campaigns.metrics()](#campaignsmetrics)
 - [CampaignGroups.list()](#campaigngroupslist)
 - [CampaignGroups.create()](#campaigngroupscreate)
 - [CampaignGroups.get()](#campaigngroupsget)
 - [CampaignGroups.update()](#campaigngroupsupdate)
+- [WorkflowGroups.list()](#workflowgroupslist)
+- [WorkflowGroups.create()](#workflowgroupscreate)
+- [WorkflowGroups.get()](#workflowgroupsget)
+- [WorkflowGroups.update()](#workflowgroupsupdate)
 - [AudienceSegments.list()](#audiencesegmentslist)
 - [AudienceSegments.get()](#audiencesegmentsget)
+- [AudienceSegments.create()](#audiencesegmentscreate)
 - [Workflows.list()](#workflowslist)
+- [Workflows.create()](#workflowscreate)
 - [Workflows.get()](#workflowsget)
+- [Workflows.update()](#workflowsupdate)
+- [Workflows.delete()](#workflowsdelete)
+- [Workflows.change_mailing_list()](#workflowschange_mailing_list)
 - [Workflows.get_node()](#workflowsget_node)
+- [Workflows.get_node_metrics()](#workflowsget_node_metrics)
+- [Workflows.create_node()](#workflowscreate_node)
+- [Workflows.update_node()](#workflowsupdate_node)
+- [Workflows.delete_node()](#workflowsdelete_node)
+- [Workflows.add_branch()](#workflowsadd_branch)
+- [Workflows.reroute_node()](#workflowsreroute_node)
+- [Workflows.delete_node_recursive()](#workflowsdelete_node_recursive)
+- [EventPatterns.list()](#eventpatternslist)
+- [EventPatterns.get()](#eventpatternsget)
+- [EventPatterns.get_by_name()](#eventpatternsget_by_name)
 - [EmailMessages.get()](#emailmessagesget)
 - [EmailMessages.update()](#emailmessagesupdate)
 - [EmailMessages.preview()](#emailmessagespreview)
+- [EmailMessages.run_guardian()](#emailmessagesrun_guardian)
 - [TransactionalGroups.list()](#transactionalgroupslist)
 - [TransactionalGroups.create()](#transactionalgroupscreate)
 - [TransactionalGroups.get()](#transactionalgroupsget)
@@ -851,6 +877,21 @@ Get a single transactional email by ID.
 response = LoopsSdk::Transactional.get(transactional_id: "clfq6dinn000yl70fgwwyp82l")
 ```
 
+#### Response
+
+```json
+{
+  "id": "cll42l54f20i1la0lfooe3z12",
+  "name": "Sign up confirmation",
+  "draftEmailMessageId": "cle5f7g9h1i3j5k7l9m1n3p5",
+  "publishedEmailMessageId": "cle5f7g9h1i3j5k7l9m1n3p5",
+  "transactionalGroupId": "clg7n5p3q1r9s7t5u3v1w9y7",
+  "createdAt": "2025-06-29T07:47:39.370Z",
+  "updatedAt": "2025-06-29T07:47:39.370Z",
+  "dataVariables": ["confirmationUrl"]
+}
+```
+
 ---
 
 ### Transactional.update()
@@ -878,6 +919,21 @@ response = LoopsSdk::Transactional.update(
 )
 ```
 
+#### Response
+
+```json
+{
+  "id": "cll42l54f20i1la0lfooe3z12",
+  "name": "Updated name",
+  "draftEmailMessageId": "cle5f7g9h1i3j5k7l9m1n3p5",
+  "publishedEmailMessageId": "cle5f7g9h1i3j5k7l9m1n3p5",
+  "transactionalGroupId": "clg7n5p3q1r9s7t5u3v1w9y7",
+  "createdAt": "2025-06-29T07:47:39.370Z",
+  "updatedAt": "2025-06-29T07:47:39.370Z",
+  "dataVariables": ["confirmationUrl"]
+}
+```
+
 ---
 
 ### Transactional.ensure_draft()
@@ -898,6 +954,22 @@ Ensure a transactional email has a draft email message. If a draft already exist
 response = LoopsSdk::Transactional.ensure_draft(transactional_id: "clfq6dinn000yl70fgwwyp82l")
 ```
 
+#### Response
+
+```json
+{
+  "id": "cll42l54f20i1la0lfooe3z12",
+  "name": "Sign up confirmation",
+  "draftEmailMessageId": "cle5f7g9h1i3j5k7l9m1n3p5",
+  "draftEmailMessageContentRevisionId": "clrev1s10n2i3d4e5f6g7h8",
+  "publishedEmailMessageId": null,
+  "transactionalGroupId": "clg7n5p3q1r9s7t5u3v1w9y7",
+  "createdAt": "2025-06-29T07:47:39.370Z",
+  "updatedAt": "2025-06-29T07:47:39.370Z",
+  "dataVariables": []
+}
+```
+
 ---
 
 ### Transactional.publish()
@@ -918,6 +990,53 @@ Publish a transactional email's current draft. The draft becomes the published v
 response = LoopsSdk::Transactional.publish(transactional_id: "clfq6dinn000yl70fgwwyp82l")
 ```
 
+#### Response
+
+```json
+{
+  "id": "cll42l54f20i1la0lfooe3z12",
+  "name": "Sign up confirmation",
+  "draftEmailMessageId": null,
+  "publishedEmailMessageId": "cle5f7g9h1i3j5k7l9m1n3p5",
+  "transactionalGroupId": "clg7n5p3q1r9s7t5u3v1w9y7",
+  "createdAt": "2025-06-29T07:47:39.370Z",
+  "updatedAt": "2025-06-29T07:47:39.370Z",
+  "dataVariables": []
+}
+```
+
+---
+
+### Transactional.metrics()
+
+Get all-time delivery metrics for a transactional email.
+
+[API Reference](https://loops.so/docs/api-reference/get-transactional-email-metrics)
+
+#### Parameters
+
+| Name               | Type   | Required | Notes |
+| ------------------ | ------ | -------- | ----- |
+| `transactional_id` | string | Yes      |       |
+
+#### Example
+
+```ruby
+response = LoopsSdk::Transactional.metrics(transactional_id: "clfq6dinn000yl70fgwwyp82l")
+```
+
+#### Response
+
+```json
+{
+  "sends": 4210,
+  "deliveries": 4175,
+  "spamReports": 1,
+  "hardBounces": 9,
+  "softBounces": 13
+}
+```
+
 ---
 
 ### Transactional.send()
@@ -1060,6 +1179,31 @@ response = LoopsSdk::Themes.list
 response = LoopsSdk::Themes.list(perPage: 15, cursor: "cursor_value")
 ```
 
+#### Response
+
+```json
+{
+  "pagination": {
+    "totalResults": 1,
+    "returnedResults": 1,
+    "perPage": 20,
+    "totalPages": 1,
+    "nextCursor": null,
+    "nextPage": null
+  },
+  "data": [
+    {
+      "id": "clo1z5q7s004yl70y3z4a5b6c",
+      "name": "Default",
+      "styles": { "backgroundColor": "#ffffff" },
+      "isDefault": true,
+      "createdAt": "2025-01-01T00:00:00.000Z",
+      "updatedAt": "2025-01-01T00:00:00.000Z"
+    }
+  ]
+}
+```
+
 ---
 
 ### Themes.get()
@@ -1080,6 +1224,100 @@ Get a single theme by ID.
 response = LoopsSdk::Themes.get(theme_id: "clo5p8q0r0132ntx6flkunw89")
 ```
 
+#### Response
+
+```json
+{
+  "id": "clo1z5q7s004yl70y3z4a5b6c",
+  "name": "Default",
+  "styles": { "backgroundColor": "#ffffff" },
+  "isDefault": true,
+  "createdAt": "2025-01-01T00:00:00.000Z",
+  "updatedAt": "2025-01-01T00:00:00.000Z"
+}
+```
+
+---
+
+### Themes.create()
+
+Create a new email theme.
+
+[API Reference](https://loops.so/docs/api-reference/create-theme)
+
+#### Parameters
+
+| Name     | Type   | Required | Notes                                                                                              |
+| -------- | ------ | -------- | -------------------------------------------------------------------------------------------------- |
+| `name`   | string | Yes      |                                                                                                    |
+| `styles` | object | No       | Style attributes matching LMX `<Style />` tag attribute names. See the API reference for the full list. |
+
+#### Example
+
+```ruby
+response = LoopsSdk::Themes.create(
+  name: "Dark mode",
+  styles: { backgroundColor: "#111827", bodyColor: "#1f2937" }
+)
+```
+
+#### Response
+
+```json
+{
+  "id": "clt3u5v7w9x1y3z5a7b9c1d3",
+  "name": "Dark mode",
+  "styles": {
+    "backgroundColor": "#111827",
+    "bodyColor": "#1f2937"
+  },
+  "isDefault": false,
+  "createdAt": "2025-06-29T07:47:39.370Z",
+  "updatedAt": "2025-06-29T07:47:39.370Z"
+}
+```
+
+---
+
+### Themes.update()
+
+Update a theme's name and/or styles. Style changes cascade to emails using the theme.
+
+[API Reference](https://loops.so/docs/api-reference/update-theme)
+
+#### Parameters
+
+| Name       | Type   | Required | Notes |
+| ---------- | ------ | -------- | ----- |
+| `theme_id` | string | Yes      |       |
+| `name`     | string | No       |       |
+| `styles`   | object | No       |       |
+
+At least one of `name` or `styles` must be provided.
+
+#### Example
+
+```ruby
+response = LoopsSdk::Themes.update(
+  theme_id: "clo5p8q0r0132ntx6flkunw89",
+  name: "Updated theme"
+)
+```
+
+#### Response
+
+```json
+{
+  "id": "clt3u5v7w9x1y3z5a7b9c1d3",
+  "name": "Updated theme",
+  "styles": { "backgroundColor": "#111827" },
+  "isDefault": false,
+  "createdAt": "2025-06-29T07:47:39.370Z",
+  "updatedAt": "2025-06-29T07:47:39.370Z",
+  "affectedEmailCount": 3
+}
+```
+
 ---
 
 ### Components.list()
@@ -1101,6 +1339,28 @@ List email components.
 response = LoopsSdk::Components.list
 ```
 
+#### Response
+
+```json
+{
+  "pagination": {
+    "totalResults": 1,
+    "returnedResults": 1,
+    "perPage": 20,
+    "totalPages": 1,
+    "nextCursor": null,
+    "nextPage": null
+  },
+  "data": [
+    {
+      "id": "clp2a6r8t005yl70d7e8f9g0h",
+      "name": "Header",
+      "lmx": "<Paragraph>Welcome to Acme</Paragraph>"
+    }
+  ]
+}
+```
+
 ---
 
 ### Components.get()
@@ -1121,6 +1381,88 @@ Get a single component by ID.
 response = LoopsSdk::Components.get(component_id: "clp6q9r1s0154ouy7gmlovx90")
 ```
 
+#### Response
+
+```json
+{
+  "id": "clp2a6r8t005yl70d7e8f9g0h",
+  "name": "Header",
+  "lmx": "<Paragraph>Welcome to Acme</Paragraph>"
+}
+```
+
+---
+
+### Components.create()
+
+Create a new email component from an LMX body.
+
+[API Reference](https://loops.so/docs/api-reference/create-component)
+
+#### Parameters
+
+| Name   | Type   | Required | Notes                            |
+| ------ | ------ | -------- | -------------------------------- |
+| `name` | string | Yes      |                                  |
+| `lmx`  | string | Yes      | The component body as LMX.       |
+
+#### Example
+
+```ruby
+response = LoopsSdk::Components.create(
+  name: "Header",
+  lmx: "<Paragraph>Welcome to Acme</Paragraph>"
+)
+```
+
+#### Response
+
+```json
+{
+  "id": "clp2a6r8t005yl70d7e8f9g0h",
+  "name": "Header",
+  "lmx": "<Paragraph>Welcome to Acme</Paragraph>"
+}
+```
+
+---
+
+### Components.update()
+
+Update a component's name and/or LMX body. Body changes cascade to emails using the component.
+
+[API Reference](https://loops.so/docs/api-reference/update-component)
+
+#### Parameters
+
+| Name           | Type   | Required | Notes |
+| -------------- | ------ | -------- | ----- |
+| `component_id` | string | Yes      |       |
+| `name`         | string | No       |       |
+| `lmx`          | string | No       |       |
+
+At least one of `name` or `lmx` must be provided.
+
+#### Example
+
+```ruby
+response = LoopsSdk::Components.update(
+  component_id: "clp6q9r1s0154ouy7gmlovx90",
+  name: "Updated Header"
+)
+```
+
+#### Response
+
+```json
+{
+  "id": "clp2a6r8t005yl70d7e8f9g0h",
+  "name": "Updated Header",
+  "lmx": "<Paragraph>Welcome to Acme</Paragraph>",
+  "affectedEmailCount": 2
+}
+```
+
 ---
 
 ### Campaigns.list()
@@ -1142,6 +1484,36 @@ List campaigns.
 response = LoopsSdk::Campaigns.list
 ```
 
+#### Response
+
+```json
+{
+  "pagination": {
+    "totalResults": 1,
+    "returnedResults": 1,
+    "perPage": 20,
+    "totalPages": 1,
+    "nextCursor": null,
+    "nextPage": null
+  },
+  "data": [
+    {
+      "id": "cln0y4p6r003yl70i1j2k3l4m",
+      "emailMessageId": "clm9x3o5q002yl70a8b3c4d5e",
+      "name": "Spring announcement",
+      "status": "Draft",
+      "createdAt": "2025-01-01T00:00:00.000Z",
+      "updatedAt": "2025-01-01T00:00:00.000Z",
+      "campaignGroupId": null,
+      "mailingListId": null,
+      "audienceSegmentId": null,
+      "audienceFilter": null,
+      "scheduling": { "method": "now", "timestamp": null }
+    }
+  ]
+}
+```
+
 ---
 
 ### Campaigns.create()
@@ -1173,6 +1545,25 @@ response = LoopsSdk::Campaigns.create(
 )
 ```
 
+#### Response
+
+```json
+{
+  "id": "cln0y4p6r003yl70i1j2k3l4m",
+  "name": "Spring announcement",
+  "status": "Draft",
+  "createdAt": "2025-01-01T00:00:00.000Z",
+  "updatedAt": "2025-01-01T00:00:00.000Z",
+  "emailMessageId": "clm9x3o5q002yl70a8b3c4d5e",
+  "emailMessageContentRevisionId": "clv8g2x4z012yl70n5o6p7q8r",
+  "campaignGroupId": null,
+  "mailingListId": null,
+  "audienceSegmentId": null,
+  "audienceFilter": null,
+  "scheduling": { "method": "now", "timestamp": null }
+}
+```
+
 ---
 
 ### Campaigns.get()
@@ -1193,6 +1584,24 @@ Get a single campaign by ID.
 response = LoopsSdk::Campaigns.get(campaign_id: "cln4o7p9q0110msw5ekjtmv78")
 ```
 
+#### Response
+
+```json
+{
+  "id": "cln0y4p6r003yl70i1j2k3l4m",
+  "name": "Spring announcement",
+  "status": "Draft",
+  "createdAt": "2025-01-01T00:00:00.000Z",
+  "updatedAt": "2025-01-01T00:00:00.000Z",
+  "emailMessageId": "clm9x3o5q002yl70a8b3c4d5e",
+  "campaignGroupId": null,
+  "mailingListId": null,
+  "audienceSegmentId": null,
+  "audienceFilter": null,
+  "scheduling": { "method": "now", "timestamp": null }
+}
+```
+
 ---
 
 ### Campaigns.update()
@@ -1224,6 +1633,58 @@ response = LoopsSdk::Campaigns.update(
 )
 ```
 
+#### Response
+
+```json
+{
+  "id": "cln0y4p6r003yl70i1j2k3l4m",
+  "name": "Updated campaign name",
+  "status": "Draft",
+  "createdAt": "2025-01-01T00:00:00.000Z",
+  "updatedAt": "2025-01-02T00:00:00.000Z",
+  "emailMessageId": "clm9x3o5q002yl70a8b3c4d5e",
+  "campaignGroupId": null,
+  "mailingListId": null,
+  "audienceSegmentId": null,
+  "audienceFilter": null,
+  "scheduling": { "method": "now", "timestamp": null }
+}
+```
+
+---
+
+### Campaigns.metrics()
+
+Get all-time engagement metrics for a campaign.
+
+[API Reference](https://loops.so/docs/api-reference/get-campaign-metrics)
+
+#### Parameters
+
+| Name          | Type   | Required | Notes |
+| ------------- | ------ | -------- | ----- |
+| `campaign_id` | string | Yes      |       |
+
+#### Example
+
+```ruby
+response = LoopsSdk::Campaigns.metrics(campaign_id: "cln4o7p9q0110msw5ekjtmv78")
+```
+
+#### Response
+
+```json
+{
+  "sends": 4210,
+  "opens": 1922,
+  "clicks": 301,
+  "unsubscribes": 12,
+  "spamReports": 1,
+  "hardBounces": 9,
+  "softBounces": 13
+}
+```
+
 ---
 
 ### EmailMessages.get()
@@ -1244,6 +1705,24 @@ Get an email message, including its LMX content.
 response = LoopsSdk::EmailMessages.get(email_message_id: "cly8k3m0n0044jpx2bghepq45")
 ```
 
+#### Response
+
+```json
+{
+  "id": "clm9x3o5q002yl70a8b3c4d5e",
+  "campaignId": "cln0y4p6r003yl70i1j2k3l4m",
+  "subject": "Hello",
+  "previewText": "Preview text",
+  "fromName": "Loops",
+  "fromEmail": "hello",
+  "replyToEmail": "",
+  "emailFormat": "styled",
+  "lmx": "<H1>...</H1><Paragraph>...</Paragraph>",
+  "contentRevisionId": "clv8g2x4z012yl70n5o6p7q8r",
+  "updatedAt": "2025-01-01T00:00:00.000Z"
+}
+```
+
 ---
 
 ### EmailMessages.update()
@@ -1282,15 +1761,33 @@ response = LoopsSdk::EmailMessages.update(
   preview_text: "See what's new",
   from_name: "Loops",
   from_email: "hello",
-  lmx: "<Email><Style /></Email>"
+  lmx: "<Style /><Paragraph>...</Paragraph>"
 )
 ```
 
----
-
-### EmailMessages.preview()
-
-Send a test preview of an email message to one or more addresses.
+#### Response
+
+```json
+{
+  "id": "clm9x3o5q002yl70a8b3c4d5e",
+  "campaignId": "cln0y4p6r003yl70i1j2k3l4m",
+  "subject": "Spring announcement",
+  "previewText": "See what's new",
+  "fromName": "Loops",
+  "fromEmail": "hello",
+  "replyToEmail": "",
+  "emailFormat": "styled",
+  "lmx": "<Style /><Paragraph>...</Paragraph>",
+  "contentRevisionId": "clv8g2x4z013yl70s9t0u1v2w",
+  "updatedAt": "2025-01-02T00:00:00.000Z"
+}
+```
+
+---
+
+### EmailMessages.preview()
+
+Send a test preview of an email message to one or more addresses.
 
 [API Reference](https://loops.so/docs/api-reference/preview-email-message)
 
@@ -1314,6 +1811,50 @@ response = LoopsSdk::EmailMessages.preview(
 )
 ```
 
+#### Response
+
+```json
+{
+  "id": "cle5f7g9h1i3j5k7l9m1n3p5"
+}
+```
+
+---
+
+### EmailMessages.run_guardian()
+
+Run Guardian content validation on an email message and return errors and warnings.
+
+[API Reference](https://loops.so/docs/api-reference/run-guardian-checks)
+
+#### Parameters
+
+| Name               | Type   | Required | Notes |
+| ------------------ | ------ | -------- | ----- |
+| `email_message_id` | string | Yes      |       |
+
+#### Example
+
+```ruby
+response = LoopsSdk::EmailMessages.run_guardian(email_message_id: "cly8k3m0n0044jpx2bghepq45")
+```
+
+#### Response
+
+```json
+{
+  "errors": [
+    {
+      "rule": "missingButtonHrefs",
+      "title": "Missing button link",
+      "description": "Buttons won't work without href value",
+      "items": [{ "label": "Click here" }]
+    }
+  ],
+  "warnings": []
+}
+```
+
 ---
 
 ### CampaignGroups.list()
@@ -1335,6 +1876,30 @@ List campaign groups.
 response = LoopsSdk::CampaignGroups.list
 ```
 
+#### Response
+
+```json
+{
+  "pagination": {
+    "totalResults": 1,
+    "returnedResults": 1,
+    "perPage": 20,
+    "totalPages": 1,
+    "nextCursor": null,
+    "nextPage": null
+  },
+  "data": [
+    {
+      "id": "clg7n5p3q1r9s7t5u3v1w9y7",
+      "name": "Newsletters",
+      "description": "Monthly product updates",
+      "createdAt": "2025-06-29T07:47:39.370Z",
+      "updatedAt": "2025-06-29T07:47:39.370Z"
+    }
+  ]
+}
+```
+
 ---
 
 ### CampaignGroups.create()
@@ -1356,6 +1921,18 @@ Create a campaign group.
 response = LoopsSdk::CampaignGroups.create(name: "Newsletters", description: "Monthly updates")
 ```
 
+#### Response
+
+```json
+{
+  "id": "clg7n5p3q1r9s7t5u3v1w9y7",
+  "name": "Newsletters",
+  "description": "Monthly updates",
+  "createdAt": "2025-06-29T07:47:39.370Z",
+  "updatedAt": "2025-06-29T07:47:39.370Z"
+}
+```
+
 ---
 
 ### CampaignGroups.get()
@@ -1376,6 +1953,18 @@ Get a campaign group by ID.
 response = LoopsSdk::CampaignGroups.get(campaign_group_id: "clq7r0s2t0176pvz8hnmpwy01")
 ```
 
+#### Response
+
+```json
+{
+  "id": "clg7n5p3q1r9s7t5u3v1w9y7",
+  "name": "Newsletters",
+  "description": "Monthly product updates",
+  "createdAt": "2025-06-29T07:47:39.370Z",
+  "updatedAt": "2025-06-29T07:47:39.370Z"
+}
+```
+
 ---
 
 ### CampaignGroups.update()
@@ -1403,13 +1992,25 @@ response = LoopsSdk::CampaignGroups.update(
 )
 ```
 
+#### Response
+
+```json
+{
+  "id": "clg7n5p3q1r9s7t5u3v1w9y7",
+  "name": "Updated name",
+  "description": "Monthly product updates",
+  "createdAt": "2025-06-29T07:47:39.370Z",
+  "updatedAt": "2025-06-29T07:47:39.370Z"
+}
+```
+
 ---
 
-### AudienceSegments.list()
+### WorkflowGroups.list()
 
-List audience segments.
+List workflow groups.
 
-[API Reference](https://loops.so/docs/api-reference/list-audience-segments)
+[API Reference](https://loops.so/docs/api-reference/list-workflow-groups)
 
 #### Parameters
 
@@ -1421,167 +2022,1265 @@ List audience segments.
 #### Example
 
 ```ruby
-response = LoopsSdk::AudienceSegments.list
+response = LoopsSdk::WorkflowGroups.list
+```
+
+#### Response
+
+```json
+{
+  "pagination": {
+    "totalResults": 1,
+    "returnedResults": 1,
+    "perPage": 20,
+    "totalPages": 1,
+    "nextCursor": null,
+    "nextPage": null
+  },
+  "data": [
+    {
+      "id": "clg7n5p3q1r9s7t5u3v1w9y7",
+      "name": "Onboarding",
+      "description": "Signup and activation flows",
+      "createdAt": "2025-06-29T07:47:39.370Z",
+      "updatedAt": "2025-06-29T07:47:39.370Z"
+    }
+  ]
+}
 ```
 
 ---
 
-### AudienceSegments.get()
+### WorkflowGroups.create()
 
-Get an audience segment by ID.
+Create a workflow group.
 
-[API Reference](https://loops.so/docs/api-reference/get-audience-segment)
+[API Reference](https://loops.so/docs/api-reference/create-workflow-group)
 
 #### Parameters
 
-| Name | Type   | Required | Notes |
-| ---- | ------ | -------- | ----- |
-| `audience_segment_id` | string | Yes      |       |
+| Name          | Type   | Required | Notes                                   |
+| ------------- | ------ | -------- | --------------------------------------- |
+| `name`        | string | Yes      | Cannot be the reserved name "Unsorted". |
+| `description` | string | No       | An optional description for the group.  |
 
 #### Example
 
 ```ruby
-response = LoopsSdk::AudienceSegments.get(audience_segment_id: "clr8s1t3u0198qw09iotqzx12")
+response = LoopsSdk::WorkflowGroups.create(name: "Onboarding", description: "Signup flows")
+```
+
+#### Response
+
+```json
+{
+  "id": "clg7n5p3q1r9s7t5u3v1w9y7",
+  "name": "Onboarding",
+  "description": "Signup flows",
+  "createdAt": "2025-06-29T07:47:39.370Z",
+  "updatedAt": "2025-06-29T07:47:39.370Z"
+}
 ```
 
 ---
 
-### Workflows.list()
+### WorkflowGroups.get()
 
-List workflows.
+Get a workflow group by ID.
 
-[API Reference](https://loops.so/docs/api-reference/list-workflows)
+[API Reference](https://loops.so/docs/api-reference/get-workflow-group)
 
 #### Parameters
 
-| Name      | Type    | Required | Notes                                                                                                                         |
-| --------- | ------- | -------- | ----------------------------------------------------------------------------------------------------------------------------- |
-| `perPage` | integer | No       | How many results to return per page. Must be between 10 and 50. Defaults to 20 if omitted.                                    |
-| `cursor`  | string  | No       | A cursor, to return a specific page of results. Cursors can be found from the `pagination.nextCursor` value in each response. |
+| Name                | Type   | Required | Notes |
+| ------------------- | ------ | -------- | ----- |
+| `workflow_group_id` | string | Yes      |       |
 
 #### Example
 
 ```ruby
-response = LoopsSdk::Workflows.list
+response = LoopsSdk::WorkflowGroups.get(workflow_group_id: "clw8x0y2z0300ycc1lrstvw78")
+```
+
+#### Response
+
+```json
+{
+  "id": "clg7n5p3q1r9s7t5u3v1w9y7",
+  "name": "Onboarding",
+  "description": "Signup and activation flows",
+  "createdAt": "2025-06-29T07:47:39.370Z",
+  "updatedAt": "2025-06-29T07:47:39.370Z"
+}
 ```
 
 ---
 
-### Workflows.get()
+### WorkflowGroups.update()
 
-Get a simplified workflow graph.
+Update a workflow group's name or description.
 
-[API Reference](https://loops.so/docs/api-reference/get-workflow)
+[API Reference](https://loops.so/docs/api-reference/update-workflow-group)
 
 #### Parameters
 
-| Name | Type   | Required | Notes |
-| ---- | ------ | -------- | ----- |
-| `workflow_id` | string | Yes      |       |
+| Name                | Type   | Required | Notes                                   |
+| ------------------- | ------ | -------- | --------------------------------------- |
+| `workflow_group_id` | string | Yes      |                                         |
+| `name`              | string | No       | Cannot be the reserved name "Unsorted". |
+| `description`       | string | No       |                                         |
+
+At least one field must be provided.
 
 #### Example
 
 ```ruby
-response = LoopsSdk::Workflows.get(workflow_id: "cls9t2u4v0210rx20jpuary23")
+response = LoopsSdk::WorkflowGroups.update(
+  workflow_group_id: "clw8x0y2z0300ycc1lrstvw78",
+  name: "Updated name"
+)
+```
+
+#### Response
+
+```json
+{
+  "id": "clg7n5p3q1r9s7t5u3v1w9y7",
+  "name": "Updated name",
+  "description": "Signup and activation flows",
+  "createdAt": "2025-06-29T07:47:39.370Z",
+  "updatedAt": "2025-06-29T07:47:39.370Z"
+}
 ```
 
 ---
 
-### Workflows.get_node()
+### AudienceSegments.list()
 
-Get detailed data for a single workflow node.
+List audience segments.
 
-[API Reference](https://loops.so/docs/api-reference/get-workflow-node)
+[API Reference](https://loops.so/docs/api-reference/list-audience-segments)
 
 #### Parameters
 
-| Name         | Type   | Required | Notes |
-| ------------ | ------ | -------- | ----- |
-| `workflow_id`| string | Yes      |       |
-| `node_id`    | string | Yes      |       |
+| Name      | Type    | Required | Notes                                                                                                                         |
+| --------- | ------- | -------- | ----------------------------------------------------------------------------------------------------------------------------- |
+| `perPage` | integer | No       | How many results to return per page. Must be between 10 and 50. Defaults to 20 if omitted.                                    |
+| `cursor`  | string  | No       | A cursor, to return a specific page of results. Cursors can be found from the `pagination.nextCursor` value in each response. |
 
 #### Example
 
 ```ruby
-response = LoopsSdk::Workflows.get_node(workflow_id: "cls9t2u4v0210rx20jpuary23", node_id: "clt0u3v5w0232sy31kqvbzs34")
+response = LoopsSdk::AudienceSegments.list
+```
+
+#### Response
+
+```json
+{
+  "pagination": {
+    "totalResults": 1,
+    "returnedResults": 1,
+    "perPage": 20,
+    "totalPages": 1,
+    "nextCursor": null,
+    "nextPage": null
+  },
+  "data": [
+    {
+      "id": "cls6e8g0i2k4m6o8q0s2u4w6",
+      "name": "Power users",
+      "description": "Contacts on the pro plan",
+      "createdAt": "2025-06-29T07:47:39.370Z",
+      "updatedAt": "2025-06-29T07:47:39.370Z",
+      "filter": {
+        "match": "all",
+        "conditions": [
+          { "type": "property", "key": "plan", "operator": "equals", "value": "pro" }
+        ]
+      }
+    }
+  ]
+}
 ```
 
 ---
 
-### TransactionalGroups.list()
+### AudienceSegments.get()
 
-List transactional groups.
+Get an audience segment by ID.
 
-[API Reference](https://loops.so/docs/api-reference/list-transactional-groups)
+[API Reference](https://loops.so/docs/api-reference/get-audience-segment)
 
 #### Parameters
 
-| Name      | Type    | Required | Notes                                                                                                                         |
-| --------- | ------- | -------- | ----------------------------------------------------------------------------------------------------------------------------- |
-| `perPage` | integer | No       | How many results to return per page. Must be between 10 and 50. Defaults to 20 if omitted.                                    |
-| `cursor`  | string  | No       | A cursor, to return a specific page of results. Cursors can be found from the `pagination.nextCursor` value in each response. |
+| Name | Type   | Required | Notes |
+| ---- | ------ | -------- | ----- |
+| `audience_segment_id` | string | Yes      |       |
 
 #### Example
 
 ```ruby
-response = LoopsSdk::TransactionalGroups.list
+response = LoopsSdk::AudienceSegments.get(audience_segment_id: "clr8s1t3u0198qw09iotqzx12")
+```
+
+#### Response
+
+```json
+{
+  "id": "cls6e8g0i2k4m6o8q0s2u4w6",
+  "name": "Power users",
+  "description": "Contacts on the pro plan",
+  "createdAt": "2025-06-29T07:47:39.370Z",
+  "updatedAt": "2025-06-29T07:47:39.370Z",
+  "filter": {
+    "match": "all",
+    "conditions": [
+      { "type": "property", "key": "plan", "operator": "equals", "value": "pro" }
+    ]
+  }
+}
 ```
 
 ---
 
-### TransactionalGroups.create()
+### AudienceSegments.create()
 
-Create a transactional group.
+Create a new audience segment.
 
-[API Reference](https://loops.so/docs/api-reference/create-transactional-group)
+[API Reference](https://loops.so/docs/api-reference/create-audience-segment)
 
 #### Parameters
 
-| Name          | Type   | Required | Notes                                   |
-| ------------- | ------ | -------- | --------------------------------------- |
-| `name`        | string | Yes      | Cannot be the reserved name "Unsorted". |
-| `description` | string | No       | An optional description for the group.  |
+| Name          | Type   | Required | Notes                                                                       |
+| ------------- | ------ | -------- | --------------------------------------------------------------------------- |
+| `name`        | string | Yes      | Must be unique within the team.                                             |
+| `filter`      | object | Yes      | JSON tree of audience conditions with `match` and `conditions`. See the [API reference](https://loops.so/docs/api-reference/create-audience-segment#body-filter). |
+| `description` | string | No       |                                                                             |
 
 #### Example
 
 ```ruby
-response = LoopsSdk::TransactionalGroups.create(name: "Account emails")
+response = LoopsSdk::AudienceSegments.create(
+  name: "Power users",
+  filter: {
+    match: "all",
+    conditions: [
+      { type: "property", key: "plan", operator: "equals", value: "pro" }
+    ]
+  }
+)
+```
+
+#### Response
+
+```json
+{
+  "id": "cls6e8g0i2k4m6o8q0s2u4w6",
+  "name": "Power users",
+  "description": null,
+  "createdAt": "2025-06-29T07:47:39.370Z",
+  "updatedAt": "2025-06-29T07:47:39.370Z",
+  "filter": {
+    "match": "all",
+    "conditions": [
+      { "type": "property", "key": "plan", "operator": "equals", "value": "pro" }
+    ]
+  }
+}
 ```
 
 ---
 
-### TransactionalGroups.get()
+### Workflows.list()
 
-Get a transactional group by ID.
+List workflows.
 
-[API Reference](https://loops.so/docs/api-reference/get-transactional-group)
+[API Reference](https://loops.so/docs/api-reference/list-workflows)
 
 #### Parameters
 
-| Name | Type   | Required | Notes |
-| ---- | ------ | -------- | ----- |
-| `transactional_group_id` | string | Yes      |       |
+| Name      | Type    | Required | Notes                                                                                                                         |
+| --------- | ------- | -------- | ----------------------------------------------------------------------------------------------------------------------------- |
+| `perPage` | integer | No       | How many results to return per page. Must be between 10 and 50. Defaults to 20 if omitted.                                    |
+| `cursor`  | string  | No       | A cursor, to return a specific page of results. Cursors can be found from the `pagination.nextCursor` value in each response. |
 
 #### Example
 
 ```ruby
-response = LoopsSdk::TransactionalGroups.get(transactional_group_id: "clv2w3x4y0288xbb0kqrsuv67")
+response = LoopsSdk::Workflows.list
+```
+
+#### Response
+
+```json
+{
+  "pagination": {
+    "totalResults": 1,
+    "returnedResults": 1,
+    "perPage": 20,
+    "totalPages": 1,
+    "nextCursor": null,
+    "nextPage": null
+  },
+  "data": [
+    {
+      "id": "clw1a3b5c7d9e1f3g5h7i9j1",
+      "url": "https://app.loops.so/workflows/clw1a3b5c7d9e1f3g5h7i9j1",
+      "name": "Onboarding",
+      "workflowGroupId": "clg7n5p3q1r9s7t5u3v1w9y7",
+      "createdAt": "2025-06-29T07:47:39.370Z",
+      "updatedAt": "2025-06-29T07:47:39.370Z"
+    }
+  ]
+}
 ```
 
 ---
 
-### TransactionalGroups.update()
+### Workflows.create()
 
-Update a transactional group's name or description.
+Create a draft workflow with a blank trigger and exit node.
 
-[API Reference](https://loops.so/docs/api-reference/update-transactional-group)
+[API Reference](https://loops.so/docs/api-reference/create-workflow)
 
 #### Parameters
 
-| Name          | Type   | Required | Notes                                   |
-| ------------- | ------ | -------- | --------------------------------------- |
-| `transactional_group_id`          | string | Yes      |                                         |
-| `name`        | string | No       | Cannot be the reserved name "Unsorted". |
+| Name                 | Type   | Required | Notes                                                                                          |
+| -------------------- | ------ | -------- | ---------------------------------------------------------------------------------------------- |
+| `name`               | string | Yes      |                                                                                                |
+| `description`        | string | No       |                                                                                                |
+| `mailing_list_id`    | string | No       | The mailing list the workflow sends to.                                                        |
+| `workflow_group_id`  | string | No       | The workflow group to create this workflow in. Defaults to the team's Unsorted group when omitted. |
+
+#### Example
+
+```ruby
+response = LoopsSdk::Workflows.create(name: "Welcome series")
+```
+
+#### Response
+
+```json
+{
+  "id": "clw1a3b5c7d9e1f3g5h7i9j1",
+  "status": "Draft",
+  "name": "Welcome series",
+  "workflowGroupId": "clg7n5p3q1r9s7t5u3v1w9y7",
+  "mailingListId": null,
+  "rootNodeId": "cf16k73gq014h3mmj5b6jdi9r",
+  "workflowRevisionId": "clrev0w0r1k2f3l4o5w6",
+  "nodes": {
+    "cf16k73gq014h3mmj5b6jdi9r": {
+      "typeName": "BlankTrigger",
+      "nextNodeIds": ["cf16k73gq014h3mmj5b4jdifg"]
+    },
+    "cf16k73gq014h3mmj5b4jdifg": {
+      "typeName": "ExitAction",
+      "nextNodeIds": []
+    }
+  }
+}
+```
+
+---
+
+### Workflows.get()
+
+Get a simplified workflow graph.
+
+[API Reference](https://loops.so/docs/api-reference/get-workflow)
+
+#### Parameters
+
+| Name | Type   | Required | Notes |
+| ---- | ------ | -------- | ----- |
+| `workflow_id` | string | Yes      |       |
+
+#### Example
+
+```ruby
+response = LoopsSdk::Workflows.get(workflow_id: "cls9t2u4v0210rx20jpuary23")
+```
+
+#### Response
+
+```json
+{
+  "id": "clw1a3b5c7d9e1f3g5h7i9j1",
+  "status": "Draft",
+  "name": "Onboarding",
+  "workflowGroupId": "clg7n5p3q1r9s7t5u3v1w9y7",
+  "mailingListId": null,
+  "rootNodeId": "cf16k73gq014h3mmj5b6jdi9r",
+  "workflowRevisionId": "clrev0w0r1k2f3l4o5w6",
+  "nodes": {
+    "cf16k73gq014h3mmj5b6jdi9r": {
+      "typeName": "SignupTrigger",
+      "nextNodeIds": ["cf16k73gq014h3mmj5b4jdifg"]
+    },
+    "cf16k73gq014h3mmj5b4jdifg": {
+      "typeName": "ExitAction",
+      "nextNodeIds": []
+    }
+  }
+}
+```
+
+---
+
+### Workflows.update()
+
+Update a workflow's display properties. To change the mailing list, use `Workflows.change_mailing_list()`.
+
+[API Reference](https://loops.so/docs/api-reference/update-workflow)
+
+#### Parameters
+
+| Name                     | Type   | Required | Notes                                                                                          |
+| ------------------------ | ------ | -------- | ---------------------------------------------------------------------------------------------- |
+| `workflow_id`            | string | Yes      |                                                                                                |
+| `expected_revision_id`   | string | Yes      | The `workflowRevisionId` from the latest read or mutation. Pass `nil` for older workflows.     |
+| `name`                   | string | No       |                                                                                                |
+| `description`            | string | No       |                                                                                                |
+| `workflow_group_id`      | string | No       | The workflow group to move this workflow into.                                                 |
+
+At least one of `name`, `description`, or `workflow_group_id` must be provided.
+
+#### Example
+
+```ruby
+response = LoopsSdk::Workflows.update(
+  workflow_id: "cls9t2u4v0210rx20jpuary23",
+  expected_revision_id: "rev_123",
+  name: "Updated name"
+)
+```
+
+#### Response
+
+```json
+{
+  "id": "clw1a3b5c7d9e1f3g5h7i9j1",
+  "status": "Draft",
+  "name": "Updated name",
+  "workflowGroupId": "clg7n5p3q1r9s7t5u3v1w9y7",
+  "mailingListId": null,
+  "rootNodeId": "cf16k73gq014h3mmj5b6jdi9r",
+  "workflowRevisionId": "clrev0w0r1k2f3l4o5w6",
+  "nodes": {
+    "cf16k73gq014h3mmj5b6jdi9r": {
+      "typeName": "BlankTrigger",
+      "nextNodeIds": ["cf16k73gq014h3mmj5b4jdifg"]
+    },
+    "cf16k73gq014h3mmj5b4jdifg": {
+      "typeName": "ExitAction",
+      "nextNodeIds": []
+    }
+  }
+}
+```
+
+---
+
+### Workflows.delete()
+
+Delete a workflow. Successful deletion returns no content (`nil`). If the workflow is currently sending or has queued contacts, the API returns `409 Conflict` — retry with `confirm_delete: true` to delete the workflow, stop sending, and cancel queued contacts.
+
+[API Reference](https://loops.so/docs/api-reference/delete-workflow)
+
+#### Parameters
+
+| Name                   | Type    | Required | Notes                                                                                          |
+| ---------------------- | ------- | -------- | ---------------------------------------------------------------------------------------------- |
+| `workflow_id`          | string  | Yes      |                                                                                                |
+| `expected_revision_id` | string  | Yes      | The `workflowRevisionId` from the latest read or mutation. Pass `nil` for older workflows.     |
+| `confirm_delete`       | boolean | No       | Set to `true` after a confirmation-required `409` to confirm deleting a sending workflow or a workflow with queued contacts. |
+
+#### Example
+
+```ruby
+LoopsSdk::Workflows.delete(
+  workflow_id: "cls9t2u4v0210rx20jpuary23",
+  expected_revision_id: "rev_123"
+)
+
+# After a 409 confirming a sending or queued workflow:
+LoopsSdk::Workflows.delete(
+  workflow_id: "cls9t2u4v0210rx20jpuary23",
+  expected_revision_id: "rev_123",
+  confirm_delete: true
+)
+```
+
+#### Response
+
+`nil` (HTTP `204 No Content`)
+
+---
+
+### Workflows.change_mailing_list()
+
+Dry run or apply a workflow mailing list change. If queued contacts would be removed, the API returns `"status": "queuedContactsFound"` — retry with `queued_contact_policy: "discard"` to apply.
+
+[API Reference](https://loops.so/docs/api-reference/change-workflow-mailing-list)
+
+#### Parameters
+
+| Name                     | Type    | Required | Notes                                                                 |
+| ------------------------ | ------- | -------- | --------------------------------------------------------------------- |
+| `workflow_id`            | string  | Yes      |                                                                       |
+| `expected_revision_id`   | string  | Yes      | Pass `nil` for older workflows.                                       |
+| `mailing_list_id`        | string  | Yes      | Pass `nil` to clear the mailing list.                                 |
+| `dry_run`                | boolean | No       | If `true`, validate without modifying.                                |
+| `queued_contact_policy`  | string  | No       | `fail` (default) or `discard`.                                        |
+
+#### Example
+
+```ruby
+response = LoopsSdk::Workflows.change_mailing_list(
+  workflow_id: "cls9t2u4v0210rx20jpuary23",
+  expected_revision_id: "rev_123",
+  mailing_list_id: "cm06f5v0e45nf0ml5754o9cix",
+  dry_run: true
+)
+```
+
+#### Response
+
+```json
+{
+  "status": "updated",
+  "mailingListId": "cm06f5v0e45nf0ml5754o9cix",
+  "workflowRevisionId": "clrev0w0r1k2f3l4o5w6",
+  "queuedContactCount": 0,
+  "workflow": {
+    "id": "clw1a3b5c7d9e1f3g5h7i9j1",
+    "status": "Draft",
+    "name": "Welcome series",
+    "workflowGroupId": "clg7n5p3q1r9s7t5u3v1w9y7",
+    "mailingListId": "cm06f5v0e45nf0ml5754o9cix",
+    "rootNodeId": "cln8p0q2r4s6t8u0v2w4x6z8",
+    "workflowRevisionId": "clrev0w0r1k2f3l4o5w6",
+    "nodes": {
+      "cln8p0q2r4s6t8u0v2w4x6z8": {
+        "typeName": "BlankTrigger",
+        "nextNodeIds": ["cln1a3b5c7d9e1f3g5h7i9j1"]
+      },
+      "cln1a3b5c7d9e1f3g5h7i9j1": {
+        "typeName": "ExitAction",
+        "nextNodeIds": []
+      }
+    }
+  }
+}
+```
+
+---
+
+### Workflows.get_node()
+
+Get detailed data for a single workflow node.
+
+[API Reference](https://loops.so/docs/api-reference/get-workflow-node)
+
+#### Parameters
+
+| Name         | Type   | Required | Notes |
+| ------------ | ------ | -------- | ----- |
+| `workflow_id`| string | Yes      |       |
+| `node_id`    | string | Yes      |       |
+
+#### Example
+
+```ruby
+response = LoopsSdk::Workflows.get_node(workflow_id: "cls9t2u4v0210rx20jpuary23", node_id: "clt0u3v5w0232sy31kqvbzs34")
+```
+
+#### Response
+
+```json
+{
+  "id": "cln8p0q2r4s6t8u0v2w4x6z8",
+  "workflowId": "clw1a3b5c7d9e1f3g5h7i9j1",
+  "typeName": "TimerAction",
+  "nextNodeIds": ["cf16k73gq014h3mmj5b4jdifg"],
+  "amount": 1,
+  "unit": "h",
+  "workflowRevisionId": "clrev0w0r1k2f3l4o5w6"
+}
+```
+
+---
+
+### Workflows.get_node_metrics()
+
+Get all-time engagement metrics for a workflow email node.
+
+[API Reference](https://loops.so/docs/api-reference/get-workflow-node-metrics)
+
+#### Parameters
+
+| Name          | Type   | Required | Notes |
+| ------------- | ------ | -------- | ----- |
+| `workflow_id` | string | Yes      |       |
+| `node_id`     | string | Yes      |       |
+
+#### Example
+
+```ruby
+response = LoopsSdk::Workflows.get_node_metrics(
+  workflow_id: "cls9t2u4v0210rx20jpuary23",
+  node_id: "clt0u3v5w0232sy31kqvbzs34"
+)
+```
+
+#### Response
+
+```json
+{
+  "sends": 4210,
+  "opens": 1922,
+  "clicks": 301,
+  "unsubscribes": 12,
+  "spamReports": 1,
+  "hardBounces": 9,
+  "softBounces": 13
+}
+```
+
+---
+
+### Workflows.create_node()
+
+Create a new default workflow node.
+
+Use `insert_mode` to choose placement:
+- `between` — insert between `from_node_id` and `to_node_id`
+- `before` — insert before `to_node_id`
+- `after` — insert after `from_node_id` (source must have exactly one outgoing connection)
+
+[API Reference](https://loops.so/docs/api-reference/create-workflow-node)
+
+#### Parameters
+
+| Name                   | Type   | Required | Notes                                                                                          |
+| ---------------------- | ------ | -------- | ---------------------------------------------------------------------------------------------- |
+| `workflow_id`          | string | Yes      |                                                                                                |
+| `expected_revision_id` | string | Yes      | Pass `nil` for older workflows.                                                                |
+| `insert_mode`          | string | Yes      | `between`, `before`, or `after`.                                                               |
+| `node_type_name`       | string | Yes      | One of `AudienceFilter`, `BranchNode`, `ExperimentBranchNode`, `TimerAction`, `SendEmailAction`, `VariantNode`. |
+| `from_node_id`         | string | Cond.    | Required for `between` and `after`. Not permitted for `before`.                                |
+| `to_node_id`           | string | Cond.    | Required for `between`. For `before`, provide this or `before_node_id` (not both). Not permitted for `after`. |
+| `before_node_id`       | string | Cond.    | Deprecated. For `before`, provide this or `to_node_id` (not both).                             |
+
+#### Example
+
+```ruby
+response = LoopsSdk::Workflows.create_node(
+  workflow_id: "cls9t2u4v0210rx20jpuary23",
+  expected_revision_id: "rev_123",
+  insert_mode: "between",
+  node_type_name: "TimerAction",
+  from_node_id: "node_a",
+  to_node_id: "node_b"
+)
+
+response = LoopsSdk::Workflows.create_node(
+  workflow_id: "cls9t2u4v0210rx20jpuary23",
+  expected_revision_id: "rev_123",
+  insert_mode: "after",
+  node_type_name: "TimerAction",
+  from_node_id: "node_a"
+)
+
+response = LoopsSdk::Workflows.create_node(
+  workflow_id: "cls9t2u4v0210rx20jpuary23",
+  expected_revision_id: "rev_123",
+  insert_mode: "before",
+  node_type_name: "TimerAction",
+  to_node_id: "node_b"
+)
+```
+
+#### Response
+
+```json
+{
+  "node": {
+    "id": "cln8p0q2r4s6t8u0v2w4x6z8",
+    "typeName": "TimerAction",
+    "nextNodeIds": ["node_b"],
+    "amount": 0,
+    "unit": "m",
+    "workflowRevisionId": "clrev0w0r1k2f3l4o5w6"
+  },
+  "workflow": {
+    "id": "clw1a3b5c7d9e1f3g5h7i9j1",
+    "status": "Draft",
+    "name": "Welcome series",
+    "workflowGroupId": "clg7n5p3q1r9s7t5u3v1w9y7",
+    "mailingListId": null,
+    "rootNodeId": "node_a",
+    "workflowRevisionId": "clrev0w0r1k2f3l4o5w6",
+    "nodes": {
+      "node_a": {
+        "typeName": "BlankTrigger",
+        "nextNodeIds": ["cln8p0q2r4s6t8u0v2w4x6z8"]
+      },
+      "cln8p0q2r4s6t8u0v2w4x6z8": {
+        "typeName": "TimerAction",
+        "nextNodeIds": ["node_b"],
+        "amount": 0,
+        "unit": "m"
+      },
+      "node_b": {
+        "typeName": "ExitAction",
+        "nextNodeIds": []
+      }
+    }
+  }
+}
+```
+
+---
+
+### Workflows.update_node()
+
+Update workflow-node-owned fields for a single node.
+
+[API Reference](https://loops.so/docs/api-reference/update-workflow-node)
+
+#### Parameters
+
+| Name                   | Type   | Required | Notes                                                      |
+| ---------------------- | ------ | -------- | ---------------------------------------------------------- |
+| `workflow_id`          | string | Yes      |                                                            |
+| `node_id`              | string | Yes      |                                                            |
+| `expected_revision_id` | string | Yes      | Pass `nil` for older workflows.                            |
+| `payload`              | object | Yes      | Node-type-specific fields. See the API reference.          |
+
+#### Example
+
+```ruby
+response = LoopsSdk::Workflows.update_node(
+  workflow_id: "cls9t2u4v0210rx20jpuary23",
+  node_id: "clt0u3v5w0232sy31kqvbzs34",
+  expected_revision_id: "rev_123",
+  payload: { amount: 2, unit: "d" }
+)
+```
+
+#### Response
+
+```json
+{
+  "id": "cln8p0q2r4s6t8u0v2w4x6z8",
+  "workflowId": "clw1a3b5c7d9e1f3g5h7i9j1",
+  "typeName": "TimerAction",
+  "nextNodeIds": ["cf16k73gq014h3mmj5b4jdifg"],
+  "amount": 2,
+  "unit": "d",
+  "workflowRevisionId": "clrev0w0r1k2f3l4o5w6",
+  "workflow": {
+    "id": "clw1a3b5c7d9e1f3g5h7i9j1",
+    "status": "Draft",
+    "name": "Welcome series",
+    "workflowGroupId": "clg7n5p3q1r9s7t5u3v1w9y7",
+    "mailingListId": null,
+    "rootNodeId": "cln8p0q2r4s6t8u0v2w4x6z8",
+    "workflowRevisionId": "clrev0w0r1k2f3l4o5w6",
+    "nodes": {
+      "cln8p0q2r4s6t8u0v2w4x6z8": {
+        "typeName": "TimerAction",
+        "nextNodeIds": ["cf16k73gq014h3mmj5b4jdifg"],
+        "amount": 2,
+        "unit": "d"
+      },
+      "cf16k73gq014h3mmj5b4jdifg": {
+        "typeName": "ExitAction",
+        "nextNodeIds": []
+      }
+    }
+  }
+}
+```
+
+---
+
+### Workflows.delete_node()
+
+Delete a single workflow node. If contacts are queued, the API returns `"status": "queuedContactsFound"` — retry with `queued_contact_policy: "discard"` to delete.
+
+[API Reference](https://loops.so/docs/api-reference/delete-workflow-node)
+
+#### Parameters
+
+| Name                    | Type    | Required | Notes                          |
+| ----------------------- | ------- | -------- | ------------------------------ |
+| `workflow_id`           | string  | Yes      |                                |
+| `node_id`               | string  | Yes      |                                |
+| `expected_revision_id`  | string  | Yes      | Pass `nil` for older workflows.|
+| `dry_run`               | boolean | No       |                                |
+| `queued_contact_policy` | string  | No       | `fail` (default) or `discard`. |
+
+#### Example
+
+```ruby
+response = LoopsSdk::Workflows.delete_node(
+  workflow_id: "cls9t2u4v0210rx20jpuary23",
+  node_id: "clt0u3v5w0232sy31kqvbzs34",
+  expected_revision_id: "rev_123",
+  dry_run: true
+)
+```
+
+#### Response
+
+```json
+{
+  "status": "deleted",
+  "nodeIds": ["clt0u3v5w0232sy31kqvbzs34"],
+  "workflowRevisionId": "clrev0w0r1k2f3l4o5w6",
+  "queuedContactCount": 0,
+  "workflow": {
+    "id": "clw1a3b5c7d9e1f3g5h7i9j1",
+    "status": "Draft",
+    "name": "Welcome series",
+    "workflowGroupId": "clg7n5p3q1r9s7t5u3v1w9y7",
+    "mailingListId": null,
+    "rootNodeId": "cln8p0q2r4s6t8u0v2w4x6z8",
+    "workflowRevisionId": "clrev0w0r1k2f3l4o5w6",
+    "nodes": {
+      "cln8p0q2r4s6t8u0v2w4x6z8": {
+        "typeName": "BlankTrigger",
+        "nextNodeIds": ["cln1a3b5c7d9e1f3g5h7i9j1"]
+      },
+      "cln1a3b5c7d9e1f3g5h7i9j1": {
+        "typeName": "ExitAction",
+        "nextNodeIds": []
+      }
+    }
+  }
+}
+```
+
+---
+
+### Workflows.add_branch()
+
+Add a branch and child node under an existing `BranchNode` or `ExperimentBranchNode`.
+
+[API Reference](https://loops.so/docs/api-reference/add-workflow-branch)
+
+#### Parameters
+
+| Name                   | Type   | Required | Notes                           |
+| ---------------------- | ------ | -------- | ------------------------------- |
+| `workflow_id`          | string | Yes      |                                 |
+| `node_id`              | string | Yes      | The branch or experiment node.  |
+| `expected_revision_id` | string | Yes      | Pass `nil` for older workflows. |
+
+#### Example
+
+```ruby
+response = LoopsSdk::Workflows.add_branch(
+  workflow_id: "cls9t2u4v0210rx20jpuary23",
+  node_id: "clt0u3v5w0232sy31kqvbzs34",
+  expected_revision_id: "rev_123"
+)
+```
+
+#### Response
+
+```json
+{
+  "node": {
+    "id": "cln0a2b4c6d8e0f2g4h6i8j0",
+    "typeName": "AudienceFilter",
+    "nextNodeIds": [],
+    "appliesDownstream": false,
+    "workflowRevisionId": "clrev0w0r1k2f3l4o5w6"
+  },
+  "workflow": {
+    "id": "clw1a3b5c7d9e1f3g5h7i9j1",
+    "status": "Draft",
+    "name": "Welcome series",
+    "workflowGroupId": "clg7n5p3q1r9s7t5u3v1w9y7",
+    "mailingListId": null,
+    "rootNodeId": "clt0u3v5w0232sy31kqvbzs34",
+    "workflowRevisionId": "clrev0w0r1k2f3l4o5w6",
+    "nodes": {
+      "clt0u3v5w0232sy31kqvbzs34": {
+        "typeName": "BranchNode",
+        "nextNodeIds": ["cln0a2b4c6d8e0f2g4h6i8j0"]
+      },
+      "cln0a2b4c6d8e0f2g4h6i8j0": {
+        "typeName": "AudienceFilter",
+        "nextNodeIds": []
+      }
+    }
+  }
+}
+```
+
+---
+
+### Workflows.reroute_node()
+
+Reroute a source node's outgoing connection to another valid target node. The source node must have exactly one outgoing connection. Branch and experiment branch nodes cannot be rerouted with this endpoint.
+
+[API Reference](https://loops.so/docs/api-reference/reroute-node-connection)
+
+#### Parameters
+
+| Name                   | Type   | Required | Notes                                      |
+| ---------------------- | ------ | -------- | ------------------------------------------ |
+| `workflow_id`          | string | Yes      |                                            |
+| `node_id`              | string | Yes      | The source node whose connection to move.  |
+| `expected_revision_id` | string | Yes      | Pass `nil` for older workflows.            |
+| `new_target_node_id`   | string | Yes      | The node that should receive the connection. |
+
+#### Example
+
+```ruby
+response = LoopsSdk::Workflows.reroute_node(
+  workflow_id: "cls9t2u4v0210rx20jpuary23",
+  node_id: "clt0u3v5w0232sy31kqvbzs34",
+  expected_revision_id: "rev_123",
+  new_target_node_id: "cln3c5d7e9f1g3h5i7j9k1l3"
+)
+```
+
+#### Response
+
+```json
+{
+  "id": "cln8p0q2r4s6t8u0v2w4x6z8",
+  "typeName": "SignupTrigger",
+  "nextNodeIds": ["cln3c5d7e9f1g3h5i7j9k1l3"],
+  "workflowRevisionId": "clx7a3b5c7d9e1f3g5h7i9j2",
+  "workflow": {
+    "id": "clw1a3b5c7d9e1f3g5h7i9j1",
+    "workflowRevisionId": "clx7a3b5c7d9e1f3g5h7i9j2",
+    "status": "Draft",
+    "name": "Welcome series",
+    "workflowGroupId": "clg7n5p3q1r9s7t5u3v1w9y7",
+    "mailingListId": "clm2k8j4h6g0f8d6s4a2b0z8",
+    "rootNodeId": "cln8p0q2r4s6t8u0v2w4x6z8",
+    "nodes": {
+      "cln8p0q2r4s6t8u0v2w4x6z8": {
+        "typeName": "SignupTrigger",
+        "nextNodeIds": ["cln3c5d7e9f1g3h5i7j9k1l3"]
+      },
+      "cln3c5d7e9f1g3h5i7j9k1l3": {
+        "typeName": "SendEmailAction",
+        "nextNodeIds": [],
+        "emailMessageId": "cle5f7g9h1i3j5k7l9m1n3p5",
+        "subject": "Welcome to Acme!"
+      }
+    }
+  }
+}
+```
+
+---
+
+### Workflows.delete_node_recursive()
+
+Delete a node and its downstream subtree.
+
+[API Reference](https://loops.so/docs/api-reference/delete-workflow-nodes)
+
+#### Parameters
+
+| Name                    | Type    | Required | Notes                          |
+| ----------------------- | ------- | -------- | ------------------------------ |
+| `workflow_id`           | string  | Yes      |                                |
+| `node_id`               | string  | Yes      | Root of the subtree to delete. |
+| `expected_revision_id`  | string  | Yes      | Pass `nil` for older workflows.|
+| `dry_run`               | boolean | No       |                                |
+| `queued_contact_policy` | string  | No       | `fail` (default) or `discard`. |
+
+#### Example
+
+```ruby
+response = LoopsSdk::Workflows.delete_node_recursive(
+  workflow_id: "cls9t2u4v0210rx20jpuary23",
+  node_id: "clt0u3v5w0232sy31kqvbzs34",
+  expected_revision_id: "rev_123",
+  queued_contact_policy: "discard"
+)
+```
+
+#### Response
+
+```json
+{
+  "status": "deleted",
+  "nodeIds": [
+    "clt0u3v5w0232sy31kqvbzs34",
+    "cln9q1r3s5t7u9v1w3x5y7z9"
+  ],
+  "workflowRevisionId": "clrev0w0r1k2f3l4o5w6",
+  "queuedContactCount": 0,
+  "workflow": {
+    "id": "clw1a3b5c7d9e1f3g5h7i9j1",
+    "status": "Draft",
+    "name": "Welcome series",
+    "workflowGroupId": "clg7n5p3q1r9s7t5u3v1w9y7",
+    "mailingListId": null,
+    "rootNodeId": "cln8p0q2r4s6t8u0v2w4x6z8",
+    "workflowRevisionId": "clrev0w0r1k2f3l4o5w6",
+    "nodes": {
+      "cln8p0q2r4s6t8u0v2w4x6z8": {
+        "typeName": "BlankTrigger",
+        "nextNodeIds": ["cln1a3b5c7d9e1f3g5h7i9j1"]
+      },
+      "cln1a3b5c7d9e1f3g5h7i9j1": {
+        "typeName": "ExitAction",
+        "nextNodeIds": []
+      }
+    }
+  }
+}
+```
+
+---
+
+### EventPatterns.list()
+
+List event patterns available to workflow event trigger nodes.
+
+[API Reference](https://loops.so/docs/api-reference/list-event-patterns)
+
+#### Parameters
+
+| Name      | Type    | Required | Notes                                                                                                                         |
+| --------- | ------- | -------- | ----------------------------------------------------------------------------------------------------------------------------- |
+| `perPage` | integer | No       | How many results to return per page. Must be between 10 and 50. Defaults to 20 if omitted.                                    |
+| `cursor`  | string  | No       | A cursor, to return a specific page of results. Cursors can be found from the `pagination.nextCursor` value in each response. |
+
+#### Example
+
+```ruby
+response = LoopsSdk::EventPatterns.list
+```
+
+#### Response
+
+```json
+{
+  "pagination": {
+    "totalResults": 1,
+    "returnedResults": 1,
+    "perPage": 20,
+    "totalPages": 1,
+    "nextCursor": null,
+    "nextPage": null
+  },
+  "data": [
+    {
+      "id": "cle1a2b3c004yl70d5e6f7g8h",
+      "eventName": "signup",
+      "incomingWebhookPlatform": null
+    }
+  ]
+}
+```
+
+---
+
+### EventPatterns.get()
+
+Get an event pattern by ID.
+
+[API Reference](https://loops.so/docs/api-reference/get-event-pattern)
+
+#### Parameters
+
+| Name               | Type   | Required | Notes |
+| ------------------ | ------ | -------- | ----- |
+| `event_pattern_id` | string | Yes      |       |
+
+#### Example
+
+```ruby
+response = LoopsSdk::EventPatterns.get(event_pattern_id: "cle1v2e3n4t5p6a7t8t9e0r1")
+```
+
+#### Response
+
+```json
+{
+  "id": "cle1a2b3c004yl70d5e6f7g8h",
+  "eventName": "signup",
+  "eventProperties": [
+    { "name": "plan", "type": "string" },
+    { "name": "trialDays", "type": "number" }
+  ],
+  "incomingWebhookPlatform": null
+}
+```
+
+---
+
+### EventPatterns.get_by_name()
+
+Get an event pattern by event name. Event names are case-sensitive.
+
+[API Reference](https://loops.so/docs/api-reference/get-event-pattern-by-name)
+
+#### Parameters
+
+| Name         | Type   | Required | Notes |
+| ------------ | ------ | -------- | ----- |
+| `event_name` | string | Yes      |       |
+
+#### Example
+
+```ruby
+response = LoopsSdk::EventPatterns.get_by_name(event_name: "signup")
+```
+
+#### Response
+
+```json
+{
+  "id": "cle1a2b3c004yl70d5e6f7g8h",
+  "eventName": "signup",
+  "eventProperties": [
+    { "name": "plan", "type": "string" },
+    { "name": "trialDays", "type": "number" }
+  ],
+  "incomingWebhookPlatform": null
+}
+```
+
+---
+
+### TransactionalGroups.list()
+
+List transactional groups.
+
+[API Reference](https://loops.so/docs/api-reference/list-transactional-groups)
+
+#### Parameters
+
+| Name      | Type    | Required | Notes                                                                                                                         |
+| --------- | ------- | -------- | ----------------------------------------------------------------------------------------------------------------------------- |
+| `perPage` | integer | No       | How many results to return per page. Must be between 10 and 50. Defaults to 20 if omitted.                                    |
+| `cursor`  | string  | No       | A cursor, to return a specific page of results. Cursors can be found from the `pagination.nextCursor` value in each response. |
+
+#### Example
+
+```ruby
+response = LoopsSdk::TransactionalGroups.list
+```
+
+#### Response
+
+```json
+{
+  "pagination": {
+    "totalResults": 1,
+    "returnedResults": 1,
+    "perPage": 20,
+    "totalPages": 1,
+    "nextCursor": null,
+    "nextPage": null
+  },
+  "data": [
+    {
+      "id": "clg7n5p3q1r9s7t5u3v1w9y7",
+      "name": "Onboarding",
+      "description": "Top of funnel campaigns",
+      "createdAt": "2025-06-29T07:47:39.370Z",
+      "updatedAt": "2025-06-29T07:47:39.370Z"
+    }
+  ]
+}
+```
+
+---
+
+### TransactionalGroups.create()
+
+Create a transactional group.
+
+[API Reference](https://loops.so/docs/api-reference/create-transactional-group)
+
+#### Parameters
+
+| Name          | Type   | Required | Notes                                   |
+| ------------- | ------ | -------- | --------------------------------------- |
+| `name`        | string | Yes      | Cannot be the reserved name "Unsorted". |
+| `description` | string | No       | An optional description for the group.  |
+
+#### Example
+
+```ruby
+response = LoopsSdk::TransactionalGroups.create(name: "Account emails")
+```
+
+#### Response
+
+```json
+{
+  "id": "clg7n5p3q1r9s7t5u3v1w9y7",
+  "name": "Account emails",
+  "description": "",
+  "createdAt": "2025-06-29T07:47:39.370Z",
+  "updatedAt": "2025-06-29T07:47:39.370Z"
+}
+```
+
+---
+
+### TransactionalGroups.get()
+
+Get a transactional group by ID.
+
+[API Reference](https://loops.so/docs/api-reference/get-transactional-group)
+
+#### Parameters
+
+| Name | Type   | Required | Notes |
+| ---- | ------ | -------- | ----- |
+| `transactional_group_id` | string | Yes      |       |
+
+#### Example
+
+```ruby
+response = LoopsSdk::TransactionalGroups.get(transactional_group_id: "clv2w3x4y0288xbb0kqrsuv67")
+```
+
+#### Response
+
+```json
+{
+  "id": "clg7n5p3q1r9s7t5u3v1w9y7",
+  "name": "Account emails",
+  "description": "",
+  "createdAt": "2025-06-29T07:47:39.370Z",
+  "updatedAt": "2025-06-29T07:47:39.370Z"
+}
+```
+
+---
+
+### TransactionalGroups.update()
+
+Update a transactional group's name or description.
+
+[API Reference](https://loops.so/docs/api-reference/update-transactional-group)
+
+#### Parameters
+
+| Name          | Type   | Required | Notes                                   |
+| ------------- | ------ | -------- | --------------------------------------- |
+| `transactional_group_id`          | string | Yes      |                                         |
+| `name`        | string | No       | Cannot be the reserved name "Unsorted". |
 | `description` | string | No       |                                         |
 
 At least one field must be provided.
@@ -1595,6 +3294,18 @@ response = LoopsSdk::TransactionalGroups.update(
 )
 ```
 
+#### Response
+
+```json
+{
+  "id": "clg7n5p3q1r9s7t5u3v1w9y7",
+  "name": "Updated name",
+  "description": "",
+  "createdAt": "2025-06-29T07:47:39.370Z",
+  "updatedAt": "2025-06-29T07:47:39.370Z"
+}
+```
+
 ---
 
 ### Uploads.upload()