Claude · Schema

ToolUseBlock

A tool use content block in a response, indicating the model wants to use a tool.

Artificial IntelligenceChatbotsConversational AIGenerative AILarge Language ModelsMachine-LearningNatural Language Processing

Properties

Name	Type	Description
type	string
id	string	A unique identifier for this particular tool use block. Used to match tool results to tool use requests.
name	string	The name of the tool being used.
input	object	An object containing the input passed to the tool, conforming to the tool's input_schema.

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "#/components/schemas/ToolUseBlock",
  "title": "ToolUseBlock",
  "type": "object",
  "description": "A tool use content block in a response, indicating the model wants to use a tool.",
  "required": [
    "type",
    "id",
    "name",
    "input"
  ],
  "properties": {
    "type": {
      "type": "string",
      "const": "tool_use",
      "example": "example_value"
    },
    "id": {
      "type": "string",
      "description": "A unique identifier for this particular tool use block. Used to match tool results to tool use requests.",
      "pattern": "^toolu_",
      "example": "toolu_01D7FLrfh4GYq7yT1ULFeyMV"
    },
    "name": {
      "type": "string",
      "description": "The name of the tool being used.",
      "example": "Example Title"
    },
    "input": {
      "type": "object",
      "description": "An object containing the input passed to the tool, conforming to the tool's input_schema.",
      "additionalProperties": true,
      "example": "example_value"
    }
  }
}