Delete item
delete_itemPermanently delete one item; every deletion an agent can make goes through this tool, and none can be undone. item secret: one key and its whole version history from one environment (to change a value use manage_secrets). item field: one project key/value field (fields keep no history). item login: one saved login by id or exact name. item file: one secure file or attachment by id or exact name (a name several files share needs the id). item environment: an empty environment and its deployment URLs; refused while it holds any secret or file or is synced to Vercel, a project keeps at least one environment, and it needs the owner role. item deployment_url: forget one recorded URL by url_id (nothing is taken offline; if it was primary the oldest remaining becomes primary). Protected and sealed items, sensitive fields and files in protected projects, and archived projects are refused. One client approval of this tool covers every item kind. Audited. Requires the write scope of the item (secrets:write, projects:write, logins:write or files:write; a sensitive field also secrets:write) and the editor role, owner for environments.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"item": "<item>",
"project": "<project>"
},
"name": "delete_item"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| key | No | secret: the key. field: the field name, as get_project lists it | |
| file | No | file only: file id, or its exact name when unique | |
| item | Yes | What to delete | |
| login | No | login only: login id, or its exact name | |
| url_id | No | deployment_url only: deployment URL id, from list_project_items item deployment_urls | |
| project | Yes | Project slug or id | |
| environment | No | secret, environment: required |