workos 10.2.1 → 10.4.0

data/lib/workos/agents/agent_blueprints_token_validate_token_request.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+# This file is auto-generated by oagen. Do not edit.
+
+module WorkOS
+  class AgentBlueprintsTokenValidateTokenRequest < WorkOS::Types::BaseModel
+    HASH_ATTRS = {
+      agent_access_token: :agent_access_token
+    }.freeze
+
+    attr_accessor :agent_access_token
+
+    def initialize(json)
+      hash = self.class.normalize(json)
+      @agent_access_token = hash[:agent_access_token]
+    end
+  end
+end

data/lib/workos/agents/agent_blueprints_update_request.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+# This file is auto-generated by oagen. Do not edit.
+
+module WorkOS
+  class AgentBlueprintsUpdateRequest < WorkOS::Types::BaseModel
+    HASH_ATTRS = {
+      name: :name,
+      description: :description,
+      permissions: :permissions,
+      invocable_by: :invocable_by,
+      session_settings: :session_settings
+    }.freeze
+
+    attr_accessor \
+      :name,
+      :description,
+      :permissions,
+      :invocable_by,
+      :session_settings
+
+    def initialize(json)
+      hash = self.class.normalize(json)
+      @name = hash[:name]
+      @description = hash[:description]
+      @permissions = hash[:permissions] || []
+      @invocable_by = hash[:invocable_by] ? WorkOS::AgentBlueprintsUpdateRequestInvocableBy.new(hash[:invocable_by]) : nil
+      @session_settings = hash[:session_settings] ? WorkOS::AgentBlueprintsUpdateRequestSessionSetting.new(hash[:session_settings]) : nil
+    end
+  end
+end

data/lib/workos/agents/agent_blueprints_update_request_invocable_by.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+# This file is auto-generated by oagen. Do not edit.
+
+module WorkOS
+  AgentBlueprintsUpdateRequestInvocableBy = AgentBlueprintsCreateRequestInvocableBy
+end

data/lib/workos/agents/agent_blueprints_update_request_session_setting.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+# This file is auto-generated by oagen. Do not edit.
+
+module WorkOS
+  class AgentBlueprintsUpdateRequestSessionSetting < WorkOS::Types::BaseModel
+    HASH_ATTRS = {
+      max_age_seconds: :max_age_seconds,
+      access_token_ttl_seconds: :access_token_ttl_seconds,
+      refresh_token_ttl_seconds: :refresh_token_ttl_seconds
+    }.freeze
+
+    attr_accessor \
+      :max_age_seconds,
+      :access_token_ttl_seconds,
+      :refresh_token_ttl_seconds
+
+    def initialize(json)
+      hash = self.class.normalize(json)
+      @max_age_seconds = hash[:max_age_seconds]
+      @access_token_ttl_seconds = hash[:access_token_ttl_seconds]
+      @refresh_token_ttl_seconds = hash[:refresh_token_ttl_seconds]
+    end
+  end
+end

data/lib/workos/agents/agent_instance.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+# This file is auto-generated by oagen. Do not edit.
+
+module WorkOS
+  class AgentInstance < WorkOS::Types::BaseModel
+    HASH_ATTRS = {
+      object: :object,
+      id: :id,
+      agent_blueprint_id: :agent_blueprint_id,
+      organization_id: :organization_id,
+      organization_membership_id: :organization_membership_id,
+      type: :type,
+      created_at: :created_at,
+      updated_at: :updated_at
+    }.freeze
+
+    attr_accessor \
+      :object,
+      :id,
+      :agent_blueprint_id,
+      :organization_id,
+      :organization_membership_id,
+      :type,
+      :created_at,
+      :updated_at
+
+    def initialize(json)
+      hash = self.class.normalize(json)
+      @object = hash[:object]
+      @id = hash[:id]
+      @agent_blueprint_id = hash[:agent_blueprint_id]
+      @organization_id = hash[:organization_id]
+      @organization_membership_id = hash[:organization_membership_id]
+      @type = hash[:type]
+      @created_at = hash[:created_at]
+      @updated_at = hash[:updated_at]
+    end
+  end
+end

data/lib/workos/agents/agent_instance_session.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+# This file is auto-generated by oagen. Do not edit.
+
+module WorkOS
+  class AgentInstanceSession < WorkOS::Types::BaseModel
+    HASH_ATTRS = {
+      object: :object,
+      id: :id,
+      agent_instance_id: :agent_instance_id,
+      status: :status,
+      expires_at: :expires_at,
+      revoked_at: :revoked_at,
+      created_at: :created_at,
+      updated_at: :updated_at
+    }.freeze
+
+    attr_accessor \
+      :object,
+      :id,
+      :agent_instance_id,
+      :status,
+      :expires_at,
+      :revoked_at,
+      :created_at,
+      :updated_at
+
+    def initialize(json)
+      hash = self.class.normalize(json)
+      @object = hash[:object]
+      @id = hash[:id]
+      @agent_instance_id = hash[:agent_instance_id]
+      @status = hash[:status]
+      @expires_at = hash[:expires_at]
+      @revoked_at = hash[:revoked_at]
+      @created_at = hash[:created_at]
+      @updated_at = hash[:updated_at]
+    end
+  end
+end

data/lib/workos/agents/agent_token.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+# This file is auto-generated by oagen. Do not edit.
+
+module WorkOS
+  class AgentToken < WorkOS::Types::BaseModel
+    HASH_ATTRS = {
+      access_token: :access_token,
+      token_type: :token_type,
+      expires_in: :expires_in,
+      refresh_token: :refresh_token,
+      agent_instance_id: :agent_instance_id,
+      new_instance: :new_instance,
+      agent_instance_session_id: :agent_instance_session_id,
+      permissions: :permissions
+    }.freeze
+
+    attr_accessor \
+      :access_token,
+      :token_type,
+      :expires_in,
+      :refresh_token,
+      :agent_instance_id,
+      :new_instance,
+      :agent_instance_session_id,
+      :permissions
+
+    def initialize(json)
+      hash = self.class.normalize(json)
+      @access_token = hash[:access_token]
+      @token_type = hash[:token_type]
+      @expires_in = hash[:expires_in]
+      @refresh_token = hash[:refresh_token]
+      @agent_instance_id = hash[:agent_instance_id]
+      @new_instance = hash[:new_instance]
+      @agent_instance_session_id = hash[:agent_instance_session_id]
+      @permissions = hash[:permissions] || []
+    end
+  end
+end

data/lib/workos/agents/agent_token_validation.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+# This file is auto-generated by oagen. Do not edit.
+
+module WorkOS
+  class AgentTokenValidation < WorkOS::Types::BaseModel
+    HASH_ATTRS = {
+      valid: :valid,
+      agent_instance_id: :agent_instance_id,
+      agent_instance_session_id: :agent_instance_session_id,
+      organization_id: :organization_id,
+      permissions: :permissions,
+      intent: :intent,
+      acting_user_id: :acting_user_id,
+      session_expires_at: :session_expires_at
+    }.freeze
+
+    attr_accessor \
+      :valid,
+      :agent_instance_id,
+      :agent_instance_session_id,
+      :organization_id,
+      :permissions,
+      :intent,
+      :acting_user_id,
+      :session_expires_at
+
+    def initialize(json)
+      hash = self.class.normalize(json)
+      @valid = hash[:valid]
+      @agent_instance_id = hash[:agent_instance_id]
+      @agent_instance_session_id = hash[:agent_instance_session_id]
+      @organization_id = hash[:organization_id]
+      @permissions = hash[:permissions] || []
+      @intent = hash[:intent]
+      @acting_user_id = hash[:acting_user_id]
+      @session_expires_at = hash[:session_expires_at]
+    end
+  end
+end

data/lib/workos/agents.rb

@@ -10,6 +10,223 @@ module WorkOS
       @client = client
     end
 
+    # List agent blueprints
+    # @param before [String, nil] An object ID that defines your place in the list. When the ID is not present, you are at the end of the list. For example, if you make a list request and receive 100 objects, ending with `"obj_123"`, your subsequent call can include `before="obj_123"` to fetch a new batch of objects before `"obj_123"`.
+    # @param after [String, nil] An object ID that defines your place in the list. When the ID is not present, you are at the end of the list. For example, if you make a list request and receive 100 objects, ending with `"obj_123"`, your subsequent call can include `after="obj_123"` to fetch a new batch of objects after `"obj_123"`.
+    # @param limit [Integer, nil] Upper limit on the number of objects to return, between `1` and `100`.
+    # @param order [WorkOS::Types::PaginationOrder, nil] Order the results by the creation time. Supported values are `"asc"` (ascending), `"desc"` (descending), and `"normal"` (descending with reversed cursor semantics where `before` fetches older records and `after` fetches newer records).
+    # @param request_options [Hash] (see WorkOS::Types::RequestOptions)
+    # @return [WorkOS::Types::ListStruct<WorkOS::AgentBlueprint>]
+    def list_blueprints(
+      before: nil,
+      after: nil,
+      limit: 10,
+      order: "desc",
+      request_options: {}
+    )
+      params = {
+        "before" => before,
+        "after" => after,
+        "limit" => limit,
+        "order" => order
+      }.compact
+      response = @client.request(
+        method: :get,
+        path: "/agents/blueprints",
+        auth: true,
+        params: params,
+        request_options: request_options
+      )
+      fetch_next = ->(cursor) {
+        list_blueprints(
+          before: before,
+          after: cursor,
+          limit: limit,
+          order: order,
+          request_options: request_options
+        )
+      }
+      WorkOS::Types::ListStruct.from_response(
+        response,
+        model: WorkOS::AgentBlueprint,
+        filters: {before: before, limit: limit, order: order},
+        fetch_next: fetch_next
+      )
+    end
+
+    # Create an agent blueprint
+    # @param name [String] Human-readable name of the agent blueprint.
+    # @param description [String, nil] Human-readable description of the agent blueprint.
+    # @param permissions [Array<String>, nil] Permission slugs forming the ceiling on what sessions minted from this blueprint may do. Each slug must exist in the environment.
+    # @param invocable_by [WorkOS::AgentBlueprintsCreateRequestInvocableBy, nil] Who may mint sessions from this blueprint.
+    # @param session_settings [WorkOS::AgentBlueprintsCreateRequestSessionSetting, nil] Token and session lifetimes for sessions minted from this blueprint.
+    # @param request_options [Hash] (see WorkOS::Types::RequestOptions)
+    # @return [WorkOS::AgentBlueprint]
+    def create_blueprint(
+      name:,
+      description: nil,
+      permissions: nil,
+      invocable_by: nil,
+      session_settings: nil,
+      request_options: {}
+    )
+      body = {
+        "name" => name,
+        "description" => description,
+        "permissions" => permissions,
+        "invocable_by" => invocable_by,
+        "session_settings" => session_settings
+      }.compact
+      response = @client.request(
+        method: :post,
+        path: "/agents/blueprints",
+        auth: true,
+        body: body,
+        request_options: request_options
+      )
+      result = WorkOS::AgentBlueprint.new(response.body)
+      result.last_response = WorkOS::Types::ApiResponse.new(http_status: response.code.to_i, http_headers: response.each_header.to_h, request_id: response["x-request-id"])
+      result
+    end
+
+    # Get an agent blueprint
+    # @param agent_blueprint_id [String] The unique ID of the agent blueprint.
+    # @param request_options [Hash] (see WorkOS::Types::RequestOptions)
+    # @return [WorkOS::AgentBlueprint]
+    def get_blueprint(
+      agent_blueprint_id:,
+      request_options: {}
+    )
+      response = @client.request(
+        method: :get,
+        path: "/agents/blueprints/#{WorkOS::Util.encode_path(agent_blueprint_id)}",
+        auth: true,
+        request_options: request_options
+      )
+      result = WorkOS::AgentBlueprint.new(response.body)
+      result.last_response = WorkOS::Types::ApiResponse.new(http_status: response.code.to_i, http_headers: response.each_header.to_h, request_id: response["x-request-id"])
+      result
+    end
+
+    # Update an agent blueprint
+    # @param agent_blueprint_id [String] The unique ID of the agent blueprint.
+    # @param name [String, nil] Human-readable name of the agent blueprint.
+    # @param description [String, nil] Human-readable description of the agent blueprint. Pass `null` to clear it.
+    # @param permissions [Array<String>, nil] Permission slugs forming the ceiling on what sessions minted from this blueprint may do. Each slug must exist in the environment.
+    # @param invocable_by [WorkOS::AgentBlueprintsUpdateRequestInvocableBy, nil] Who may mint sessions from this blueprint. Omitted lists are left unchanged.
+    # @param session_settings [WorkOS::AgentBlueprintsUpdateRequestSessionSetting, nil] Token and session lifetimes for sessions minted from this blueprint. Omitted fields are left unchanged.
+    # @param request_options [Hash] (see WorkOS::Types::RequestOptions)
+    # @return [WorkOS::AgentBlueprint]
+    def update_blueprint(
+      agent_blueprint_id:,
+      name: nil,
+      description: WorkOS::OMIT,
+      permissions: nil,
+      invocable_by: nil,
+      session_settings: nil,
+      request_options: {}
+    )
+      body = {
+        "name" => name,
+        "permissions" => permissions,
+        "invocable_by" => invocable_by,
+        "session_settings" => session_settings
+      }.compact
+      body["description"] = description unless description.equal?(WorkOS::OMIT)
+      response = @client.request(
+        method: :patch,
+        path: "/agents/blueprints/#{WorkOS::Util.encode_path(agent_blueprint_id)}",
+        auth: true,
+        body: body,
+        request_options: request_options
+      )
+      result = WorkOS::AgentBlueprint.new(response.body)
+      result.last_response = WorkOS::Types::ApiResponse.new(http_status: response.code.to_i, http_headers: response.each_header.to_h, request_id: response["x-request-id"])
+      result
+    end
+
+    # Delete an agent blueprint
+    # @param agent_blueprint_id [String] The unique ID of the agent blueprint.
+    # @param request_options [Hash] (see WorkOS::Types::RequestOptions)
+    # @return [void]
+    def delete_blueprint(
+      agent_blueprint_id:,
+      request_options: {}
+    )
+      @client.request(
+        method: :delete,
+        path: "/agents/blueprints/#{WorkOS::Util.encode_path(agent_blueprint_id)}",
+        auth: true,
+        request_options: request_options
+      )
+      nil
+    end
+
+    # Mint an agent token
+    # @param agent_blueprint_id [String] The unique ID of the agent blueprint.
+    # @param type [WorkOS::Types::AgentBlueprintsTokenMintTokenRequestType] How the session is minted: `user_delegated`, `autonomous`, `agent_delegated`, or `refresh`.
+    # @param user_access_token [String, nil] The access token of the user delegating to the agent. The token identifies the user and organization; effective permissions are resolved server-side.
+    # @param intent [String, nil] Optional caller-supplied context, echoed as an object with a `text` field in the `intent` claim of the minted access token.
+    # @param organization_id [String, nil] The organization the agent acts within when operating as itself.
+    # @param agent_access_token [String, nil] The agent's own access token to exchange for a new session on the same instance. The token must have been minted from this blueprint; permissions are re-derived from current authority.
+    # @param refresh_token [String, nil] The refresh token issued with a previous agent access token. Refresh tokens are single-use: each refresh rotates it.
+    # @param request_options [Hash] (see WorkOS::Types::RequestOptions)
+    # @return [WorkOS::AgentToken]
+    def create_blueprint_token(
+      agent_blueprint_id:,
+      type:,
+      user_access_token: nil,
+      intent: nil,
+      organization_id: nil,
+      agent_access_token: nil,
+      refresh_token: nil,
+      request_options: {}
+    )
+      body = {
+        "type" => type,
+        "user_access_token" => user_access_token,
+        "intent" => intent,
+        "organization_id" => organization_id,
+        "agent_access_token" => agent_access_token,
+        "refresh_token" => refresh_token
+      }.compact
+      response = @client.request(
+        method: :post,
+        path: "/agents/blueprints/#{WorkOS::Util.encode_path(agent_blueprint_id)}/tokens",
+        auth: true,
+        body: body,
+        request_options: request_options
+      )
+      result = WorkOS::AgentToken.new(response.body)
+      result.last_response = WorkOS::Types::ApiResponse.new(http_status: response.code.to_i, http_headers: response.each_header.to_h, request_id: response["x-request-id"])
+      result
+    end
+
+    # Validate an agent token
+    # @param agent_blueprint_id [String] The unique ID of the agent blueprint.
+    # @param agent_access_token [String] The agent access token (a JWT) to validate.
+    # @param request_options [Hash] (see WorkOS::Types::RequestOptions)
+    # @return [WorkOS::AgentTokenValidation]
+    def validate_blueprint_token(
+      agent_blueprint_id:,
+      agent_access_token:,
+      request_options: {}
+    )
+      body = {
+        "agent_access_token" => agent_access_token
+      }
+      response = @client.request(
+        method: :post,
+        path: "/agents/blueprints/#{WorkOS::Util.encode_path(agent_blueprint_id)}/tokens/validate",
+        auth: true,
+        body: body,
+        request_options: request_options
+      )
+      result = WorkOS::AgentTokenValidation.new(response.body)
+      result.last_response = WorkOS::Types::ApiResponse.new(http_status: response.code.to_i, http_headers: response.each_header.to_h, request_id: response["x-request-id"])
+      result
+    end
+
     # Link a claim attempt to an external user
     # @param type [String] The operation to perform on the claim attempt. Currently only `link_external_user` is supported.
     # @param claim_attempt_token [String] The token identifying the claim attempt.
@@ -89,5 +306,187 @@ module WorkOS
       result.last_response = WorkOS::Types::ApiResponse.new(http_status: response.code.to_i, http_headers: response.each_header.to_h, request_id: response["x-request-id"])
       result
     end
+
+    # List agent instances
+    # @param before [String, nil] An object ID that defines your place in the list. When the ID is not present, you are at the end of the list. For example, if you make a list request and receive 100 objects, ending with `"obj_123"`, your subsequent call can include `before="obj_123"` to fetch a new batch of objects before `"obj_123"`.
+    # @param after [String, nil] An object ID that defines your place in the list. When the ID is not present, you are at the end of the list. For example, if you make a list request and receive 100 objects, ending with `"obj_123"`, your subsequent call can include `after="obj_123"` to fetch a new batch of objects after `"obj_123"`.
+    # @param limit [Integer, nil] Upper limit on the number of objects to return, between `1` and `100`.
+    # @param order [WorkOS::Types::PaginationOrder, nil] Order the results by the creation time. Supported values are `"asc"` (ascending), `"desc"` (descending), and `"normal"` (descending with reversed cursor semantics where `before` fetches older records and `after` fetches newer records).
+    # @param organization_id [String, nil] Only return instances acting within this organization.
+    # @param agent_blueprint_id [String, nil] Only return instances minted from this blueprint.
+    # @param request_options [Hash] (see WorkOS::Types::RequestOptions)
+    # @return [WorkOS::Types::ListStruct<WorkOS::AgentInstance>]
+    def list_instances(
+      before: nil,
+      after: nil,
+      limit: 10,
+      order: "desc",
+      organization_id: nil,
+      agent_blueprint_id: nil,
+      request_options: {}
+    )
+      params = {
+        "before" => before,
+        "after" => after,
+        "limit" => limit,
+        "order" => order,
+        "organization_id" => organization_id,
+        "agent_blueprint_id" => agent_blueprint_id
+      }.compact
+      response = @client.request(
+        method: :get,
+        path: "/agents/instances",
+        auth: true,
+        params: params,
+        request_options: request_options
+      )
+      fetch_next = ->(cursor) {
+        list_instances(
+          before: before,
+          after: cursor,
+          limit: limit,
+          order: order,
+          organization_id: organization_id,
+          agent_blueprint_id: agent_blueprint_id,
+          request_options: request_options
+        )
+      }
+      WorkOS::Types::ListStruct.from_response(
+        response,
+        model: WorkOS::AgentInstance,
+        filters: {before: before, limit: limit, order: order, organization_id: organization_id, agent_blueprint_id: agent_blueprint_id},
+        fetch_next: fetch_next
+      )
+    end
+
+    # Get an agent instance
+    # @param agent_instance_id [String] The unique ID of the agent instance.
+    # @param request_options [Hash] (see WorkOS::Types::RequestOptions)
+    # @return [WorkOS::AgentInstance]
+    def get_instance(
+      agent_instance_id:,
+      request_options: {}
+    )
+      response = @client.request(
+        method: :get,
+        path: "/agents/instances/#{WorkOS::Util.encode_path(agent_instance_id)}",
+        auth: true,
+        request_options: request_options
+      )
+      result = WorkOS::AgentInstance.new(response.body)
+      result.last_response = WorkOS::Types::ApiResponse.new(http_status: response.code.to_i, http_headers: response.each_header.to_h, request_id: response["x-request-id"])
+      result
+    end
+
+    # Delete an agent instance
+    # @param agent_instance_id [String] The unique ID of the agent instance.
+    # @param request_options [Hash] (see WorkOS::Types::RequestOptions)
+    # @return [void]
+    def delete_instance(
+      agent_instance_id:,
+      request_options: {}
+    )
+      @client.request(
+        method: :delete,
+        path: "/agents/instances/#{WorkOS::Util.encode_path(agent_instance_id)}",
+        auth: true,
+        request_options: request_options
+      )
+      nil
+    end
+
+    # List agent instance sessions
+    # @param before [String, nil] An object ID that defines your place in the list. When the ID is not present, you are at the end of the list. For example, if you make a list request and receive 100 objects, ending with `"obj_123"`, your subsequent call can include `before="obj_123"` to fetch a new batch of objects before `"obj_123"`.
+    # @param after [String, nil] An object ID that defines your place in the list. When the ID is not present, you are at the end of the list. For example, if you make a list request and receive 100 objects, ending with `"obj_123"`, your subsequent call can include `after="obj_123"` to fetch a new batch of objects after `"obj_123"`.
+    # @param limit [Integer, nil] Upper limit on the number of objects to return, between `1` and `100`.
+    # @param order [WorkOS::Types::PaginationOrder, nil] Order the results by the creation time. Supported values are `"asc"` (ascending), `"desc"` (descending), and `"normal"` (descending with reversed cursor semantics where `before` fetches older records and `after` fetches newer records).
+    # @param organization_id [String, nil] Only return sessions of instances acting within this organization.
+    # @param agent_blueprint_id [String, nil] Only return sessions of instances minted from this blueprint.
+    # @param agent_instance_id [String, nil] Only return sessions belonging to this agent instance.
+    # @param request_options [Hash] (see WorkOS::Types::RequestOptions)
+    # @return [WorkOS::Types::ListStruct<WorkOS::AgentInstanceSession>]
+    def list_sessions(
+      before: nil,
+      after: nil,
+      limit: 10,
+      order: "desc",
+      organization_id: nil,
+      agent_blueprint_id: nil,
+      agent_instance_id: nil,
+      request_options: {}
+    )
+      params = {
+        "before" => before,
+        "after" => after,
+        "limit" => limit,
+        "order" => order,
+        "organization_id" => organization_id,
+        "agent_blueprint_id" => agent_blueprint_id,
+        "agent_instance_id" => agent_instance_id
+      }.compact
+      response = @client.request(
+        method: :get,
+        path: "/agents/sessions",
+        auth: true,
+        params: params,
+        request_options: request_options
+      )
+      fetch_next = ->(cursor) {
+        list_sessions(
+          before: before,
+          after: cursor,
+          limit: limit,
+          order: order,
+          organization_id: organization_id,
+          agent_blueprint_id: agent_blueprint_id,
+          agent_instance_id: agent_instance_id,
+          request_options: request_options
+        )
+      }
+      WorkOS::Types::ListStruct.from_response(
+        response,
+        model: WorkOS::AgentInstanceSession,
+        filters: {before: before, limit: limit, order: order, organization_id: organization_id, agent_blueprint_id: agent_blueprint_id, agent_instance_id: agent_instance_id},
+        fetch_next: fetch_next
+      )
+    end
+
+    # Get an agent instance session
+    # @param agent_instance_session_id [String] The unique ID of the agent instance session.
+    # @param request_options [Hash] (see WorkOS::Types::RequestOptions)
+    # @return [WorkOS::AgentInstanceSession]
+    def get_session(
+      agent_instance_session_id:,
+      request_options: {}
+    )
+      response = @client.request(
+        method: :get,
+        path: "/agents/sessions/#{WorkOS::Util.encode_path(agent_instance_session_id)}",
+        auth: true,
+        request_options: request_options
+      )
+      result = WorkOS::AgentInstanceSession.new(response.body)
+      result.last_response = WorkOS::Types::ApiResponse.new(http_status: response.code.to_i, http_headers: response.each_header.to_h, request_id: response["x-request-id"])
+      result
+    end
+
+    # Revoke an agent instance session
+    # @param agent_instance_session_id [String] The unique ID of the agent instance session.
+    # @param request_options [Hash] (see WorkOS::Types::RequestOptions)
+    # @return [WorkOS::AgentInstanceSession]
+    def revoke_session(
+      agent_instance_session_id:,
+      request_options: {}
+    )
+      response = @client.request(
+        method: :post,
+        path: "/agents/sessions/#{WorkOS::Util.encode_path(agent_instance_session_id)}/revoke",
+        auth: true,
+        request_options: request_options
+      )
+      result = WorkOS::AgentInstanceSession.new(response.body)
+      result.last_response = WorkOS::Types::ApiResponse.new(http_status: response.code.to_i, http_headers: response.each_header.to_h, request_id: response["x-request-id"])
+      result
+    end
   end
 end