deepl-rb 3.6.1 → 3.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8ea8e9d6cc6601abfadddf2b0b70169a7449e71434a8b695c534789d2263d681
-  data.tar.gz: '029b836b133bbf60d9b4a8acecf90b89d969d991e793db1bf5643f5633895282'
+  metadata.gz: ac9df781efec35e22812fb7d998386c19dd2f51afeb020d1850c4b2091e5ba20
+  data.tar.gz: 70db2ae1bd08aa8e1dffb01198225ad29fc5c2514cf4f1a38da948bbe97c51f3
 SHA512:
-  metadata.gz: 83070b04ae93261b4524cb5353bdb888c2b9f5a98c9314239ed4ae8c76a53182363bb31ba31f7468a7a5d705162c09fbb69fb0f4a71bc802d8b373d97c46aeaa
-  data.tar.gz: 8ac545b8fb392b31a0e3fa00f4ed7f556bcf92304d8852226e57d099d365554c6eb5f510fe76891c329bdf89851c2bff217417f157947ffb96e41e50ef58b562
+  metadata.gz: 5c55b0eb6a6ef528eb14f78acfb89591fa99de7c7d8a82fb322e5b189c6663ff5f5f915d46ac4e93fcebc5a1d1f71bcef3d94fb1cac36d5e5fcabec9eb656cb5
+  data.tar.gz: a606b2405448a3598faf0d38e51830437d14019ab6b2cec4a794f93bc47f8329612fc524b1f2d5c71e48063ef4682a12831cada04d8b5c2a9f8ffd1f2012c3e6

data/.gitlab-ci.yml

@@ -57,6 +57,8 @@ package:
   image:
     name: ruby:2.7
     entrypoint: ['/builds/deepl/backend/oss-client-libs/deepl-ruby']
+  variables:
+    HOME: /tmp
   script: bundle exec rubocop
 
 rubocop_scheduled:
@@ -167,6 +169,9 @@ test_manual:
 
 gitlab release:
   stage: publish
+  image: registry.gitlab.com/gitlab-org/release-cli:latest
   extends: .create_gitlab_release
+  before_script:
+    - echo "overriding default before_script..."
   rules:
     - if: '$CI_COMMIT_TAG =~ /^v[0-9]+\.[0-9]+\.[0-9]+$/'

data/CHANGELOG.md

@@ -6,6 +6,23 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [3.7.0] - 2026-05-14
+### Added
+- Added support for listing translation memories via `DeepL.translation_memories.list`.
+- Added `translation_memory` and `translation_memory_threshold` parameters to `translate()`
+  to use a translation memory during text translation. The `translation_memory` parameter
+  accepts a string ID or a `TranslationMemory` object.
+- Added support for style rules CRUD operations via `DeepL.style_rules`:
+  `create()`, `find()`, `update_name()`, `update_configured_rules()`, and `destroy()`.
+- Added support for style rule custom instruction CRUD operations via `DeepL.style_rules`:
+  `create_custom_instruction()`, `find_custom_instruction()`,
+  `update_custom_instruction()`, and `destroy_custom_instruction()`.
+  Please refer to the README for usage instructions.
+
+### Changed
+- Updated unit test to expect the `model_type_used` to now be `quality_optimized`
+- Set explicit `image` for `gitlab release` CI job to avoid missing `$HOME` issues
+
 ## [3.6.1] - 2025-12-19
 ### Fixed
 - Fixed broken 3.6.0 release
@@ -102,7 +119,8 @@ The change in major version is only due to the change in maintainership, there i
 ### Fixed
 - Make RequestEntityTooLarge error message more clear
 
-[Unreleased]: https://github.com/DeepLcom/deepl-rb/compare/v3.6.1...HEAD
+[Unreleased]: https://github.com/DeepLcom/deepl-rb/compare/v3.7.0...HEAD
+[3.7.0]: https://github.com/DeepLcom/deepl-rb/compare/v3.6.1...v3.7.0
 [3.6.1]: https://github.com/DeepLcom/deepl-rb/compare/v3.6.0...v3.6.1
 [3.6.0]: https://github.com/DeepLcom/deepl-rb/compare/v3.5.1...v3.6.0
 [3.5.1]: https://github.com/DeepLcom/deepl-rb/compare/v3.5.0...v3.5.1

data/README.md

@@ -191,8 +191,9 @@ The following parameters will be automatically converted:
 | `ignore_tags`         | Converts arrays to strings joining by commas
 | `formality`           | No conversion applied
 | `glossary_id`         | No conversion applied
-| `style_id`            | No conversion applied
 | `style_rule`          | No conversion applied (can be a string ID or a StyleRule object)
+| `translation_memory`  | No conversion applied (can be a string ID or a TranslationMemory object)
+| `translation_memory_threshold` | No conversion applied (integer 0-100, recommended minimum 75)
 | `context`             | No conversion applied
 | `custom_instructions` | No conversion applied
 | `tag_handling_version` | No conversion applied
@@ -329,28 +330,52 @@ Style rules allow you to customize your translations using a managed, shared lis
 of rules for style, formatting, and more. Multiple style rules can be stored with
 your account, each with a user-specified name and a uniquely-assigned ID.
 
-#### Creating and managing style rules
+#### Creating a style rule
 
-Currently style rules must be created and managed in the DeepL UI via
-https://www.deepl.com/en/custom-rules. Full CRUD functionality via the APIs will
-come shortly.
+Use `create` to create a new style rule with a name and language code. You can
+optionally provide `configured_rules` and `custom_instructions`.
 
-#### Listing all style rules
+```rb
+# Simple creation with just a name and language
+style_rule = DeepL.style_rules.create('My Style Rule', 'en')
+puts "Created: #{style_rule.name} (#{style_rule.style_id})"
+
+# Creation with configured rules and custom instructions
+style_rule = DeepL.style_rules.create(
+  'Formal English',
+  'en',
+  configured_rules: { style_and_tone: { formality: 'formal' } },
+  custom_instructions: [{ label: 'Tone', prompt: 'Always use formal language' }]
+)
+```
 
-`style_rules.list` returns a list of `StyleRule` objects
-corresponding to all of your stored style rules. The method accepts optional
-parameters: `page` (page number for pagination, 0-indexed), `page_size` (number
-of items per page), and `detailed` (whether to include detailed configuration
-rules in the `configured_rules` property).
+#### Retrieving and listing style rules
+
+Use `find` to retrieve a single style rule by ID, or `list` to list all style
+rules.
+
+`list` returns a list of `StyleRule` objects corresponding to all of your stored
+style rules. The method accepts optional parameters: `page` (page number for
+pagination, 0-indexed), `page_size` (number of items per page), and `detailed`.
+When `true`, the response includes `configured_rules` and `custom_instructions`
+for each style rule. When `false` (default), these fields are omitted for faster
+responses.
 
 ```rb
-# Get all style rules
+# Get a single style rule by ID
+style_rule = DeepL.style_rules.find('YOUR_STYLE_ID')
+puts "#{style_rule.name} (#{style_rule.language})"
+
+# List all style rules
 style_rules = DeepL.style_rules.list
 style_rules.each do |rule|
   puts "#{rule.name} (#{rule.style_id})"
 end
 
-# Get style rules with detailed configuration
+# List with pagination
+style_rules = DeepL.style_rules.list(page: 0, page_size: 10)
+
+# List with detailed configuration
 style_rules = DeepL.style_rules.list(detailed: true)
 style_rules.each do |rule|
   if rule.configured_rules
@@ -359,24 +384,130 @@ style_rules.each do |rule|
 end
 ```
 
-Created style rules can be used in the `translate` method by specifying the `style_id` option:
+#### Updating a style rule
+
+Use `update_name` to rename a style rule, and `update_configured_rules` to
+update its configured rules.
 
 ```rb
-translation = DeepL.translate 'Hello World', 'EN', 'ES', style_id: 'dca2e053-8ae5-45e6-a0d2-881156e7f4e4'
+# Update the name
+updated = DeepL.style_rules.update_name('YOUR_STYLE_ID', 'New Name')
 
-puts translation.class
-# => DeepL::Resources::Text
-puts translation.text
-# => 'Hola Mundo'
+# Update configured rules
+updated = DeepL.style_rules.update_configured_rules(
+  'YOUR_STYLE_ID',
+  { style_and_tone: { formality: 'formal' } }
+)
+```
+
+The `configured_rules` hash supports the following categories: `dates_and_times`,
+`formatting`, `numbers`, `punctuation`, `spelling_and_grammar`, `style_and_tone`,
+and `vocabulary`.
+
+#### Managing custom instructions
+
+Custom instructions allow you to add free-text prompts to a style rule. Each
+instruction has an `id`, `label`, `prompt`, and `source_language`. Use
+`create_custom_instruction`, `find_custom_instruction`,
+`update_custom_instruction`, and `destroy_custom_instruction` to manage them.
+
+```rb
+# Create a custom instruction
+instruction = DeepL.style_rules.create_custom_instruction(
+  'YOUR_STYLE_ID', 'Formal tone', 'Always use formal language'
+)
+puts "Created instruction: #{instruction.id}"
+
+# Create with an optional source language
+instruction = DeepL.style_rules.create_custom_instruction(
+  'YOUR_STYLE_ID', 'Formal tone', 'Always use formal language', 'en'
+)
+
+# Get a custom instruction
+instruction = DeepL.style_rules.find_custom_instruction('YOUR_STYLE_ID', instruction.id)
+
+# Update a custom instruction
+updated = DeepL.style_rules.update_custom_instruction(
+  'YOUR_STYLE_ID', instruction.id, 'Updated label', 'Use very formal language'
+)
+
+# Delete a custom instruction
+DeepL.style_rules.destroy_custom_instruction('YOUR_STYLE_ID', instruction.id)
+```
+
+#### Deleting a style rule
+
+Use `destroy` to delete a style rule by ID.
+
+```rb
+DeepL.style_rules.destroy('YOUR_STYLE_ID')
 ```
 
-You can also pass a `StyleRule` object directly:
+#### Using style rules in translations
+
+Style rules can be used in the `translate` method by specifying the `style_rule` option
+with either a style rule ID string or a `StyleRule` object:
 
 ```rb
+# Using a style rule ID
+translation = DeepL.translate 'Hello World', 'EN', 'ES', style_rule: 'dca2e053-8ae5-45e6-a0d2-881156e7f4e4'
+
+# Or using a StyleRule object
 style_rules = DeepL.style_rules.list
-style_rule = style_rules.first
+translation = DeepL.translate 'Hello World', 'EN', 'ES', style_rule: style_rules.first
+```
+
+### Translation Memories
+
+Translation memories allow you to store and reuse previously created translations.
+They can be used in text translation requests to improve consistency by matching
+against stored segments. Multiple translation memories can be stored with your
+account, each with a source language and one or more target languages.
+
+#### Uploading and managing translation memories
+
+Currently translation memories must be uploaded and managed in the DeepL UI via
+https://www.deepl.com/translation-memory. Full translation memory management via
+the API will come shortly.
+
+#### Listing translation memories
+
+`translation_memories.list` returns a list of `TranslationMemory` objects
+for your stored translation memories. The method accepts optional parameters:
+`page` (page number for pagination, 0-indexed) and `page_size` (number of items
+per page, max 25).
 
-translation = DeepL.translate 'Hello World', 'EN', 'ES', style_rule: style_rule
+```rb
+# List translation memories
+translation_memories = DeepL.translation_memories.list
+translation_memories.each do |tm|
+  puts "#{tm.name} (#{tm.translation_memory_id})"
+  puts "  Source: #{tm.source_language}, Targets: #{tm.target_languages.join(', ')}"
+  puts "  Segments: #{tm.segment_count}"
+end
+
+# List with pagination
+translation_memories = DeepL.translation_memories.list(page: 0, page_size: 10)
+```
+
+#### Using a translation memory in translations
+
+Pass the `translation_memory` parameter to `translate` to use a translation
+memory. You can pass either a string containing the translation memory ID, or a
+`TranslationMemory` object. Use `translation_memory_threshold` to control the
+minimum matching percentage for fuzzy matches (0-100, recommended minimum of
+75%).
+
+```rb
+# Using a translation memory ID
+translation = DeepL.translate 'Hello, world!', 'EN', 'DE',
+                              translation_memory: 'YOUR_TM_ID',
+                              translation_memory_threshold: 80
+
+# Or using a TranslationMemory object
+translation_memories = DeepL.translation_memories.list
+translation = DeepL.translate 'Hello, world!', 'EN', 'DE',
+                              translation_memory: translation_memories.first
 ```
 
 ### Monitor usage

data/Rakefile

@@ -33,6 +33,8 @@ Juwelier::Tasks.new do |gem|
     'documentation_uri' => 'https://github.com/DeepLcom/deepl-rb/blob/main/README.md',
     'homepage_uri' => 'https://github.com/DeepLcom/deepl-rb'
   }
+  gem.files.exclude '.bumpversion.toml'
+  gem.files.exclude '.devcontainer/**/*'
   gem.files.exclude '.github'
   gem.files.exclude '.circleci'
   gem.files.exclude 'catalog-info.yaml'

data/VERSION

@@ -1 +1 @@
-3.6.1
+3.7.0

data/deepl-rb.gemspec

@@ -2,17 +2,17 @@
 # DO NOT EDIT THIS FILE DIRECTLY
 # Instead, edit Juwelier::Tasks in Rakefile, and run 'rake gemspec'
 # -*- encoding: utf-8 -*-
-# stub: deepl-rb 3.6.1 ruby lib
+# stub: deepl-rb 3.7.0 ruby lib
 
 Gem::Specification.new do |s|
   s.name = "deepl-rb".freeze
-  s.version = "3.6.1"
+  s.version = "3.7.0"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0".freeze) if s.respond_to? :required_rubygems_version=
   s.metadata = { "bug_tracker_uri" => "https://github.com/DeepLcom/deepl-rb/issues", "changelog_uri" => "https://github.com/DeepLcom/deepl-rb/blob/main/CHANGELOG.md", "documentation_uri" => "https://github.com/DeepLcom/deepl-rb/blob/main/README.md", "homepage_uri" => "https://github.com/DeepLcom/deepl-rb" } if s.respond_to? :metadata=
   s.require_paths = ["lib".freeze]
   s.authors = ["DeepL SE".freeze]
-  s.date = "2025-12-19"
+  s.date = "2026-05-14"
   s.description = "Official Ruby library for the DeepL language translation API (v2). For more information, check this: https://www.deepl.com/docs/api-reference.html".freeze
   s.email = "open-source@deepl.com".freeze
   s.extra_rdoc_files = [
@@ -71,8 +71,18 @@ Gem::Specification.new do |s|
     "lib/deepl/requests/glossary/list.rb",
     "lib/deepl/requests/languages.rb",
     "lib/deepl/requests/rephrase.rb",
+    "lib/deepl/requests/style_rule/create.rb",
+    "lib/deepl/requests/style_rule/create_custom_instruction.rb",
+    "lib/deepl/requests/style_rule/destroy.rb",
+    "lib/deepl/requests/style_rule/destroy_custom_instruction.rb",
+    "lib/deepl/requests/style_rule/find.rb",
+    "lib/deepl/requests/style_rule/find_custom_instruction.rb",
     "lib/deepl/requests/style_rule/list.rb",
+    "lib/deepl/requests/style_rule/update.rb",
+    "lib/deepl/requests/style_rule/update_configured_rules.rb",
+    "lib/deepl/requests/style_rule/update_custom_instruction.rb",
     "lib/deepl/requests/translate.rb",
+    "lib/deepl/requests/translation_memory/list.rb",
     "lib/deepl/requests/usage.rb",
     "lib/deepl/resources/base.rb",
     "lib/deepl/resources/document_handle.rb",
@@ -82,8 +92,10 @@ Gem::Specification.new do |s|
     "lib/deepl/resources/language_pair.rb",
     "lib/deepl/resources/style_rule.rb",
     "lib/deepl/resources/text.rb",
+    "lib/deepl/resources/translation_memory.rb",
     "lib/deepl/resources/usage.rb",
     "lib/deepl/style_rule_api.rb",
+    "lib/deepl/translation_memory_api.rb",
     "lib/deepl/utils/backoff_timer.rb",
     "lib/deepl/utils/exception_builder.rb",
     "lib/http_client_options.rb",
@@ -104,11 +116,14 @@ Gem::Specification.new do |s|
     "spec/fixtures/vcr_cassettes/languages.yml",
     "spec/fixtures/vcr_cassettes/rephrase_texts.yml",
     "spec/fixtures/vcr_cassettes/style_rules.yml",
+    "spec/fixtures/vcr_cassettes/style_rules_crud.yml",
     "spec/fixtures/vcr_cassettes/translate_texts.yml",
+    "spec/fixtures/vcr_cassettes/translation_memories.yml",
     "spec/fixtures/vcr_cassettes/usage.yml",
     "spec/integration_tests/document_api_spec.rb",
     "spec/integration_tests/integration_test_utils.rb",
     "spec/integration_tests/style_rule_api_spec.rb",
+    "spec/integration_tests/translation_memory_api_spec.rb",
     "spec/requests/extra_body_parameters_types_spec.rb",
     "spec/requests/glossary/create_spec.rb",
     "spec/requests/glossary/destroy_spec.rb",
@@ -118,18 +133,30 @@ Gem::Specification.new do |s|
     "spec/requests/glossary/list_spec.rb",
     "spec/requests/languages_spec.rb",
     "spec/requests/rephrase_spec.rb",
+    "spec/requests/style_rule/create_custom_instruction_spec.rb",
+    "spec/requests/style_rule/create_spec.rb",
+    "spec/requests/style_rule/destroy_custom_instruction_spec.rb",
+    "spec/requests/style_rule/destroy_spec.rb",
+    "spec/requests/style_rule/find_custom_instruction_spec.rb",
+    "spec/requests/style_rule/find_spec.rb",
+    "spec/requests/style_rule/list_spec.rb",
+    "spec/requests/style_rule/update_configured_rules_spec.rb",
+    "spec/requests/style_rule/update_custom_instruction_spec.rb",
+    "spec/requests/style_rule/update_spec.rb",
     "spec/requests/translate_spec.rb",
+    "spec/requests/translation_memory/list_spec.rb",
     "spec/requests/usage_spec.rb",
     "spec/resources/glossary_spec.rb",
     "spec/resources/language_pair_spec.rb",
     "spec/resources/language_spec.rb",
     "spec/resources/text_spec.rb",
+    "spec/resources/translation_memory_spec.rb",
     "spec/resources/usage_spec.rb",
     "spec/spec_helper.rb"
   ]
   s.homepage = "https://github.com/DeepLcom/deepl-rb".freeze
   s.licenses = ["MIT".freeze]
-  s.rubygems_version = "3.4.6".freeze
+  s.rubygems_version = "3.4.10".freeze
   s.summary = "Official Ruby library for the DeepL language translation API.".freeze
 
   s.specification_version = 4

data/lib/deepl/requests/base.rb

@@ -143,6 +143,22 @@ module DeepL
         get_req
       end
 
+      def patch_request(payload)
+        apply_extra_body_parameters_to_json(payload)
+        http_headers = add_json_content_type(headers)
+        req = Net::HTTP::Patch.new(uri.path, http_headers)
+        req.body = payload.merge(options_without_extra_params).to_json
+        req
+      end
+
+      def put_request(payload)
+        apply_extra_body_parameters_to_json(payload)
+        http_headers = add_json_content_type(headers)
+        req = Net::HTTP::Put.new(uri.path, http_headers)
+        req.body = payload.merge(options_without_extra_params).to_json
+        req
+      end
+
       def delete_request
         http_headers = add_json_content_type(headers)
         del_req = Net::HTTP::Delete.new(uri.path, http_headers)

data/lib/deepl/requests/document/upload.rb

@@ -21,11 +21,12 @@ module DeepL
         end
 
         def request
-          input_file = File.open(input_file_path, 'rb')
-          form_data = build_base_form_data(input_file)
-          apply_extra_body_parameters_to_form(form_data)
-          build_doc_handle(*execute_request_with_retries(post_request_with_file(form_data),
-                                                         [input_file]))
+          File.open(input_file_path, 'rb') do |input_file|
+            form_data = build_base_form_data(input_file)
+            apply_extra_body_parameters_to_form(form_data)
+            build_doc_handle(*execute_request_with_retries(post_request_with_file(form_data),
+                                                           [input_file]))
+          end
         end
 
         def details

data/lib/deepl/requests/style_rule/create.rb

@@ -0,0 +1,46 @@
+# Copyright 2026 DeepL SE (https://www.deepl.com)
+# Use of this source code is governed by an MIT
+# license that can be found in the LICENSE.md file.
+# frozen_string_literal: true
+
+module DeepL
+  module Requests
+    module StyleRule
+      class Create < Base
+        def initialize(api, name, language, options = {})
+          super(api, options)
+          @name = name
+          @language = language
+          @configured_rules = delete_option(:configured_rules)
+          @custom_instructions = delete_option(:custom_instructions)
+        end
+
+        def request
+          payload = { name: @name, language: @language }
+          payload[:configured_rules] = @configured_rules if @configured_rules
+          payload[:custom_instructions] = @custom_instructions if @custom_instructions
+          build_style_rule(*execute_request_with_retries(post_request(payload)))
+        end
+
+        def to_s
+          "POST #{uri.request_uri}"
+        end
+
+        private
+
+        def build_style_rule(request, response)
+          data = JSON.parse(response.body)
+          DeepL::Resources::StyleRule.new(data, request, response)
+        end
+
+        def uri
+          @uri ||= URI("#{host}/v3/#{path}")
+        end
+
+        def path
+          'style_rules'
+        end
+      end
+    end
+  end
+end

data/lib/deepl/requests/style_rule/create_custom_instruction.rb

@@ -0,0 +1,45 @@
+# Copyright 2026 DeepL SE (https://www.deepl.com)
+# Use of this source code is governed by an MIT
+# license that can be found in the LICENSE.md file.
+# frozen_string_literal: true
+
+module DeepL
+  module Requests
+    module StyleRule
+      class CreateCustomInstruction < Base
+        def initialize(api, style_id, label, prompt, source_language = nil, options = {})
+          super(api, options)
+          @style_id = style_id
+          @label = label
+          @prompt = prompt
+          @source_language = source_language
+        end
+
+        def request
+          payload = { label: @label, prompt: @prompt }
+          payload[:source_language] = @source_language if @source_language
+          build_custom_instruction(*execute_request_with_retries(post_request(payload)))
+        end
+
+        def to_s
+          "POST #{uri.request_uri}"
+        end
+
+        private
+
+        def build_custom_instruction(_request, response)
+          data = JSON.parse(response.body)
+          DeepL::Resources::CustomInstruction.new(data)
+        end
+
+        def uri
+          @uri ||= URI("#{host}/v3/#{path}")
+        end
+
+        def path
+          "style_rules/#{@style_id}/custom_instructions"
+        end
+      end
+    end
+  end
+end

data/lib/deepl/requests/style_rule/destroy.rb

@@ -0,0 +1,39 @@
+# Copyright 2026 DeepL SE (https://www.deepl.com)
+# Use of this source code is governed by an MIT
+# license that can be found in the LICENSE.md file.
+# frozen_string_literal: true
+
+module DeepL
+  module Requests
+    module StyleRule
+      class Destroy < Base
+        def initialize(api, style_id, options = {})
+          super(api, options)
+          @style_id = style_id
+        end
+
+        def request
+          build_response(*execute_request_with_retries(delete_request))
+        end
+
+        def to_s
+          "DELETE #{uri.request_uri}"
+        end
+
+        private
+
+        def build_response(_, _)
+          @style_id
+        end
+
+        def uri
+          @uri ||= URI("#{host}/v3/#{path}")
+        end
+
+        def path
+          "style_rules/#{@style_id}"
+        end
+      end
+    end
+  end
+end

data/lib/deepl/requests/style_rule/destroy_custom_instruction.rb

@@ -0,0 +1,40 @@
+# Copyright 2026 DeepL SE (https://www.deepl.com)
+# Use of this source code is governed by an MIT
+# license that can be found in the LICENSE.md file.
+# frozen_string_literal: true
+
+module DeepL
+  module Requests
+    module StyleRule
+      class DestroyCustomInstruction < Base
+        def initialize(api, style_id, instruction_id, options = {})
+          super(api, options)
+          @style_id = style_id
+          @instruction_id = instruction_id
+        end
+
+        def request
+          build_response(*execute_request_with_retries(delete_request))
+        end
+
+        def to_s
+          "DELETE #{uri.request_uri}"
+        end
+
+        private
+
+        def build_response(_, _)
+          @instruction_id
+        end
+
+        def uri
+          @uri ||= URI("#{host}/v3/#{path}")
+        end
+
+        def path
+          "style_rules/#{@style_id}/custom_instructions/#{@instruction_id}"
+        end
+      end
+    end
+  end
+end

data/lib/deepl/requests/style_rule/find.rb

@@ -0,0 +1,40 @@
+# Copyright 2026 DeepL SE (https://www.deepl.com)
+# Use of this source code is governed by an MIT
+# license that can be found in the LICENSE.md file.
+# frozen_string_literal: true
+
+module DeepL
+  module Requests
+    module StyleRule
+      class Find < Base
+        def initialize(api, style_id, options = {})
+          super(api, options)
+          @style_id = style_id
+        end
+
+        def request
+          build_style_rule(*execute_request_with_retries(get_request))
+        end
+
+        def to_s
+          "GET #{uri.request_uri}"
+        end
+
+        private
+
+        def build_style_rule(request, response)
+          data = JSON.parse(response.body)
+          DeepL::Resources::StyleRule.new(data, request, response)
+        end
+
+        def uri
+          @uri ||= URI("#{host}/v3/#{path}")
+        end
+
+        def path
+          "style_rules/#{@style_id}"
+        end
+      end
+    end
+  end
+end