Skip to content

Terminate Task

client.tasks.terminate(stringtaskID, TaskTerminateParams { reason } body?, RequestOptionsoptions?): Task { id, cleaned_at, created_at, 6 more }
POST/tasks/{task_id}/terminate

Mark a running task as terminated.

ParametersExpand Collapse
taskID: string
body: TaskTerminateParams { reason }
reason?: string | null
ReturnsExpand Collapse
Task { id, cleaned_at, created_at, 6 more }
id: string
cleaned_at?: string | null
created_at?: string | null
name?: string | null
params?: Record<string, unknown> | null
status?: "CANCELED" | "COMPLETED" | "FAILED" | 5 more | null
One of the following:
"CANCELED"
"COMPLETED"
"FAILED"
"RUNNING"
"INTERRUPTED"
"TERMINATED"
"TIMED_OUT"
"DELETED"
status_reason?: string | null
task_metadata?: Record<string, unknown> | null
updated_at?: string | null

Terminate Task

import Agentex from 'agentex';

const client = new Agentex({
  apiKey: process.env['AGENTEX_SDK_API_KEY'], // This is the default and can be omitted
});

const task = await client.tasks.terminate('task_id');

console.log(task.id);
{
  "id": "id",
  "cleaned_at": "2019-12-27T18:11:19.117Z",
  "created_at": "2019-12-27T18:11:19.117Z",
  "name": "name",
  "params": {
    "foo": "bar"
  },
  "status": "CANCELED",
  "status_reason": "status_reason",
  "task_metadata": {
    "foo": "bar"
  },
  "updated_at": "2019-12-27T18:11:19.117Z"
}
Returns Examples
{
  "id": "id",
  "cleaned_at": "2019-12-27T18:11:19.117Z",
  "created_at": "2019-12-27T18:11:19.117Z",
  "name": "name",
  "params": {
    "foo": "bar"
  },
  "status": "CANCELED",
  "status_reason": "status_reason",
  "task_metadata": {
    "foo": "bar"
  },
  "updated_at": "2019-12-27T18:11:19.117Z"
}