Updates the list of issues associated with the commit to the specified repository.
- Jira administrators
- Jira user who has all of the following:
- View/browse permissions to the project;
- View Development Tools permissions to the same project; and
- The repository is associated to the project.
url
{JiraBaseURL}/rest/gitplugin/1.0/repository/{repoId}/commits/{commitHash}/issues
method
POST
parameters
| Field | Description |
|---|---|
| jira-host | String. Required.
This is the default url location where you host your Jira. For example: |
| repoId | Integer. Required.
Substitute Use the Repository REST API to obtain the connected repositories’ IDs. Example: In the case of the above example, the commit association(s) of the specified commit hash and repository will be updated using the parameters specified in the JSON request body. See changeStrs parameter. |
| commitHash | String. Required.
This is the hash of the commit that you want the results from. Example: |
changeStrs extension
The request body is a JSON structure supporting the following parameters:
| Parameter | Description |
|---|---|
| a | Adds a new issue key to associate to the commit. |
| d | Disassociate the specified issue key from the commit. |
Example request:
{
"changeStrs": ["d:TEST-5", "a:TEST-6", "a:TEST-7"]
}response
Returns the result for the example below.
Example for POST queries:
POST /jira/rest/gitplugin/1.0/repository/1/commits/e012663bf9bd968388faa510cb5b310e4798c512/issues HTTP/1.1
Host: localhost:2990
Content-Type: application/json
{
"changeStrs": ["d:TEST-5", "a:TEST-6", "a:TEST-7"]
}The changeStrs modifier with the specified parameters will give the following result:
Removes association of TEST-5; and
associates TEST-6 and TEST-7 to the same commit in repo1 and repo2.
Commits REST APIs
Update Commit Issue Changes (this page)
