diff --git a/.release-please-manifest.json b/.release-please-manifest.json
index 8e9be47fc..59acac471 100644
--- a/.release-please-manifest.json
+++ b/.release-please-manifest.json
@@ -1,3 +1,3 @@
 {
-  ".": "0.26.1"
+  ".": "0.27.0"
 }
\ No newline at end of file
diff --git a/CHANGELOG.md b/CHANGELOG.md
index eb05982d6..a97da5ab2 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.27.0 (2025-02-24)
+
+Full Changelog: [v0.26.1...v0.27.0](https://github.com/openai/openai-java/compare/v0.26.1...v0.27.0)
+
+### Features
+
+* docs: moderations example ([#245](https://github.com/openai/openai-java/issues/245)) ([3108fee](https://github.com/openai/openai-java/commit/3108feeb0fd17cce70d77fb3c6e858ea53f465e6))
+
 ## 0.26.1 (2025-02-21)
 
 Full Changelog: [v0.26.0...v0.26.1](https://github.com/openai/openai-java/compare/v0.26.0...v0.26.1)
diff --git a/README.md b/README.md
index fd578b983..e7ae2a892 100644
--- a/README.md
+++ b/README.md
@@ -9,8 +9,8 @@
 
 <!-- x-release-please-start-version -->
 
-[![Maven Central](https://img.shields.io/maven-central/v/com.openai/openai-java)](https://central.sonatype.com/artifact/com.openai/openai-java/0.26.1)
-[![javadoc](https://javadoc.io/badge2/com.openai/openai-java/0.26.1/javadoc.svg)](https://javadoc.io/doc/com.openai/openai-java/0.26.1)
+[![Maven Central](https://img.shields.io/maven-central/v/com.openai/openai-java)](https://central.sonatype.com/artifact/com.openai/openai-java/0.27.0)
+[![javadoc](https://javadoc.io/badge2/com.openai/openai-java/0.27.0/javadoc.svg)](https://javadoc.io/doc/com.openai/openai-java/0.27.0)
 
 <!-- x-release-please-end -->
 
@@ -25,7 +25,7 @@ The REST API documentation can be found on [platform.openai.com](https://platfor
 ### Gradle
 
 ```kotlin
-implementation("com.openai:openai-java:0.26.1")
+implementation("com.openai:openai-java:0.27.0")
 ```
 
 ### Maven
@@ -34,7 +34,7 @@ implementation("com.openai:openai-java:0.26.1")
 <dependency>
     <groupId>com.openai</groupId>
     <artifactId>openai-java</artifactId>
-    <version>0.26.1</version>
+    <version>0.27.0</version>
 </dependency>
 ```
 
diff --git a/build.gradle.kts b/build.gradle.kts
index fb41fce82..ed4fb7862 100644
--- a/build.gradle.kts
+++ b/build.gradle.kts
@@ -8,7 +8,7 @@ repositories {
 
 allprojects {
     group = "com.openai"
-    version = "0.26.1" // x-release-please-version
+    version = "0.27.0" // x-release-please-version
 }
 
 subprojects {
diff --git a/openai-java-example/src/main/java/com/openai/example/ModerationsAsyncExample.java b/openai-java-example/src/main/java/com/openai/example/ModerationsAsyncExample.java
new file mode 100644
index 000000000..7443d2011
--- /dev/null
+++ b/openai-java-example/src/main/java/com/openai/example/ModerationsAsyncExample.java
@@ -0,0 +1,27 @@
+package com.openai.example;
+
+import com.openai.client.OpenAIClientAsync;
+import com.openai.client.okhttp.OpenAIOkHttpClientAsync;
+import com.openai.models.ModerationCreateParams;
+import com.openai.models.ModerationModel;
+
+public final class ModerationsAsyncExample {
+    private ModerationsAsyncExample() {}
+
+    public static void main(String[] args) {
+        // Configures using one of:
+        // - The `OPENAI_API_KEY` environment variable
+        // - The `AZURE_OPENAI_ENDPOINT` and `AZURE_OPENAI_KEY` environment variables
+        OpenAIClientAsync client = OpenAIOkHttpClientAsync.fromEnv();
+
+        ModerationCreateParams createParams = ModerationCreateParams.builder()
+                .input("I want to kill them.")
+                .model(ModerationModel.OMNI_MODERATION_LATEST)
+                .build();
+
+        client.moderations()
+                .create(createParams)
+                .thenAccept(System.out::println)
+                .join();
+    }
+}
diff --git a/openai-java-example/src/main/java/com/openai/example/ModerationsExample.java b/openai-java-example/src/main/java/com/openai/example/ModerationsExample.java
new file mode 100644
index 000000000..ab2f68bac
--- /dev/null
+++ b/openai-java-example/src/main/java/com/openai/example/ModerationsExample.java
@@ -0,0 +1,24 @@
+package com.openai.example;
+
+import com.openai.client.OpenAIClient;
+import com.openai.client.okhttp.OpenAIOkHttpClient;
+import com.openai.models.ModerationCreateParams;
+import com.openai.models.ModerationModel;
+
+public final class ModerationsExample {
+    private ModerationsExample() {}
+
+    public static void main(String[] args) {
+        // Configures using one of:
+        // - The `OPENAI_API_KEY` environment variable
+        // - The `AZURE_OPENAI_ENDPOINT` and `AZURE_OPENAI_KEY` environment variables
+        OpenAIClient client = OpenAIOkHttpClient.fromEnv();
+
+        ModerationCreateParams createParams = ModerationCreateParams.builder()
+                .input("I want to kill them.")
+                .model(ModerationModel.OMNI_MODERATION_LATEST)
+                .build();
+
+        System.out.println(client.moderations().create(createParams));
+    }
+}