v4

latestOpenAPI 3.0.1Apache 2.02026-08-016169702.3 MB
Issue link types

Create issue link type

Creates an issue link type. Use this operation to create descriptions of the reasons why issues are linked. The issue link type consists of a name and descriptions for a link's inward and outward relationships.

To use this operation, the site must have issue linking enabled.

Permissions required: Administer Jira global permission.

post/rest/api/3/issueLinkType

Request body

idstring

The ID of the issue link type and is used as follows:

  • In the issueLink resource it is the type of issue link. Required on create when name isn't provided. Otherwise, read only.
  • In the issueLinkType resource it is read only.
inwardstring

The description of the issue link type inward link and is used as follows:

  • In the issueLink resource it is read only.
  • In the issueLinkType resource it is required on create and optional on update. Otherwise, read only.
namestring

The name of the issue link type and is used as follows:

  • In the issueLink resource it is the type of issue link. Required on create when id isn't provided. Otherwise, read only.
  • In the issueLinkType resource it is required on create and optional on update. Otherwise, read only.
outwardstring

The description of the issue link type outward link and is used as follows:

  • In the issueLink resource it is read only.
  • In the issueLinkType resource it is required on create and optional on update. Otherwise, read only.
selfstring uri

The URL of the issue link type. Read only.

Response

Returned if the request is successful.

idstring

The ID of the issue link type and is used as follows:

  • In the issueLink resource it is the type of issue link. Required on create when name isn't provided. Otherwise, read only.
  • In the issueLinkType resource it is read only.
inwardstring

The description of the issue link type inward link and is used as follows:

  • In the issueLink resource it is read only.
  • In the issueLinkType resource it is required on create and optional on update. Otherwise, read only.
namestring

The name of the issue link type and is used as follows:

  • In the issueLink resource it is the type of issue link. Required on create when id isn't provided. Otherwise, read only.
  • In the issueLinkType resource it is required on create and optional on update. Otherwise, read only.
outwardstring

The description of the issue link type outward link and is used as follows:

  • In the issueLink resource it is read only.
  • In the issueLinkType resource it is required on create and optional on update. Otherwise, read only.
selfstring uri

The URL of the issue link type. Read only.