Delete an idle run

Logically deletes an idle run and starts asynchronous cleanup. Requires run:write. A busy run returns a conflict.

DELETE/runs/{runId}

Authorization

AuthorizationBearer <token>

Path parameters

runIdstringrequired

pattern: "^run_[A-Za-z0-9]+$"

Headers

Idempotency-Keystringrequired

minLength: 1
maxLength: 255

Response

application/json

Delete result

object

Additional properties are allowed.

idstringrequired

pattern: "^run_[A-Za-z0-9]+$"

objectstringrequired

const: "run.deleted"

deletedbooleanrequired

const: true

deleted_atintegerrequired

minimum: 0

curl --request DELETE \
  --url 'https://YOUR_SALAMBO_BASE_URL/api/v1/runs/{runId}' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Idempotency-Key: YOUR_IDEMPOTENCY_KEY'

Replace placeholders with your values.

Response

{
  "id": "<string>",
  "object": "run.deleted",
  "deleted": true,
  "deleted_at": 123
}