trycourier 6.0.0 → 6.1.0

data/rbi/courier/models/journeys/run_list_steps_params.rbi

@@ -0,0 +1,40 @@
+# typed: strong
+
+module Courier
+  module Models
+    module Journeys
+      class RunListStepsParams < Courier::Internal::Type::BaseModel
+        extend Courier::Internal::Type::RequestParameters::Converter
+        include Courier::Internal::Type::RequestParameters
+
+        OrHash =
+          T.type_alias do
+            T.any(
+              Courier::Journeys::RunListStepsParams,
+              Courier::Internal::AnyHash
+            )
+          end
+
+        sig { returns(String) }
+        attr_accessor :run_id
+
+        sig do
+          params(
+            run_id: String,
+            request_options: Courier::RequestOptions::OrHash
+          ).returns(T.attached_class)
+        end
+        def self.new(run_id:, request_options: {})
+        end
+
+        sig do
+          override.returns(
+            { run_id: String, request_options: Courier::RequestOptions }
+          )
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/courier/models/journeys/run_retrieve_params.rbi

@@ -0,0 +1,40 @@
+# typed: strong
+
+module Courier
+  module Models
+    module Journeys
+      class RunRetrieveParams < Courier::Internal::Type::BaseModel
+        extend Courier::Internal::Type::RequestParameters::Converter
+        include Courier::Internal::Type::RequestParameters
+
+        OrHash =
+          T.type_alias do
+            T.any(
+              Courier::Journeys::RunRetrieveParams,
+              Courier::Internal::AnyHash
+            )
+          end
+
+        sig { returns(String) }
+        attr_accessor :run_id
+
+        sig do
+          params(
+            run_id: String,
+            request_options: Courier::RequestOptions::OrHash
+          ).returns(T.attached_class)
+        end
+        def self.new(run_id:, request_options: {})
+        end
+
+        sig do
+          override.returns(
+            { run_id: String, request_options: Courier::RequestOptions }
+          )
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/courier/models/users/topic_preference.rbi

@@ -43,6 +43,24 @@ module Courier
         sig { returns(T.nilable(T::Boolean)) }
         attr_accessor :has_custom_routing
 
+        # The unique identifier of the section this topic belongs to. Always present when
+        # listing a user's preferences; omitted by the single-topic read when the topic
+        # has no resolvable section.
+        sig { returns(T.nilable(String)) }
+        attr_reader :section_id
+
+        sig { params(section_id: String).void }
+        attr_writer :section_id
+
+        # The display name of the section this topic belongs to. Always present when
+        # listing a user's preferences; omitted by the single-topic read when the topic
+        # has no resolvable section.
+        sig { returns(T.nilable(String)) }
+        attr_reader :section_name
+
+        sig { params(section_name: String).void }
+        attr_writer :section_name
+
         sig do
           params(
             default_status: Courier::PreferenceStatus::OrSymbol,
@@ -51,7 +69,9 @@ module Courier
             topic_name: String,
             custom_routing:
               T.nilable(T::Array[Courier::ChannelClassification::OrSymbol]),
-            has_custom_routing: T.nilable(T::Boolean)
+            has_custom_routing: T.nilable(T::Boolean),
+            section_id: String,
+            section_name: String
           ).returns(T.attached_class)
         end
         def self.new(
@@ -72,7 +92,15 @@ module Courier
           custom_routing: nil,
           # Whether the user has chosen specific delivery channels for this topic (listed in
           # custom_routing) rather than the topic's default routing.
-          has_custom_routing: nil
+          has_custom_routing: nil,
+          # The unique identifier of the section this topic belongs to. Always present when
+          # listing a user's preferences; omitted by the single-topic read when the topic
+          # has no resolvable section.
+          section_id: nil,
+          # The display name of the section this topic belongs to. Always present when
+          # listing a user's preferences; omitted by the single-topic read when the topic
+          # has no resolvable section.
+          section_name: nil
         )
         end
 
@@ -87,7 +115,9 @@ module Courier
                 T.nilable(
                   T::Array[Courier::ChannelClassification::TaggedSymbol]
                 ),
-              has_custom_routing: T.nilable(T::Boolean)
+              has_custom_routing: T.nilable(T::Boolean),
+              section_id: String,
+              section_name: String
             }
           )
         end

data/rbi/courier/models.rbi

@@ -42,6 +42,14 @@ module Courier
 
   AutomationListParams = Courier::Models::AutomationListParams
 
+  AutomationRunListItem = Courier::Models::AutomationRunListItem
+
+  AutomationRunListResponse = Courier::Models::AutomationRunListResponse
+
+  AutomationRunStep = Courier::Models::AutomationRunStep
+
+  AutomationRunStepsResponse = Courier::Models::AutomationRunStepsResponse
+
   Automations = Courier::Models::Automations
 
   AutomationTemplate = Courier::Models::AutomationTemplate
@@ -210,6 +218,8 @@ module Courier
 
   JourneyArchiveParams = Courier::Models::JourneyArchiveParams
 
+  JourneyAudienceTriggerNode = Courier::Models::JourneyAudienceTriggerNode
+
   JourneyCancelParams = Courier::Models::JourneyCancelParams
 
   JourneyConditionAtom =
@@ -260,6 +270,18 @@ module Courier
 
   JourneyRetrieveParams = Courier::Models::JourneyRetrieveParams
 
+  JourneyRun = Courier::Models::JourneyRun
+
+  JourneyRunListItem = Courier::Models::JourneyRunListItem
+
+  JourneyRunListResponse = Courier::Models::JourneyRunListResponse
+
+  JourneyRunResponse = Courier::Models::JourneyRunResponse
+
+  JourneyRunStep = Courier::Models::JourneyRunStep
+
+  JourneyRunStepsResponse = Courier::Models::JourneyRunStepsResponse
+
   Journeys = Courier::Models::Journeys
 
   JourneySegmentTriggerNode = Courier::Models::JourneySegmentTriggerNode
@@ -294,6 +316,8 @@ module Courier
 
   JourneyVersionsListResponse = Courier::Models::JourneyVersionsListResponse
 
+  JourneyWebhookTriggerNode = Courier::Models::JourneyWebhookTriggerNode
+
   ListDeleteParams = Courier::Models::ListDeleteParams
 
   ListFilter = Courier::Models::ListFilter

data/rbi/courier/resources/automations/runs.rbi

@@ -0,0 +1,69 @@
+# typed: strong
+
+module Courier
+  module Resources
+    class Automations
+      # Invoke a stored automation template or an ad hoc automation defined in the
+      # request.
+      class Runs
+        # List runs of the workspace's v2 Automations, newest first, filtered by status,
+        # Template, or date range and paged by cursor. Journey (v3) runs are listed by
+        # `GET /journeys/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::AutomationRunListResponse)
+        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 Automation Template ids to filter on.
+          template_id: nil,
+          request_options: {}
+        )
+        end
+
+        # List the per-step state of one Automation run, in full — this endpoint is not
+        # paginated. `message_id` is present on send steps that produced a message; follow
+        # it to `GET /messages/{message_id}` for delivery status. A send to a List or an
+        # Audience yields one `message_id` for the request, not one per recipient.
+        sig do
+          params(
+            id: String,
+            request_options: Courier::RequestOptions::OrHash
+          ).returns(Courier::AutomationRunStepsResponse)
+        end
+        def list_steps(
+          # A unique identifier representing the Automation 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/automations.rbi

@@ -10,6 +10,11 @@ module Courier
       sig { returns(Courier::Resources::Automations::Invoke) }
       attr_reader :invoke
 
+      # Invoke a stored automation template or an ad hoc automation defined in the
+      # request.
+      sig { returns(Courier::Resources::Automations::Runs) }
+      attr_reader :runs
+
       # Lists the workspace's saved automation templates, each with its id and a cursor
       # for paging to the next page of results.
       sig do

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/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