Delete Tool Configuration Version API Definition

The Delete Tool Configuration Version API enables you to permanently delete a specific version of a tool configuration while preserving other versions. Organizations use this API to clean up old configuration versions, manage storage costs, and maintain a focused version history while ensuring that critical versions remain available for rollback scenarios.

Delete Tool Configuration Version Request and Response

To delete a specific configuration version, send a DELETE request to /v2/tools/{tool_id}/configurations/{configuration_id}/versions/{version}. No request body is required.

The API returns a 204 No Content status on successful deletion. This action cannot be undone and will affect any agents that specifically reference this version.

Example Request

EXAMPLE REQUEST

Code example with json syntax.json

1

Example Response

EXAMPLE RESPONSE

Code example with text syntax.text

1

Error Responses

The API returns standard HTTP error codes with detailed error information:

HTTP Code	Error Code	Description
401	unauthorized	Invalid or missing API key
403	forbidden	Insufficient permissions for deleting tool configuration versions
404	not_found	Tool, tool configuration, or version not found
409	conflict	The specified version cannot be deleted as it's used in an agent
429	rate_limit_exceeded	Request rate limit exceeded