Delete Task

This endpoint soft-deletes an existing task by ID.

Endpoint

DELETE /v1/tasks/tasks/:id

Authentication

Include your API key in the x-api-key header. See Authentication.

Required Scope

tasks:write

Path Parameters

Parameter	Type	Required	Description
id	string	Yes	Task ID to delete.

Request Body

This endpoint does not accept a request body.

Example Request

cURL

curl -X DELETE "https://api.crewsum.com/v1/tasks/tasks/task-pqr123stu4567890" \
  -H "x-api-key: $CREWSUM_API_KEY"

JavaScript

const response = await fetch(
  "https://api.crewsum.com/v1/tasks/tasks/task-pqr123stu4567890",
  {
    method: "DELETE",
    headers: { "x-api-key": process.env.CREWSUM_API_KEY },
  },
);
const result = await response.json();

HTTP

DELETE /v1/tasks/tasks/task-pqr123stu4567890 HTTP/1.1
Host: api.crewsum.com
x-api-key: <your-api-key>

Response

On success, the API returns HTTP 200 OK.

Example Response

{
  "message": "Successfully deleted task task-pqr123stu4567890"
}

Behavior

• The task is soft-deleted: it is marked isDeleted: true. Get Task still returns it. List Tasks returns it only when all is "true".
• You can delete a project’s default task with this endpoint.
• If no task exists for the ID, the API still returns 200. No webhook is sent in that case.
• After the task is deleted, Crewsum emits the tasks.deleted webhook event. A webhook delivery failure does not change the API response.

Error Responses

Status	Meaning
400	The task ID was missing from the route.
500	Crewsum could not delete the task. The message is Error deleting task <id>.

Authentication and scope failures are described in Errors.

Related Webhooks

tasks.deleted View webhook event details.