Tasks

Permanently deletes a task and all its messages. Use this to remove sensitive tasks or clean up test data.

Warning: This action cannot be undone. All messages in the task will be permanently deleted from the user-facing API.

delete/api/v1/projects/{projectId}/tasks/{taskId}

Request

Path parameters

projectIdinteger required

The unique identifier of the agent.

taskIdstring required

The task ID. This is the value returned in data.id when you create a task via POST /tasks.

Response

Task deleted. It will no longer appear in GET /tasks results. This action cannot be undone.

status'error' | 'success'

The status of the response

Example response

{
  "status": "success",
  "data": {
    "deleted": true
  }
}

Changes