/** * Jira Software Cloud API * Jira Software Cloud REST API documentation * * The version of the OpenAPI document: 1001.0.0 * * * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech). * https://openapi-generator.tech * Do not edit the class manually. */ import * as runtime from '../runtime'; import { BodiesCreateBoard, BodiesToggleFeatures, InlineResponse200, InlineResponse2001, InlineResponse2002, InlineResponse2002Values, InlineResponse2003, MoveIssuesToBacklogForBoard } from '../models'; export interface CreateBoardRequest { BodiesCreateBoard: BodiesCreateBoard; } export interface DeleteBoardRequest { boardId: number; } export interface DeleteBoardPropertyRequest { boardId: string; propertyKey: string; } export interface GetAllBoardsRequest { startAt?: number; maxResults?: number; type?: string; name?: string; projectKeyOrId?: string; accountIdLocation?: string; userkeyLocation?: string; usernameLocation?: string; projectLocation?: string; includePrivate?: boolean; negateLocationFiltering?: boolean; orderBy?: string; expand?: string; filterId?: number; } export interface GetAllQuickFiltersRequest { boardId: number; startAt?: number; maxResults?: number; } export interface GetAllSprintsRequest { boardId: number; startAt?: number; maxResults?: number; state?: string; } export interface GetAllVersionsRequest { boardId: number; startAt?: number; maxResults?: number; released?: string; } export interface GetBoardRequest { boardId: number; } export interface GetBoardByFilterIdRequest { filterId: number; startAt?: number; maxResults?: number; } export interface GetBoardPropertyRequest { boardId: string; propertyKey: string; } export interface GetBoardPropertyKeysRequest { boardId: string; } export interface GetConfigurationRequest { boardId: number; } export interface GetEpicsRequest { boardId: number; startAt?: number; maxResults?: number; done?: string; } export interface GetFeaturesForBoardRequest { boardId: number; } export interface GetIssuesForBacklogRequest { boardId: number; startAt?: number; maxResults?: number; jql?: string; validateQuery?: boolean; fields?: Array; expand?: string; } export interface GetIssuesForBoardRequest { boardId: number; startAt?: number; maxResults?: number; jql?: string; validateQuery?: boolean; fields?: Array; expand?: string; } export interface GetIssuesForEpicRequest { boardId: number; epicId: number; startAt?: number; maxResults?: number; jql?: string; validateQuery?: boolean; fields?: Array; expand?: string; } export interface GetIssuesForSprintRequest { boardId: number; sprintId: number; startAt?: number; maxResults?: number; jql?: string; validateQuery?: boolean; fields?: Array; expand?: string; } export interface GetIssuesWithoutEpicRequest { boardId: number; startAt?: number; maxResults?: number; jql?: string; validateQuery?: boolean; fields?: Array; expand?: string; } export interface GetProjectsRequest { boardId: number; startAt?: number; maxResults?: number; } export interface GetProjectsFullRequest { boardId: number; } export interface GetQuickFilterRequest { boardId: number; quickFilterId: number; } export interface GetReportsForBoardRequest { boardId: number; } export interface MoveIssuesToBoardRequest { boardId: number; MoveIssuesToBacklogForBoard: MoveIssuesToBacklogForBoard; } export interface SetBoardPropertyRequest { boardId: string; propertyKey: string; } export interface ToggleFeaturesRequest { boardId: number; BodiesToggleFeatures: BodiesToggleFeatures; } /** * no description */ export declare class BoardApi extends runtime.BaseAPI { /** * 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: * If you want to create a new project with an associated board, use the [Jira platform REST API](https://docs.atlassian.com/jira/REST/latest). For more information, see the [Create project](#api-rest-api--project-post) method. The `projectTypeKey` for software boards must be \'software\' and the `projectTemplateKey` must be either `com.pyxis.greenhopper.jira:gh-kanban-template` or `com.pyxis.greenhopper.jira:gh-scrum-template`. * You can create a filter using the [Jira REST API](https://docs.atlassian.com/jira/REST/latest). For more information, see the [Create filter](#api-rest-api--filter-post) method. * If you do not ORDER BY the Rank field for the filter of your board, you will not be able to reorder issues on the board. * Create board */ createBoardRaw(requestParameters: CreateBoardRequest): Promise>; /** * 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: * If you want to create a new project with an associated board, use the [Jira platform REST API](https://docs.atlassian.com/jira/REST/latest). For more information, see the [Create project](#api-rest-api--project-post) method. The `projectTypeKey` for software boards must be \'software\' and the `projectTemplateKey` must be either `com.pyxis.greenhopper.jira:gh-kanban-template` or `com.pyxis.greenhopper.jira:gh-scrum-template`. * You can create a filter using the [Jira REST API](https://docs.atlassian.com/jira/REST/latest). For more information, see the [Create filter](#api-rest-api--filter-post) method. * If you do not ORDER BY the Rank field for the filter of your board, you will not be able to reorder issues on the board. * Create board */ createBoard(requestParameters: CreateBoardRequest): Promise; /** * Deletes the board. Admin without the view permission can still remove the board. * Delete board */ deleteBoardRaw(requestParameters: DeleteBoardRequest): Promise>; /** * Deletes the board. Admin without the view permission can still remove the board. * Delete board */ deleteBoard(requestParameters: DeleteBoardRequest): Promise; /** * Removes the property from the board identified by the id. Ths user removing the property is required to have permissions to modify the board. * Delete board property */ deleteBoardPropertyRaw(requestParameters: DeleteBoardPropertyRequest): Promise>; /** * Removes the property from the board identified by the id. Ths user removing the property is required to have permissions to modify the board. * Delete board property */ deleteBoardProperty(requestParameters: DeleteBoardPropertyRequest): Promise; /** * Returns all boards. This only includes boards that the user has permission to view. * Get all boards */ getAllBoardsRaw(requestParameters: GetAllBoardsRequest): Promise>; /** * Returns all boards. This only includes boards that the user has permission to view. * Get all boards */ getAllBoards(requestParameters: GetAllBoardsRequest): Promise; /** * Returns all quick filters from a board, for a given board ID. * Get all quick filters */ getAllQuickFiltersRaw(requestParameters: GetAllQuickFiltersRequest): Promise>; /** * Returns all quick filters from a board, for a given board ID. * Get all quick filters */ getAllQuickFilters(requestParameters: GetAllQuickFiltersRequest): Promise; /** * Returns all sprints from a board, for a given board ID. This only includes sprints that the user has permission to view. * Get all sprints */ getAllSprintsRaw(requestParameters: GetAllSprintsRequest): Promise>; /** * Returns all sprints from a board, for a given board ID. This only includes sprints that the user has permission to view. * Get all sprints */ getAllSprints(requestParameters: GetAllSprintsRequest): Promise; /** * Returns all versions from a board, for a given board ID. This only includes versions that the user has permission to view. Note, if the user does not have permission to view the board, no versions will be returned at all. Returned versions are ordered by the name of the project from which they belong and then by sequence defined by user. * Get all versions */ getAllVersionsRaw(requestParameters: GetAllVersionsRequest): Promise>; /** * Returns all versions from a board, for a given board ID. This only includes versions that the user has permission to view. Note, if the user does not have permission to view the board, no versions will be returned at all. Returned versions are ordered by the name of the project from which they belong and then by sequence defined by user. * Get all versions */ getAllVersions(requestParameters: GetAllVersionsRequest): Promise; /** * 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). * Get board */ getBoardRaw(requestParameters: GetBoardRequest): Promise>; /** * 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). * Get board */ getBoard(requestParameters: GetBoardRequest): Promise; /** * 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. * Get board by filter id */ getBoardByFilterIdRaw(requestParameters: GetBoardByFilterIdRequest): Promise>; /** * 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. * Get board by filter id */ getBoardByFilterId(requestParameters: GetBoardByFilterIdRequest): Promise; /** * Returns the value of the property with a given key from the board identified by the provided id. The user who retrieves the property is required to have permissions to view the board. * Get board property */ getBoardPropertyRaw(requestParameters: GetBoardPropertyRequest): Promise>; /** * Returns the value of the property with a given key from the board identified by the provided id. The user who retrieves the property is required to have permissions to view the board. * Get board property */ getBoardProperty(requestParameters: GetBoardPropertyRequest): Promise; /** * Returns the keys of all properties for the board identified by the id. The user who retrieves the property keys is required to have permissions to view the board. * Get board property keys */ getBoardPropertyKeysRaw(requestParameters: GetBoardPropertyKeysRequest): Promise>; /** * Returns the keys of all properties for the board identified by the id. The user who retrieves the property keys is required to have permissions to view the board. * Get board property keys */ getBoardPropertyKeys(requestParameters: GetBoardPropertyKeysRequest): Promise; /** * Get the board configuration. The response contains the following fields: * `id` \\- ID of the board. * `name` \\- Name of the board. * `filter` \\- Reference to the filter used by the given board. * `location` \\- Reference to the container that the board is located in. Includes the container type (Valid values: project, user). * `subQuery` (Kanban only) - JQL subquery used by the given board. * `columnConfig` \\- The column configuration lists the columns for the board, in the order defined in the column configuration. For each column, it shows the issue status mapping as well as the constraint type (Valid values: none, issueCount, issueCountExclSubs) for the min/max number of issues. Note, the last column with statuses mapped to it is treated as the \"Done\" column, which means that issues in that column will be marked as already completed. * `estimation` (Scrum only) - Contains information about type of estimation used for the board. Valid values: none, issueCount, field. If the estimation type is \"field\", the ID and display name of the field used for estimation is also returned. Note, estimates for an issue can be updated by a PUT /rest/api/~ver~/issue/{issueIdOrKey} request, however the fields must be on the screen. \"timeoriginalestimate\" field will never be on the screen, so in order to update it \"originalEstimate\" in \"timetracking\" field should be updated. * `ranking` \\- Contains information about custom field used for ranking in the given board. * Get configuration */ getConfigurationRaw(requestParameters: GetConfigurationRequest): Promise>; /** * Get the board configuration. The response contains the following fields: * `id` \\- ID of the board. * `name` \\- Name of the board. * `filter` \\- Reference to the filter used by the given board. * `location` \\- Reference to the container that the board is located in. Includes the container type (Valid values: project, user). * `subQuery` (Kanban only) - JQL subquery used by the given board. * `columnConfig` \\- The column configuration lists the columns for the board, in the order defined in the column configuration. For each column, it shows the issue status mapping as well as the constraint type (Valid values: none, issueCount, issueCountExclSubs) for the min/max number of issues. Note, the last column with statuses mapped to it is treated as the \"Done\" column, which means that issues in that column will be marked as already completed. * `estimation` (Scrum only) - Contains information about type of estimation used for the board. Valid values: none, issueCount, field. If the estimation type is \"field\", the ID and display name of the field used for estimation is also returned. Note, estimates for an issue can be updated by a PUT /rest/api/~ver~/issue/{issueIdOrKey} request, however the fields must be on the screen. \"timeoriginalestimate\" field will never be on the screen, so in order to update it \"originalEstimate\" in \"timetracking\" field should be updated. * `ranking` \\- Contains information about custom field used for ranking in the given board. * Get configuration */ getConfiguration(requestParameters: GetConfigurationRequest): Promise; /** * Returns all epics from the board, for the given board ID. This only includes epics that the user has permission to view. Note, if the user does not have permission to view the board, no epics will be returned at all. * Get epics */ getEpicsRaw(requestParameters: GetEpicsRequest): Promise>; /** * Returns all epics from the board, for the given board ID. This only includes epics that the user has permission to view. Note, if the user does not have permission to view the board, no epics will be returned at all. * Get epics */ getEpics(requestParameters: GetEpicsRequest): Promise; /** * Get features for board */ getFeaturesForBoardRaw(requestParameters: GetFeaturesForBoardRequest): Promise>; /** * Get features for board */ getFeaturesForBoard(requestParameters: GetFeaturesForBoardRequest): Promise; /** * 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. * Get issues for backlog */ getIssuesForBacklogRaw(requestParameters: GetIssuesForBacklogRequest): Promise>; /** * 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. * Get issues for backlog */ getIssuesForBacklog(requestParameters: GetIssuesForBacklogRequest): Promise; /** * Returns all issues from a board, for a given board ID. This only includes issues that the user has permission to view. An issue belongs to the board if its status is mapped to the board\'s column. Epic issues do not belongs to the scrum boards. 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. * Get issues for board */ getIssuesForBoardRaw(requestParameters: GetIssuesForBoardRequest): Promise>; /** * Returns all issues from a board, for a given board ID. This only includes issues that the user has permission to view. An issue belongs to the board if its status is mapped to the board\'s column. Epic issues do not belongs to the scrum boards. 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. * Get issues for board */ getIssuesForBoard(requestParameters: GetIssuesForBoardRequest): Promise; /** * Returns all issues that belong to an epic on the board, for the given epic ID and the board ID. This only includes issues that the user has permission to view. Issues returned from this resource include Agile fields, like sprint, closedSprints, flagged, and epic. By default, the returned issues are ordered by rank. * Get issues for epic */ getIssuesForEpicRaw(requestParameters: GetIssuesForEpicRequest): Promise>; /** * Returns all issues that belong to an epic on the board, for the given epic ID and the board ID. This only includes issues that the user has permission to view. Issues returned from this resource include Agile fields, like sprint, closedSprints, flagged, and epic. By default, the returned issues are ordered by rank. * Get issues for epic */ getIssuesForEpic(requestParameters: GetIssuesForEpicRequest): Promise; /** * Get all issues you have access to that belong to the sprint from the board. Issue returned from this resource contains additional fields like: sprint, closedSprints, flagged and epic. Issues are returned ordered by rank. JQL order has higher priority than default rank. * Get issues for sprint */ getIssuesForSprintRaw(requestParameters: GetIssuesForSprintRequest): Promise>; /** * Get all issues you have access to that belong to the sprint from the board. Issue returned from this resource contains additional fields like: sprint, closedSprints, flagged and epic. Issues are returned ordered by rank. JQL order has higher priority than default rank. * Get issues for sprint */ getIssuesForSprint(requestParameters: GetIssuesForSprintRequest): Promise; /** * Returns all issues that do not belong to any epic on a board, for a given board ID. This only includes issues that the user has permission to view. Issues returned from this resource include Agile fields, like sprint, closedSprints, flagged, and epic. By default, the returned issues are ordered by rank. * Get issues without epic */ getIssuesWithoutEpicRaw(requestParameters: GetIssuesWithoutEpicRequest): Promise>; /** * Returns all issues that do not belong to any epic on a board, for a given board ID. This only includes issues that the user has permission to view. Issues returned from this resource include Agile fields, like sprint, closedSprints, flagged, and epic. By default, the returned issues are ordered by rank. * Get issues without epic */ getIssuesWithoutEpic(requestParameters: GetIssuesWithoutEpicRequest): Promise; /** * Returns all projects that are associated with the board, for the given board ID. If the user does not have permission to view the board, no projects will be returned at all. Returned projects are ordered by the name. A project is associated with a board if the board filter contains reference the project or there is an issue from the project that belongs to the board. The board filter contains reference the project only if JQL query guarantees that returned issues will be returned from the project set defined in JQL. For instance the query `project in (ABC, BCD) AND reporter = admin` have reference to ABC and BCD projects but query `project in (ABC, BCD) OR reporter = admin` doesn\'t have reference to any project. An issue belongs to the board if its status is mapped to the board\'s column. Epic issues do not belongs to the scrum boards. * Get projects */ getProjectsRaw(requestParameters: GetProjectsRequest): Promise>; /** * Returns all projects that are associated with the board, for the given board ID. If the user does not have permission to view the board, no projects will be returned at all. Returned projects are ordered by the name. A project is associated with a board if the board filter contains reference the project or there is an issue from the project that belongs to the board. The board filter contains reference the project only if JQL query guarantees that returned issues will be returned from the project set defined in JQL. For instance the query `project in (ABC, BCD) AND reporter = admin` have reference to ABC and BCD projects but query `project in (ABC, BCD) OR reporter = admin` doesn\'t have reference to any project. An issue belongs to the board if its status is mapped to the board\'s column. Epic issues do not belongs to the scrum boards. * Get projects */ getProjects(requestParameters: GetProjectsRequest): Promise; /** * Returns all projects that are statically associated with the board, for the given board ID. Returned projects are ordered by the name. A project is associated with a board if the board filter contains reference the project. The board filter contains reference the project only if JQL query guarantees that returned issues will be returned from the project set defined in JQL. For instance the query `project in (ABC, BCD) AND reporter = admin` have reference to ABC and BCD projects but query `project in (ABC, BCD) OR reporter = admin` doesn\'t have reference to any project. * Get projects full */ getProjectsFullRaw(requestParameters: GetProjectsFullRequest): Promise>; /** * Returns all projects that are statically associated with the board, for the given board ID. Returned projects are ordered by the name. A project is associated with a board if the board filter contains reference the project. The board filter contains reference the project only if JQL query guarantees that returned issues will be returned from the project set defined in JQL. For instance the query `project in (ABC, BCD) AND reporter = admin` have reference to ABC and BCD projects but query `project in (ABC, BCD) OR reporter = admin` doesn\'t have reference to any project. * Get projects full */ getProjectsFull(requestParameters: GetProjectsFullRequest): Promise; /** * Returns the quick filter for a given quick filter ID. The quick filter will only be returned if the user can view the board that the quick filter belongs to. * Get quick filter */ getQuickFilterRaw(requestParameters: GetQuickFilterRequest): Promise>; /** * Returns the quick filter for a given quick filter ID. The quick filter will only be returned if the user can view the board that the quick filter belongs to. * Get quick filter */ getQuickFilter(requestParameters: GetQuickFilterRequest): Promise; /** * Get reports for board */ getReportsForBoardRaw(requestParameters: GetReportsForBoardRequest): Promise>; /** * Get reports for board */ getReportsForBoard(requestParameters: GetReportsForBoardRequest): Promise; /** * Move issues from the backog to the board (if they are already in the backlog of that board). This operation either moves an issue(s) onto a board from the backlog (by adding it to the issueList for the board) Or transitions the issue(s) to the first column for a kanban board with backlog. At most 50 issues may be moved at once. * Move issues to board */ moveIssuesToBoardRaw(requestParameters: MoveIssuesToBoardRequest): Promise>; /** * Move issues from the backog to the board (if they are already in the backlog of that board). This operation either moves an issue(s) onto a board from the backlog (by adding it to the issueList for the board) Or transitions the issue(s) to the first column for a kanban board with backlog. At most 50 issues may be moved at once. * Move issues to board */ moveIssuesToBoard(requestParameters: MoveIssuesToBoardRequest): Promise; /** * Sets the value of the specified board\'s property. You can use this resource to store a custom data against the board identified by the id. The user who stores the data is required to have permissions to modify the board. * Set board property */ setBoardPropertyRaw(requestParameters: SetBoardPropertyRequest): Promise>; /** * Sets the value of the specified board\'s property. You can use this resource to store a custom data against the board identified by the id. The user who stores the data is required to have permissions to modify the board. * Set board property */ setBoardProperty(requestParameters: SetBoardPropertyRequest): Promise; /** * Toggle features */ toggleFeaturesRaw(requestParameters: ToggleFeaturesRequest): Promise>; /** * Toggle features */ toggleFeatures(requestParameters: ToggleFeaturesRequest): Promise; }