---
title: "Create related work"
method: POST
path: "/rest/api/2/version/{id}/relatedwork"
tags: ["Project versions"]
---

# Create related work

`POST /rest/api/2/version/{id}/relatedwork`

Creates a related work for the given version. You can only create a generic link type of related works via this API. relatedWorkId will be auto-generated UUID, that does not need to be provided.

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 `201`

Returned if the request is successful.

- 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 is invalid.
- `401` — Returned if the authentication credentials are incorrect or missing.
- `403` — Returned if the user does not have the required permissions.
- `404` — Returned if the version is not found.

---

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