---
title: "Repositions a task"
method: PATCH
path: "/api/v2/tasks/{id}/reposition"
tags: ["Tasks"]
---

# Repositions a task

`PATCH /api/v2/tasks/{id}/reposition`

Reorders a task within its task list. Pass `move_before_id` and/or `move_after_id` — the IDs of sibling tasks to position it relative to. When both are provided, the task is placed between them.

Set `subtask: true` to reorder within the parent task's subtask order instead of within the task list.

```json
{
  "data": {
    "type": "tasks",
    "attributes": { "move_after_id": 5560100 }
  }
}
```

## Path parameters

- `id` string, required

## Headers

- `X-Organization-Id` string, required

## Response `204`

No Content

---

[API](https://skmtc.net/productive/apis/api-documentation.md) · [All operations](https://skmtc.net/productive/apis/api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/productive/api-documentation/versions/6bb0150a5c5f/schema)