How to create a swimlane in the Board programmatically using REST API
Platform Notice: Data Center Only - This article only applies to Atlassian products on the Data Center platform.
Note that this KB was created for the Data Center version of the product. Data Center KBs for non-Data-Center-specific features may also work for Server versions of the product, however they have not been tested. 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
Learn how to create a swimlane in the Board programmatically using REST API.
Solution
First find the Board ID in which the Swimlane is to be created. You can make the GET getAllBoards API call to find this information: <Jira_BASE_URL>/rest/agile/1.0/board/.
Let's take the Board with ID 17 and we will add a swimlane to this board.
The next step is to make a POST call to the endpoint: <Jira_BASE_URL>/rest/greenhopper/1.0/swimlanes/<Board_ID>/. The user needs to replace the Board ID in this API call which we got from the above GET call. Make sure to set the Accept and Content-Type headers to application/JSON.
Go to the respective board and verify if the swimlane is created and issues are grouped based on it.
Please note that the POST call to create the swimlanes is not documented in the Jira Agile Server REST API reference and thus users need to be cautious while working with it. Also, Atlassian may not be taking improvements or bug fix requests on this API for the same reason.
Was this helpful?