loops_sdk 2.4.0 → 2.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 26e2946fb1c882b535762d964ef73b0c79c7631315527f3b967aeaab5fe9cb13
-  data.tar.gz: f44c32833e2191a6565541c87ed6242580e2cd5e01ca023f6b4444c706a6c6f0
+  metadata.gz: a8a4baf2050d5fbaeeb96e5c39000b77fb84603d539218df1b001763d265aeab
+  data.tar.gz: 707d8a389ae61d4f8c3c0621a6ec4edb4b0d1c822084e2b680b41ecf7f6d6375
 SHA512:
-  metadata.gz: fcbedd17d573585d04d0e474fc5f2f2d712dd7c3da76fae62675df80d1277aafbcfc3ab9992cd764208e8a1ebd0295ee72a4c5b5bd4b9d522e1cca5ab53cdbd2
-  data.tar.gz: 64048aaf770aa228250d012a6fd83747c0f62ec2f3c75e531426fd6982c882b4488bbea92a945ac4a2f8cfb6c8cae445d601dcb2bd96f61163c82ed90a5c15f9
+  metadata.gz: f0b31acb878a70e3665a081e26db46e61cd32cf4d4d032560547122f12c74ef5d0fd03824d481b981f836d9d2aa9ba4ccc279b3131a2dfab01dad3e148fa4c6a
+  data.tar.gz: 8c7575f7b5882b62bf7d627c36be1ac801f5f31b973c5e72a787c6b61247e5766219642dcc75eab860fbcba4ad9f0e9925e4479d1927c8b58c2d881e96515493

data/README.md

@@ -120,6 +120,7 @@ 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)
@@ -134,10 +135,15 @@ You can use custom contact properties in API calls. Please make sure to [add cus
 - [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)
@@ -145,12 +151,15 @@ You can use custom contact properties in API calls. Please make sure to [add cus
 - [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)
@@ -998,6 +1007,38 @@ response = LoopsSdk::Transactional.publish(transactional_id: "clfq6dinn000yl70fg
 
 ---
 
+### 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()
 
 Send a transactional email to a contact. [Learn about sending transactional email](https://loops.so/docs/transactional/guide)
@@ -1612,6 +1653,40 @@ response = LoopsSdk::Campaigns.update(
 
 ---
 
+### 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()
 
 Get an email message, including its LMX content.
@@ -1931,6 +2006,155 @@ response = LoopsSdk::CampaignGroups.update(
 
 ---
 
+### WorkflowGroups.list()
+
+List workflow groups.
+
+[API Reference](https://loops.so/docs/api-reference/list-workflow-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::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"
+    }
+  ]
+}
+```
+
+---
+
+### WorkflowGroups.create()
+
+Create a workflow group.
+
+[API Reference](https://loops.so/docs/api-reference/create-workflow-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::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"
+}
+```
+
+---
+
+### WorkflowGroups.get()
+
+Get a workflow group by ID.
+
+[API Reference](https://loops.so/docs/api-reference/get-workflow-group)
+
+#### Parameters
+
+| Name                | Type   | Required | Notes |
+| ------------------- | ------ | -------- | ----- |
+| `workflow_group_id` | string | Yes      |       |
+
+#### Example
+
+```ruby
+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"
+}
+```
+
+---
+
+### WorkflowGroups.update()
+
+Update a workflow group's name or description.
+
+[API Reference](https://loops.so/docs/api-reference/update-workflow-group)
+
+#### Parameters
+
+| 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::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"
+}
+```
+
+---
+
 ### AudienceSegments.list()
 
 List audience segments.
@@ -2102,7 +2326,9 @@ response = LoopsSdk::Workflows.list
   "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"
     }
@@ -2120,11 +2346,12 @@ Create a draft workflow with a blank trigger and exit node.
 
 #### Parameters
 
-| Name              | Type   | Required | Notes                                          |
-| ----------------- | ------ | -------- | ---------------------------------------------- |
-| `name`            | string | Yes      |                                                |
-| `description`     | string | No       |                                                |
-| `mailing_list_id` | string | No       | The mailing list the workflow sends to.        |
+| 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
 
@@ -2139,6 +2366,7 @@ response = LoopsSdk::Workflows.create(name: "Welcome series")
   "id": "clw1a3b5c7d9e1f3g5h7i9j1",
   "status": "Draft",
   "name": "Welcome series",
+  "workflowGroupId": "clg7n5p3q1r9s7t5u3v1w9y7",
   "mailingListId": null,
   "rootNodeId": "cf16k73gq014h3mmj5b6jdi9r",
   "workflowRevisionId": "clrev0w0r1k2f3l4o5w6",
@@ -2182,6 +2410,7 @@ response = LoopsSdk::Workflows.get(workflow_id: "cls9t2u4v0210rx20jpuary23")
   "id": "clw1a3b5c7d9e1f3g5h7i9j1",
   "status": "Draft",
   "name": "Onboarding",
+  "workflowGroupId": "clg7n5p3q1r9s7t5u3v1w9y7",
   "mailingListId": null,
   "rootNodeId": "cf16k73gq014h3mmj5b6jdi9r",
   "workflowRevisionId": "clrev0w0r1k2f3l4o5w6",
@@ -2214,8 +2443,9 @@ Update a workflow's display properties. To change the mailing list, use `Workflo
 | `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` or `description` must be provided.
+At least one of `name`, `description`, or `workflow_group_id` must be provided.
 
 #### Example
 
@@ -2234,6 +2464,7 @@ response = LoopsSdk::Workflows.update(
   "id": "clw1a3b5c7d9e1f3g5h7i9j1",
   "status": "Draft",
   "name": "Updated name",
+  "workflowGroupId": "clg7n5p3q1r9s7t5u3v1w9y7",
   "mailingListId": null,
   "rootNodeId": "cf16k73gq014h3mmj5b6jdi9r",
   "workflowRevisionId": "clrev0w0r1k2f3l4o5w6",
@@ -2252,6 +2483,42 @@ response = LoopsSdk::Workflows.update(
 
 ---
 
+### 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.
@@ -2287,7 +2554,25 @@ response = LoopsSdk::Workflows.change_mailing_list(
   "mailingListId": "cm06f5v0e45nf0ml5754o9cix",
   "workflowRevisionId": "clrev0w0r1k2f3l4o5w6",
   "queuedContactCount": 0,
-  "queuedContactLimitReached": false
+  "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": []
+      }
+    }
+  }
 }
 ```
 
@@ -2328,9 +2613,52 @@ response = LoopsSdk::Workflows.get_node(workflow_id: "cls9t2u4v0210rx20jpuary23"
 
 ---
 
+### 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: "between"` with `from_node_id`/`to_node_id`, or `insert_mode: "before"` with `before_node_id`.
+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)
 
@@ -2340,11 +2668,11 @@ Create a new default workflow node. Use `insert_mode: "between"` with `from_node
 | ---------------------- | ------ | -------- | ---------------------------------------------------------------------------------------------- |
 | `workflow_id`          | string | Yes      |                                                                                                |
 | `expected_revision_id` | string | Yes      | Pass `nil` for older workflows.                                                                |
-| `insert_mode`          | string | Yes      | `between` or `before`.                                                                         |
+| `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 | No       | Required when `insert_mode` is `between`.                                                      |
-| `to_node_id`           | string | No       | Required when `insert_mode` is `between`.                                                      |
-| `before_node_id`       | string | No       | Required when `insert_mode` is `before`.                                                       |
+| `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
 
@@ -2357,6 +2685,22 @@ response = LoopsSdk::Workflows.create_node(
   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
@@ -2375,6 +2719,7 @@ response = LoopsSdk::Workflows.create_node(
     "id": "clw1a3b5c7d9e1f3g5h7i9j1",
     "status": "Draft",
     "name": "Welcome series",
+    "workflowGroupId": "clg7n5p3q1r9s7t5u3v1w9y7",
     "mailingListId": null,
     "rootNodeId": "node_a",
     "workflowRevisionId": "clrev0w0r1k2f3l4o5w6",
@@ -2436,7 +2781,28 @@ response = LoopsSdk::Workflows.update_node(
   "nextNodeIds": ["cf16k73gq014h3mmj5b4jdifg"],
   "amount": 2,
   "unit": "d",
-  "workflowRevisionId": "clrev0w0r1k2f3l4o5w6"
+  "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": []
+      }
+    }
+  }
 }
 ```
 
@@ -2477,7 +2843,25 @@ response = LoopsSdk::Workflows.delete_node(
   "nodeIds": ["clt0u3v5w0232sy31kqvbzs34"],
   "workflowRevisionId": "clrev0w0r1k2f3l4o5w6",
   "queuedContactCount": 0,
-  "queuedContactLimitReached": false
+  "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": []
+      }
+    }
+  }
 }
 ```
 
@@ -2522,6 +2906,7 @@ response = LoopsSdk::Workflows.add_branch(
     "id": "clw1a3b5c7d9e1f3g5h7i9j1",
     "status": "Draft",
     "name": "Welcome series",
+    "workflowGroupId": "clg7n5p3q1r9s7t5u3v1w9y7",
     "mailingListId": null,
     "rootNodeId": "clt0u3v5w0232sy31kqvbzs34",
     "workflowRevisionId": "clrev0w0r1k2f3l4o5w6",
@@ -2541,6 +2926,66 @@ response = LoopsSdk::Workflows.add_branch(
 
 ---
 
+### 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.
@@ -2579,7 +3024,25 @@ response = LoopsSdk::Workflows.delete_node_recursive(
   ],
   "workflowRevisionId": "clrev0w0r1k2f3l4o5w6",
   "queuedContactCount": 0,
-  "queuedContactLimitReached": false
+  "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": []
+      }
+    }
+  }
 }
 ```
 

data/lib/loops_sdk/base.rb

@@ -9,6 +9,8 @@ module LoopsSdk
         case response.status
         when 200, 201
           JSON.parse(response.body)
+        when 204
+          nil
         when 429
           limit = response.headers["x-ratelimit-limit"]
           remaining = response.headers["x-ratelimit-remaining"]

data/lib/loops_sdk/campaigns.rb

@@ -34,6 +34,10 @@ module LoopsSdk
         }.compact
         make_request(method: :post, path: "v1/campaigns/#{campaign_id}", body: body)
       end
+
+      def metrics(campaign_id:)
+        make_request(method: :get, path: "v1/campaigns/#{campaign_id}/metrics")
+      end
     end
   end
 end

data/lib/loops_sdk/transactional.rb

@@ -29,6 +29,10 @@ module LoopsSdk
         make_request(method: :post, path: "v1/transactional-emails/#{transactional_id}/publish")
       end
 
+      def metrics(transactional_id:)
+        make_request(method: :get, path: "v1/transactional-emails/#{transactional_id}/metrics")
+      end
+
       def send(transactional_id:, email:, add_to_audience: false, data_variables: {}, attachments: [], headers: {})
         attachments = attachments.map do |attachment|
           attachment.transform_keys { |key| key == :content_type ? :contentType : key }

data/lib/loops_sdk/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module LoopsSdk
-  VERSION = "2.4.0"
+  VERSION = "2.6.0"
 end

data/lib/loops_sdk/workflow_groups.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module LoopsSdk
+  class WorkflowGroups < Base
+    class << self
+      def list(perPage: 20, cursor: nil)
+        make_request(method: :get, path: "v1/workflow-groups", params: { perPage: perPage, cursor: cursor })
+      end
+
+      def create(name:, description: nil)
+        body = { name: name, description: description }.compact
+        make_request(method: :post, path: "v1/workflow-groups", body: body)
+      end
+
+      def get(workflow_group_id:)
+        make_request(method: :get, path: "v1/workflow-groups/#{workflow_group_id}")
+      end
+
+      def update(workflow_group_id:, name: nil, description: nil)
+        body = { name: name, description: description }.compact
+        make_request(method: :post, path: "v1/workflow-groups/#{workflow_group_id}", body: body)
+      end
+    end
+  end
+end

data/lib/loops_sdk/workflows.rb

@@ -7,11 +7,12 @@ module LoopsSdk
         make_request(method: :get, path: "v1/workflows", params: { perPage: perPage, cursor: cursor })
       end
 
-      def create(name:, description: nil, mailing_list_id: nil)
+      def create(name:, description: nil, mailing_list_id: nil, workflow_group_id: nil)
         body = {
           name: name,
           description: description,
-          mailingListId: mailing_list_id
+          mailingListId: mailing_list_id,
+          workflowGroupId: workflow_group_id
         }.compact
         make_request(method: :post, path: "v1/workflows", body: body)
       end
@@ -20,17 +21,28 @@ module LoopsSdk
         make_request(method: :get, path: "v1/workflows/#{workflow_id}")
       end
 
-      def update(workflow_id:, expected_revision_id:, name: nil, description: nil)
+      def update(workflow_id:, expected_revision_id:, name: nil, description: nil, workflow_group_id: nil)
         body = {
           expectedRevisionId: expected_revision_id,
           name: name,
-          description: description
+          description: description,
+          workflowGroupId: workflow_group_id
         }.compact
         # expectedRevisionId may be null for older workflows; always include it
         body[:expectedRevisionId] = expected_revision_id
         make_request(method: :post, path: "v1/workflows/#{workflow_id}", body: body)
       end
 
+      def delete(workflow_id:, expected_revision_id:, confirm_delete: nil)
+        body = {
+          expectedRevisionId: expected_revision_id,
+          confirmDelete: confirm_delete
+        }.compact
+        # expectedRevisionId may be null for older workflows; always include it
+        body[:expectedRevisionId] = expected_revision_id
+        make_request(method: :delete, path: "v1/workflows/#{workflow_id}", body: body)
+      end
+
       def change_mailing_list(workflow_id:, expected_revision_id:, mailing_list_id:, dry_run: nil, queued_contact_policy: nil)
         body = {
           expectedRevisionId: expected_revision_id,
@@ -48,6 +60,10 @@ module LoopsSdk
         make_request(method: :get, path: "v1/workflows/#{workflow_id}/nodes/#{node_id}")
       end
 
+      def get_node_metrics(workflow_id:, node_id:)
+        make_request(method: :get, path: "v1/workflows/#{workflow_id}/nodes/#{node_id}/metrics")
+      end
+
       def create_node(
         workflow_id:,
         expected_revision_id:,
@@ -60,12 +76,36 @@ module LoopsSdk
         body = {
           expectedRevisionId: expected_revision_id,
           insertMode: insert_mode,
-          nodeTypeName: node_type_name,
-          fromNodeId: from_node_id,
-          toNodeId: to_node_id,
-          beforeNodeId: before_node_id
-        }.compact
-        body[:expectedRevisionId] = expected_revision_id
+          nodeTypeName: node_type_name
+        }
+
+        case insert_mode
+        when "between"
+          raise ArgumentError, "from_node_id and to_node_id are required when insert_mode is \"between\"." if from_node_id.nil? || to_node_id.nil?
+          raise ArgumentError, "before_node_id is not permitted when insert_mode is \"between\"." unless before_node_id.nil?
+
+          body[:fromNodeId] = from_node_id
+          body[:toNodeId] = to_node_id
+        when "before"
+          raise ArgumentError, "from_node_id is not permitted when insert_mode is \"before\"." unless from_node_id.nil?
+          raise ArgumentError, "Provide either to_node_id or before_node_id when insert_mode is \"before\", not both." if !to_node_id.nil? && !before_node_id.nil?
+          raise ArgumentError, "to_node_id or before_node_id is required when insert_mode is \"before\"." if to_node_id.nil? && before_node_id.nil?
+
+          if !to_node_id.nil?
+            body[:toNodeId] = to_node_id
+          else
+            body[:beforeNodeId] = before_node_id
+          end
+        when "after"
+          raise ArgumentError, "from_node_id is required when insert_mode is \"after\"." if from_node_id.nil?
+          raise ArgumentError, "to_node_id is not permitted when insert_mode is \"after\"." unless to_node_id.nil?
+          raise ArgumentError, "before_node_id is not permitted when insert_mode is \"after\"." unless before_node_id.nil?
+
+          body[:fromNodeId] = from_node_id
+        else
+          raise ArgumentError, "insert_mode must be \"between\", \"before\", or \"after\"."
+        end
+
         make_request(method: :post, path: "v1/workflows/#{workflow_id}/nodes", body: body)
       end
 
@@ -92,6 +132,14 @@ module LoopsSdk
         make_request(method: :post, path: "v1/workflows/#{workflow_id}/nodes/#{node_id}/add-branch", body: body)
       end
 
+      def reroute_node(workflow_id:, node_id:, expected_revision_id:, new_target_node_id:)
+        body = {
+          expectedRevisionId: expected_revision_id,
+          newTargetNodeId: new_target_node_id
+        }
+        make_request(method: :post, path: "v1/workflows/#{workflow_id}/nodes/#{node_id}/reroute", body: body)
+      end
+
       def delete_node_recursive(workflow_id:, node_id:, expected_revision_id:, dry_run: nil, queued_contact_policy: nil)
         body = {
           expectedRevisionId: expected_revision_id,

data/lib/loops_sdk.rb

@@ -20,6 +20,7 @@ require_relative "loops_sdk/email_messages"
 require_relative "loops_sdk/uploads"
 require_relative "loops_sdk/audience_segments"
 require_relative "loops_sdk/workflows"
+require_relative "loops_sdk/workflow_groups"
 require_relative "loops_sdk/event_patterns"
 require_relative "loops_sdk/transactional_groups"
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: loops_sdk
 version: !ruby/object:Gem::Version
-  version: 2.4.0
+  version: 2.6.0
 platform: ruby
 authors:
 - Dan Rowden
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-08-04 00:00:00.000000000 Z
+date: 2026-11-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -53,6 +53,7 @@ files:
 - lib/loops_sdk/transactional_groups.rb
 - lib/loops_sdk/uploads.rb
 - lib/loops_sdk/version.rb
+- lib/loops_sdk/workflow_groups.rb
 - lib/loops_sdk/workflows.rb
 homepage: https://loops.so/docs/api-reference
 licenses: