AWS Security ChangesHomeSearch

AWS bedrock: Clarify toolUseId prefix to distinguish Bedrock vs provider IDs

Service: bedrock · 2026-10-19 · Documentation medium

File: bedrock/latest/userguide/tool-use-client-side.md

Summary

Documents that Bedrock-generated tool use identifiers always start with `tooluse_` followed by 22 characters, while identifiers passed through from some model providers use the provider's own format, lack the prefix, and can contain text derived from the request (such as the tool name). Advises checking the prefix at runtime and testing the specific model.

Security assessment

The guidance tells developers how to validate the provenance/format of tool-use identifiers, since provider-supplied IDs can embed request-derived text (e.g., tool names) and are not in Bedrock's format. This is hardening/validation guidance for tool-use handling rather than a fix for a specific vulnerability or incident.

Evidence

+To tell the two apart at runtime, check the prefix. Every identifier that Amazon Bedrock generates begins with `tooluse_` followed by 22 characters. An identifier that does not begin with `tooluse_` came from the model provider. This behavior can differ between models in the same family, so test the specific model that you call.

Diff

diff --git a/bedrock/latest/userguide/tool-use-client-side.md b/bedrock/latest/userguide/tool-use-client-side.md
index f43c276..980fc19 100644
--- a//bedrock/latest/userguide/tool-use-client-side.md
+++ b//bedrock/latest/userguide/tool-use-client-side.md
@@ -318 +318 @@ Each tool request in a response carries a `toolUseId` that identifies that reque
-  * For Amazon Bedrock server-side tools and MCP tools, Amazon Bedrock computes the value deterministically from the tool request rather than generating it randomly.
+  * For Amazon Bedrock server-side tools and MCP tools, Amazon Bedrock computes the value deterministically from the tool request rather than generating it randomly. The value still carries the `tooluse_` prefix.
@@ -320 +320 @@ Each tool request in a response carries a `toolUseId` that identifies that reque
-  * For some models, the identifier that the model provider returns is passed through unchanged.
+  * For some models, the identifier that the model provider returns is passed through unchanged. Such a value uses the provider's own format, does not carry the `tooluse_` prefix, and can contain text derived from your request, such as the name of the tool.
@@ -324,0 +325,2 @@ Each tool request in a response carries a `toolUseId` that identifies that reque
+To tell the two apart at runtime, check the prefix. Every identifier that Amazon Bedrock generates begins with `tooluse_` followed by 22 characters. An identifier that does not begin with `tooluse_` came from the model provider. This behavior can differ between models in the same family, so test the specific model that you call.
+