task.delete

Deletes a task permanently. If the task is still running, use task.stop first.

POST /v2/task.delete

DeleteTask

cURL

curl --request POST \
  --url https://api.manus.ai/v2/task.delete \
  --header 'Content-Type: application/json' \
  --data '
{
  "task_id": "<string>"
}
'

200

{
  "ok": true,
  "request_id": "<string>",
  "id": "<string>",
  "deleted": true
}

^{Questions or issues? Contact us at [e-mail].}

OAuth scope: create_task or manage_all_tasks — see the OAuth2 guide. With create_task scope, can only access tasks created by this OAuth app.

This action is permanent. If the task is still running, use task.stop to stop it first. Agent-related tasks (e.g. agent main tasks and subtasks) cannot be deleted.

Headers

x-manus-api-key · string

API key for direct authentication. Provide either this or Authorization, not both. See Authentication.

Authorization · string

OAuth2 access token in Bearer {token} format. Provide either this or x-manus-api-key, not both. See the OAuth2 guide.

Example:

"Bearer {access_token}"

Body

application/json

task_id · string · required

The unique identifier of the task to delete. Agent-related tasks cannot be deleted.

Response

200

application/json

Task deleted successfully.

ok · boolean

Whether the request was successful.

Example:

true

request_id · string

Unique identifier for this API request.

id · string

The ID of the deleted task.

deleted · boolean

Always true when the deletion was successful.