Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


Info

You can can query/update Checklists by using the REST APIs from v4 and above. To update the checklist, you must use the Edit Issue REST API.

JSON Schema Information

Checklist Schema

The schema for a Checklist is an array of JSON Checklist item

Code Block
languageruby
titlechecklist
[checklist-item, ...]

Sample Request Payload

Code Block
languageruby
titlechecklist-item
{
  "update": {
    "customfield_10101": [
      {
        "set": [
          {
            "name": "Code Review",
            "checked": false,
            "mandatory": true,
            "option": true,
            "id": 10003
          },
          {
            "name": "Reviewed by Architect",
            "checked": false,
            "mandatory": true,
            "option": false,
            "id": 1,
            "status": {
              "id": "inProgress"
            }
          }
        ]
      }
    ]
  }
}

Request Parameter Description

ParameterSub-parameterDescriptionData TypeAccessibility
name
Indicates the name of the Checklist item.Stringread-write
idIndicates the ID for the Checklist item. It is not necessary to set the item ID as it is automatically created. If you do set an ID, ensure that it is unique across the entire Checklist.Numberread-write
rankIndicates the rank of the item in the Checklist. Rank starts from 0. While updating the Checklist, the rank value is ignored and the order used is the order in which they are set in the array of Checklist items.Numberread
checkedIndicates if the item is checked.Booleanread-write
option

Indicates if the item is an option. It this value is set to true, the ID of the item must be set to a valid option ID. Options cannot be created through this REST interface.

If the option value is set to true and ID is not provided, the option value is ignored.

Booleanread-write
mandatoryIndicates if the item is a mandatory one.Booleanread-write
status

Indicates an object containing the status information.

Objectread-write
nameIndicates the name for the status.Stringread
idIndicates the status ID.Stringread-write


Filter by label (Content by label)
showLabelsfalse
showSpacefalse
sorttitle
cqllabel in ("statusenabling_checklist_configurationsearcher","globalvalidating_item_templatechecklist","configuremodifying_checklist_workflow","generalconfiguring_preferenceschecklist","validatedisplaying_checklist","agileadd_checklist_cardfield") and type = "page" and space = currentSpace()


Page Properties
hiddentrue


Related issues