openai 0.89.0 → 0.91.0

data/rbi/openai/resources/beta/agents/sessions.rbi

@@ -0,0 +1,212 @@
+# typed: strong
+
+module OpenAI
+  module Resources
+
+    class Beta
+
+      class Agents
+
+        class Sessions
+
+          sig { returns(OpenAI::Resources::Beta::Agents::Sessions::Subagents) }
+          attr_reader :subagents
+
+          sig { returns(OpenAI::Resources::Beta::Agents::Sessions::Artifacts) }
+          attr_reader :artifacts
+
+          sig { returns(OpenAI::Resources::Beta::Agents::Sessions::Items) }
+          attr_reader :items
+
+          sig { returns(OpenAI::Resources::Beta::Agents::Sessions::Events) }
+          attr_reader :events
+
+          sig { returns(OpenAI::Resources::Beta::Agents::Sessions::Turns) }
+          attr_reader :turns
+
+          # See {OpenAI::Resources::Beta::Agents::Sessions#create_streaming} for streaming
+          # counterpart.
+          #
+          # Creates a managed agent session, optionally submits initial input, and returns
+          # the session or streams its events when stream is true. See
+          # [running sessions](https://developers.openai.com/api/docs/guides/agents-api/sessions).
+          sig {
+            params(
+              environment: T.any(
+                OpenAI::Beta::EnvironmentParam::None::OrHash,
+                OpenAI::Beta::EnvironmentParam::OpenAIHosted::OrHash,
+                OpenAI::Beta::EnvironmentParam::SelfHosted::OrHash
+              ),
+              agent: OpenAI::Beta::Agents::SessionCreateParams::Agent::OrHash,
+              agent_id: String,
+              input: T.nilable(OpenAI::Beta::Agents::SessionCreateParams::Input::Variants),
+              metadata: T.nilable(T::Hash[Symbol, String]),
+              vault_ids: T.nilable(T::Array[String]),
+              stream: T.noreturn,
+              request_options: OpenAI::RequestOptions::OrHash
+            )
+              .returns(OpenAI::Beta::AgentSession)
+          }
+          def create(
+            # An inline execution environment or a reference to an environment template.
+            environment:,
+            # Agent configuration. With `agent_id`, supplied fields override the saved agent
+            # for this session. Without `agent_id`, `model` is required.
+            agent: nil,
+            # The ID of a saved reusable agent. Omit `agent` to use its configuration
+            # unchanged.
+            agent_id: nil,
+            # Initial input submitted when creating a session.
+            input: nil,
+            # Up to 16 string key-value pairs, with keys up to 64 and values up to 512
+            # characters. Omission or null defaults to an empty map.
+            metadata: nil,
+            # The IDs of vaults made available to the session.
+            vault_ids: nil,
+            # There is no need to provide `stream:`. Instead, use `#create_streaming` or
+            # `#create` for streaming and non-streaming use cases, respectively.
+            stream: false,
+            request_options: {}
+          )
+          end
+
+          # See {OpenAI::Resources::Beta::Agents::Sessions#create} for non-streaming
+          # counterpart.
+          #
+          # Creates a managed agent session, optionally submits initial input, and returns
+          # the session or streams its events when stream is true. See
+          # [running sessions](https://developers.openai.com/api/docs/guides/agents-api/sessions).
+          sig {
+            params(
+              environment: T.any(
+                OpenAI::Beta::EnvironmentParam::None::OrHash,
+                OpenAI::Beta::EnvironmentParam::OpenAIHosted::OrHash,
+                OpenAI::Beta::EnvironmentParam::SelfHosted::OrHash
+              ),
+              agent: OpenAI::Beta::Agents::SessionCreateParams::Agent::OrHash,
+              agent_id: String,
+              input: T.nilable(OpenAI::Beta::Agents::SessionCreateParams::Input::Variants),
+              metadata: T.nilable(T::Hash[Symbol, String]),
+              vault_ids: T.nilable(T::Array[String]),
+              stream: T.noreturn,
+              request_options: OpenAI::RequestOptions::OrHash
+            )
+              .returns(OpenAI::Internal::Stream[OpenAI::Beta::AgentSessionEvent::Variants])
+          }
+          def create_streaming(
+            # An inline execution environment or a reference to an environment template.
+            environment:,
+            # Agent configuration. With `agent_id`, supplied fields override the saved agent
+            # for this session. Without `agent_id`, `model` is required.
+            agent: nil,
+            # The ID of a saved reusable agent. Omit `agent` to use its configuration
+            # unchanged.
+            agent_id: nil,
+            # Initial input submitted when creating a session.
+            input: nil,
+            # Up to 16 string key-value pairs, with keys up to 64 and values up to 512
+            # characters. Omission or null defaults to an empty map.
+            metadata: nil,
+            # The IDs of vaults made available to the session.
+            vault_ids: nil,
+            # There is no need to provide `stream:`. Instead, use `#create_streaming` or
+            # `#create` for streaming and non-streaming use cases, respectively.
+            stream: true,
+            request_options: {}
+          )
+          end
+
+          # Retrieves the current state of a managed agent session. See
+          # [managing sessions](https://developers.openai.com/api/docs/guides/agents-api/sessions/manage).
+          sig {
+            params(session_id: String, request_options: OpenAI::RequestOptions::OrHash).returns(
+              OpenAI::Beta::AgentSession
+            )
+          }
+          def retrieve(
+            # The ID of the session.
+            session_id,
+            request_options: {}
+          )
+          end
+
+          # Updates session metadata, model, reasoning effort, or service tier. Model
+          # settings apply to subsequent turns. Omitted fields are unchanged. See
+          # [managing sessions](https://developers.openai.com/api/docs/guides/agents-api/sessions/manage).
+          sig {
+            params(
+              session_id: String,
+              agent: OpenAI::Beta::Agents::SessionUpdateParams::Agent::OrHash,
+              metadata: T.nilable(T::Hash[Symbol, String]),
+              request_options: OpenAI::RequestOptions::OrHash
+            )
+              .returns(OpenAI::Beta::AgentSession)
+          }
+          def update(
+            # The ID of the session.
+            session_id,
+            # Model settings for subsequent turns. Omitted fields stay unchanged.
+            agent: nil,
+            # Replaces all metadata. Omit to leave unchanged, or pass null or {} to clear it.
+            # Up to 16 string key-value pairs, with keys up to 64 and values up to 512
+            # characters.
+            metadata: nil,
+            request_options: {}
+          )
+          end
+
+          # Lists managed agent sessions using ID-based pagination and the requested sort
+          # order. See
+          # [managing sessions](https://developers.openai.com/api/docs/guides/agents-api/sessions/manage).
+          sig {
+            params(
+              after: String,
+              agent_id: String,
+              limit: T.nilable(Integer),
+              order: OpenAI::Beta::Agents::SessionListParams::Order::OrSymbol,
+              request_options: OpenAI::RequestOptions::OrHash
+            )
+              .returns(OpenAI::Internal::CursorPage[OpenAI::Beta::AgentSession])
+          }
+          def list(
+            # Return resources after this resource ID in the selected order.
+            after: nil,
+            # Only return sessions whose root agent has this ID. Omit to return sessions for
+            # all agents.
+            agent_id: nil,
+            # The maximum number of resources to return.
+            limit: nil,
+            # Sort order by the `created_at` timestamp. Use `asc` for ascending order or
+            # `desc` for descending order. Defaults to `desc`.
+            order: nil,
+            request_options: {}
+          )
+          end
+
+          # Removes a managed agent session from the public API and returns a deletion
+          # confirmation. Physical cleanup may continue asynchronously. See
+          # [managing sessions](https://developers.openai.com/api/docs/guides/agents-api/sessions/manage).
+          sig {
+            params(session_id: String, request_options: OpenAI::RequestOptions::OrHash).returns(
+              OpenAI::Beta::AgentSessionDeleted
+            )
+          }
+          def delete(
+            # The ID of the session.
+            session_id,
+            request_options: {}
+          )
+          end
+
+          # @api private
+          sig { params(client: OpenAI::Client).returns(T.attached_class) }
+          def self.new(client:)
+          end
+        end
+
+      end
+
+    end
+
+  end
+end

data/rbi/openai/resources/beta/agents/vaults/credentials.rbi

@@ -0,0 +1,148 @@
+# typed: strong
+
+module OpenAI
+  module Resources
+
+    class Beta
+
+      class Agents
+
+        class Vaults
+
+          class Credentials
+
+            # Creates a vault credential. Secret values are write-only and are never returned.
+            # See
+            # [vaults](https://developers.openai.com/api/docs/guides/agents-api/tools/vaults).
+            sig {
+              params(
+                vault_id: String,
+                auth: T.any(
+                  OpenAI::Beta::Agents::Vaults::CredentialAuthCreateParam::McpOauth::OrHash,
+                  OpenAI::Beta::Agents::Vaults::CredentialAuthCreateParam::StaticBearer::OrHash
+                ),
+                name: String,
+                request_options: OpenAI::RequestOptions::OrHash
+              )
+                .returns(OpenAI::Beta::Agents::Vaults::Credential)
+            }
+            def create(
+              # The ID of the vault.
+              vault_id,
+              # The authentication method and secret values to store for the MCP server.
+              auth:,
+              # The name is trimmed before storage. It must contain 1 to 256 UTF-8 bytes after
+              # trimming.
+              name:,
+              request_options: {}
+            )
+            end
+
+            # Retrieves vault credential metadata without returning secret values. See
+            # [vaults](https://developers.openai.com/api/docs/guides/agents-api/tools/vaults).
+            sig {
+              params(credential_id: String, vault_id: String, request_options: OpenAI::RequestOptions::OrHash).returns(
+                OpenAI::Beta::Agents::Vaults::Credential
+              )
+            }
+            def retrieve(
+              # The ID of the vault credential.
+              credential_id,
+              # The ID of the vault.
+              vault_id:,
+              request_options: {}
+            )
+            end
+
+            # Rotates a vault credential's write-only secret and returns only credential
+            # metadata. See
+            # [vaults](https://developers.openai.com/api/docs/guides/agents-api/tools/vaults).
+            sig {
+              params(
+                credential_id: String,
+                vault_id: String,
+                auth: T.any(
+                  OpenAI::Beta::Agents::Vaults::CredentialAuthRotateParam::McpOauth::OrHash,
+                  OpenAI::Beta::Agents::Vaults::CredentialAuthRotateParam::StaticBearer::OrHash
+                ),
+                request_options: OpenAI::RequestOptions::OrHash
+              )
+                .returns(OpenAI::Beta::Agents::Vaults::Credential)
+            }
+            def update(
+              # Path param: The ID of the vault credential.
+              credential_id,
+              # Path param: The ID of the vault.
+              vault_id:,
+              # Body param: Replacement values for the credential's existing authentication
+              # method.
+              auth:,
+              request_options: {}
+            )
+            end
+
+            # Lists a vault's credentials using ID-based pagination without returning secret
+            # values. See
+            # [vaults](https://developers.openai.com/api/docs/guides/agents-api/tools/vaults).
+            sig {
+              params(
+                vault_id: String,
+                after: String,
+                limit: T.nilable(Integer),
+                order: OpenAI::Beta::Agents::Vaults::CredentialListParams::Order::OrSymbol,
+                status: T.any(
+                  OpenAI::Beta::Agents::VaultStatus::OrSymbol,
+                  T::Array[OpenAI::Beta::Agents::VaultStatus::OrSymbol]
+                ),
+                request_options: OpenAI::RequestOptions::OrHash
+              )
+                .returns(OpenAI::Internal::CursorPage[OpenAI::Beta::Agents::Vaults::Credential])
+            }
+            def list(
+              # The ID of the vault.
+              vault_id,
+              # Return resources after this resource ID in the selected order.
+              after: nil,
+              # The maximum number of resources to return. Defaults to 20. Values are clamped
+              # between 1 and 100.
+              limit: nil,
+              # Sort order by the `created_at` timestamp. Use `asc` for ascending order or
+              # `desc` for descending order. Defaults to `desc`.
+              order: nil,
+              # Filter by one status or a list, such as `status=active` or
+              # `status[]=active&status[]=archived`. Both statuses are included by default.
+              status: nil,
+              request_options: {}
+            )
+            end
+
+            # Deletes a vault credential. See
+            # [vaults](https://developers.openai.com/api/docs/guides/agents-api/tools/vaults).
+            sig {
+              params(credential_id: String, vault_id: String, request_options: OpenAI::RequestOptions::OrHash).returns(
+                OpenAI::Beta::Agents::Vaults::CredentialDeleted
+              )
+            }
+            def delete(
+              # The ID of the vault credential.
+              credential_id,
+              # The ID of the vault.
+              vault_id:,
+              request_options: {}
+            )
+            end
+
+            # @api private
+            sig { params(client: OpenAI::Client).returns(T.attached_class) }
+            def self.new(client:)
+            end
+          end
+
+        end
+
+      end
+
+    end
+
+  end
+end

data/rbi/openai/resources/beta/agents/vaults.rbi

@@ -0,0 +1,106 @@
+# typed: strong
+
+module OpenAI
+  module Resources
+
+    class Beta
+
+      class Agents
+
+        class Vaults
+
+          sig { returns(OpenAI::Resources::Beta::Agents::Vaults::Credentials) }
+          attr_reader :credentials
+
+          # Creates a vault for the current project. See
+          # [vaults](https://developers.openai.com/api/docs/guides/agents-api/tools/vaults).
+          sig {
+            params(
+              metadata: T.nilable(T::Hash[Symbol, String]),
+              name: String,
+              request_options: OpenAI::RequestOptions::OrHash
+            )
+              .returns(OpenAI::Beta::Agents::Vault)
+          }
+          def create(
+            # Key-value pairs to associate with the vault, such as an application or team
+            # identifier.
+            metadata: nil,
+            # The name is trimmed before storage. It must contain 1 to 256 UTF-8 bytes after
+            # trimming.
+            name: nil,
+            request_options: {}
+          )
+          end
+
+          # Retrieves a vault by its ID. See
+          # [vaults](https://developers.openai.com/api/docs/guides/agents-api/tools/vaults).
+          sig {
+            params(vault_id: String, request_options: OpenAI::RequestOptions::OrHash).returns(
+              OpenAI::Beta::Agents::Vault
+            )
+          }
+          def retrieve(
+            # The ID of the vault.
+            vault_id,
+            request_options: {}
+          )
+          end
+
+          # Lists vaults using ID-based pagination. See
+          # [vaults](https://developers.openai.com/api/docs/guides/agents-api/tools/vaults).
+          sig {
+            params(
+              after: String,
+              limit: T.nilable(Integer),
+              order: OpenAI::Beta::Agents::VaultListParams::Order::OrSymbol,
+              status: T.any(
+                OpenAI::Beta::Agents::VaultStatus::OrSymbol,
+                T::Array[OpenAI::Beta::Agents::VaultStatus::OrSymbol]
+              ),
+              request_options: OpenAI::RequestOptions::OrHash
+            )
+              .returns(OpenAI::Internal::CursorPage[OpenAI::Beta::Agents::Vault])
+          }
+          def list(
+            # Return resources after this resource ID in the selected order.
+            after: nil,
+            # The maximum number of resources to return. Defaults to 20. Values are clamped
+            # between 1 and 100.
+            limit: nil,
+            # Sort order by the `created_at` timestamp. Use `asc` for ascending order or
+            # `desc` for descending order. Defaults to `desc`.
+            order: nil,
+            # Filter by one status or a list, such as `status=active` or
+            # `status[]=active&status[]=archived`. Both statuses are included by default.
+            status: nil,
+            request_options: {}
+          )
+          end
+
+          # Deletes a vault and all its credentials. See
+          # [vaults](https://developers.openai.com/api/docs/guides/agents-api/tools/vaults).
+          sig {
+            params(vault_id: String, request_options: OpenAI::RequestOptions::OrHash).returns(
+              OpenAI::Beta::Agents::VaultDeleted
+            )
+          }
+          def delete(
+            # The ID of the vault.
+            vault_id,
+            request_options: {}
+          )
+          end
+
+          # @api private
+          sig { params(client: OpenAI::Client).returns(T.attached_class) }
+          def self.new(client:)
+          end
+        end
+
+      end
+
+    end
+
+  end
+end

data/rbi/openai/resources/beta/agents.rbi

@@ -0,0 +1,180 @@
+# typed: strong
+
+module OpenAI
+  module Resources
+
+    class Beta
+
+      class Agents
+
+        sig { returns(OpenAI::Resources::Beta::Agents::Environments) }
+        attr_reader :environments
+
+        sig { returns(OpenAI::Resources::Beta::Agents::Vaults) }
+        attr_reader :vaults
+
+        sig { returns(OpenAI::Resources::Beta::Agents::Sessions) }
+        attr_reader :sessions
+
+        # Creates a reusable agent without storing credentials. See
+        # [agent configuration](https://developers.openai.com/api/docs/guides/agents-api/configuration).
+        sig {
+          params(
+            model: String,
+            instructions: T.nilable(String),
+            metadata: T.nilable(T::Hash[Symbol, String]),
+            multi_agent: T.nilable(OpenAI::Beta::MultiAgentConfigParam::OrHash),
+            name: T.nilable(String),
+            reasoning: T.nilable(OpenAI::Beta::AgentReasoningParam::OrHash),
+            service_tier: T.nilable(OpenAI::Beta::AgentCreateParams::ServiceTier::OrSymbol),
+            text: T.nilable(OpenAI::Beta::AgentTextParam::OrHash),
+            tools: T.nilable(
+              T::Array[
+                T.any(
+                  OpenAI::Beta::PersistedAgentToolParam::Function::OrHash,
+                  OpenAI::Beta::PersistedAgentToolParam::ToolSearch::OrHash,
+                  OpenAI::Beta::PersistedAgentToolParam::ProgrammaticToolCalling::OrHash,
+                  OpenAI::Beta::PersistedAgentToolParam::Mcp::OrHash,
+                  OpenAI::Beta::PersistedAgentToolParam::WebSearch::OrHash
+                )
+              ]
+            ),
+            request_options: OpenAI::RequestOptions::OrHash
+          )
+            .returns(OpenAI::Beta::Agent)
+        }
+        def create(
+          # The model to use for the agent. The requested model name is preserved.
+          model:,
+          # Additional instructions appended to the agent's default base instructions. Omit
+          # or set to null to add no custom instructions.
+          instructions: nil,
+          # Up to 16 string key-value pairs, with keys up to 64 and values up to 512
+          # characters. Omission or null defaults to an empty map.
+          metadata: nil,
+          # Explicit configuration for creating and coordinating subagents.
+          multi_agent: nil,
+          # A human-readable name for the agent. Omission or null leaves the agent unnamed.
+          name: nil,
+          # Reasoning configuration for the agent.
+          reasoning: nil,
+          # The service tier used for model requests.
+          service_tier: nil,
+          # Configuration for text generated by the agent.
+          text: nil,
+          # Tools available to the agent. Defaults to an empty list.
+          tools: nil,
+          request_options: {}
+        )
+        end
+
+        # Retrieves a reusable agent by ID. See
+        # [agent configuration](https://developers.openai.com/api/docs/guides/agents-api/configuration).
+        sig { params(agent_id: String, request_options: OpenAI::RequestOptions::OrHash).returns(OpenAI::Beta::Agent) }
+        def retrieve(
+          # The ID of the reusable agent.
+          agent_id,
+          request_options: {}
+        )
+        end
+
+        # Updates a reusable agent. See
+        # [agent configuration](https://developers.openai.com/api/docs/guides/agents-api/configuration).
+        sig {
+          params(
+            agent_id: String,
+            instructions: T.nilable(String),
+            metadata: T.nilable(T::Hash[Symbol, String]),
+            model: String,
+            multi_agent: T.nilable(OpenAI::Beta::MultiAgentConfigParam::OrHash),
+            name: T.nilable(String),
+            reasoning: T.nilable(OpenAI::Beta::AgentReasoningParam::OrHash),
+            service_tier: T.nilable(OpenAI::Beta::AgentUpdateParams::ServiceTier::OrSymbol),
+            text: T.nilable(OpenAI::Beta::AgentTextParam::OrHash),
+            tools: T.nilable(
+              T::Array[
+                T.any(
+                  OpenAI::Beta::PersistedAgentToolParam::Function::OrHash,
+                  OpenAI::Beta::PersistedAgentToolParam::ToolSearch::OrHash,
+                  OpenAI::Beta::PersistedAgentToolParam::ProgrammaticToolCalling::OrHash,
+                  OpenAI::Beta::PersistedAgentToolParam::Mcp::OrHash,
+                  OpenAI::Beta::PersistedAgentToolParam::WebSearch::OrHash
+                )
+              ]
+            ),
+            request_options: OpenAI::RequestOptions::OrHash
+          )
+            .returns(OpenAI::Beta::Agent)
+        }
+        def update(
+          # The ID of the reusable agent.
+          agent_id,
+          # Additional instructions appended to the agent's default base instructions. Omit
+          # to leave unchanged.
+          instructions: nil,
+          # Replaces all metadata. Omit to leave unchanged, or pass null or {} to clear it.
+          # Up to 16 string key-value pairs, with keys up to 64 and values up to 512
+          # characters.
+          metadata: nil,
+          # The model to use for the agent. The requested model name is preserved.
+          model: nil,
+          # Explicit configuration for creating and coordinating subagents.
+          multi_agent: nil,
+          # A replacement name. Omit to leave unchanged, or pass null to clear it.
+          name: nil,
+          # Reasoning configuration for the agent.
+          reasoning: nil,
+          # The service tier used for model requests.
+          service_tier: nil,
+          # Configuration for text generated by the agent.
+          text: nil,
+          # Tools available to the agent.
+          tools: nil,
+          request_options: {}
+        )
+        end
+
+        # Lists reusable agents in the current project. See
+        # [agent configuration](https://developers.openai.com/api/docs/guides/agents-api/configuration).
+        sig {
+          params(
+            after: String,
+            limit: T.nilable(Integer),
+            order: OpenAI::Beta::AgentListParams::Order::OrSymbol,
+            request_options: OpenAI::RequestOptions::OrHash
+          )
+            .returns(OpenAI::Internal::CursorPage[OpenAI::Beta::Agent])
+        }
+        def list(
+          # Return resources after this resource ID in the selected order.
+          after: nil,
+          # The maximum number of resources to return.
+          limit: nil,
+          # The order in which resources are returned. Defaults to `desc`.
+          order: nil,
+          request_options: {}
+        )
+        end
+
+        # Deletes a reusable agent. See
+        # [agent configuration](https://developers.openai.com/api/docs/guides/agents-api/configuration).
+        sig {
+          params(agent_id: String, request_options: OpenAI::RequestOptions::OrHash).returns(OpenAI::Beta::AgentDeleted)
+        }
+        def delete(
+          # The ID of the reusable agent.
+          agent_id,
+          request_options: {}
+        )
+        end
+
+        # @api private
+        sig { params(client: OpenAI::Client).returns(T.attached_class) }
+        def self.new(client:)
+        end
+      end
+
+    end
+
+  end
+end

data/rbi/openai/resources/beta.rbi

@@ -5,6 +5,9 @@ module OpenAI
 
     class Beta
 
+      sig { returns(OpenAI::Resources::Beta::Agents) }
+      attr_reader :agents
+
       sig { returns(OpenAI::Resources::Beta::Responses) }
       attr_reader :responses
 

data/rbi/openai/resources/live/sessions.rbi

@@ -7,7 +7,11 @@ module OpenAI
 
       class Sessions
 
-        # Accept an incoming SIP call with Live startup configuration.
+        # Accept an incoming SIP call. Supply session with type live, the model, and
+        # startup configuration. Before accepting calls, follow the
+        # [Live prompting guide](https://developers.openai.com/api/docs/guides/live-prompting)
+        # to write frontend conversation instructions and a separate backend prompt. SIP
+        # media format is negotiated; omit audio.format.
         sig {
           params(
             session_id: String,
@@ -63,7 +67,7 @@ module OpenAI
         )
         end
 
-        # Hang up a Live session.
+        # End a SIP call identified by session_id.
         sig { params(session_id: String, request_options: OpenAI::RequestOptions::OrHash).void }
         def hangup(
           # Opaque Live session identifier from the creation response or incoming-call
@@ -73,7 +77,8 @@ module OpenAI
         )
         end
 
-        # Transfer a Live SIP call to another destination.
+        # Transfer a SIP call to another destination. Supply a nonblank target_uri for the
+        # SIP Refer-To header.
         sig { params(session_id: String, target_uri: String, request_options: OpenAI::RequestOptions::OrHash).void }
         def refer(
           # Opaque Live session identifier from the creation response or incoming-call
@@ -86,7 +91,8 @@ module OpenAI
         )
         end
 
-        # Reject an incoming SIP call.
+        # Reject an incoming SIP call. Send a required SIP rejection status_code between
+        # 300 and 699.
         sig { params(session_id: String, status_code: Integer, request_options: OpenAI::RequestOptions::OrHash).void }
         def reject(
           # Opaque Live session identifier from the creation response or incoming-call