diff --git a/src/content/docs/apm/agents/java-agent/api-guides/guide-using-java-agent-api.mdx b/src/content/docs/apm/agents/java-agent/api-guides/guide-using-java-agent-api.mdx
index 28547c5ecab..af38ba68bb3 100644
--- a/src/content/docs/apm/agents/java-agent/api-guides/guide-using-java-agent-api.mdx
+++ b/src/content/docs/apm/agents/java-agent/api-guides/guide-using-java-agent-api.mdx
@@ -45,7 +45,7 @@ Here's an example for gradle:
 implementation 'com.newrelic.agent.java:newrelic-api:8.10.0'
 ```
 
-You can call the API when the Java agent is not running. The API methods are just stubs; the implementation is added when the Java agent loads the class.
+You can call the API even without the agent running, but the methods will be a no-op until the agent loads your application.
 
 ## Transactions
 
diff --git a/src/content/docs/apm/agents/java-agent/installation/update-java-agent.mdx b/src/content/docs/apm/agents/java-agent/installation/update-java-agent.mdx
index f52e9282027..61884239f06 100644
--- a/src/content/docs/apm/agents/java-agent/installation/update-java-agent.mdx
+++ b/src/content/docs/apm/agents/java-agent/installation/update-java-agent.mdx
@@ -31,7 +31,7 @@ Then, to update to the latest Java agent version:
 4. (Optional) If you are using the any of the agent APIs like our [Java agent API](/docs/apm/agents/java-agent/api-guides/guide-using-java-agent-api/) or a [Scala API](/docs/apm/agents/java-agent/frameworks/scala-installation-java/#using-the-scala-api), we recommend you upgrade your API dependencies to the latest version. The newer agent version will still support the APIs, but you may be missing new features. If you're using a build tool like maven, upgrade the API versions to latest. For example, if you're  using the Java Agent API with gradle, replace `${agent.version}` with the latest version:
 
   ```groovy
-  implementation 'com.newrelic.agent.java:newrelic-api:8.10.0'
+  implementation 'com.newrelic.agent.java:newrelic-api:${agent.version}'
   ```
 5. Restart your Java process.