ATatlassian
Project versions

Update related work

Updates the given related work. You can only update generic link related works via Rest APIs. Any archived version related works can't be edited.

This operation can be accessed anonymously.

Permissions required: Resolve issues: and Edit issues Managing project permissions for the project that contains the version.

put/rest/api/3/version/{id}/relatedwork

Request

  • Base URL
    https://your-domain.atlassian.net
  • URL
    https://your-domain.atlassian.net/rest/api/3/version/{id}/relatedwork
  • Auth
    • HTTP basic
    • or OAuth 2
      Authorization code: https://auth.atlassian.com/authorize
      Token URL: https://auth.atlassian.com/oauth/token scopes: write:jira-work
    • or none

Path parameters

idstring required

The ID of the version to update the related work on. For the related work id, pass it to the input JSON.

Request body

categorystring required

The category of the related work

issueIdinteger

The ID of the issue associated with the related work (if there is one). Cannot be updated via the Rest API.

relatedWorkIdstring

The id of the related work. For the native release note related work item, this will be null, and Rest API does not support updating it.

titlestring

The title of the related work

urlstring uri

The URL of the related work. Will be null for the native release note related work item, but is otherwise required.

Response

Returned if the request is successful together with updated related work.

categorystring required

The category of the related work

issueIdinteger

The ID of the issue associated with the related work (if there is one). Cannot be updated via the Rest API.

relatedWorkIdstring

The id of the related work. For the native release note related work item, this will be null, and Rest API does not support updating it.

titlestring

The title of the related work

urlstring uri

The URL of the related work. Will be null for the native release note related work item, but is otherwise required.

Changes

No recorded changes to this operation across all 31 revisions of this API.