How to Set Assignee to Unassigned via REST API in JIRA

Platform Notice: Cloud and Data Center - This article applies equally to both cloud and data center platforms.

Support for Server* products ended on February 15th 2024. If you are running a Server product, you can visit the Atlassian Server end of support announcement to review your migration options.

*Except Fisheye and Crucible

Summary

Purpose

The purpose of this article is to show how to set assignee field to "Unassigned" via REST API in JIRA. The complete REST API documentation can be found at REST API and versions.

Solution

Resolution

  • Don't:

Example:

1 2 3 { "name": "Unassigned" }

Note: Performing such way will throw "Unassigned is not an assignable user" error. This is because "Unassigned" is not an user in JIRA.

  • Do:

Example:

1 2 3 { "name": "-1" }

Note: If the name is "-1" default assignee is used. If your default assignee is not "Unassigned", then please do as following:

1 2 3 { "name": null }

Note: A null name will remove the assignee.

Updated on April 2, 2025

Still need help?

The Atlassian Community is here for you.