You need administrator rights in Jira to perform the tasks on this page.
| Info |
|---|
To improve readability, all JSON results will be beautified whereas the actual results will not. |
This API lets you configure Checklist, Proxy and Customer Portal Proxy parameters based on what the provided field configuration ID is provided.
Request URI
The base request URI for all APIs on this page is as follows:
| Code Block |
|---|
{JIRA Instance}/rest/com.okapya.jira.checklist/latest/checklists/configuration/{FieldConfigId}/parameters |
| Info |
|---|
See https://okapya.atlassian.net/wiki/spaces/CHKDOC5/pages/2940666209/Configuring+checklists+using+REST+APIs#Base-configuration-path for more help with the Request URI. |
APIs
Update the parameters
| Status | ||||
|---|---|---|---|---|
|
[...]/parameters
Description
Example
Request
A JSON representation of the fields to update, including their values.
To keep updating simple, you only have to list the fields and values you want to update.
| Code Block |
|---|
{"showStatusMenu":true} |
or
| Code Block | ||
|---|---|---|
| ||
{"showStatusMenu":true, "allowLocalItems":false} |
Response
Returns the full JSON representation of the updated parameters.
| language | json |
|---|
JSON examples
The following are full JSON examples of the different parameters with default values.
Checklist parameters
| Code Block |
|---|
{ "version": 5, |
"discretionaryOptionIds": [], |
"statusCsv": "notApplicable, N/A, Default, Complete, Keep\r\ninProgress, In Progress, Current, Incomplete, Remove\r\nblocked, Blocked, Error, Incomplete, Remove", |
"showStatusMenu": false, |
"allowLocalItems": true, |
"allowMandatory": true, |
"lockOnResolution": true, "canConvertToIssue": true, " |
canBulkEdit": true, "canBulkComplete": true, "issueLinkType": null, "canAssignUsers": false, |
"canSetDueDate": false, |
"canSetPriority": false, |
"enableAdvancedMarkdown": false, |
"enableExternalAssetLinking": false, |
"enableHeaderItems": true, |
"enableHeaderItemCollapsing": true, "showHeaderItemSummaries": true, "collapseHeaderItemsByDefault": false, |
" |
defaultMandatoryState": true, |
" |
limitChecklistWidth": true, |
"showProgressHeaderInReadOnlyView": true, |
"showProgressHeaderInEditView": true, |
"strikeThrough": true, |
"showMore": false, |
"showMoreCount": 0, |
"alwaysShowEmptyChecklist": true, |
"alwaysShowUncheckedChecklist": true, "hideUncheckedInReadonlyView": false, "issueViewDisplayMode": "CustomField", |
"summarySource": "AllItems", |
"bannerParameters": { |
"completedLabel": "", |
"allMandatoryLabel": "", |
"incompleteLabel": "", |
"emptyLabel": "", |
|
"type": "Progression", |
"appearance": "Normal" |
}, |
"assigneeDisplay": "Avatar", "descriptionDisplay": "LinkUnderItem", "compactView": false, "reporterCanEdit": true, |
"allCanComplete": true, |
"limitEditionWithRoles": false, |
"editRoleIds": [], "canImportTemplateIntoChecklist": true, "canCreateTemplateFromChecklist": true, "createTemplateFromChecklistRoleIds": [], "useConfluenceRenderer": true |
} |
Checklist proxy parameters
| Code Block |
|---|
{ "version":5, "type":"Banner", "summarySource":"AllItems" || "MandatoryItems", "banner":{ "completedLabel":"", "allMandatoryLabel":"", "incompleteLabel":"", "emptyLabel":"", "type":"Progression", "appearance":"Subtle", " |
prefix": |
"Checkbox", " |
customPrefix": |
"" }, "progressBarParameters":null, "onlyShowUnchecked":false } |
Checklist proxy for customer portal parameters
| Code Block |
|---|
{ |
"version":5, " |
proxiedFieldConfigId": |
null, " |
showOnCreateScreen":true, |
"showOnViewScreen":true
} |
APIs
Get parameters
| Status | ||||
|---|---|---|---|---|
|
[...]/parameters
| Description | Example |
|---|---|---|
Response | Returns the full JSON representation of the requested parameters. |
|
Update parameters
| Status | ||||
|---|---|---|---|---|
|
[...]/parameters
| Description | Example | ||||
|---|---|---|---|---|---|---|
Request | A JSON representation of the fields to be updated, including their values. You only have to list the fields and values you want to update. |
or
| ||||
Response | Returns the full JSON representation of the updated parameters. |
|
Exceptions
For the list of potential exceptions, see https://okapya.atlassian.net/wiki/spaces/CHKDOC5/pages/2940666327/Exceptions+for+configuration+REST+APIs#Parameter-exceptions.
| Status | ||
|---|---|---|
|