delete_custom_tool

Permanently delete a custom tool. Use a bare name with a standalone personal credential, me/name for private content in organization scope, or <team>/name for a bound team. A bare organization-scoped name denotes the read-only organization catalogue. This cannot be undone.

Parameters

Parameter	Type	Required	Description
name	string	Yes	Caller-relative address: bare with a standalone personal credential, me/name in private organization space, or <team>/name for a bound team.

Response

Field	Type	Description
deleted	string	The name you asked to delete — confirms completion.

Example

{
	"name": "weather"
}

Result:

{
	"deleted": "weather"
}

Errors

Each failure carries a precise code in the response. A domain rejection — a not-found or a permission denial — is returned as a tool result with isError: true, so the agent can read the code and self-correct; malformed arguments and server faults are JSON-RPC protocol errors.

Code	Cause	Delivered as
custom_tool_not_found	No custom tool remains at the requested name in the target space, including if it was renamed while this call was pending.	tool error (isError)
team_not_found	No team with that name is bound to this credential.	tool error (isError)
forbidden	The credential lacks delete authority, uses me/ outside organization scope, or targets the read-only organization catalogue.	tool error (isError)
empty_name	The name is empty after removing the team prefix.	tool error (isError)
personal_cannot_address_team	You used a team/ prefix (or team field) with a personal credential.	tool error (isError)
no_personal_space	A userless organization credential used me/name.	tool error (isError)
invalid_arguments	The arguments are missing or don't match the input schema.	protocol error (invalid_params)
internal_error	An unexpected error occurred.	protocol error (internal_error)

Notes

• Deletion is permanent.
• Deleting a custom tool counts as one tool call against your plan's tool-invocation allowance.