---
title: "Update related work"
method: PUT
path: "/rest/api/3/version/{id}/relatedwork"
tags: ["Project versions"]
---

# Update related work

`PUT /rest/api/3/version/{id}/relatedwork`

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](#permissions) required:** *Resolve issues:* and *Edit issues* [Managing project permissions](https://confluence.atlassian.com/adminjiraserver/managing-project-permissions-938847145.html) for the project that contains the version.

## Path parameters

- `id` string, required

## Request body

- VersionRelatedWork — Associated related work to a version
  - `category` string, required — The category of the related work
  - `issueId` integer — The ID of the issue associated with the related work (if there is one). Cannot be updated via the Rest API.
  - `relatedWorkId` string — 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.
  - `title` string — The title of the related work
  - `url` string, uri — The URL of the related work. Will be null for the native release note related work item, but is otherwise required.

## Response `200`

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

- VersionRelatedWork — Associated related work to a version
  - `category` string, required — The category of the related work
  - `issueId` integer — The ID of the issue associated with the related work (if there is one). Cannot be updated via the Rest API.
  - `relatedWorkId` string — 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.
  - `title` string — The title of the related work
  - `url` string, uri — The URL of the related work. Will be null for the native release note related work item, but is otherwise required.

## Other responses

- `400` — Returned if the request data is invalid
- `401` — Returned if the authentication credentials are incorrect.
- `403` — Returned if the user does not have the required permissions.
- `404` — Returned if the version or the related work is not found.

---

[API](https://skmtc.dev/atlassian/apis/the-jira-cloud-platform-rest-api-3.md) · [All operations](https://skmtc.dev/atlassian/apis/the-jira-cloud-platform-rest-api-3/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/atlassian/the-jira-cloud-platform-rest-api-3/revisions/9029bb1c5ebd/schema)