---
title: "Update the order of an issue"
method: PUT
path: "/api/v4/projects/{id}/issues/{issue_iid}/reorder"
tags: ["projects"]
---

# Update the order of an issue

`PUT /api/v4/projects/{id}/issues/{issue_iid}/reorder`

## Request

- Base URL: `https://gitlab.com`
- URL: `https://gitlab.com/api/v4/projects/{id}/issues/{issue_iid}/reorder`
- Auth: none declared

Updates the order of a specified issue in a project. You can see the results when sorting issues manually.

## Path parameters

- `id` string, required
- `issue_iid` integer, required

## Request body

- PutApiV4ProjectsIdIssuesIssueIidReorder: Update the order of an issue
  - `move_after_id` integer: The ID of the issue we want to be after
  - `move_before_id` integer: The ID of the issue we want to be before

## Response `200`

Update the order of an issue

- APIEntitiesIssue: API_Entities_Issue model
  - `id` integer, required
  - `iid` integer, required
  - `project_id` integer, required
  - `title` string, required
  - `description` string, required
  - `state` string, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `closed_at` string, date-time, required
  - `closed_by` APIEntitiesUserBasic, required: API_Entities_UserBasic model
    - `id` integer, required
    - `username` string, required
    - `public_email` string, required
    - `name` string, required
    - `state` string, required
    - `locked` boolean, required
    - `avatar_url` string, required
    - `avatar_path` string
    - `custom_attributes` APIEntitiesCustomAttribute[]
      - `key` string, required
      - `value` string, required
    - `web_url` string, required
  - `labels` string[], required
  - `milestone` APIEntitiesMilestone, required
    - `id` integer, required
    - `iid` integer, required
    - `project_id` integer
    - `group_id` string
    - `title` string, required
    - `description` string, required
    - `state` string, required
    - `created_at` string, required
    - `updated_at` string, required
    - `due_date` string, required
    - `start_date` string, required
    - `expired` boolean, required
    - `web_url` string, required
  - `assignees` APIEntitiesUserBasic, required: API_Entities_UserBasic model
    - `id` integer, required
    - `username` string, required
    - `public_email` string, required
    - `name` string, required
    - `state` string, required
    - `locked` boolean, required
    - `avatar_url` string, required
    - `avatar_path` string
    - `custom_attributes` APIEntitiesCustomAttribute[]
      - `key` string, required
      - `value` string, required
    - `web_url` string, required
  - `author` APIEntitiesUserBasic, required: API_Entities_UserBasic model
    - `id` integer, required
    - `username` string, required
    - `public_email` string, required
    - `name` string, required
    - `state` string, required
    - `locked` boolean, required
    - `avatar_url` string, required
    - `avatar_path` string
    - `custom_attributes` APIEntitiesCustomAttribute[]
      - `key` string, required
      - `value` string, required
    - `web_url` string, required
  - `type` string, required: One of ["ISSUE", "INCIDENT", "TEST_CASE", "REQUIREMENT", "TASK", "TICKET"]
  - `assignee` APIEntitiesUserBasic, required: API_Entities_UserBasic model
    - `id` integer, required
    - `username` string, required
    - `public_email` string, required
    - `name` string, required
    - `state` string, required
    - `locked` boolean, required
    - `avatar_url` string, required
    - `avatar_path` string
    - `custom_attributes` APIEntitiesCustomAttribute[]
      - `key` string, required
      - `value` string, required
    - `web_url` string, required
  - `user_notes_count` integer, required
  - `merge_requests_count` integer, required
  - `upvotes` integer, required
  - `downvotes` integer, required
  - `start_date` string, date, required
  - `due_date` string, date, required
  - `confidential` boolean, required
  - `discussion_locked` boolean, required
  - `issue_type` string, required
  - `web_url` string, required
  - `time_stats` APIEntitiesIssuableTimeStats, required: API_Entities_IssuableTimeStats model
    - `time_estimate` integer, required
    - `total_time_spent` integer, required
    - `human_time_estimate` string, required
    - `human_total_time_spent` string, required
  - `task_completion_status` APIEntitiesTaskCompletionStatus, required
    - `count` integer, required
    - `completed_count` integer, required
  - `weight` integer
  - `blocking_issues_count` integer, required
  - `has_tasks` boolean, required
  - `task_status` string
  - `_links` object, required
    - `self` string, required
    - `notes` string, required
    - `award_emoji` string, required
    - `project` string, required
    - `closed_as_duplicate_of` string, required
  - `references` APIEntitiesIssuableReferences, required
    - `short` string, required
    - `relative` string, required
    - `full` string, required
  - `severity` string, required: One of ["UNKNOWN", "LOW", "MEDIUM", "HIGH", "CRITICAL"]
  - `subscribed` boolean
  - `moved_to_id` integer, required
  - `imported` boolean, required
  - `imported_from` string, required
  - `service_desk_reply_to` string, required
  - `epic_iid` string
  - `epic` EpicBaseEntity
    - `id` string, required
    - `iid` string, required
    - `title` string, required
    - `url` string, required
    - `group_id` string, required
    - `human_readable_end_date` string
    - `human_readable_timestamp` string
  - `iteration` APIEntitiesIteration
    - `id` integer, required
    - `iid` integer, required
    - `sequence` integer, required
    - `group_id` integer, required
    - `title` string, required
    - `description` string, required
    - `state` integer, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `start_date` string, date, required
    - `due_date` string, date, required
    - `web_url` string, required
  - `health_status` string

---

[API](https://skmtc.dev/gitlab/apis/gitlab-api.md) - [All operations](https://skmtc.dev/gitlab/apis/gitlab-api/llms.txt) - [OpenAPI document](https://skmtc.dev/gitlab/apis/gitlab-api/revisions/b234947ef3f2?raw)