safetykit 0.44.0 → 0.46.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 207ad345a64fa1b890d3aaad33043e17859c09ce95bc203ecfb9ddadeb703c8c
-  data.tar.gz: 57d104b1c3117be45e035aee0308c0f628d08bb5522b3af27e3b83e1c13df233
+  metadata.gz: 340c394a384325db1c560c08f7f33ffcebe3c7c0b0b39a9a9cce433e0ea83e0c
+  data.tar.gz: aa13a48e8e75de7178ebdf1656cdc88dc08b963b95f6555bf2914bdabba01927
 SHA512:
-  metadata.gz: 487285a9bc781d67c5920ce0af7cd9998a11cb9e2cea9b8b6ccd3479b48b1ea38246783355b2956656be1524ce1a756e9187ed167594b1d2ddd0a65a349c392f
-  data.tar.gz: 072efb531430625cba569586c125f5776ac077e33bae57cc68bab8e69431e4186ef802937ee6eaaa0fb7cda47c3561adcf7f18b45ac3ff9439a0417517976f6b
+  metadata.gz: cc2b7c83e15b3420fb0267a4d486f6504a3b28701c14e2a7b834ff4943db102fa7d30657305cd95d4407f45c408ddc8c6a78dd32527ab7c2bedc8d2d1537e9c0
+  data.tar.gz: bfc8f39fa22b6357769f611647dd1a96b66dacc94218b771ff3186c357490a516e5ae680f5f56823a23a0804fb0afb38fd9453179645d9207581074cbbfca4de

data/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## 0.46.0 (2026-07-30)
+
+Full Changelog: [v0.45.0...v0.46.0](https://github.com/GetSafetyKit/safetykit-ruby/compare/v0.45.0...v0.46.0)
+
+### Features
+
+* **api:** api update ([8b9fae0](https://github.com/GetSafetyKit/safetykit-ruby/commit/8b9fae0b71202015e14dfcaa009944d6b42fe10c))
+
+## 0.45.0 (2026-07-28)
+
+Full Changelog: [v0.44.0...v0.45.0](https://github.com/GetSafetyKit/safetykit-ruby/compare/v0.44.0...v0.45.0)
+
+### Features
+
+* **api:** api update ([8e44e07](https://github.com/GetSafetyKit/safetykit-ruby/commit/8e44e073b72a432bd3b914def5e44a215cf8d610))
+
 ## 0.44.0 (2026-07-28)
 
 Full Changelog: [v0.43.0...v0.44.0](https://github.com/GetSafetyKit/safetykit-ruby/compare/v0.43.0...v0.44.0)

data/README.md

@@ -17,7 +17,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "safetykit", "~> 0.44.0"
+gem "safetykit", "~> 0.46.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/safety_kit/client.rb

@@ -32,6 +32,11 @@ module SafetyKit
     # @return [SafetyKit::Resources::AgentDecisions]
     attr_reader :agent_decisions
 
+    # Exchange a long-lived API key for a short-lived access token suitable for
+    # delegated or time-boxed use.
+    # @return [SafetyKit::Resources::AccessTokens]
+    attr_reader :access_tokens
+
     # Beta. Send backend events for account, content, user interaction, report,
     # appeal, and moderation activity.
     # @return [SafetyKit::Resources::Async]
@@ -121,6 +126,7 @@ module SafetyKit
       @data = SafetyKit::Resources::Data.new(client: self)
       @streams = SafetyKit::Resources::Streams.new(client: self)
       @agent_decisions = SafetyKit::Resources::AgentDecisions.new(client: self)
+      @access_tokens = SafetyKit::Resources::AccessTokens.new(client: self)
       @async = SafetyKit::Resources::Async.new(client: self)
       @deletion_requests = SafetyKit::Resources::DeletionRequests.new(client: self)
       @client_sessions = SafetyKit::Resources::ClientSessions.new(client: self)

data/lib/safety_kit/models/access_token_create_access_token_params.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+module SafetyKit
+  module Models
+    # @see SafetyKit::Resources::AccessTokens#create_access_token
+    class AccessTokenCreateAccessTokenParams < SafetyKit::Internal::Type::BaseModel
+      extend SafetyKit::Internal::Type::RequestParameters::Converter
+      include SafetyKit::Internal::Type::RequestParameters
+
+      # @!attribute customer_session_id
+      #   Optional opaque session identifier to associate with the access token.
+      #
+      #   @return [String, nil]
+      optional :customer_session_id, String
+
+      # @!attribute expires_in
+      #   Lifetime of the access token in seconds. Defaults to 3600 (1 hour). Minimum 300
+      #   (5 minutes), maximum 43200 (12 hours).
+      #
+      #   @return [Integer, nil]
+      optional :expires_in, Integer
+
+      # @!attribute user_id
+      #   Optional user identifier to associate with the access token for attribution. Use
+      #   the same canonical user ID string that you send in other SafetyKit API calls.
+      #
+      #   @return [String, nil]
+      optional :user_id, String
+
+      # @!method initialize(customer_session_id: nil, expires_in: nil, user_id: nil, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {SafetyKit::Models::AccessTokenCreateAccessTokenParams} for more details.
+      #
+      #   @param customer_session_id [String] Optional opaque session identifier to associate with the access token.
+      #
+      #   @param expires_in [Integer] Lifetime of the access token in seconds. Defaults to 3600 (1 hour). Minimum 300
+      #
+      #   @param user_id [String] Optional user identifier to associate with the access token for attribution. Use
+      #
+      #   @param request_options [SafetyKit::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/safety_kit/models/access_token_create_access_token_response.rb

@@ -0,0 +1,59 @@
+# frozen_string_literal: true
+
+module SafetyKit
+  module Models
+    # @see SafetyKit::Resources::AccessTokens#create_access_token
+    class AccessTokenCreateAccessTokenResponse < SafetyKit::Internal::Type::BaseModel
+      # @!attribute access_token
+      #   Short-lived bearer token. Use it in the Authorization header exactly like a
+      #   long-lived API key. It cannot be used to create additional access tokens.
+      #
+      #   @return [String]
+      required :access_token, String
+
+      # @!attribute expires_at
+      #   ISO 8601 timestamp at which the access token expires.
+      #
+      #   @return [Time]
+      required :expires_at, Time
+
+      # @!attribute expires_in
+      #   Number of seconds until the access token expires.
+      #
+      #   @return [Integer]
+      required :expires_in, Integer
+
+      # @!attribute token_type
+      #   Token type. Always Bearer.
+      #
+      #   @return [Symbol, SafetyKit::Models::AccessTokenCreateAccessTokenResponse::TokenType]
+      required :token_type, enum: -> { SafetyKit::Models::AccessTokenCreateAccessTokenResponse::TokenType }
+
+      # @!method initialize(access_token:, expires_at:, expires_in:, token_type:)
+      #   Some parameter documentations has been truncated, see
+      #   {SafetyKit::Models::AccessTokenCreateAccessTokenResponse} for more details.
+      #
+      #   Response containing the newly created short-lived access token.
+      #
+      #   @param access_token [String] Short-lived bearer token. Use it in the Authorization header exactly like a long
+      #
+      #   @param expires_at [Time] ISO 8601 timestamp at which the access token expires.
+      #
+      #   @param expires_in [Integer] Number of seconds until the access token expires.
+      #
+      #   @param token_type [Symbol, SafetyKit::Models::AccessTokenCreateAccessTokenResponse::TokenType] Token type. Always Bearer.
+
+      # Token type. Always Bearer.
+      #
+      # @see SafetyKit::Models::AccessTokenCreateAccessTokenResponse#token_type
+      module TokenType
+        extend SafetyKit::Internal::Type::Enum
+
+        BEARER = :Bearer
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end

data/lib/safety_kit/models/stream_add_frame_params.rb

@@ -32,12 +32,12 @@ module SafetyKit
       #   @return [Integer]
       required :timestamp, Integer
 
-      # @!attribute artifact_id
+      # @!attribute frame_id
       #
       #   @return [String, nil]
-      optional :artifact_id, String
+      optional :frame_id, String
 
-      # @!method initialize(namespace:, image_data_uri:, stream_id:, timestamp:, artifact_id: nil, request_options: {})
+      # @!method initialize(namespace:, image_data_uri:, stream_id:, timestamp:, frame_id: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {SafetyKit::Models::StreamAddFrameParams} for more details.
       #
@@ -49,7 +49,7 @@ module SafetyKit
       #
       #   @param timestamp [Integer]
       #
-      #   @param artifact_id [String]
+      #   @param frame_id [String]
       #
       #   @param request_options [SafetyKit::RequestOptions, Hash{Symbol=>Object}]
     end

data/lib/safety_kit/models/stream_add_transcript_params.rb

@@ -28,12 +28,12 @@ module SafetyKit
       #   @return [Integer]
       required :timestamp, Integer
 
-      # @!attribute artifact_id
+      # @!attribute transcript_id
       #
       #   @return [String, nil]
-      optional :artifact_id, String
+      optional :transcript_id, String
 
-      # @!method initialize(namespace:, stream_id:, text:, timestamp:, artifact_id: nil, request_options: {})
+      # @!method initialize(namespace:, stream_id:, text:, timestamp:, transcript_id: nil, request_options: {})
       #   @param namespace [String] The namespace to ingest stream data into
       #
       #   @param stream_id [String]
@@ -42,7 +42,7 @@ module SafetyKit
       #
       #   @param timestamp [Integer]
       #
-      #   @param artifact_id [String]
+      #   @param transcript_id [String]
       #
       #   @param request_options [SafetyKit::RequestOptions, Hash{Symbol=>Object}]
     end

data/lib/safety_kit/models.rb

@@ -39,6 +39,8 @@ module SafetyKit
     mod.define_sorbet_constant!(const) { T.type_alias { mod.to_sorbet_type } }
   end
 
+  AccessTokenCreateAccessTokenParams = SafetyKit::Models::AccessTokenCreateAccessTokenParams
+
   AgentDecisionCreateAgentDecisionParams = SafetyKit::Models::AgentDecisionCreateAgentDecisionParams
 
   AsyncCreateAsyncParams = SafetyKit::Models::AsyncCreateAsyncParams

data/lib/safety_kit/resources/access_tokens.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+module SafetyKit
+  module Resources
+    # Exchange a long-lived API key for a short-lived access token suitable for
+    # delegated or time-boxed use.
+    class AccessTokens
+      # Some parameter documentations has been truncated, see
+      # {SafetyKit::Models::AccessTokenCreateAccessTokenParams} for more details.
+      #
+      # Exchange a long-lived API key for a short-lived access token. Authenticate with
+      # your long-lived API key as the Bearer token; the response contains a new token
+      # that authenticates the same team until it expires. Short-lived access tokens
+      # cannot be used to create additional access tokens.
+      #
+      # @overload create_access_token(customer_session_id: nil, expires_in: nil, user_id: nil, request_options: {})
+      #
+      # @param customer_session_id [String] Optional opaque session identifier to associate with the access token.
+      #
+      # @param expires_in [Integer] Lifetime of the access token in seconds. Defaults to 3600 (1 hour). Minimum 300
+      #
+      # @param user_id [String] Optional user identifier to associate with the access token for attribution. Use
+      #
+      # @param request_options [SafetyKit::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [SafetyKit::Models::AccessTokenCreateAccessTokenResponse]
+      #
+      # @see SafetyKit::Models::AccessTokenCreateAccessTokenParams
+      def create_access_token(params = {})
+        parsed, options = SafetyKit::AccessTokenCreateAccessTokenParams.dump_request(params)
+        @client.request(
+          method: :post,
+          path: "v1/access_tokens",
+          body: parsed,
+          model: SafetyKit::Models::AccessTokenCreateAccessTokenResponse,
+          options: options
+        )
+      end
+
+      # @api private
+      #
+      # @param client [SafetyKit::Client]
+      def initialize(client:)
+        @client = client
+      end
+    end
+  end
+end

data/lib/safety_kit/resources/streams.rb

@@ -43,7 +43,7 @@ module SafetyKit
       # ignored by downstream processing. This method returns immediately after the
       # frame has been accepted for processing.
       #
-      # @overload add_frame(namespace, image_data_uri:, stream_id:, timestamp:, artifact_id: nil, request_options: {})
+      # @overload add_frame(namespace, image_data_uri:, stream_id:, timestamp:, frame_id: nil, request_options: {})
       #
       # @param namespace [String] The namespace to ingest stream data into
       #
@@ -53,7 +53,7 @@ module SafetyKit
       #
       # @param timestamp [Integer]
       #
-      # @param artifact_id [String]
+      # @param frame_id [String]
       #
       # @param request_options [SafetyKit::RequestOptions, Hash{Symbol=>Object}, nil]
       #
@@ -78,7 +78,7 @@ module SafetyKit
       # correctly with later frames. This method returns immediately after the
       # transcript has been accepted for processing.
       #
-      # @overload add_transcript(namespace, stream_id:, text:, timestamp:, artifact_id: nil, request_options: {})
+      # @overload add_transcript(namespace, stream_id:, text:, timestamp:, transcript_id: nil, request_options: {})
       #
       # @param namespace [String] The namespace to ingest stream data into
       #
@@ -88,7 +88,7 @@ module SafetyKit
       #
       # @param timestamp [Integer]
       #
-      # @param artifact_id [String]
+      # @param transcript_id [String]
       #
       # @param request_options [SafetyKit::RequestOptions, Hash{Symbol=>Object}, nil]
       #

data/lib/safety_kit/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module SafetyKit
-  VERSION = "0.44.0"
+  VERSION = "0.46.0"
 end

data/lib/safety_kit.rb

@@ -52,6 +52,8 @@ require_relative "safety_kit/errors"
 require_relative "safety_kit/internal/transport/base_client"
 require_relative "safety_kit/internal/transport/pooled_net_requester"
 require_relative "safety_kit/client"
+require_relative "safety_kit/models/access_token_create_access_token_params"
+require_relative "safety_kit/models/access_token_create_access_token_response"
 require_relative "safety_kit/models/agent_decision_create_agent_decision_params"
 require_relative "safety_kit/models/agent_decision_create_agent_decision_response"
 require_relative "safety_kit/models/async_create_async_params"
@@ -80,6 +82,7 @@ require_relative "safety_kit/models/stream_add_response"
 require_relative "safety_kit/models/stream_add_transcript_params"
 require_relative "safety_kit/models/stream_add_transcript_response"
 require_relative "safety_kit/models"
+require_relative "safety_kit/resources/access_tokens"
 require_relative "safety_kit/resources/agent_decisions"
 require_relative "safety_kit/resources/async"
 require_relative "safety_kit/resources/beta"

data/rbi/safety_kit/client.rbi

@@ -27,6 +27,11 @@ module SafetyKit
     sig { returns(SafetyKit::Resources::AgentDecisions) }
     attr_reader :agent_decisions
 
+    # Exchange a long-lived API key for a short-lived access token suitable for
+    # delegated or time-boxed use.
+    sig { returns(SafetyKit::Resources::AccessTokens) }
+    attr_reader :access_tokens
+
     # Beta. Send backend events for account, content, user interaction, report,
     # appeal, and moderation activity.
     sig { returns(SafetyKit::Resources::Async) }

data/rbi/safety_kit/models/access_token_create_access_token_params.rbi

@@ -0,0 +1,75 @@
+# typed: strong
+
+module SafetyKit
+  module Models
+    class AccessTokenCreateAccessTokenParams < SafetyKit::Internal::Type::BaseModel
+      extend SafetyKit::Internal::Type::RequestParameters::Converter
+      include SafetyKit::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias do
+          T.any(
+            SafetyKit::AccessTokenCreateAccessTokenParams,
+            SafetyKit::Internal::AnyHash
+          )
+        end
+
+      # Optional opaque session identifier to associate with the access token.
+      sig { returns(T.nilable(String)) }
+      attr_reader :customer_session_id
+
+      sig { params(customer_session_id: String).void }
+      attr_writer :customer_session_id
+
+      # Lifetime of the access token in seconds. Defaults to 3600 (1 hour). Minimum 300
+      # (5 minutes), maximum 43200 (12 hours).
+      sig { returns(T.nilable(Integer)) }
+      attr_reader :expires_in
+
+      sig { params(expires_in: Integer).void }
+      attr_writer :expires_in
+
+      # Optional user identifier to associate with the access token for attribution. Use
+      # the same canonical user ID string that you send in other SafetyKit API calls.
+      sig { returns(T.nilable(String)) }
+      attr_reader :user_id
+
+      sig { params(user_id: String).void }
+      attr_writer :user_id
+
+      sig do
+        params(
+          customer_session_id: String,
+          expires_in: Integer,
+          user_id: String,
+          request_options: SafetyKit::RequestOptions::OrHash
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # Optional opaque session identifier to associate with the access token.
+        customer_session_id: nil,
+        # Lifetime of the access token in seconds. Defaults to 3600 (1 hour). Minimum 300
+        # (5 minutes), maximum 43200 (12 hours).
+        expires_in: nil,
+        # Optional user identifier to associate with the access token for attribution. Use
+        # the same canonical user ID string that you send in other SafetyKit API calls.
+        user_id: nil,
+        request_options: {}
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            customer_session_id: String,
+            expires_in: Integer,
+            user_id: String,
+            request_options: SafetyKit::RequestOptions
+          }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/safety_kit/models/access_token_create_access_token_response.rbi

@@ -0,0 +1,103 @@
+# typed: strong
+
+module SafetyKit
+  module Models
+    class AccessTokenCreateAccessTokenResponse < SafetyKit::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(
+            SafetyKit::Models::AccessTokenCreateAccessTokenResponse,
+            SafetyKit::Internal::AnyHash
+          )
+        end
+
+      # Short-lived bearer token. Use it in the Authorization header exactly like a
+      # long-lived API key. It cannot be used to create additional access tokens.
+      sig { returns(String) }
+      attr_accessor :access_token
+
+      # ISO 8601 timestamp at which the access token expires.
+      sig { returns(Time) }
+      attr_accessor :expires_at
+
+      # Number of seconds until the access token expires.
+      sig { returns(Integer) }
+      attr_accessor :expires_in
+
+      # Token type. Always Bearer.
+      sig do
+        returns(
+          SafetyKit::Models::AccessTokenCreateAccessTokenResponse::TokenType::TaggedSymbol
+        )
+      end
+      attr_accessor :token_type
+
+      # Response containing the newly created short-lived access token.
+      sig do
+        params(
+          access_token: String,
+          expires_at: Time,
+          expires_in: Integer,
+          token_type:
+            SafetyKit::Models::AccessTokenCreateAccessTokenResponse::TokenType::OrSymbol
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # Short-lived bearer token. Use it in the Authorization header exactly like a
+        # long-lived API key. It cannot be used to create additional access tokens.
+        access_token:,
+        # ISO 8601 timestamp at which the access token expires.
+        expires_at:,
+        # Number of seconds until the access token expires.
+        expires_in:,
+        # Token type. Always Bearer.
+        token_type:
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            access_token: String,
+            expires_at: Time,
+            expires_in: Integer,
+            token_type:
+              SafetyKit::Models::AccessTokenCreateAccessTokenResponse::TokenType::TaggedSymbol
+          }
+        )
+      end
+      def to_hash
+      end
+
+      # Token type. Always Bearer.
+      module TokenType
+        extend SafetyKit::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(
+              Symbol,
+              SafetyKit::Models::AccessTokenCreateAccessTokenResponse::TokenType
+            )
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        BEARER =
+          T.let(
+            :Bearer,
+            SafetyKit::Models::AccessTokenCreateAccessTokenResponse::TokenType::TaggedSymbol
+          )
+
+        sig do
+          override.returns(
+            T::Array[
+              SafetyKit::Models::AccessTokenCreateAccessTokenResponse::TokenType::TaggedSymbol
+            ]
+          )
+        end
+        def self.values
+        end
+      end
+    end
+  end
+end

data/rbi/safety_kit/models/stream_add_frame_params.rbi

@@ -29,10 +29,10 @@ module SafetyKit
       attr_accessor :timestamp
 
       sig { returns(T.nilable(String)) }
-      attr_reader :artifact_id
+      attr_reader :frame_id
 
-      sig { params(artifact_id: String).void }
-      attr_writer :artifact_id
+      sig { params(frame_id: String).void }
+      attr_writer :frame_id
 
       sig do
         params(
@@ -40,7 +40,7 @@ module SafetyKit
           image_data_uri: String,
           stream_id: String,
           timestamp: Integer,
-          artifact_id: String,
+          frame_id: String,
           request_options: SafetyKit::RequestOptions::OrHash
         ).returns(T.attached_class)
       end
@@ -54,7 +54,7 @@ module SafetyKit
         image_data_uri:,
         stream_id:,
         timestamp:,
-        artifact_id: nil,
+        frame_id: nil,
         request_options: {}
       )
       end
@@ -66,7 +66,7 @@ module SafetyKit
             image_data_uri: String,
             stream_id: String,
             timestamp: Integer,
-            artifact_id: String,
+            frame_id: String,
             request_options: SafetyKit::RequestOptions
           }
         )

data/rbi/safety_kit/models/stream_add_transcript_params.rbi

@@ -28,10 +28,10 @@ module SafetyKit
       attr_accessor :timestamp
 
       sig { returns(T.nilable(String)) }
-      attr_reader :artifact_id
+      attr_reader :transcript_id
 
-      sig { params(artifact_id: String).void }
-      attr_writer :artifact_id
+      sig { params(transcript_id: String).void }
+      attr_writer :transcript_id
 
       sig do
         params(
@@ -39,7 +39,7 @@ module SafetyKit
           stream_id: String,
           text: String,
           timestamp: Integer,
-          artifact_id: String,
+          transcript_id: String,
           request_options: SafetyKit::RequestOptions::OrHash
         ).returns(T.attached_class)
       end
@@ -49,7 +49,7 @@ module SafetyKit
         stream_id:,
         text:,
         timestamp:,
-        artifact_id: nil,
+        transcript_id: nil,
         request_options: {}
       )
       end
@@ -61,7 +61,7 @@ module SafetyKit
             stream_id: String,
             text: String,
             timestamp: Integer,
-            artifact_id: String,
+            transcript_id: String,
             request_options: SafetyKit::RequestOptions
           }
         )

data/rbi/safety_kit/models.rbi

@@ -1,6 +1,9 @@
 # typed: strong
 
 module SafetyKit
+  AccessTokenCreateAccessTokenParams =
+    SafetyKit::Models::AccessTokenCreateAccessTokenParams
+
   AgentDecisionCreateAgentDecisionParams =
     SafetyKit::Models::AgentDecisionCreateAgentDecisionParams
 

data/rbi/safety_kit/resources/access_tokens.rbi

@@ -0,0 +1,39 @@
+# typed: strong
+
+module SafetyKit
+  module Resources
+    # Exchange a long-lived API key for a short-lived access token suitable for
+    # delegated or time-boxed use.
+    class AccessTokens
+      # Exchange a long-lived API key for a short-lived access token. Authenticate with
+      # your long-lived API key as the Bearer token; the response contains a new token
+      # that authenticates the same team until it expires. Short-lived access tokens
+      # cannot be used to create additional access tokens.
+      sig do
+        params(
+          customer_session_id: String,
+          expires_in: Integer,
+          user_id: String,
+          request_options: SafetyKit::RequestOptions::OrHash
+        ).returns(SafetyKit::Models::AccessTokenCreateAccessTokenResponse)
+      end
+      def create_access_token(
+        # Optional opaque session identifier to associate with the access token.
+        customer_session_id: nil,
+        # Lifetime of the access token in seconds. Defaults to 3600 (1 hour). Minimum 300
+        # (5 minutes), maximum 43200 (12 hours).
+        expires_in: nil,
+        # Optional user identifier to associate with the access token for attribution. Use
+        # the same canonical user ID string that you send in other SafetyKit API calls.
+        user_id: nil,
+        request_options: {}
+      )
+      end
+
+      # @api private
+      sig { params(client: SafetyKit::Client).returns(T.attached_class) }
+      def self.new(client:)
+      end
+    end
+  end
+end

data/rbi/safety_kit/resources/streams.rbi

@@ -37,7 +37,7 @@ module SafetyKit
           image_data_uri: String,
           stream_id: String,
           timestamp: Integer,
-          artifact_id: String,
+          frame_id: String,
           request_options: SafetyKit::RequestOptions::OrHash
         ).returns(SafetyKit::Models::StreamAddFrameResponse)
       end
@@ -51,7 +51,7 @@ module SafetyKit
         image_data_uri:,
         stream_id:,
         timestamp:,
-        artifact_id: nil,
+        frame_id: nil,
         request_options: {}
       )
       end
@@ -68,7 +68,7 @@ module SafetyKit
           stream_id: String,
           text: String,
           timestamp: Integer,
-          artifact_id: String,
+          transcript_id: String,
           request_options: SafetyKit::RequestOptions::OrHash
         ).returns(SafetyKit::Models::StreamAddTranscriptResponse)
       end
@@ -78,7 +78,7 @@ module SafetyKit
         stream_id:,
         text:,
         timestamp:,
-        artifact_id: nil,
+        transcript_id: nil,
         request_options: {}
       )
       end

data/sig/safety_kit/client.rbs

@@ -16,6 +16,8 @@ module SafetyKit
 
     attr_reader agent_decisions: SafetyKit::Resources::AgentDecisions
 
+    attr_reader access_tokens: SafetyKit::Resources::AccessTokens
+
     attr_reader async: SafetyKit::Resources::Async
 
     attr_reader deletion_requests: SafetyKit::Resources::DeletionRequests

data/sig/safety_kit/models/access_token_create_access_token_params.rbs

@@ -0,0 +1,38 @@
+module SafetyKit
+  module Models
+    type access_token_create_access_token_params =
+      { customer_session_id: String, expires_in: Integer, user_id: String }
+      & SafetyKit::Internal::Type::request_parameters
+
+    class AccessTokenCreateAccessTokenParams < SafetyKit::Internal::Type::BaseModel
+      extend SafetyKit::Internal::Type::RequestParameters::Converter
+      include SafetyKit::Internal::Type::RequestParameters
+
+      attr_reader customer_session_id: String?
+
+      def customer_session_id=: (String) -> String
+
+      attr_reader expires_in: Integer?
+
+      def expires_in=: (Integer) -> Integer
+
+      attr_reader user_id: String?
+
+      def user_id=: (String) -> String
+
+      def initialize: (
+        ?customer_session_id: String,
+        ?expires_in: Integer,
+        ?user_id: String,
+        ?request_options: SafetyKit::request_opts
+      ) -> void
+
+      def to_hash: -> {
+        customer_session_id: String,
+        expires_in: Integer,
+        user_id: String,
+        request_options: SafetyKit::RequestOptions
+      }
+    end
+  end
+end

data/sig/safety_kit/models/access_token_create_access_token_response.rbs

@@ -0,0 +1,45 @@
+module SafetyKit
+  module Models
+    type access_token_create_access_token_response =
+      {
+        access_token: String,
+        expires_at: Time,
+        expires_in: Integer,
+        token_type: SafetyKit::Models::AccessTokenCreateAccessTokenResponse::token_type
+      }
+
+    class AccessTokenCreateAccessTokenResponse < SafetyKit::Internal::Type::BaseModel
+      attr_accessor access_token: String
+
+      attr_accessor expires_at: Time
+
+      attr_accessor expires_in: Integer
+
+      attr_accessor token_type: SafetyKit::Models::AccessTokenCreateAccessTokenResponse::token_type
+
+      def initialize: (
+        access_token: String,
+        expires_at: Time,
+        expires_in: Integer,
+        token_type: SafetyKit::Models::AccessTokenCreateAccessTokenResponse::token_type
+      ) -> void
+
+      def to_hash: -> {
+        access_token: String,
+        expires_at: Time,
+        expires_in: Integer,
+        token_type: SafetyKit::Models::AccessTokenCreateAccessTokenResponse::token_type
+      }
+
+      type token_type = :Bearer
+
+      module TokenType
+        extend SafetyKit::Internal::Type::Enum
+
+        BEARER: :Bearer
+
+        def self?.values: -> ::Array[SafetyKit::Models::AccessTokenCreateAccessTokenResponse::token_type]
+      end
+    end
+  end
+end

data/sig/safety_kit/models/stream_add_frame_params.rbs

@@ -6,7 +6,7 @@ module SafetyKit
         image_data_uri: String,
         stream_id: String,
         timestamp: Integer,
-        artifact_id: String
+        frame_id: String
       }
       & SafetyKit::Internal::Type::request_parameters
 
@@ -22,16 +22,16 @@ module SafetyKit
 
       attr_accessor timestamp: Integer
 
-      attr_reader artifact_id: String?
+      attr_reader frame_id: String?
 
-      def artifact_id=: (String) -> String
+      def frame_id=: (String) -> String
 
       def initialize: (
         namespace: String,
         image_data_uri: String,
         stream_id: String,
         timestamp: Integer,
-        ?artifact_id: String,
+        ?frame_id: String,
         ?request_options: SafetyKit::request_opts
       ) -> void
 
@@ -40,7 +40,7 @@ module SafetyKit
         image_data_uri: String,
         stream_id: String,
         timestamp: Integer,
-        artifact_id: String,
+        frame_id: String,
         request_options: SafetyKit::RequestOptions
       }
     end

data/sig/safety_kit/models/stream_add_transcript_params.rbs

@@ -6,7 +6,7 @@ module SafetyKit
         stream_id: String,
         text: String,
         timestamp: Integer,
-        artifact_id: String
+        transcript_id: String
       }
       & SafetyKit::Internal::Type::request_parameters
 
@@ -22,16 +22,16 @@ module SafetyKit
 
       attr_accessor timestamp: Integer
 
-      attr_reader artifact_id: String?
+      attr_reader transcript_id: String?
 
-      def artifact_id=: (String) -> String
+      def transcript_id=: (String) -> String
 
       def initialize: (
         namespace: String,
         stream_id: String,
         text: String,
         timestamp: Integer,
-        ?artifact_id: String,
+        ?transcript_id: String,
         ?request_options: SafetyKit::request_opts
       ) -> void
 
@@ -40,7 +40,7 @@ module SafetyKit
         stream_id: String,
         text: String,
         timestamp: Integer,
-        artifact_id: String,
+        transcript_id: String,
         request_options: SafetyKit::RequestOptions
       }
     end

data/sig/safety_kit/models.rbs

@@ -1,4 +1,6 @@
 module SafetyKit
+  class AccessTokenCreateAccessTokenParams = SafetyKit::Models::AccessTokenCreateAccessTokenParams
+
   class AgentDecisionCreateAgentDecisionParams = SafetyKit::Models::AgentDecisionCreateAgentDecisionParams
 
   class AsyncCreateAsyncParams = SafetyKit::Models::AsyncCreateAsyncParams

data/sig/safety_kit/resources/access_tokens.rbs

@@ -0,0 +1,14 @@
+module SafetyKit
+  module Resources
+    class AccessTokens
+      def create_access_token: (
+        ?customer_session_id: String,
+        ?expires_in: Integer,
+        ?user_id: String,
+        ?request_options: SafetyKit::request_opts
+      ) -> SafetyKit::Models::AccessTokenCreateAccessTokenResponse
+
+      def initialize: (client: SafetyKit::Client) -> void
+    end
+  end
+end

data/sig/safety_kit/resources/streams.rbs

@@ -13,7 +13,7 @@ module SafetyKit
         image_data_uri: String,
         stream_id: String,
         timestamp: Integer,
-        ?artifact_id: String,
+        ?frame_id: String,
         ?request_options: SafetyKit::request_opts
       ) -> SafetyKit::Models::StreamAddFrameResponse
 
@@ -22,7 +22,7 @@ module SafetyKit
         stream_id: String,
         text: String,
         timestamp: Integer,
-        ?artifact_id: String,
+        ?transcript_id: String,
         ?request_options: SafetyKit::request_opts
       ) -> SafetyKit::Models::StreamAddTranscriptResponse
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: safetykit
 version: !ruby/object:Gem::Version
-  version: 0.44.0
+  version: 0.46.0
 platform: ruby
 authors:
 - Safetykit
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-07-28 00:00:00.000000000 Z
+date: 2026-07-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: cgi
@@ -69,6 +69,8 @@ files:
 - lib/safety_kit/internal/type/unknown.rb
 - lib/safety_kit/internal/util.rb
 - lib/safety_kit/models.rb
+- lib/safety_kit/models/access_token_create_access_token_params.rb
+- lib/safety_kit/models/access_token_create_access_token_response.rb
 - lib/safety_kit/models/agent_decision_create_agent_decision_params.rb
 - lib/safety_kit/models/agent_decision_create_agent_decision_response.rb
 - lib/safety_kit/models/async_create_async_params.rb
@@ -97,6 +99,7 @@ files:
 - lib/safety_kit/models/stream_add_transcript_params.rb
 - lib/safety_kit/models/stream_add_transcript_response.rb
 - lib/safety_kit/request_options.rb
+- lib/safety_kit/resources/access_tokens.rb
 - lib/safety_kit/resources/agent_decisions.rb
 - lib/safety_kit/resources/async.rb
 - lib/safety_kit/resources/beta.rb
@@ -126,6 +129,8 @@ files:
 - rbi/safety_kit/internal/type/unknown.rbi
 - rbi/safety_kit/internal/util.rbi
 - rbi/safety_kit/models.rbi
+- rbi/safety_kit/models/access_token_create_access_token_params.rbi
+- rbi/safety_kit/models/access_token_create_access_token_response.rbi
 - rbi/safety_kit/models/agent_decision_create_agent_decision_params.rbi
 - rbi/safety_kit/models/agent_decision_create_agent_decision_response.rbi
 - rbi/safety_kit/models/async_create_async_params.rbi
@@ -154,6 +159,7 @@ files:
 - rbi/safety_kit/models/stream_add_transcript_params.rbi
 - rbi/safety_kit/models/stream_add_transcript_response.rbi
 - rbi/safety_kit/request_options.rbi
+- rbi/safety_kit/resources/access_tokens.rbi
 - rbi/safety_kit/resources/agent_decisions.rbi
 - rbi/safety_kit/resources/async.rbi
 - rbi/safety_kit/resources/beta.rbi
@@ -182,6 +188,8 @@ files:
 - sig/safety_kit/internal/type/unknown.rbs
 - sig/safety_kit/internal/util.rbs
 - sig/safety_kit/models.rbs
+- sig/safety_kit/models/access_token_create_access_token_params.rbs
+- sig/safety_kit/models/access_token_create_access_token_response.rbs
 - sig/safety_kit/models/agent_decision_create_agent_decision_params.rbs
 - sig/safety_kit/models/agent_decision_create_agent_decision_response.rbs
 - sig/safety_kit/models/async_create_async_params.rbs
@@ -210,6 +218,7 @@ files:
 - sig/safety_kit/models/stream_add_transcript_params.rbs
 - sig/safety_kit/models/stream_add_transcript_response.rbs
 - sig/safety_kit/request_options.rbs
+- sig/safety_kit/resources/access_tokens.rbs
 - sig/safety_kit/resources/agent_decisions.rbs
 - sig/safety_kit/resources/async.rbs
 - sig/safety_kit/resources/beta.rbs