Delete a result you saved
delete_runDeletes one of your own runs -- one result -- and its share link, leaving the model it came from alone. It works on any run_id you can read, whether the run came from a model you passed inline or from one you saved; afterwards get_simulation_results can no longer read it. Use this when the user has explicitly asked for that result to be removed, and not otherwise. To remove a saved model and all of its runs at once, use delete_graph. Neumann purges it for good after 30 days, and until then nothing on this connector can restore it -- no tool here can put it back -- so treat it as final and do not tell the user it can be recovered. Deleting the same run twice changes nothing and does not extend the 30 days. It returns the run_id, what kind of thing was deleted, the time it was deleted and the date it is purged for good. It needs a Neumann account: send your key, or your signed-in token, in the Authorization header as a Bearer credential. No Neumann tool takes an api_key argument. Cost: free -- it debits no credits and spends none of your free daily runs -- but it needs an account; an anonymous caller gets authentication_required.
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": {
"run_id": "<run_id>"
},
"name": "delete_run"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| run_id | Yes | Which run to delete, as returned by any run tool. The model it came from is left alone. Confirm with the user first: no tool here can put it back. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| kind | No | What kind of thing was deleted: a run. | run |
| run_id | Yes | The id of the run that was deleted. | |
| billing | No | Who you are and what this call cost: principal, auth source, credits debited and balance, or the anonymous allowance left today. | |
| deleted_at | Yes | When it was deleted, as an ISO-8601 time. | |
| purge_after | Yes | The ISO-8601 instant after which it is removed for good. Until then it is recoverable inside Neumann, but not by any tool here. |