Hi, I have a working automation that does the following: * On new version created * Create relevant issues and set the fix version as the trigger version * Create a new confluence page for a "Release Plan" I noticed on the release page however, I can add "related work" to this release. I want to update my automation to link the Confluence page so that it displays as "related work" on this trigger release. Is this possible to do? Thanks!

nav[aria-label="Primary Navigation"] { padding: 0; & ul { list-style: none; width: 100%; display: flex; flex-direction: row; justify-content: start; align-items: start; gap: 30px; padding: 0; & li { margin: 0; } & ul li { list-style: none; } } }

Jira Automation - Link/Create "Related Work" to Version

Luke Abel_q2xetn

Hi, I have a working automation that does the following:

On new version created
Create relevant issues and set the fix version as the trigger version
Create a new confluence page for a "Release Plan"

I noticed on the release page however, I can add "related work" to this release.

Screen Shot 2023-08-16 at 3.50.16 pm.png

I want to update my automation to link the Confluence page so that it displays as "related work" on this trigger release. Is this possible to do?

Thanks!

Accepted answers

Agraj Mangal

Hi @Luke Abel

I do not think there is a OOTB Automation action today that lets you `Add Related Work` to the release.

You can probably log a feature request for the same here

Alternatively If you can find a Jira REST API that lets you do this, then we can probably use the `Send Web Request` action after you create the confluence page to do this linking but I do not know if such a public API exists today.

Cheers,
Agraj

All comments

Agraj Mangal

Hi @Luke Abel

I do not think there is a OOTB Automation action today that lets you `Add Related Work` to the release.

You can probably log a feature request for the same here

Cheers,
Agraj

Luke Abel_q2xetn

Thanks for the response @Agraj Mangal!

Keane Yam

Hi Luke, I am in need of help to set up the automation rules that you have. Could you share your steps with me?

Phill Pafford

do you have an example Rest API request?

Sairam Sanjay Simha

Not sure when this particular one was release, but there is this... https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-project-versions/#api-rest-api-3-version-id-relatedwork-post

Unfortunately, this does not seem to acutally LINK the issue

Ahmad Akilan

I was able to get as far as linking a URL but not a Jira Work Item (Issue).

You can achieve this using Jira's REST API through automation. Here's the approach:

Setup:
1. Create a [service account](https://support.atlassian.com/user-management/docs/understand-service-accounts/) (Standard tier+) to ensure automations persist when team members leave
2. Get your [cloud ID](https://support.atlassian.com/jira/kb/retrieve-my-atlassian-sites-cloud-id/)
3. Add the service account to relevant projects

API Call (REST):
Use the "Send web request" action in automation with:

curl -X POST \
"https://api.atlassian.com/ex/jira/{cloudId}/rest/api/3/version/{versionId}/relatedwork" \
-H "Content-Type: application/json" \
-u "serviceaccount@company.com:API_TOKEN" \
-d '{
"category": "Test",
"title": "Regression Cycle",
"url": "{{someURL}}"
}'

GraphQL Alternative:
I was able to achieve this with GraphQL as well:

curl -X POST \
"https://api.atlassian.com/graphql" \
-H "Content-Type: application/json" \
-H "X-ExperimentalApi: AddRelatedWorkToVersion" \
-u "serviceaccount@company.com:API_TOKEN" \
-d '{"operationName": "addRelatedWorkMutation", "query": "mutation addRelatedWorkMutation { jira { addRelatedWorkToVersion(input: {versionId: \"ari:cloud:jira:{cloudId}:version/activation/{versionAri}\", relatedWorkId: \"{workId}\", url: \"{{baseUrl}}/browse/{{issue.key}}\", title: \"{{issue.summary}}\", category: \"Development\"}) { success errors { message } } } }"}'