delete_variable

Delete a variable.

Destructive · Writes data · Idempotent · Calls external systems. This tool can modify or delete data. Review the arguments before letting an agent call it.

Parameters

Field	Type	Required	Description
`acknowledge`	boolean	Yes	Must be true to confirm the delete
`variable_id`	number	Yes	Variable id

Example arguments

Illustrative arguments an agent supplies when calling this tool:

{
  "variable_id": 0,
  "acknowledge": false
}

Description

Refuses if any test references it (the platform enforces this guard server-side and exposes no override — there is no force parameter).

acknowledge=true is required (the delete is destructive). When the refusal lists test references, update those tests ('test_edit') or remove the references first, then re-run delete.

What's next?

All MCP tools

Browse the full tool reference by category.

Connect a client

Point Claude, Cursor, or Claude Code at the server.