Skip to main content
DELETE
Delete Task
Delete a task by ID. Running tasks will be cancelled before deletion, and all associated data including results and conversation history will be permanently removed.

Path Parameters

string
required
Unique identifier of the task to delete (UUID format)

Response

Returns 204 No Content on successful deletion (empty response body).

Example Request

Response Status Codes

Important Notes

  • Permanent deletion - This action cannot be undone
  • Running tasks - Will be cancelled before deletion
  • Data removal - Results, conversation history, and all associated data are removed
  • Sub-tasks - All sub-tasks are also deleted

Example with Error Handling

Use Cases

  • Clean up completed tasks - Remove old task data to save storage
  • Cancel running tasks - Stop a task that’s in progress
  • Manage sensitive data - Delete tasks containing sensitive information
  • Maintain organization - Remove test or failed tasks

Authorizations

x-api-key
string
header
required

API Key for authentication

Path Parameters

task_id
string
required

Response

Successful Response