Delete Run

Take one instance out of the graph’s dock. Soft: the assets point back at it and per-person spend counts what it cost, so the document stays and only stops being listed.

A run still executing is refused until cancellation has been asked for — not until it has taken effect. One whose worker went away never leaves running, and refusing that would leave a row the operator can neither cancel nor remove.

DELETE/api/v1/runs/{run_id}

Authorization

AuthorizationBearer token · headerrequired

AuthorizationOAuth2 access token · headerrequired

Path parameters

run_idstringrequired

Responses

200Successful Response

successboolean

default: true

dataany

messagestring | any

Show properties

Any of:

string

string

any

any

errorsstring[] | any

Show properties

Any of:

string[]

Array of string

string

any

any

422Validation Error

detailValidationError[]

Show properties

Array of ValidationError

locstring | integer[]required

Show properties

Array of string | integer

Any of:

string

string

integer

integer

msgstringrequired

typestringrequired

inputany

ctxobject

Request

curl -X DELETE "/api/v1/runs/string" \
  -H "Authorization: Bearer YOUR_TOKEN"

const response = await fetch("/api/v1/runs/string", {
  method: "DELETE",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN"
  }
});

import requests

response = requests.delete(
    "/api/v1/runs/string",
    headers={
        "Authorization": "Bearer YOUR_TOKEN"
    },
)

Response

{
  "success": true,
  "data": null,
  "message": "string",
  "errors": [
    "string"
  ]
}