> ## Documentation Index
> Fetch the complete documentation index at: https://www.voiceflow.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Delete agent tool message

> Clears one message slot on one of the agent's tools, discarding its examples and unlinking its scripted response. The response carries only a confirmation message, so refetch the agent's tool to see its remaining messages.



## OpenAPI

````yaml /specs-prettified/realtime/openapi.stable.json delete /v1/stable/agent/tool-message
openapi: 3.0.0
info:
  title: Realtime
  description: Realtime gateway API service
  version: 1.0.0
  contact: {}
servers:
  - url: https://realtime-api.voiceflow.com
security: []
tags: []
paths:
  /v1/stable/agent/tool-message:
    delete:
      tags:
        - Agent
      summary: Delete agent tool message
      description: Clears one message slot on one of the agent's tools, discarding its
        examples and unlinking its scripted response. The response carries only
        a confirmation message, so refetch the agent's tool to see its remaining
        messages.
      operationId: StableAgentController_deleteToolMessage
      parameters:
        - name: projectID
          required: true
          in: query
          description: Addresses one message on one tool. Exactly one of toolID and
            nativeTool is required; sending neither or both is rejected.
          schema:
            type: string
            description: The ID of the project to operate on.
        - name: environmentAlias
          required: true
          in: query
          description: Addresses one message on one tool. Exactly one of toolID and
            nativeTool is required; sending neither or both is rejected.
          schema:
            type: string
            description: The alias of the environment to operate on (e.g. `main`).
        - name: slot
          required: true
          in: query
          description: Addresses one message on one tool. Exactly one of toolID and
            nativeTool is required; sending neither or both is rejected.
          schema:
            $ref: "#/components/schemas/StableToolMessageSlot"
        - name: toolID
          required: false
          in: query
          description: Addresses one message on one tool. Exactly one of toolID and
            nativeTool is required; sending neither or both is rejected.
          schema:
            description: A tool attached to this agent or playbook. Cannot be used with
              nativeTool.
            type: string
            minLength: 1
        - name: nativeTool
          required: false
          in: query
          description: Addresses one message on one tool. Exactly one of toolID and
            nativeTool is required; sending neither or both is rejected.
          schema:
            allOf:
              - $ref: "#/components/schemas/StableNativeToolKey"
      responses:
        "200":
          description: Confirms the message in the requested slot was removed.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/StableDeleteResponse"
          x-vf-doc:
            description: Confirms the message in the requested slot was removed.
      security:
        - token: []
components:
  schemas:
    StableToolMessageSlot:
      type: string
      enum:
        - delay
        - failure
        - execution
        - completion
      description: Which of the tool's four messages to write. `execution` is said
        when the tool starts (the editor labels it Start), `completion` when it
        finishes (Complete), `failure` when it errors (Failed), `delay` when it
        is taking a while (Delayed).
      x-enumNames:
        - DELAY
        - FAILURE
        - EXECUTION
        - COMPLETION
    StableNativeToolKey:
      type: string
      enum:
        - endTool
        - cardTool
        - buttonTool
        - carouselTool
        - webSearchTool
        - callForwardTool
        - knowledgeBaseTool
      description: One of the built-in tools on this agent or playbook, under the same
        key it is read back at. skipTurnTool is absent because it carries no
        messages. The Voiceflow editor offers only the execution message on
        endTool, cardTool, buttonTool, carouselTool and callForwardTool;
        webSearchTool and knowledgeBaseTool offer all four. This API accepts any
        slot on any of them.
      x-enumNames:
        - END_TOOL
        - CARD_TOOL
        - BUTTON_TOOL
        - CAROUSEL_TOOL
        - WEB_SEARCH_TOOL
        - CALL_FORWARD_TOOL
        - KNOWLEDGE_BASE_TOOL
    StableDeleteResponse:
      type: object
      properties:
        message:
          type: string
          description: A human-readable message confirming the deletion.
      required:
        - message
  securitySchemes:
    token:
      scheme: bearer
      bearerFormat: JWT
      type: http
      description: Voiceflow bearer token
````