v1

latestOpenAPI 3.0.1Apache 2.02026-07-1310566642.9 KB
Board

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
get/rest/agile/1.0/board

Query parameters

startAtinteger

The starting index of the returned boards. Base index: 0. See the 'Pagination' section at the top of this page for more details.

maxResultsinteger

The maximum number of boards to return per page. See the 'Pagination' section at the top of this page for more details.

typeobject

Filters results to boards of the specified types. Valid values: scrum, kanban, simple.

namestring

Filters results to boards that match or partially match the specified name.

projectKeyOrIdstring

Filters results to boards that are relevant to a project. Relevance means that the jql filter defined in board contains a reference to a project.

accountIdLocationstring
projectLocationstring
includePrivateboolean

Appends private boards to the end of the list. The name and type fields are excluded for security reasons.

negateLocationFilteringboolean

If set to true, negate filters used for querying by location. By default false.

orderBy'name' | '-name' | '+name'

Ordering of the results by a given field. If not provided, values will not be sorted. Valid values: name.

expandstring

List of fields to expand for each board. Valid values: admins, permissions.

projectTypeLocationstring[]

Filters results to boards that are relevant to a project types. Support Jira Software, Jira Service Management. Valid values: software, service_desk. By default software.

filterIdinteger

Filters results to boards that are relevant to a filter. Not supported for next-gen boards.

Response

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

isLastboolean
maxResultsinteger
startAtinteger
totalinteger