Cancel an in-flight run by id (owner-guarded)
POST
/api/v1/kg/studio/kill/{runId}
const url = 'http://localhost:11044/api/v1/kg/studio/kill/example';const options = {method: 'POST', headers: {'X-Embabel-Api-Key': '<X-Embabel-Api-Key>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url http://localhost:11044/api/v1/kg/studio/kill/example \ --header 'X-Embabel-Api-Key: <X-Embabel-Api-Key>'Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”runId
required
string
The run’s id, as GET /kg/studio/runs lists it (the queryId its SSE stream carries); a run that has settled or is not the caller’s answers killed: false
Responses
Section titled “Responses”Whether the kill landed
Media typeapplication/json
The outcome of a kill request.
object
killed
required
False when the run had already settled, or was never the caller’s.
boolean
runId
required
The run id from the path, echoed back.
string
Example generated
{ "killed": true, "runId": "example"}Not authenticated
Media typeapplication/json
A refusal carrying only a human-readable reason.
object
error
required
What went wrong, in the terms the caller can act on.
string
Example generated
{ "error": "example"}