trycourier 6.0.0 → 6.2.0

data/lib/courier/resources/automations/runs.rb

@@ -0,0 +1,80 @@
+# frozen_string_literal: true
+
+module Courier
+  module Resources
+    class Automations
+      # Invoke a stored automation template or an ad hoc automation defined in the
+      # request.
+      class Runs
+        # Some parameter documentations has been truncated, see
+        # {Courier::Models::Automations::RunListParams} for more details.
+        #
+        # 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.
+        #
+        # @overload list(cursor: nil, end_date: nil, limit: nil, start_date: nil, status: nil, template_id: nil, request_options: {})
+        #
+        # @param cursor [String] A cursor token for pagination. Use the `next_cursor` from the previous response
+        #
+        # @param end_date [String] An inclusive upper bound on `created_at`, in the same format as `start_date`.
+        #
+        # @param limit [String] The number of runs to return per page, between `1` and `50`. Defaults to `20`. V
+        #
+        # @param start_date [String] An inclusive lower bound on `created_at`, as an ISO 8601 date or timestamp (e.g.
+        #
+        # @param status [String] A comma-separated list of run statuses to filter on, e.g. `PROCESSED,ERROR`.
+        #
+        # @param template_id [String] A comma-separated list of Automation Template ids to filter on.
+        #
+        # @param request_options [Courier::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Courier::Models::AutomationRunListResponse]
+        #
+        # @see Courier::Models::Automations::RunListParams
+        def list(params = {})
+          parsed, options = Courier::Automations::RunListParams.dump_request(params)
+          query = Courier::Internal::Util.encode_query_params(parsed)
+          @client.request(
+            method: :get,
+            path: "automations/runs",
+            query: query,
+            model: Courier::AutomationRunListResponse,
+            options: 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.
+        #
+        # @overload list_steps(id, request_options: {})
+        #
+        # @param id [String] A unique identifier representing the Automation run.
+        #
+        # @param request_options [Courier::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Courier::Models::AutomationRunStepsResponse]
+        #
+        # @see Courier::Models::Automations::RunListStepsParams
+        def list_steps(id, params = {})
+          @client.request(
+            method: :get,
+            path: ["automations/runs/%1$s/steps", id],
+            model: Courier::AutomationRunStepsResponse,
+            options: params[:request_options]
+          )
+        end
+
+        # @api private
+        #
+        # @param client [Courier::Client]
+        def initialize(client:)
+          @client = client
+        end
+      end
+    end
+  end
+end

data/lib/courier/resources/automations.rb

@@ -10,6 +10,11 @@ module Courier
       # @return [Courier::Resources::Automations::Invoke]
       attr_reader :invoke
 
+      # Invoke a stored automation template or an ad hoc automation defined in the
+      # request.
+      # @return [Courier::Resources::Automations::Runs]
+      attr_reader :runs
+
       # Some parameter documentations has been truncated, see
       # {Courier::Models::AutomationListParams} for more details.
       #
@@ -45,6 +50,7 @@ module Courier
       def initialize(client:)
         @client = client
         @invoke = Courier::Resources::Automations::Invoke.new(client: client)
+        @runs = Courier::Resources::Automations::Runs.new(client: client)
       end
     end
   end

data/lib/courier/resources/journeys/runs.rb

@@ -0,0 +1,104 @@
+# frozen_string_literal: true
+
+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.
+        #
+        # @overload retrieve(run_id, request_options: {})
+        #
+        # @param run_id [String] A unique identifier representing the Journey run.
+        #
+        # @param request_options [Courier::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Courier::Models::JourneyRunResponse]
+        #
+        # @see Courier::Models::Journeys::RunRetrieveParams
+        def retrieve(run_id, params = {})
+          @client.request(
+            method: :get,
+            path: ["journeys/runs/%1$s", run_id],
+            model: Courier::JourneyRunResponse,
+            options: params[:request_options]
+          )
+        end
+
+        # Some parameter documentations has been truncated, see
+        # {Courier::Models::Journeys::RunListParams} for more details.
+        #
+        # 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.
+        #
+        # @overload list(cursor: nil, end_date: nil, limit: nil, start_date: nil, status: nil, template_id: nil, request_options: {})
+        #
+        # @param cursor [String] A cursor token for pagination. Use the `next_cursor` from the previous response
+        #
+        # @param end_date [String] An inclusive upper bound on `created_at`, in the same format as `start_date`.
+        #
+        # @param limit [String] The number of runs to return per page, between `1` and `50`. Defaults to `20`. V
+        #
+        # @param start_date [String] An inclusive lower bound on `created_at`, as an ISO 8601 date or timestamp (e.g.
+        #
+        # @param status [String] A comma-separated list of run statuses to filter on, e.g. `PROCESSED,ERROR`.
+        #
+        # @param template_id [String] A comma-separated list of Journey ids to filter on.
+        #
+        # @param request_options [Courier::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Courier::Models::JourneyRunListResponse]
+        #
+        # @see Courier::Models::Journeys::RunListParams
+        def list(params = {})
+          parsed, options = Courier::Journeys::RunListParams.dump_request(params)
+          query = Courier::Internal::Util.encode_query_params(parsed)
+          @client.request(
+            method: :get,
+            path: "journeys/runs",
+            query: query,
+            model: Courier::JourneyRunListResponse,
+            options: 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.
+        #
+        # @overload list_steps(run_id, request_options: {})
+        #
+        # @param run_id [String] A unique identifier representing the Journey run.
+        #
+        # @param request_options [Courier::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Courier::Models::JourneyRunStepsResponse]
+        #
+        # @see Courier::Models::Journeys::RunListStepsParams
+        def list_steps(run_id, params = {})
+          @client.request(
+            method: :get,
+            path: ["journeys/runs/%1$s/steps", run_id],
+            model: Courier::JourneyRunStepsResponse,
+            options: params[:request_options]
+          )
+        end
+
+        # @api private
+        #
+        # @param client [Courier::Client]
+        def initialize(client:)
+          @client = client
+        end
+      end
+    end
+  end
+end

data/lib/courier/resources/journeys.rb

@@ -10,6 +10,11 @@ module Courier
       # @return [Courier::Resources::Journeys::Templates]
       attr_reader :templates
 
+      # Build, version, publish, invoke, and cancel multi-step notification workflows,
+      # along with the templates scoped to them.
+      # @return [Courier::Resources::Journeys::Runs]
+      attr_reader :runs
+
       # Some parameter documentations has been truncated, see
       # {Courier::Models::JourneyCreateParams} for more details.
       #
@@ -20,7 +25,7 @@ module Courier
       #
       # @param name [String] Body param
       #
-      # @param nodes [Array<Courier::Models::JourneyAPIInvokeTriggerNode, Courier::Models::JourneySegmentTriggerNode, Courier::Models::JourneySendNode, Courier::Models::JourneyDelayDurationNode, Courier::Models::JourneyDelayUntilNode, Courier::Models::JourneyFetchGetDeleteNode, Courier::Models::JourneyFetchPostPutNode, Courier::Models::JourneyAINode, Courier::Models::JourneyThrottleStaticNode, Courier::Models::JourneyThrottleDynamicNode, Courier::Models::JourneyNode::JourneyBatchNode, Courier::Models::JourneyNode::JourneyAddToDigestNode, Courier::Models::JourneyExitNode, Courier::Models::JourneyNode::JourneyBranchNode>] Body param
+      # @param nodes [Array<Courier::Models::JourneyAPIInvokeTriggerNode, Courier::Models::JourneySegmentTriggerNode, Courier::Models::JourneyAudienceTriggerNode, Courier::Models::JourneyWebhookTriggerNode, Courier::Models::JourneySendNode, Courier::Models::JourneyDelayDurationNode, Courier::Models::JourneyDelayUntilNode, Courier::Models::JourneyFetchGetDeleteNode, Courier::Models::JourneyFetchPostPutNode, Courier::Models::JourneyAINode, Courier::Models::JourneyThrottleStaticNode, Courier::Models::JourneyThrottleDynamicNode, Courier::Models::JourneyNode::JourneyBatchNode, Courier::Models::JourneyNode::JourneyAddToDigestNode, Courier::Models::JourneyExitNode, Courier::Models::JourneyNode::JourneyBranchNode>] Body param
       #
       # @param enabled [Boolean] Body param
       #
@@ -263,7 +268,7 @@ module Courier
       #
       # @param name [String]
       #
-      # @param nodes [Array<Courier::Models::JourneyAPIInvokeTriggerNode, Courier::Models::JourneySegmentTriggerNode, Courier::Models::JourneySendNode, Courier::Models::JourneyDelayDurationNode, Courier::Models::JourneyDelayUntilNode, Courier::Models::JourneyFetchGetDeleteNode, Courier::Models::JourneyFetchPostPutNode, Courier::Models::JourneyAINode, Courier::Models::JourneyThrottleStaticNode, Courier::Models::JourneyThrottleDynamicNode, Courier::Models::JourneyNode::JourneyBatchNode, Courier::Models::JourneyNode::JourneyAddToDigestNode, Courier::Models::JourneyExitNode, Courier::Models::JourneyNode::JourneyBranchNode>]
+      # @param nodes [Array<Courier::Models::JourneyAPIInvokeTriggerNode, Courier::Models::JourneySegmentTriggerNode, Courier::Models::JourneyAudienceTriggerNode, Courier::Models::JourneyWebhookTriggerNode, Courier::Models::JourneySendNode, Courier::Models::JourneyDelayDurationNode, Courier::Models::JourneyDelayUntilNode, Courier::Models::JourneyFetchGetDeleteNode, Courier::Models::JourneyFetchPostPutNode, Courier::Models::JourneyAINode, Courier::Models::JourneyThrottleStaticNode, Courier::Models::JourneyThrottleDynamicNode, Courier::Models::JourneyNode::JourneyBatchNode, Courier::Models::JourneyNode::JourneyAddToDigestNode, Courier::Models::JourneyExitNode, Courier::Models::JourneyNode::JourneyBranchNode>]
       #
       # @param enabled [Boolean]
       #
@@ -291,6 +296,7 @@ module Courier
       def initialize(client:)
         @client = client
         @templates = Courier::Resources::Journeys::Templates.new(client: client)
+        @runs = Courier::Resources::Journeys::Runs.new(client: client)
       end
     end
   end

data/lib/courier/resources/notifications.rb

@@ -123,6 +123,59 @@ module Courier
         )
       end
 
+      # Some parameter documentations has been truncated, see
+      # {Courier::Models::NotificationGetMetricsParams} for more details.
+      #
+      # Fetch the delivery funnel for one Notification Template as a time series — sent,
+      # delivered, opened, clicked, errors, and undeliverable — broken out per provider
+      # and channel inside each bucket. Sum the entries in a bucket for its totals;
+      # there is no bucket-level total.
+      #
+      # Choose the window absolutely with `start` and `end`, or relatively with
+      # `lookback` (an ISO 8601 duration). `start` and `end` take precedence when both
+      # are supplied, and a request carrying neither defaults to `lookback=P30D`. The
+      # window is snapped outwards onto the `granularity` grid so every bucket it
+      # overlaps is returned whole, and the snapped boundaries come back as `start` and
+      # `end` — align a chart on those rather than on what was requested. Every boundary
+      # is UTC; there is no timezone support.
+      #
+      # Every bucket in the window is returned, including the quiet ones, whose `data`
+      # array is empty, so a series is directly plottable with no gap filling
+      # client-side. An unknown template id returns `200` with an all-empty series
+      # rather than `404`, and messages sent without a Notification Template never
+      # appear here.
+      #
+      # Available in the US region only.
+      #
+      # @overload get_metrics(id, end_: nil, granularity: nil, lookback: nil, start: nil, request_options: {})
+      #
+      # @param id [String] The Notification Template to report on — its ID (`nt_` prefix) or an alias. Must
+      #
+      # @param end_ [Time] The end of the window, as an ISO 8601 timestamp with an offset. Must be supplied
+      #
+      # @param granularity [Symbol, Courier::Models::NotificationGetMetricsParams::Granularity] The size of each bucket in the series. Defaults to `DAY`. `WEEK` buckets start o
+      #
+      # @param lookback [String] The length of the window, counted back from now, as an ISO 8601 duration (`P30D`
+      #
+      # @param start [Time] The inclusive start of the window, as an ISO 8601 timestamp with an offset (`202
+      #
+      # @param request_options [Courier::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Courier::Models::NotificationMetricsResponse]
+      #
+      # @see Courier::Models::NotificationGetMetricsParams
+      def get_metrics(id, params = {})
+        parsed, options = Courier::NotificationGetMetricsParams.dump_request(params)
+        query = Courier::Internal::Util.encode_query_params(parsed)
+        @client.request(
+          method: :get,
+          path: ["notifications/%1$s/metrics", id],
+          query: query.transform_keys(end_: "end"),
+          model: Courier::NotificationMetricsResponse,
+          options: options
+        )
+      end
+
       # Returns a notification template's published versions, most recent first, for
       # comparison or rollback. Paged.
       #

data/lib/courier/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Courier
-  VERSION = "6.0.0"
+  VERSION = "6.2.0"
 end

data/lib/courier.rb

@@ -113,8 +113,14 @@ require_relative "courier/models/auth_issue_token_params"
 require_relative "courier/models/auth_issue_token_response"
 require_relative "courier/models/automation_invoke_response"
 require_relative "courier/models/automation_list_params"
+require_relative "courier/models/automation_run_list_item"
+require_relative "courier/models/automation_run_list_response"
+require_relative "courier/models/automation_run_step"
+require_relative "courier/models/automation_run_steps_response"
 require_relative "courier/models/automations/invoke_invoke_ad_hoc_params"
 require_relative "courier/models/automations/invoke_invoke_by_template_params"
+require_relative "courier/models/automations/run_list_params"
+require_relative "courier/models/automations/run_list_steps_params"
 require_relative "courier/models/automation_template"
 require_relative "courier/models/automation_template_list_response"
 require_relative "courier/models/aws_sns"
@@ -194,6 +200,7 @@ require_relative "courier/models/journey"
 require_relative "courier/models/journey_ai_node"
 require_relative "courier/models/journey_api_invoke_trigger_node"
 require_relative "courier/models/journey_archive_params"
+require_relative "courier/models/journey_audience_trigger_node"
 require_relative "courier/models/journey_cancel_params"
 require_relative "courier/models/journey_condition_atom"
 require_relative "courier/models/journey_condition_group"
@@ -216,6 +223,15 @@ require_relative "courier/models/journey_publish_params"
 require_relative "courier/models/journey_replace_params"
 require_relative "courier/models/journey_response"
 require_relative "courier/models/journey_retrieve_params"
+require_relative "courier/models/journey_run"
+require_relative "courier/models/journey_run_list_item"
+require_relative "courier/models/journey_run_list_response"
+require_relative "courier/models/journey_run_response"
+require_relative "courier/models/journey_run_step"
+require_relative "courier/models/journey_run_steps_response"
+require_relative "courier/models/journeys/run_list_params"
+require_relative "courier/models/journeys/run_list_steps_params"
+require_relative "courier/models/journeys/run_retrieve_params"
 require_relative "courier/models/journeys/template_archive_params"
 require_relative "courier/models/journeys/template_create_params"
 require_relative "courier/models/journeys/template_list_params"
@@ -238,6 +254,7 @@ require_relative "courier/models/journey_throttle_dynamic_node"
 require_relative "courier/models/journey_throttle_static_node"
 require_relative "courier/models/journey_version_item"
 require_relative "courier/models/journey_versions_list_response"
+require_relative "courier/models/journey_webhook_trigger_node"
 require_relative "courier/models/list_delete_params"
 require_relative "courier/models/list_filter"
 require_relative "courier/models/list_list_params"
@@ -281,9 +298,11 @@ require_relative "courier/models/notification_content_get_response"
 require_relative "courier/models/notification_content_mutation_response"
 require_relative "courier/models/notification_create_params"
 require_relative "courier/models/notification_get_content"
+require_relative "courier/models/notification_get_metrics_params"
 require_relative "courier/models/notification_list_params"
 require_relative "courier/models/notification_list_response"
 require_relative "courier/models/notification_list_versions_params"
+require_relative "courier/models/notification_metrics_response"
 require_relative "courier/models/notification_preference_details"
 require_relative "courier/models/notification_publish_params"
 require_relative "courier/models/notification_put_content_params"
@@ -451,6 +470,7 @@ require_relative "courier/resources/audit_events"
 require_relative "courier/resources/auth"
 require_relative "courier/resources/automations"
 require_relative "courier/resources/automations/invoke"
+require_relative "courier/resources/automations/runs"
 require_relative "courier/resources/brands"
 require_relative "courier/resources/broadcasts"
 require_relative "courier/resources/bulk"
@@ -458,6 +478,7 @@ require_relative "courier/resources/digests"
 require_relative "courier/resources/digests/schedules"
 require_relative "courier/resources/inbound"
 require_relative "courier/resources/journeys"
+require_relative "courier/resources/journeys/runs"
 require_relative "courier/resources/journeys/templates"
 require_relative "courier/resources/lists"
 require_relative "courier/resources/lists/subscriptions"

data/rbi/courier/models/automation_run_list_item.rbi

@@ -0,0 +1,87 @@
+# typed: strong
+
+module Courier
+  module Models
+    class AutomationRunListItem < Courier::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(Courier::AutomationRunListItem, Courier::Internal::AnyHash)
+        end
+
+      # A unique identifier representing the run.
+      sig { returns(String) }
+      attr_accessor :run_id
+
+      # Internal provenance strings describing what started the run, e.g.
+      # `invoke/<template_id>` or `segment/page/Pricing Page`. Diagnostic only — the
+      # format is unstable and should not be parsed.
+      sig { returns(T::Array[String]) }
+      attr_accessor :source
+
+      # When the run started, as an ISO 8601 timestamp.
+      sig { returns(T.nilable(String)) }
+      attr_reader :created_at
+
+      sig { params(created_at: String).void }
+      attr_writer :created_at
+
+      # The state of the run: `PROCESSING`, `PROCESSED`, `WAITING`, `CANCELED`, `ERROR`,
+      # `THROTTLED`, or `NOT PROCESSED`. Not an enum — new values have been added
+      # before.
+      sig { returns(T.nilable(String)) }
+      attr_reader :status
+
+      sig { params(status: String).void }
+      attr_writer :status
+
+      # The id of the Automation Template this run belongs to.
+      sig { returns(T.nilable(String)) }
+      attr_reader :template_id
+
+      sig { params(template_id: String).void }
+      attr_writer :template_id
+
+      # An Automation run as it appears in a list response.
+      sig do
+        params(
+          run_id: String,
+          source: T::Array[String],
+          created_at: String,
+          status: String,
+          template_id: String
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # A unique identifier representing the run.
+        run_id:,
+        # Internal provenance strings describing what started the run, e.g.
+        # `invoke/<template_id>` or `segment/page/Pricing Page`. Diagnostic only — the
+        # format is unstable and should not be parsed.
+        source:,
+        # When the run started, as an ISO 8601 timestamp.
+        created_at: nil,
+        # The state of the run: `PROCESSING`, `PROCESSED`, `WAITING`, `CANCELED`, `ERROR`,
+        # `THROTTLED`, or `NOT PROCESSED`. Not an enum — new values have been added
+        # before.
+        status: nil,
+        # The id of the Automation Template this run belongs to.
+        template_id: nil
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            run_id: String,
+            source: T::Array[String],
+            created_at: String,
+            status: String,
+            template_id: String
+          }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/courier/models/automation_run_list_response.rbi

@@ -0,0 +1,47 @@
+# typed: strong
+
+module Courier
+  module Models
+    class AutomationRunListResponse < Courier::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(Courier::AutomationRunListResponse, Courier::Internal::AnyHash)
+        end
+
+      sig { returns(T::Array[Courier::AutomationRunListItem]) }
+      attr_accessor :runs
+
+      # Pass back as `cursor` to fetch the next page. Absent on the last page.
+      sig { returns(T.nilable(String)) }
+      attr_reader :next_cursor
+
+      sig { params(next_cursor: String).void }
+      attr_writer :next_cursor
+
+      # A page of Automation runs.
+      sig do
+        params(
+          runs: T::Array[Courier::AutomationRunListItem::OrHash],
+          next_cursor: String
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        runs:,
+        # Pass back as `cursor` to fetch the next page. Absent on the last page.
+        next_cursor: nil
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            runs: T::Array[Courier::AutomationRunListItem],
+            next_cursor: String
+          }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/courier/models/automation_run_step.rbi

@@ -0,0 +1,96 @@
+# typed: strong
+
+module Courier
+  module Models
+    class AutomationRunStep < Courier::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(Courier::AutomationRunStep, Courier::Internal::AnyHash)
+        end
+
+      # The kind of step that ran, e.g. `send`, `delay`, or `update-profile`.
+      sig { returns(String) }
+      attr_accessor :action
+
+      # The state of the step: the seven run statuses, plus `SKIPPED` and `COMPUTING`.
+      # Not an enum — new values have been added before.
+      sig { returns(String) }
+      attr_accessor :status
+
+      # When the step started, as an ISO 8601 timestamp.
+      sig { returns(T.nilable(String)) }
+      attr_reader :created_at
+
+      sig { params(created_at: String).void }
+      attr_writer :created_at
+
+      # The message this step produced, present on send steps. Pass it to
+      # `GET /messages/{message_id}` for delivery status. A send to a List or an
+      # Audience yields one id for the request, not one per recipient.
+      sig { returns(T.nilable(String)) }
+      attr_reader :message_id
+
+      sig { params(message_id: String).void }
+      attr_writer :message_id
+
+      # A unique identifier representing the step.
+      sig { returns(T.nilable(String)) }
+      attr_reader :step_id
+
+      sig { params(step_id: String).void }
+      attr_writer :step_id
+
+      # When the step last changed state, as an ISO 8601 timestamp.
+      sig { returns(T.nilable(String)) }
+      attr_reader :updated_at
+
+      sig { params(updated_at: String).void }
+      attr_writer :updated_at
+
+      # One executed step of an Automation run.
+      sig do
+        params(
+          action: String,
+          status: String,
+          created_at: String,
+          message_id: String,
+          step_id: String,
+          updated_at: String
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # The kind of step that ran, e.g. `send`, `delay`, or `update-profile`.
+        action:,
+        # The state of the step: the seven run statuses, plus `SKIPPED` and `COMPUTING`.
+        # Not an enum — new values have been added before.
+        status:,
+        # When the step started, as an ISO 8601 timestamp.
+        created_at: nil,
+        # The message this step produced, present on send steps. Pass it to
+        # `GET /messages/{message_id}` for delivery status. A send to a List or an
+        # Audience yields one id for the request, not one per recipient.
+        message_id: nil,
+        # A unique identifier representing the step.
+        step_id: nil,
+        # When the step last changed state, as an ISO 8601 timestamp.
+        updated_at: nil
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            action: String,
+            status: String,
+            created_at: String,
+            message_id: String,
+            step_id: String,
+            updated_at: String
+          }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/courier/models/automation_run_steps_response.rbi

@@ -0,0 +1,28 @@
+# typed: strong
+
+module Courier
+  module Models
+    class AutomationRunStepsResponse < Courier::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(Courier::AutomationRunStepsResponse, Courier::Internal::AnyHash)
+        end
+
+      sig { returns(T::Array[Courier::AutomationRunStep]) }
+      attr_accessor :steps
+
+      # Every step of an Automation run. Not paginated.
+      sig do
+        params(steps: T::Array[Courier::AutomationRunStep::OrHash]).returns(
+          T.attached_class
+        )
+      end
+      def self.new(steps:)
+      end
+
+      sig { override.returns({ steps: T::Array[Courier::AutomationRunStep] }) }
+      def to_hash
+      end
+    end
+  end
+end