---
title: "Rank issues"
method: PUT
path: "/rest/agile/1.0/issue/rank"
tags: ["Issue"]
---

# Rank issues

`PUT /rest/agile/1.0/issue/rank`

Moves (ranks) issues before or after a given issue. At most 50 issues may be ranked at once.

This operation may fail for some issues, although this will be rare. In that case the 207 status code is returned for the whole response and detailed information regarding each issue is available in the response body.

If rankCustomFieldId is not defined, the default rank field will be used.

## Request body

- object
  - `issues` string[]
  - `rankAfterIssue` string
  - `rankBeforeIssue` string
  - `rankCustomFieldId` integer

## Response `204`

Empty response is returned if operation was successful.

## Other responses

- `207` — Returns the list of issue with status of rank operation.
- `400` — Returned if the request is invalid.
- `401` — Returned if the user is not logged in.
- `403` — Returned if the user does not have a valid license or does not have permission to rank. To rank issues user has to have schedule issue permission for issues that they want to rank.

---

[API](https://skmtc.net/atlassian/apis/jira-software-cloud-api.md) · [All operations](https://skmtc.net/atlassian/apis/jira-software-cloud-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/atlassian/jira-software-cloud-api/revisions/4e108d54b990/schema)