• Backlog
  • Board
  • Epic
  • Issue
  • Sprint
  • Development Information
  • Feature Flags
  • Deployments
  • Builds
  • Security Information
  • Operations
  • DevOps Components
Cloud
Jira Software Cloud / Reference / REST API

Board

Postman Collection
OpenAPI
GET

Get all boards

Returns all boards. This only includes boards that the user has permission to view.

Deprecation notice: The required OAuth 2.0 scopes will be updated on February 15, 2024.

  • read:board-scope:jira-software, read:project:jira
Data Security Policy: Exempt from app access rules
Scopes

Connect app scope requiredREAD

read:board-scope:jira-software
, read:project:jira

Request

Query parameters

startAt

integer

maxResults

integer

type

object

name

string

projectKeyOrId

string

accountIdLocation

string

projectLocation

string

includePrivate

boolean

negateLocationFiltering

boolean

orderBy

string

Responses

Returns the requested boards, at the specified page of the results.

application/json

object
GET/rest/agile/1.0/board
1 2 3 4 curl --request GET \ --url 'https://your-domain.atlassian.net/rest/agile/1.0/board' \ --header 'Authorization: Bearer <access_token>' \ --header 'Accept: application/json'
200Response
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 { "isLast": false, "maxResults": 2, "startAt": 1, "total": 5, "values": [ { "id": 84, "name": "scrum board", "self": "https://your-domain.atlassian.net/rest/agile/1.0/board/84", "type": "scrum" }, { "id": 92, "name": "kanban board", "self": "https://your-domain.atlassian.net/rest/agile/1.0/board/92", "type": "kanban" } ] }
POST

Create board

Creates a new board. Board name, type and filter ID is required.

  • name - Must be less than 255 characters.
  • type - Valid values: scrum, kanban
  • filterId - ID of a filter that the user has permissions to view. Note, if the user does not have the 'Create shared objects' permission and tries to create a shared board, a private board will be created instead (remember that board sharing depends on the filter sharing).
  • location - The container that the board will be located in. location must include the type property (Valid values: project, user). If choosing 'project', then a project must be specified by a projectKeyOrId property in location. If choosing 'user', the current user is chosen by default. The projectKeyOrId property should not be provided.

Note:

Data Security Policy: Exempt from app access rules
Scopes

Connect app scope requiredWRITE

write:board-scope:jira-software

Request

Request bodyapplication/json

filterId

integer

location

object

name

string

type

string

Responses

Returns the created board.

application/json

object

Details about a board.

POST/rest/agile/1.0/board
1 2 3 4 5 6 7 8 9 10 11 12 13 14 curl --request POST \ --url 'https://your-domain.atlassian.net/rest/agile/1.0/board' \ --header 'Authorization: Bearer <access_token>' \ --header 'Accept: application/json' \ --header 'Content-Type: application/json' \ --data '{ "filterId": 10040, "location": { "projectKeyOrId": "10000", "type": "project" }, "name": "scrum board", "type": "scrum" }'
201Response
1 2 3 4 5 6 { "id": 84, "name": "scrum board", "self": "https://your-domain.atlassian.net/rest/agile/1.0/board/84", "type": "scrum" }
GET

Get board by filter id

Returns any boards which use the provided filter id. This method can be executed by users without a valid software license in order to find which boards are using a particular filter.

Data Security Policy: Exempt from app access rules
Scopes

Connect app scope requiredREAD

read:board-scope.admin:jira-software

Request

Path parameters

filterId

integer

Required

Query parameters

startAt

integer

maxResults

integer

Responses

Returns the requested boards, at the specified page of the results.

application/json

object
GET/rest/agile/1.0/board/filter/{filterId}
1 2 3 4 curl --request GET \ --url 'https://your-domain.atlassian.net/rest/agile/1.0/board/filter/{filterId}' \ --header 'Authorization: Bearer <access_token>' \ --header 'Accept: application/json'
200Response
1 2 3 4 5 { "id": 84, "name": "scrum board", "self": "https://your-domain.atlassian.net/rest/agile/1.0/board/84" }
GET

Get board

Returns the board for the given board ID. This board will only be returned if the user has permission to view it. Admins without the view permission will see the board as a private one, so will see only a subset of the board's data (board location for instance).

Data Security Policy: Exempt from app access rules
Scopes

Connect app scope requiredREAD

read:board-scope:jira-software
, read:issue-details:jira

Request

Path parameters

boardId

integer

Required

Responses

Returns the requested board.

application/json

object

Details about a board.

GET/rest/agile/1.0/board/{boardId}
1 2 3 4 curl --request GET \ --url 'https://your-domain.atlassian.net/rest/agile/1.0/board/{boardId}' \ --header 'Authorization: Bearer <access_token>' \ --header 'Accept: application/json'
200Response
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 { "id": 84, "location": { "displayName": "Example Project", "name": "Example Project", "projectId": 10040, "projectKey": "Example Project Key", "projectName": "Example Project", "projectTypeKey": "KEY", "userAccountId": "5b10a2844c20165700ede21g", "userId": 10040 }, "name": "scrum board", "self": "https://your-domain.atlassian.net/rest/agile/1.0/board/84", "type": "scrum" }
DEL

Delete board

Deletes the board. Admin without the view permission can still remove the board.

Data Security Policy: Exempt from app access rules
Scopes

Connect app scope requiredDELETE

write:board-scope:jira-software

Request

Path parameters

boardId

integer

Required

Responses

Returned if the board has been successfully removed.

DEL/rest/agile/1.0/board/{boardId}
1 2 3 curl --request DELETE \ --url 'https://your-domain.atlassian.net/rest/agile/1.0/board/{boardId}' \ --header 'Authorization: Bearer <access_token>'
GET

Get issues for backlog

Returns all issues from the board's backlog, for the given board ID. This only includes issues that the user has permission to view. The backlog contains incomplete issues that are not assigned to any future or active sprint. Note, if the user does not have permission to view the board, no issues will be returned at all. Issues returned from this resource include Agile fields, like sprint, closedSprints, flagged, and epic. By default, the returned issues are ordered by rank.

Data Security Policy: Not exempt from app access rules
Scopes

Connect app scope requiredREAD

read:board-scope:jira-software
, read:issue-details:jira

Request

Path parameters

boardId

integer

Required

Query parameters

startAt

integer

maxResults

integer

jql

string

validateQuery

boolean

fields

array<object>

expand

string

Responses

Returns the requested issues, at the specified page of the results.

application/json

SearchResults

The result of a JQL search.

GET/rest/agile/1.0/board/{boardId}/backlog
1 2 3 4 curl --request GET \ --url 'https://your-domain.atlassian.net/rest/agile/1.0/board/{boardId}/backlog' \ --header 'Authorization: Bearer <access_token>' \ --header 'Accept: application/json'
200Response
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158