Delete a Resource
delete_resourceDelete one Control Plane resource by kind + name — the single delete tool for every deletable kind. Deleting a secret breaks the workloads that read it (cpln://secret/NAME) and any GVC pull secret or domain TLS that uses it. Deletes on the call. Before calling, read the resource and tell the user what the deletion removes and which dependents break, and proceed only on their explicit approval. Deletion is permanent.
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": {
"kind": "<kind>",
"name": "<name>"
},
"name": "delete_resource"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| gvc | No | GVC slug — REQUIRED only for GVC-scoped kinds (workload, identity, volumeset); ignored otherwise. | |
| org | No | Organization slug. | |
| kind | Yes | Resource kind to delete. | |
| name | Yes | Name of the resource to delete. Read the resource and present what the deletion removes and breaks, then call only on the user's explicit approval. Never invent a name. Most kinds use lowercase kebab-case names; exceptions: domain = the full hostname ("app.example.com"), image = NAME or NAME:TAG ("my-app:v1.2"). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ok | Yes | ||
| data | No | The full result. Read this, not only the summary. | |
| details | No | ||
| summary | Yes | ||
| nextSteps | No |