trycourier 5.0.0 → 6.1.0

data/rbi/courier/resources/journeys/runs.rbi

@@ -0,0 +1,87 @@
+# typed: strong
+
+module Courier
+  module Resources
+    class Journeys
+      # Build, version, publish, invoke, and cancel multi-step notification workflows,
+      # along with the templates scoped to them.
+      class Runs
+        # Fetch one Journey run by id. Returns `404` for an unknown run, a run belonging
+        # to another workspace, a run past the 95-day retention window, or an Automation
+        # run id — the same body in every case, so the response never reveals whether a
+        # run exists elsewhere.
+        sig do
+          params(
+            run_id: String,
+            request_options: Courier::RequestOptions::OrHash
+          ).returns(Courier::JourneyRunResponse)
+        end
+        def retrieve(
+          # A unique identifier representing the Journey run.
+          run_id,
+          request_options: {}
+        )
+        end
+
+        # List runs of the workspace's Journeys, newest first, filtered by status,
+        # Journey, or date range and paged by cursor. Runs of v2 Automations are listed by
+        # `GET /automations/runs` instead — the two surfaces never return each other's
+        # runs. Runs are retained for 95 days.
+        sig do
+          params(
+            cursor: String,
+            end_date: String,
+            limit: String,
+            start_date: String,
+            status: String,
+            template_id: String,
+            request_options: Courier::RequestOptions::OrHash
+          ).returns(Courier::JourneyRunListResponse)
+        end
+        def list(
+          # A cursor token for pagination. Use the `next_cursor` from the previous response
+          # to fetch the next page of results. Treat it as opaque.
+          cursor: nil,
+          # An inclusive upper bound on `created_at`, in the same format as `start_date`.
+          end_date: nil,
+          # The number of runs to return per page, between `1` and `50`. Defaults to `20`.
+          # Values outside the range are clamped, and a non-numeric value falls back to
+          # `20`.
+          limit: nil,
+          # An inclusive lower bound on `created_at`, as an ISO 8601 date or timestamp (e.g.
+          # `2026-08-18` or `2026-08-18T20:06:36.259Z`). Any other format returns `400`.
+          start_date: nil,
+          # A comma-separated list of run statuses to filter on, e.g. `PROCESSED,ERROR`.
+          status: nil,
+          # A comma-separated list of Journey ids to filter on.
+          template_id: nil,
+          request_options: {}
+        )
+        end
+
+        # List the per-node state of one Journey run, in full — this endpoint is not
+        # paginated. Each step's `node_id` is the id of the node in the published Journey,
+        # so a step maps directly onto the Journey graph. `message_id` is present on send
+        # steps that produced a message; follow it to `GET /messages/{message_id}` for
+        # delivery status.
+        sig do
+          params(
+            run_id: String,
+            request_options: Courier::RequestOptions::OrHash
+          ).returns(Courier::JourneyRunStepsResponse)
+        end
+        def list_steps(
+          # A unique identifier representing the Journey run.
+          run_id,
+          request_options: {}
+        )
+        end
+
+        # @api private
+        sig { params(client: Courier::Client).returns(T.attached_class) }
+        def self.new(client:)
+        end
+      end
+    end
+  end
+end

data/rbi/courier/resources/journeys.rbi

@@ -10,6 +10,11 @@ module Courier
       sig { returns(Courier::Resources::Journeys::Templates) }
       attr_reader :templates
 
+      # Build, version, publish, invoke, and cancel multi-step notification workflows,
+      # along with the templates scoped to them.
+      sig { returns(Courier::Resources::Journeys::Runs) }
+      attr_reader :runs
+
       # Creates a journey from a set of nodes, in draft state unless you pass a
       # published state. Send nodes cannot be included until their templates exist.
       sig do
@@ -20,6 +25,8 @@ module Courier
               T.any(
                 Courier::JourneyAPIInvokeTriggerNode::OrHash,
                 Courier::JourneySegmentTriggerNode::OrHash,
+                Courier::JourneyAudienceTriggerNode::OrHash,
+                Courier::JourneyWebhookTriggerNode::OrHash,
                 Courier::JourneySendNode::OrHash,
                 Courier::JourneyDelayDurationNode::OrHash,
                 Courier::JourneyDelayUntilNode::OrHash,
@@ -260,6 +267,8 @@ module Courier
               T.any(
                 Courier::JourneyAPIInvokeTriggerNode::OrHash,
                 Courier::JourneySegmentTriggerNode::OrHash,
+                Courier::JourneyAudienceTriggerNode::OrHash,
+                Courier::JourneyWebhookTriggerNode::OrHash,
                 Courier::JourneySendNode::OrHash,
                 Courier::JourneyDelayDurationNode::OrHash,
                 Courier::JourneyDelayUntilNode::OrHash,

data/rbi/courier/resources/notifications.rbi

@@ -99,22 +99,6 @@ module Courier
       )
       end
 
-      # Copies a notification template within the same workspace and environment,
-      # appending " COPY" to the title. The copy is standalone and independently
-      # editable.
-      sig do
-        params(
-          id: String,
-          request_options: Courier::RequestOptions::OrHash
-        ).returns(Courier::NotificationTemplateResponse)
-      end
-      def duplicate(
-        # Template ID (nt\_ prefix).
-        id,
-        request_options: {}
-      )
-      end
-
       # Returns a notification template's published versions, most recent first, for
       # comparison or rollback. Paged.
       sig do

data/sig/courier/models/apn.rbs

@@ -0,0 +1,11 @@
+module Courier
+  module Models
+    type apn = Courier::Token | Courier::MultipleTokens
+
+    module Apn
+      extend Courier::Internal::Type::Union
+
+      def self?.variants: -> ::Array[Courier::Models::apn]
+    end
+  end
+end

data/sig/courier/models/automation_run_list_item.rbs

@@ -0,0 +1,46 @@
+module Courier
+  module Models
+    type automation_run_list_item =
+      {
+        run_id: String,
+        source: ::Array[String],
+        created_at: String,
+        status: String,
+        template_id: String
+      }
+
+    class AutomationRunListItem < Courier::Internal::Type::BaseModel
+      attr_accessor run_id: String
+
+      attr_accessor source: ::Array[String]
+
+      attr_reader created_at: String?
+
+      def created_at=: (String) -> String
+
+      attr_reader status: String?
+
+      def status=: (String) -> String
+
+      attr_reader template_id: String?
+
+      def template_id=: (String) -> String
+
+      def initialize: (
+        run_id: String,
+        source: ::Array[String],
+        ?created_at: String,
+        ?status: String,
+        ?template_id: String
+      ) -> void
+
+      def to_hash: -> {
+        run_id: String,
+        source: ::Array[String],
+        created_at: String,
+        status: String,
+        template_id: String
+      }
+    end
+  end
+end

data/sig/courier/models/automation_run_list_response.rbs

@@ -0,0 +1,24 @@
+module Courier
+  module Models
+    type automation_run_list_response =
+      { runs: ::Array[Courier::AutomationRunListItem], next_cursor: String }
+
+    class AutomationRunListResponse < Courier::Internal::Type::BaseModel
+      attr_accessor runs: ::Array[Courier::AutomationRunListItem]
+
+      attr_reader next_cursor: String?
+
+      def next_cursor=: (String) -> String
+
+      def initialize: (
+        runs: ::Array[Courier::AutomationRunListItem],
+        ?next_cursor: String
+      ) -> void
+
+      def to_hash: -> {
+        runs: ::Array[Courier::AutomationRunListItem],
+        next_cursor: String
+      }
+    end
+  end
+end

data/sig/courier/models/automation_run_step.rbs

@@ -0,0 +1,53 @@
+module Courier
+  module Models
+    type automation_run_step =
+      {
+        action: String,
+        status: String,
+        created_at: String,
+        message_id: String,
+        step_id: String,
+        updated_at: String
+      }
+
+    class AutomationRunStep < Courier::Internal::Type::BaseModel
+      attr_accessor action: String
+
+      attr_accessor status: String
+
+      attr_reader created_at: String?
+
+      def created_at=: (String) -> String
+
+      attr_reader message_id: String?
+
+      def message_id=: (String) -> String
+
+      attr_reader step_id: String?
+
+      def step_id=: (String) -> String
+
+      attr_reader updated_at: String?
+
+      def updated_at=: (String) -> String
+
+      def initialize: (
+        action: String,
+        status: String,
+        ?created_at: String,
+        ?message_id: String,
+        ?step_id: String,
+        ?updated_at: String
+      ) -> void
+
+      def to_hash: -> {
+        action: String,
+        status: String,
+        created_at: String,
+        message_id: String,
+        step_id: String,
+        updated_at: String
+      }
+    end
+  end
+end

data/sig/courier/models/automation_run_steps_response.rbs

@@ -0,0 +1,14 @@
+module Courier
+  module Models
+    type automation_run_steps_response =
+      { steps: ::Array[Courier::AutomationRunStep] }
+
+    class AutomationRunStepsResponse < Courier::Internal::Type::BaseModel
+      attr_accessor steps: ::Array[Courier::AutomationRunStep]
+
+      def initialize: (steps: ::Array[Courier::AutomationRunStep]) -> void
+
+      def to_hash: -> { steps: ::Array[Courier::AutomationRunStep] }
+    end
+  end
+end

data/sig/courier/models/automations/run_list_params.rbs

@@ -0,0 +1,65 @@
+module Courier
+  module Models
+    module Automations
+      type run_list_params =
+        {
+          cursor: String,
+          end_date: String,
+          limit: String,
+          start_date: String,
+          status: String,
+          template_id: String
+        }
+        & Courier::Internal::Type::request_parameters
+
+      class RunListParams < Courier::Internal::Type::BaseModel
+        extend Courier::Internal::Type::RequestParameters::Converter
+        include Courier::Internal::Type::RequestParameters
+
+        attr_reader cursor: String?
+
+        def cursor=: (String) -> String
+
+        attr_reader end_date: String?
+
+        def end_date=: (String) -> String
+
+        attr_reader limit: String?
+
+        def limit=: (String) -> String
+
+        attr_reader start_date: String?
+
+        def start_date=: (String) -> String
+
+        attr_reader status: String?
+
+        def status=: (String) -> String
+
+        attr_reader template_id: String?
+
+        def template_id=: (String) -> String
+
+        def initialize: (
+          ?cursor: String,
+          ?end_date: String,
+          ?limit: String,
+          ?start_date: String,
+          ?status: String,
+          ?template_id: String,
+          ?request_options: Courier::request_opts
+        ) -> void
+
+        def to_hash: -> {
+          cursor: String,
+          end_date: String,
+          limit: String,
+          start_date: String,
+          status: String,
+          template_id: String,
+          request_options: Courier::RequestOptions
+        }
+      end
+    end
+  end
+end

data/sig/courier/models/automations/run_list_steps_params.rbs

@@ -0,0 +1,22 @@
+module Courier
+  module Models
+    module Automations
+      type run_list_steps_params =
+        { id: String } & Courier::Internal::Type::request_parameters
+
+      class RunListStepsParams < Courier::Internal::Type::BaseModel
+        extend Courier::Internal::Type::RequestParameters::Converter
+        include Courier::Internal::Type::RequestParameters
+
+        attr_accessor id: String
+
+        def initialize: (
+          id: String,
+          ?request_options: Courier::request_opts
+        ) -> void
+
+        def to_hash: -> { id: String, request_options: Courier::RequestOptions }
+      end
+    end
+  end
+end

data/sig/courier/models/journey_audience_trigger_node.rbs

@@ -0,0 +1,66 @@
+module Courier
+  module Models
+    type journey_audience_trigger_node =
+      {
+        audience_id: String,
+        trigger_type: Courier::Models::JourneyAudienceTriggerNode::trigger_type,
+        type: Courier::Models::JourneyAudienceTriggerNode::type_,
+        id: String,
+        conditions: Courier::Models::journey_conditions_field
+      }
+
+    class JourneyAudienceTriggerNode < Courier::Internal::Type::BaseModel
+      attr_accessor audience_id: String
+
+      attr_accessor trigger_type: Courier::Models::JourneyAudienceTriggerNode::trigger_type
+
+      attr_accessor type: Courier::Models::JourneyAudienceTriggerNode::type_
+
+      attr_reader id: String?
+
+      def id=: (String) -> String
+
+      attr_reader conditions: Courier::Models::journey_conditions_field?
+
+      def conditions=: (
+        Courier::Models::journey_conditions_field
+      ) -> Courier::Models::journey_conditions_field
+
+      def initialize: (
+        audience_id: String,
+        trigger_type: Courier::Models::JourneyAudienceTriggerNode::trigger_type,
+        type: Courier::Models::JourneyAudienceTriggerNode::type_,
+        ?id: String,
+        ?conditions: Courier::Models::journey_conditions_field
+      ) -> void
+
+      def to_hash: -> {
+        audience_id: String,
+        trigger_type: Courier::Models::JourneyAudienceTriggerNode::trigger_type,
+        type: Courier::Models::JourneyAudienceTriggerNode::type_,
+        id: String,
+        conditions: Courier::Models::journey_conditions_field
+      }
+
+      type trigger_type = :audience
+
+      module TriggerType
+        extend Courier::Internal::Type::Enum
+
+        AUDIENCE: :audience
+
+        def self?.values: -> ::Array[Courier::Models::JourneyAudienceTriggerNode::trigger_type]
+      end
+
+      type type_ = :trigger
+
+      module Type
+        extend Courier::Internal::Type::Enum
+
+        TRIGGER: :trigger
+
+        def self?.values: -> ::Array[Courier::Models::JourneyAudienceTriggerNode::type_]
+      end
+    end
+  end
+end

data/sig/courier/models/journey_node.rbs

@@ -3,6 +3,8 @@ module Courier
     type journey_node =
       Courier::JourneyAPIInvokeTriggerNode
       | Courier::JourneySegmentTriggerNode
+      | Courier::JourneyAudienceTriggerNode
+      | Courier::JourneyWebhookTriggerNode
       | Courier::JourneySendNode
       | Courier::JourneyDelayDurationNode
       | Courier::JourneyDelayUntilNode

data/sig/courier/models/journey_run.rbs

@@ -0,0 +1,53 @@
+module Courier
+  module Models
+    type journey_run =
+      {
+        run_id: String,
+        source: ::Array[String],
+        created_at: String,
+        status: String,
+        template_id: String,
+        updated_at: String
+      }
+
+    class JourneyRun < Courier::Internal::Type::BaseModel
+      attr_accessor run_id: String
+
+      attr_accessor source: ::Array[String]
+
+      attr_reader created_at: String?
+
+      def created_at=: (String) -> String
+
+      attr_reader status: String?
+
+      def status=: (String) -> String
+
+      attr_reader template_id: String?
+
+      def template_id=: (String) -> String
+
+      attr_reader updated_at: String?
+
+      def updated_at=: (String) -> String
+
+      def initialize: (
+        run_id: String,
+        source: ::Array[String],
+        ?created_at: String,
+        ?status: String,
+        ?template_id: String,
+        ?updated_at: String
+      ) -> void
+
+      def to_hash: -> {
+        run_id: String,
+        source: ::Array[String],
+        created_at: String,
+        status: String,
+        template_id: String,
+        updated_at: String
+      }
+    end
+  end
+end

data/sig/courier/models/journey_run_list_item.rbs

@@ -0,0 +1,46 @@
+module Courier
+  module Models
+    type journey_run_list_item =
+      {
+        run_id: String,
+        source: ::Array[String],
+        created_at: String,
+        status: String,
+        template_id: String
+      }
+
+    class JourneyRunListItem < Courier::Internal::Type::BaseModel
+      attr_accessor run_id: String
+
+      attr_accessor source: ::Array[String]
+
+      attr_reader created_at: String?
+
+      def created_at=: (String) -> String
+
+      attr_reader status: String?
+
+      def status=: (String) -> String
+
+      attr_reader template_id: String?
+
+      def template_id=: (String) -> String
+
+      def initialize: (
+        run_id: String,
+        source: ::Array[String],
+        ?created_at: String,
+        ?status: String,
+        ?template_id: String
+      ) -> void
+
+      def to_hash: -> {
+        run_id: String,
+        source: ::Array[String],
+        created_at: String,
+        status: String,
+        template_id: String
+      }
+    end
+  end
+end

data/sig/courier/models/journey_run_list_response.rbs

@@ -0,0 +1,34 @@
+module Courier
+  module Models
+    type journey_run_list_response =
+      {
+        runs: ::Array[Courier::JourneyRunListItem],
+        next_cursor: String,
+        prev_cursor: String
+      }
+
+    class JourneyRunListResponse < Courier::Internal::Type::BaseModel
+      attr_accessor runs: ::Array[Courier::JourneyRunListItem]
+
+      attr_reader next_cursor: String?
+
+      def next_cursor=: (String) -> String
+
+      attr_reader prev_cursor: String?
+
+      def prev_cursor=: (String) -> String
+
+      def initialize: (
+        runs: ::Array[Courier::JourneyRunListItem],
+        ?next_cursor: String,
+        ?prev_cursor: String
+      ) -> void
+
+      def to_hash: -> {
+        runs: ::Array[Courier::JourneyRunListItem],
+        next_cursor: String,
+        prev_cursor: String
+      }
+    end
+  end
+end

data/sig/courier/models/journey_run_response.rbs

@@ -0,0 +1,13 @@
+module Courier
+  module Models
+    type journey_run_response = { run: Courier::JourneyRun }
+
+    class JourneyRunResponse < Courier::Internal::Type::BaseModel
+      attr_accessor run: Courier::JourneyRun
+
+      def initialize: (run: Courier::JourneyRun) -> void
+
+      def to_hash: -> { run: Courier::JourneyRun }
+    end
+  end
+end

data/sig/courier/models/journey_run_step.rbs

@@ -0,0 +1,53 @@
+module Courier
+  module Models
+    type journey_run_step =
+      {
+        action: String,
+        status: String,
+        created_at: String,
+        message_id: String,
+        node_id: String,
+        updated_at: String
+      }
+
+    class JourneyRunStep < Courier::Internal::Type::BaseModel
+      attr_accessor action: String
+
+      attr_accessor status: String
+
+      attr_reader created_at: String?
+
+      def created_at=: (String) -> String
+
+      attr_reader message_id: String?
+
+      def message_id=: (String) -> String
+
+      attr_reader node_id: String?
+
+      def node_id=: (String) -> String
+
+      attr_reader updated_at: String?
+
+      def updated_at=: (String) -> String
+
+      def initialize: (
+        action: String,
+        status: String,
+        ?created_at: String,
+        ?message_id: String,
+        ?node_id: String,
+        ?updated_at: String
+      ) -> void
+
+      def to_hash: -> {
+        action: String,
+        status: String,
+        created_at: String,
+        message_id: String,
+        node_id: String,
+        updated_at: String
+      }
+    end
+  end
+end

data/sig/courier/models/journey_run_steps_response.rbs

@@ -0,0 +1,14 @@
+module Courier
+  module Models
+    type journey_run_steps_response =
+      { steps: ::Array[Courier::JourneyRunStep] }
+
+    class JourneyRunStepsResponse < Courier::Internal::Type::BaseModel
+      attr_accessor steps: ::Array[Courier::JourneyRunStep]
+
+      def initialize: (steps: ::Array[Courier::JourneyRunStep]) -> void
+
+      def to_hash: -> { steps: ::Array[Courier::JourneyRunStep] }
+    end
+  end
+end

data/sig/courier/models/journey_segment_trigger_node.rbs

@@ -49,7 +49,7 @@ module Courier
         event_id: String
       }
 
-      type request_type = :identify | :group | :track
+      type request_type = :identify | :group | :track | :page
 
       module RequestType
         extend Courier::Internal::Type::Enum
@@ -57,6 +57,7 @@ module Courier
         IDENTIFY: :identify
         GROUP: :group
         TRACK: :track
+        PAGE: :page
 
         def self?.values: -> ::Array[Courier::Models::JourneySegmentTriggerNode::request_type]
       end