Smart Checklist REST API v1.0
- Pavel Pavlovsky (Unlicensed)
- Mariya Solovey
- Olena Brazhko
- Oleksandra Kravets
Welcome to the Smart Checklist for Jira Server/Data Center platform REST API reference. You can use this REST API to develop integrations between Smart Checklist, Jira, and other 3rd party applications. This page documents the REST resources available in Smart Checklist for the Jira Server/Data Center platform, along with expected HTTP response codes and sample requests.
Looking for simpler integration using Jira REST API and/or 3rd party add-ons? Follow the links below:
- 1 Authentication
- 2 Resources
- 2.1 /rest/railsware/1.0/checklist
- 2.1.1 Get checklists GET /rest/railsware/1.0/checklist
- 2.1.1.1 Query parameters
- 2.1.1.2 Responses
- 2.1.2 Update checklist PUT /rest/railsware/1.0/checklist/{checklistId}
- 2.1.2.1 Path parameters
- 2.1.2.2 Body parameters (application/json) - list of JSON objects:
- 2.1.2.3 Example
- 2.1.2.4 Responses
- 2.1.3 Delete checklist items DELETE /rest/railsware/1.0/checklist/{checklistId}
- 2.1.3.1 Path parameters
- 2.1.3.2 Responses
- 2.1.4 Create/Update checklist from string PUT /rest/railsware/1.0/checklist/{checklistId}/item
- 2.1.4.1 Path parameters
- 2.1.4.2 Body parameters (application/json)
- 2.1.4.3 Example
- 2.1.4.4 Responses
- 2.1.1 Get checklists GET /rest/railsware/1.0/checklist
- 2.2 /rest/railsware/1.0/template/
- 2.2.1 Get templates list GET /rest/railsware/1.0/template/global
- 2.2.1.1 Query parameters
- 2.2.1.2 Responses
- 2.2.2 Get project templates GET /rest/railsware/1.0/template/project/{projectId}
- 2.2.2.1 Path parameters
- 2.2.2.2 Query parameters
- 2.2.2.3 Responses
- 2.2.3 Get template by ID GET /rest/railsware/1.0/template/{templateId}
- 2.2.3.1 Path parameters
- 2.2.3.2 Responses
- 2.2.4 Get templates fields GET /rest/railsware/1.0/template/fields
- 2.2.4.1 Supported options per field types are:
- 2.2.4.2 Responses
- 2.2.5 Create template POST /rest/railsware/1.0/template
- 2.2.5.1 Body parameters (application/json)
- 2.2.5.2 Request body example:
- 2.2.5.3 Responses
- 2.2.6 Update template PUT /rest/railsware/1.0/template/{id}
- 2.2.6.1 Path parameters
- 2.2.6.2 Body parameters (application/json)
- 2.2.6.3 Responses
- 2.2.7 Apply template to the issue POST /rest/railsware/1.0/checklist{checklistId}/template/{templateId}
- 2.2.7.1 Path parameters
- 2.2.7.2 Responses
- 2.2.8 Delete template DELETE /rest/railsware/1.0/template/{id}
- 2.2.8.1 Path parameters
- 2.2.8.2 Query parameters:
- 2.2.8.3 Responses
- 2.2.9 New Get Smart Checklist history GET /rest/railsware/1.0/history - available from v6.5.0
- 2.2.9.1 Query parameters:
- 2.2.9.2 Responses
- 2.2.10 New Run migration POST /rest/railsware/1.0/migration
- 2.2.10.1 Query parameters:
- 2.2.10.2 Example
- 2.2.10.3 Responses
- 2.2.1 Get templates list GET /rest/railsware/1.0/template/global
- 2.1 /rest/railsware/1.0/checklist
- 3 Resources based on permissions
Authentication
Use the same authentication that you use to authenticate to Jira applications on your instances.
Resources
/rest/railsware/1.0/checklist
Get checklists GET /rest/railsware/1.0/checklist
Retrieves an existing list of checklists for the given issue key
Query parameters
issueKey: string (required)
Responses
status 200 application/json Returns a list of all checklists associated with the provided issue key in JSON format
Example
{
"checklists": [
{
"checklistId": 829,
"issueId": 13657,
"mentionedUsers": {
"mariya": "mariya"
},
"items": [
{
"id": 26403,
"checklistId": 829,
"label": "INVEST",
"rank": 0,
"status": null,
"quotes": [],
"assignees": [],
"history": {
"id": 19902,
"itemId": 26403,
"checklistId": 829,
"type": "ITEM_CREATED",
"from": "",
"to": "",
"date": 1718634937972,
"user": "Admin Admin"
},
"mandatory": false,
"value": "## INVEST",
"level": 2,
"type": "HEADING",
"isCheckbox": false
},
{
"id": 26398,
"checklistId": 829,
"label": "**Independent.** The user story is self contained. @mariya ",
"rank": 1,
"status": {
"id": 1,
"rank": 0,
"statusState": "UNCHECKED",
"name": "TO DO",
"color": "GRAY",
"default": true
},
"quotes": [],
"assignees": [
{
"id": 518,
"userName": "mariya",
"displayName": "mariya"
}
],
"history": {
"id": 19904,
"itemId": 26398,
"checklistId": 829,
"type": "ITEM_UPDATED",
"from": "TO DO",
"to": "TO DO",
"date": 1718634945507,
"user": "Admin Admin"
},
"mandatory": false,
"value": "**Independent.** The user story is self contained. @mariya ",
"level": null,
"type": "item",
"isCheckbox": true
},
{
"id": 26399,
"checklistId": 829,
"label": "**Negotiable.** The details of the user story can be negotiated and refined, as the team gets a better understanding of the requirements.",
"rank": 2,
"status": {
"id": 1,
"rank": 0,
"statusState": "UNCHECKED",
"name": "TO DO",
"color": "GRAY",
"default": true
},
"quotes": [],
"assignees": [],
"history": {
"id": 19898,
"itemId": 26399,
"checklistId": 829,
"type": "ITEM_CREATED",
"from": "",
"to": "TO DO",
"date": 1718634937972,
"user": "Admin Admin"