Creates a future sprint. Sprint name and origin board id are required. Start date, end date, and goal are optional. Note that the sprint name is trimmed. Also, when starting sprints from the UI, the "endDate" set through this call is ignored and instead the last sprint's duration is used to fill the form.

Data Security Policy: Exempt from app access rules

Scopes

OAuth 2.0 scopes required:

write:sprint:jira-software

Connect app scope required: WRITE

Request

Request bodyapplication/json

endDate

string

goal

string

name

string

originBoardId

integer

startDate

string

Responses

Created sprint

application/json

any

POST/rest/agile/1.0/sprint

Forge

curl

Node.js

Java

Python

PHP

// This sample uses Atlassian Forge
// https://developer.atlassian.com/platform/forge/
import { requestJira } from "@forge/bridge";

var bodyData = `{
  "endDate": "2015-04-20T01:22:00.000+10:00",
  "goal": "sprint 1 goal",
  "name": "sprint 1",
  "originBoardId": 5,
  "startDate": "2015-04-11T15:22:00.000+10:00"
}`;

const response = await requestJira(`/rest/agile/1.0/sprint`, {
  method: 'POST',
  headers: {
    'Accept': 'application/json',
    'Content-Type': 'application/json'
  },
  body: bodyData
});

console.log(`Response: ${response.status} ${response.statusText}`);
console.log(await response.json());

201Response

{
  "id": 37,
  "self": "https://your-domain.atlassian.net/rest/agile/1.0/sprint/23",
  "state": "future",
  "name": "sprint 1",
  "startDate": "2015-04-11T15:22:00.000+10:00",
  "endDate": "2015-04-20T01:22:00.000+10:00",
  "originBoardId": 5,
  "goal": "sprint 1 goal"
}

GET

Get sprint

Returns the sprint for a given sprint ID. The sprint will only be returned if the user can view the board that the sprint was created on, or view at least one of the issues in the sprint.

Data Security Policy: Exempt from app access rules

Scopes

OAuth 2.0 scopes required:

read:sprint:jira-software

Connect app scope required: READ

Request

Path parameters

sprintId

integer

Required

Responses

Returns the requested sprint.

application/json

any

GET/rest/agile/1.0/sprint/{sprintId}

Forge

curl

Node.js

Java

Python

PHP

// This sample uses Atlassian Forge
// https://developer.atlassian.com/platform/forge/
import { requestJira } from "@forge/bridge";

const response = await requestJira(`/rest/agile/1.0/sprint/{sprintId}`, {
  headers: {
    'Accept': 'application/json'
  }
});

console.log(`Response: ${response.status} ${response.statusText}`);
console.log(await response.json());

200Response

{
  "id": 37,
  "self": "https://your-domain.atlassian.net/rest/agile/1.0/sprint/23",
  "state": "closed",
  "name": "sprint 1",
  "startDate": "2015-04-11T15:22:00.000+10:00",
  "endDate": "2015-04-20T01:22:00.000+10:00",
  "completeDate": "2015-04-20T11:04:00.000+10:00",
  "originBoardId": 5,
  "goal": "sprint 1 goal"
}

PUT

Update sprint

Performs a full update of a sprint. A full update means that the result will be exactly the same as the request body. Any fields not present in the request JSON will be set to null.

Notes:

For closed sprints, only the name and goal can be updated; changes to other fields will be ignored.
A sprint can be started by updating the state to 'active'. This requires the sprint to be in the 'future' state and have a startDate and endDate set.
A sprint can be completed by updating the state to 'closed'. This action requires the sprint to be in the 'active' state. This sets the completeDate to the time of the request.
Other changes to state are not allowed.
The completeDate field cannot be updated manually.

Data Security Policy: Exempt from app access rules

Scopes

OAuth 2.0 scopes required:

write:sprint:jira-software

Connect app scope required: WRITE

Request

Path parameters

sprintId

integer

Required

Request bodyapplication/json

completeDate

string

createdDate

string

endDate

string

goal

string

integer

name

string

originBoardId

integer

self

string

startDate

string

state

string

Responses

Updated sprint

application/json

any

PUT/rest/agile/1.0/sprint/{sprintId}

Forge

curl

Node.js

Java

Python

PHP

// This sample uses Atlassian Forge
// https://developer.atlassian.com/platform/forge/
import { requestJira } from "@forge/bridge";

var bodyData = `{
  "completeDate": "2015-04-20T11:11:28.008+10:00",
  "endDate": "2015-04-16T14:01:00.000+10:00",
  "goal": "sprint 1 goal",
  "name": "sprint 1",
  "startDate": "2015-04-11T15:36:00.000+10:00",
  "state": "closed"
}`;

const response = await requestJira(`/rest/agile/1.0/sprint/{sprintId}`, {
  method: 'PUT',
  headers: {
    'Accept': 'application/json',
    'Content-Type': 'application/json'
  },
  body: bodyData
});

console.log(`Response: ${response.status} ${response.statusText}`);
console.log(await response.json());

200Response

{
  "id": 37,
  "self": "https://your-domain.atlassian.net/rest/agile/1.0/sprint/23",
  "state": "closed",
  "name": "sprint 1",
  "startDate": "2015-04-11T15:22:00.000+10:00",
  "endDate": "2015-04-20T01:22:00.000+10:00",
  "completeDate": "2015-04-20T11:04:00.000+10:00",
  "originBoardId": 5,
  "goal": "sprint 1 goal"
}

POST

Partially update sprint

Performs a partial update of a sprint. A partial update means that fields not present in the request JSON will not be updated.

Notes:

For closed sprints, only the name and goal can be updated; changes to other fields will be ignored.
A sprint can be started by updating the state to 'active'. This requires the sprint to be in the 'future' state and have a startDate and endDate set.
A sprint can be completed by updating the state to 'closed'. This action requires the sprint to be in the 'active' state. This sets the completeDate to the time of the request.
Other changes to state are not allowed.
The completeDate field cannot be updated manually.

Data Security Policy: Exempt from app access rules

Scopes

OAuth 2.0 scopes required:

write:sprint:jira-software

Connect app scope required: WRITE

Request

Path parameters

sprintId

integer

Required

Request bodyapplication/json

completeDate

string

createdDate

string

endDate

string

goal

string

integer

name

string

originBoardId

integer

self

string

startDate

string

state

string

Responses

Updated sprint

application/json

any

POST/rest/agile/1.0/sprint/{sprintId}

Forge

curl

Node.js

Java

Python

PHP

// This sample uses Atlassian Forge
// https://developer.atlassian.com/platform/forge/
import { requestJira } from "@forge/bridge";

var bodyData = `{
  "name": "new name"
}`;

const response = await requestJira(`/rest/agile/1.0/sprint/{sprintId}`, {
  method: 'POST',
  headers: {
    'Accept': 'application/json',
    'Content-Type': 'application/json'
  },
  body: bodyData
});

console.log(`Response: ${response.status} ${response.statusText}`);
console.log(await response.json());

200Response

{
  "id": 37,
  "self": "https://your-domain.atlassian.net/rest/agile/1.0/sprint/23",
  "state": "closed",
  "name": "sprint 1",
  "startDate": "2015-04-11T15:22:00.000+10:00",
  "endDate": "2015-04-20T01:22:00.000+10:00",
  "completeDate": "2015-04-20T11:04:00.000+10:00",
  "originBoardId": 5,
  "goal": "sprint 1 goal"
}

DEL

Delete sprint

Deletes a sprint. Once a sprint is deleted, all open issues in the sprint will be moved to the backlog.

Data Security Policy: Not exempt from app access rules

Scopes

OAuth 2.0 scopes required:

delete:sprint:jira-software

Connect app scope required: DELETE

Request

Path parameters

sprintId

integer

Required

Responses

Returned if the sprint was deleted successfully

DEL/rest/agile/1.0/sprint/{sprintId}

Forge

curl

Node.js

Java

Python

PHP

// This sample uses Atlassian Forge
// https://developer.atlassian.com/platform/forge/
import { requestJira } from "@forge/bridge";

const response = await requestJira(`/rest/agile/1.0/sprint/{sprintId}`, {
  method: 'DELETE'
});

console.log(`Response: ${response.status} ${response.statusText}`);
console.log(await response.text());

GET

Get issues for sprintDeprecated

Returns all issues in a sprint, for a given sprint ID. This only includes issues that the user has permission to view. By default, the returned issues are ordered by rank.

Data Security Policy: Not exempt from app access rules

Scopes

OAuth 2.0 scopes required:

read:sprint:jira-software

, read:issue-details:jira, read:jql:jira

Connect app scope required: READ

Request

Path parameters

sprintId

integer

Required

Query parameters

startAt

integer

maxResults

integer

jql

string

validateQuery

boolean

fields

array<object>

expand

string

Responses

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

application/json

any

GET/rest/agile/1.0/sprint/{sprintId}/issue

Forge

curl

Node.js

Java

Python

PHP

// This sample uses Atlassian Forge
// https://developer.atlassian.com/platform/forge/
import { requestJira } from "@forge/bridge";

const response = await requestJira(`/rest/agile/1.0/sprint/{sprintId}/issue`, {
  headers: {
    'Accept': 'application/json'
  }
});

console.log(`Response: ${response.status} ${response.statusText}`);
console.log(await response.json());

200Response

{
  "expand": "",
  "fields": {
    "flagged": true,
    "sprint": {
      "id": 37,
      "self": "https://your-domain.atlassian.net/rest/agile/1.0/sprint/13",
      "state": "future",
      "name": "sprint 2",
      "goal": "sprint 2 goal"
    },
    "closedSprints": [
      {
        "id": 37,
        "self": "https://your-domain.atlassian.net/rest/agile/1.0/sprint/23",
        "state": "closed",
        "name": "sprint 1",
        "startDate": "2015-04-11T15:22:00.000+10:00",
        "endDate": "2015-04-20T01:22:00.000+10:00",
        "completeDate": "2015-04-20T11:04:00.000+10:00",
        "goal": "sprint 1 goal"
      }
    ],
    "description": "example bug report",
    "project": {
      "avatarUrls": {
        "16x16": "https://your-domain.atlassian.net/secure/projectavatar?size=xsmall&pid=10000",
        "24x24": "https://your-domain.atlassian.net/secure/projectavatar?size=small&pid=10000",
        "32x32": "https://your-domain.atlassian.net/secure/projectavatar?size=medium&pid=10000",
        "48x48": "https://your-domain.atlassian.net/secure/projectavatar?size=large&pid=10000"
      },
      "id": "10000",
      "insight": {
        "lastIssueUpdateTime": "2021-04-22T05:37:05.000+0000",
        "totalIssueCount": 100
      },
      "key": "EX",
      "name": "Example",
      "projectCategory": {
        "description": "First Project Category",
        "id": "10000",
        "name": "FIRST",
        "self": "https://your-domain.atlassian.net/rest/api/3/projectCategory/10000"
      },
      "self": "https://your-domain.atlassian.net/rest/api/3/project/EX",
      "simplified": false,
      "style": "classic"
    },
    "comment": [
      {
        "author": {
          "accountId": "5b10a2844c20165700ede21g",
          "active": false,
          "displayName": "Mia Krystof",
          "self": "https://your-domain.atlassian.net/rest/api/3/user?accountId=5b10a2844c20165700ede21g"
        },
        "body": {
          "type": "doc",
          "version": 1,
          "content": [
            {
              "type": "paragraph",
              "content": [
                {
                  "type": "text",
                  "text": "Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque eget venenatis elit. Duis eu justo eget augue iaculis fermentum. Sed semper quam laoreet nisi egestas at posuere augue semper."
                }
              ]
            }
          ]
        },
        "created": "2021-01-17T12:34:00.000+0000",
        "id": "10000",
        "self": "https://your-domain.atlassian.net/rest/api/3/issue/10010/comment/10000",
        "updateAuthor": {
          "accountId": "5b10a2844c20165700ede21g",
          "active": false,
          "displayName": "Mia Krystof",
          "self": "https://your-domain.atlassian.net/rest/api/3/user?accountId=5b10a2844c20165700ede21g"
        },
        "updated": "2021-01-18T23:45:00.000+0000",
        "visibility": {
          "identifier": "Administrators",
          "type": "role",
          "value": "Administrators"
        }
      }
    ],
    "epic": {
      "id": 37,
      "self": "https://your-domain.atlassian.net/rest/agile/1.0/epic/23",
      "name": "epic 1",
      "summary": "epic 1 summary",
      "color": {
        "key": "color_4"
      },
      "done": true
    },
    "worklog": [
      {
        "author": {
          "accountId": "5b10a2844c20165700ede21g",
          "active": false,
          "displayName": "Mia Krystof",
          "self": "https://your-domain.atlassian.net/rest/api/3/user?accountId=5b10a2844c20165700ede21g"
        },
        "comment": {
          "type": "doc",
          "version": 1,
          "content": [
            {
              "type": "paragraph",
              "content": [
                {
                  "type": "text",
                  "text": "I did some work here."
                }
              ]
            }
          ]
        },
        "id": "100028",
        "issueId": "10002",
        "self": "https://your-domain.atlassian.net/rest/api/3/issue/10010/worklog/10000",
        "started": "2021-01-17T12:34:00.000+0000",
        "timeSpent": "3h 20m",
        "timeSpentSeconds": 12000,
        "updateAuthor": {
          "accountId": "5b10a2844c20165700ede21g",
          "active": false,
          "displayName": "Mia Krystof",
          "self": "https://your-domain.atlassian.net/rest/api/3/user?accountId=5b10a2844c20165700ede21g"
        },
        "updated": "2021-01-18T23:45:00.000+0000",
        "visibility": {
          "identifier": "276f955c-63d7-42c8-9520-92d01dca0625",
          "type": "group",
          "value": "jira-developers"
        }
      }
    ],
    "updated": 1,
    "timetracking": {
      "originalEstimate": "10m",
      "originalEstimateSeconds": 600,
      "remainingEstimate": "3m",
      "remainingEstimateSeconds": 200,
      "timeSpent": "6m",
      "timeSpentSeconds": 400
    }
  },
  "id": "10001",
  "key": "HSP-1",
  "self": "https://your-domain.atlassian.net/rest/agile/1.0/board/92/issue/10001"
}

POST

Move issues to sprint and rank

Moves issues to a sprint, for a given sprint ID. Issues can only be moved to open or active sprints. The maximum number of issues that can be moved in one operation is 50.

Data Security Policy: Exempt from app access rules

Scopes

OAuth 2.0 scopes required:

write:sprint:jira-software

Connect app scope required: WRITE

Request

Path parameters

sprintId

integer

Required

Request bodyapplication/json

issues

array<string>

rankAfterIssue

string

rankBeforeIssue

string

rankCustomFieldId

integer

Responses

Empty response is returned if operation was successful.

POST/rest/agile/1.0/sprint/{sprintId}/issue

Forge

curl

Node.js

Java

Python

PHP

// This sample uses Atlassian Forge
// https://developer.atlassian.com/platform/forge/
import { requestJira } from "@forge/bridge";

var bodyData = `{
  "issues": [
    "PR-1",
    "10001",
    "PR-3"
  ],
  "rankBeforeIssue": "PR-4",
  "rankCustomFieldId": 10521
}`;

const response = await requestJira(`/rest/agile/1.0/sprint/{sprintId}/issue`, {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json'
  },
  body: bodyData
});

console.log(`Response: ${response.status} ${response.statusText}`);
console.log(await response.text());

GET

Get issues for sprint (enhanced)

Returns all issues in a sprint, for a given sprint ID. Result pagination is token based, using nextPageToken and maxResults. This only includes issues that the user has permission to view. Issues returned from this resource include Software project fields, like sprint, closedSprints, flagged, and epic. By default, the returned issues are ordered by rank.

Data Security Policy: Not exempt from app access rules

Scopes

OAuth 2.0 scopes required:

read:sprint:jira-software

, read:issue-details:jira, read:jql:jira

Connect app scope required: READ

Request

Path parameters

sprintId

integer

Required

Query parameters

nextPageToken

string

maxResults

integer

reconcileIssues

array<integer>

jql

string

validateQuery

boolean

fields

array<object>

expand

string

Responses

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

application/json

SoftwareIssueResults

The result of an issue search in Jira Software APIs.

GET/rest/software/1.0/sprint/{sprintId}/issue

Forge

curl

Node.js

Java

Python

PHP

// This sample uses Atlassian Forge
// https://developer.atlassian.com/platform/forge/
import { requestJira } from "@forge/bridge";

const response = await requestJira(`/rest/software/1.0/sprint/{sprintId}/issue`, {
  headers: {
    'Accept': 'application/json'
  }
});

console.log(`Response: ${response.status} ${response.statusText}`);
console.log(await response.json());

200Response

{
  "expand": "names,schema",
  "isLast": true,
  "issues": [
    {
      "expand": "",
      "fields": {
        "watcher": {
          "isWatching": false,
          "self": "https://your-domain.atlassian.net/rest/api/3/issue/EX-1/watchers",
          "watchCount": 1
        },
        "attachment": [
          {
            "author": {
              "accountId": "5b10a2844c20165700ede21g",
              "accountType": "atlassian",
              "active": false,
              "avatarUrls": {
                "16x16": "https://avatar-management--avatars.server-location.prod.public.atl-paas.net/initials/MK-5.png?size=16&s=16",
                "24x24": "https://avatar-management--avatars.server-location.prod.public.atl-paas.net/initials/MK-5.png?size=24&s=24",
                "32x32": "https://avatar-management--avatars.server-location.prod.public.atl-paas.net/initials/MK-5.png?size=32&s=32",
                "48x48": "https://avatar-management--avatars.server-location.prod.public.atl-paas.net/initials/MK-5.png?size=48&s=48"
              },
              "displayName": "Mia Krystof",
              "key": "",
              "name": "",
              "self": "https://your-domain.atlassian.net/rest/api/3/user?accountId=5b10a2844c20165700ede21g"
            },
            "content": "https://your-domain.atlassian.net/jira/rest/api/3/attachment/content/10001",
            "created": "2023-06-24T19:24:50.000+0000",
            "filename": "debuglog.txt",
            "id": 10001,
            "mimeType": "text/plain",
            "self": "https://your-domain.atlassian.net/rest/api/2/attachments/10001",
            "size": 2460
          }
        ],
        "sub-tasks": [
          {
            "id": "10000",
            "outwardIssue": {
              "fields": {
                "status": {
                  "iconUrl": "https://your-domain.atlassian.net/images/icons/statuses/open.png",
                  "name": "Open"
                }
              },
              "id": "10003",
              "key": "ED-2",
              "self": "https://your-domain.atlassian.net/rest/api/3/issue/ED-2"
            },
            "type": {
              "id": "10000",
              "inward": "Parent",
              "name": "",
              "outward": "Sub-task"
            }
          }
        ],
        "description": "Main order flow broken",
        "project": {
          "avatarUrls": {
            "16x16": "https://your-domain.atlassian.net/secure/projectavatar?size=xsmall&pid=10000",
            "24x24": "https://your-domain.atlassian.net/secure/projectavatar?size=small&pid=10000",
            "32x32": "https://your-domain.atlassian.net/secure/projectavatar?size=medium&pid=10000",
            "48x48": "https://your-domain.atlassian.net/secure/projectavatar?size=large&pid=10000"
          },
          "id": "10000",
          "insight": {
            "lastIssueUpdateTime": "2021-04-22T05:37:05.000+0000",
            "totalIssueCount": 100
          },
          "key": "EX",
          "name": "Example",
          "projectCategory": {
            "description": "First Project Category",
            "id": "10000",
            "name": "FIRST",
            "self": "https://your-domain.atlassian.net/rest/api/3/projectCategory/10000"
          },
          "self": "https://your-domain.atlassian.net/rest/api/3/project/EX",
          "simplified": false,
          "style": "classic"
        },
        "comment": [
          {
            "author": {
              "accountId": "5b10a2844c20165700ede21g",
              "active": false,
              "displayName": "Mia Krystof",
              "self": "https://your-domain.atlassian.net/rest/api/3/user?accountId=5b10a2844c20165700ede21g"
            },
            "body": "Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque eget venenatis elit. Duis eu justo eget augue iaculis fermentum. Sed semper quam laoreet nisi egestas at posuere augue semper.",
            "created": "2021-01-17T12:34:00.000+0000",
            "id": "10000",
            "self": "https://your-domain.atlassian.net/rest/api/3/issue/10010/comment/10000",
            "updateAuthor": {
              "accountId": "5b10a2844c20165700ede21g",
              "active": false,
              "displayName": "Mia Krystof",
              "self": "https://your-domain.atlassian.net/rest/api/3/user?accountId=5b10a2844c20165700ede21g"
            },
            "updated": "2021-01-18T23:45:00.000+0000",
            "visibility": {
              "identifier": "Administrators",
              "type": "role",
              "value": "Administrators"
            }
          }
        ],
        "issuelinks": [
          {
            "id": "10001",
            "outwardIssue": {
              "fields": {
                "status": {
                  "iconUrl": "https://your-domain.atlassian.net/images/icons/statuses/open.png",
                  "name": "Open"
                }
              },
              "id": "10004L",
              "key": "PR-2",
              "self": "https://your-domain.atlassian.net/rest/api/3/issue/PR-2"
            },
            "type": {
              "id": "10000",
              "inward": "depends on",
              "name": "Dependent",
              "outward": "is depended by"
            }
          },
          {
            "id": "10002",
            "inwardIssue": {
              "fields": {
                "status": {
                  "iconUrl": "https://your-domain.atlassian.net/images/icons/statuses/open.png",
                  "name": "Open"
                }
              },
              "id": "10004",
              "key": "PR-3",
              "self": "https://your-domain.atlassian.net/rest/api/3/issue/PR-3"
            },
            "type": {
              "id": "10000",
              "inward": "depends on",
              "name": "Dependent",
              "outward": "is depended by"
            }
          }
        ],
        "worklog": [
          {
            "author": {
              "accountId": "5b10a2844c20165700ede21g",
              "active": false,
              "displayName": "Mia Krystof",
              "self": "https://your-domain.atlassian.net/rest/api/3/user?accountId=5b10a2844c20165700ede21g"
            },
            "comment": "I did some work here.",
            "id": "100028",
            "issueId": "10002",
            "self": "https://your-domain.atlassian.net/rest/api/3/issue/10010/worklog/10000",
            "started": "2021-01-17T12:34:00.000+0000",
            "timeSpent": "3h 20m",
            "timeSpentSeconds": 12000,
            "updateAuthor": {
              "accountId": "5b10a2844c20165700ede21g",
              "active": false,
              "displayName": "Mia Krystof",
              "self": "https://your-domain.atlassian.net/rest/api/3/user?accountId=5b10a2844c20165700ede21g"
            },
            "updated": "2021-01-18T23:45:00.000+0000",
            "visibility": {
              "identifier": "276f955c-63d7-42c8-9520-92d01dca0625",
              "type": "group",
              "value": "jira-developers"
            }
          }
        ],
        "updated": 1,
        "timetracking": {
          "originalEstimate": "10m",
          "originalEstimateSeconds": 600,
          "remainingEstimate": "3m",
          "remainingEstimateSeconds": 200,
          "timeSpent": "6m",
          "timeSpentSeconds": 400
        }
      },
      "id": "10002",
      "key": "ED-1",
      "self": "https://your-domain.atlassian.net/rest/api/3/issue/10002"
    }
  ]
}

GET

Get properties keys

Returns the keys of all properties for the sprint identified by the id. The user who retrieves the property keys is required to have permissions to view the sprint.

Data Security Policy: Exempt from app access rules

Scopes

OAuth 2.0 scopes required:

read:sprint:jira-software

Connect app scope required: READ

Request

Path parameters

sprintId

string

Required

Responses

Returned if the sprint with given id exists.

application/json

any

GET/rest/agile/1.0/sprint/{sprintId}/properties

Forge

curl

Node.js

Java

Python

PHP

// This sample uses Atlassian Forge
// https://developer.atlassian.com/platform/forge/
import { requestJira } from "@forge/bridge";

const response = await requestJira(`/rest/agile/1.0/sprint/{sprintId}/properties`, {
  headers: {
    'Accept': 'application/json'
  }
});

console.log(`Response: ${response.status} ${response.statusText}`);
console.log(await response.json());

200Response

{
  "keys": [
    {
      "key": "issue.support",
      "self": "https://your-domain.atlassian.net/rest/api/3/issue/EX-2/properties/issue.support"
    }
  ]
}

GET

Get property

Returns the value of the property with a given key from the sprint identified by the provided id. The user who retrieves the property is required to have permissions to view the sprint.

Data Security Policy: Not exempt from app access rules

Scopes

OAuth 2.0 scopes required:

read:sprint:jira-software

Connect app scope required: READ

Request

Path parameters

sprintId

string

Required

propertyKey

string

Required

Responses

Returned if the sprint exists and the property was found.

application/json

any

GET/rest/agile/1.0/sprint/{sprintId}/properties/{propertyKey}

Forge

curl

Node.js

Java

Python

PHP

// This sample uses Atlassian Forge
// https://developer.atlassian.com/platform/forge/
import { requestJira } from "@forge/bridge";

const response = await requestJira(`/rest/agile/1.0/sprint/{sprintId}/properties/{propertyKey}`, {
  headers: {
    'Accept': 'application/json'
  }
});

console.log(`Response: ${response.status} ${response.statusText}`);
console.log(await response.json());

200Response

{
  "key": "issue.support",
  "value": {
    "system.conversation.id": "b1bf38be-5e94-4b40-a3b8-9278735ee1e6",
    "system.support.time": "1m"
  }
}

PUT

Set property

Sets the value of the specified sprint's property. You can use this resource to store a custom data against the sprint identified by the id. The user who stores the data is required to have permissions to modify the sprint.

Data Security Policy: Exempt from app access rules

Scopes

OAuth 2.0 scopes required:

write:sprint:jira-software

Connect app scope required: WRITE

Request

Path parameters

sprintId

string

Required

propertyKey

string

Required

Request bodyapplication/json

The value of the property. The value has to be a valid, non-empty JSON value. The maximum length of the property value is 32768 bytes.

any

Responses

Returned if the sprint property is successfully updated.

application/json

any

PUT/rest/agile/1.0/sprint/{sprintId}/properties/{propertyKey}

Forge

curl

Node.js

Java

Python

PHP

// This sample uses Atlassian Forge
// https://developer.atlassian.com/platform/forge/
import { requestJira } from "@forge/bridge";

var bodyData = `{}`;

const response = await requestJira(`/rest/agile/1.0/sprint/{sprintId}/properties/{propertyKey}`, {
  method: 'PUT',
  headers: {
    'Accept': 'application/json',
    'Content-Type': 'application/json'
  },
  body: bodyData
});

console.log(`Response: ${response.status} ${response.statusText}`);
console.log(await response.json());

DEL

Delete property

Removes the property from the sprint identified by the id. Ths user removing the property is required to have permissions to modify the sprint.

Data Security Policy: Exempt from app access rules

Scopes

OAuth 2.0 scopes required:

delete:sprint:jira-software

Connect app scope required: DELETE

Request

Path parameters

sprintId

string

Required

propertyKey

string

Required

Responses

Returned if the sprint property was removed successfully.

DEL/rest/agile/1.0/sprint/{sprintId}/properties/{propertyKey}

Forge

curl

Node.js

Java

Python

PHP

// This sample uses Atlassian Forge
// https://developer.atlassian.com/platform/forge/
import { requestJira } from "@forge/bridge";

const response = await requestJira(`/rest/agile/1.0/sprint/{sprintId}/properties/{propertyKey}`, {
  method: 'DELETE'
});

console.log(`Response: ${response.status} ${response.statusText}`);
console.log(await response.text());

POST

Swap sprint

Swap the position of the sprint with the second sprint.

Data Security Policy: Exempt from app access rules

Scopes

OAuth 2.0 scopes required:

write:sprint:jira-software

Connect app scope required: WRITE

Request

Path parameters

sprintId

integer

Required

Request bodyapplication/json

sprintToSwapWith

integer

Responses

Returned if the sprint swap was performed successfully

POST/rest/agile/1.0/sprint/{sprintId}/swap

Forge

curl

Node.js

Java

Python

PHP

// This sample uses Atlassian Forge
// https://developer.atlassian.com/platform/forge/
import { requestJira } from "@forge/bridge";

var bodyData = `{
  "sprintToSwapWith": 3
}`;

const response = await requestJira(`/rest/agile/1.0/sprint/{sprintId}/swap`, {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json'
  },
  body: bodyData
});

console.log(`Response: ${response.status} ${response.statusText}`);
console.log(await response.text());