Skip to main content
POST
Cancel a running or queued task
Cancel a research task that is running, queued, awaiting_input or paused. Completed, failed and already cancelled tasks cannot be cancelled again (400). A 409 with Task is no longer cancellable. means the task changed state while the cancel was processed, for example it just completed; fetch its status. Cancelling a running or awaiting_input task charges the full mode price. Cancelling a queued or paused task is free. After cancellation, retrieve task status to update your application. Cancellation and deletion are separate operations; cancellation is not a request to erase the task’s stored data.

Authorizations

X-API-Key
string
header
required

API key for authentication. Get yours at platform.valyu.ai.

Path Parameters

id
string
required

DeepResearch task ID.

Response

Task cancelled.

success
boolean
required

Whether the operation succeeded.

Example:

true

message
string
required

Human-readable status message.

Example:

"Task cancelled"

deepresearch_id
string
required

ID of the affected task.

Example:

"a1b2c3d4-e5f6-7890-abcd-ef1234567890"