---
title: "Mark Task As Deleted Endpoint"
method: POST
path: "/api/tasks/soft_delete"
tags: ["tasks"]
---

# Mark Task As Deleted Endpoint

`POST /api/tasks/soft_delete`

## Request

- Base URL: `https://api.mit-llm-survey.academy` (the document declares no server; this is the origin it was published from)
- URL: `https://api.mit-llm-survey.academy/api/tasks/soft_delete`
- Auth: none declared

Mark multiple tasks as deleted by setting the is_deleted field to the current timestamp.

**Parameters:**
- **task_ids**: List of task IDs to mark as deleted
- **occupation_id**: The occupation ID of the tasks
- **prolific_id**: The prolific ID of the user who has the tasks locked

**Returns:**
List of updated tasks with is_deleted timestamp set.

**Raises:**
- 400: task_ids is empty or null
- 404: No tasks found with the given task_ids and occupation_id

## Request body

- SoftDeleteRequest
  - `task_ids` string[], required
  - `occupation_id` string, required
  - `prolific_id` string, required

## Response `200`

Successful Response

- TaskRead[]
  - `occupation_id` string, required
  - `task_url` string, required
  - `task_desc` string, required
  - `response_url_1` string, nullable
  - `response_url_2` string, nullable
  - `response_url_3` string, nullable
  - `response_url_4` string, nullable
  - `response_url_5` string, nullable
  - `available` string
  - `prolific_id` string, nullable
  - `qualtrics_id` string, nullable
  - `history` string, nullable
  - `locked_history` string, nullable
  - `is_deleted` string, date-time, nullable
  - `models_order` string, nullable
  - `task_id` string, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/mit-llm-survey/apis/llm-survey-backend.md) - [All operations](https://skmtc.dev/mit-llm-survey/apis/llm-survey-backend/llms.txt) - [OpenAPI document](https://skmtc.dev/mit-llm-survey/apis/llm-survey-backend/revisions/6a5ef49cfcc4?raw)
