Skip to content

Security.RunDevelopers

v1 PreviewOpenAPI ↗

API & MCP reference/Delete a tool run

HTTP REFERENCE

Delete a tool run

Delete a terminal run’s local results while retaining an idempotency tombstone.

View as Markdown ↗

DELETE/v1/tool-runs/{run_id}

Remove a completed run’s results

After retaining any reports you need, send DELETE for the terminal run with an idempotency key.

What to do next

Deletion removes local results. It does not claim to delete operator backups.

Read the step-by-step guide →

Send an Idempotency-Key. Keep the same key and body when retrying this operation.

Parameter and response reference

Parameters

run_idpath · stringrequired

authorizationheader · string | nullrequired

idempotency-keyheader · string | nullrequired

Responses

200 Successful Response
422 Validation Error

Copyable examples · your API endpoint

Request

curl -X DELETE "$SECURITY_RUN_URL/v1/tool-runs/toolrun_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" \
  -H "Authorization: Bearer $SECURITY_RUN_API_KEY" \
  -H "Idempotency-Key: unique-request-key"

Request

import os, httpx

headers = {'Idempotency-Key': 'unique-request-key'}
headers["Authorization"] = "Bearer " + os.environ["SECURITY_RUN_API_KEY"]
response = httpx.request('DELETE', os.environ["SECURITY_RUN_URL"].rstrip("/") + '/v1/tool-runs/toolrun_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa',
    headers=headers)
response.raise_for_status()
print(response.text)

Request

const base = process.env.SECURITY_RUN_URL.replace(/\/$/, "");
const headers = {
  "Idempotency-Key": "unique-request-key"
};
headers.Authorization = `Bearer ${process.env.SECURITY_RUN_API_KEY}`;
const response = await fetch(base + "/v1/tool-runs/toolrun_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", {
  method: "DELETE",
  headers
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
console.log(await response.text());