Delete a Specific Task: /tasks/{task_id}
Purpose
This endpoint is used to permanently delete a specific task from the Exsited system using its unique identifier. This endpoint allows administrators or systems to remove tasks that are no longer required. The deletion is irreversible and removes the task record from active use.
Use Case
This endpoint is used when a task needs to be removed from the system, such as when a workflow is updated, a milestone is restructured, or a task was created by mistake. It is also used during cleanup operations, testing cycles, or when tasks become obsolete. This API ensures that unwanted tasks can be removed cleanly without affecting other workflow components.
Path Parameters
| Parameter | Type | Description |
|---|---|---|
| task_uuid | string | Unique identifier of the task. |
Query Parameters
No query parameters required for this endpoint.
Request Body
No request body is required for this endpoint.
Response
This endpoint does not return a response body. Upon successful execution, the task is deleted and an HTTP 204 No Content status code is returned.
Delete a Checklist Item: /tasks/{task_id}/checklist/{checklist_id}
Purpose
This endpoint is used to delete a specific checklist item from a task. Checklist items represent smaller actionable steps within a task, and this endpoint allows users or systems to remove an individual checklist entry when it is no longer required. The deletion is permanent and ensures that the task’s checklist remains accurate and up‑to‑date.
Use Case
This endpoint is used when a checklist item needs to be removed from a task, such as when a workflow changes, a step becomes irrelevant, or a checklist item was added by mistake. It is also used during task refinement, cleanup operations, or QA testing to ensure that checklist management behaves correctly. Removing unnecessary checklist items helps maintain clarity and accuracy in task execution.
Path Parameters
| Parameter | Type | Description |
|---|---|---|
| task_id | String | Unique identifier of the task containing the checklist item. |
| checklist_id | String | Unique identifier of the checklist item to be deleted. |
Query Parameters
No query parameter is required for this endpoint.
Request Body
No request body is required for this endpoint.
Response
The response is empty, but the HTTP status code returned is 204 No Content, indicating that the checklist has been successfully deleted with no further content returned in the body.