---
title: "Release Tasks Endpoint"
method: POST
path: "/api/tasks/release"
tags: ["tasks"]
---

# Release Tasks Endpoint

`POST /api/tasks/release`

## 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/release`
- Auth: none declared

Release tasks matching the prolific_id and occupation_id.

Makes tasks available again for other users and clears their prolific_id.

This endpoint is used to manage task lifecycle when a user abandons tasks
or needs to release locked tasks back to the available pool.
Only updates tasks where is_deleted is None.

## Request body

- ReleaseTasksRequest
  - `prolific_id` string, required
  - `occupation_id` string, required

## Response `200`

Successful Response

- TaskRead: Model for reading task data
  - `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)