Cancel Task

Request

Cancellation can use the cancel_url from the create-task response, or build the request path with BASE_URL, endpoint, and request_id. Cancellation requests use the PUT method.

Use cancel_url

curl -sS -X PUT "${CANCEL_URL}" \
  "${COMMON_HEADERS[@]}"

Cancel task by request_id

curl -sS -X PUT "${BASE_URL}/v1/queue/${ENDPOINT}/requests/${REQUEST_ID}/cancel" \
  "${COMMON_HEADERS[@]}"

Warning

An accepted cancellation request only means the platform has received the cancellation instruction. Whether the task stops immediately depends on its current execution stage; a task that is already running may still return a final result.

Response

HTTP status code	status	Meaning
202	CANCELLATION_REQUESTED	Cancellation request accepted
400	ALREADY_COMPLETED	The task is already terminal and cannot be canceled
404	NOT_FOUND	The task does not exist or access is not permitted

UI behavior

• Allow the user to stop local streaming or polling at any time.
• Stopping a browser request may not stop upstream generation or billing.