Skip to content

Atlassian: Issue remote links schemas

11 Atlassian schemas with complete fields and constraints.

← Issue remote links operations · All schemas

Create or update remote issue link — response body — id, self

FieldTypePresenceDescription and constraints
$objectRootDetails of the identifiers for a created or updated remote issue link.
idJSONOptional
id (anyOf 1)JSONAlternative
id (anyOf 1) (anyOf 1)integerAlternativeThe ID of the remote issue link, such as the ID of the item on the remote system.
Format: int64
Read only: true
id (anyOf 1) (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
id (anyOf 2)nullAlternative
selfJSONOptional
self (anyOf 1)stringAlternativeThe URL of the remote issue link.
Read only: true
self (anyOf 2)nullAlternative

Get remote issue link by ID — response body

FieldTypePresenceDescription and constraints
$objectRootDetails of an issue remote link.
applicationJSONOptional
application (anyOf 1)ModelAlternativeExpand Get remote issue link by ID — response body — application The application the linked item is in
Details of the remote application the linked item is in.
application (anyOf 2)nullAlternative
globalIdJSONOptional
globalId (anyOf 1)stringAlternativeThe global ID of the link, such as the ID of the item on the remote system.
globalId (anyOf 2)nullAlternative
idJSONOptional
id (anyOf 1)JSONAlternative
id (anyOf 1) (anyOf 1)integerAlternativeThe ID of the link.
Format: int64
id (anyOf 1) (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
id (anyOf 2)nullAlternative
objectJSONOptional
object (anyOf 1)ModelAlternativeExpand Get remote issue link by ID — response body — object The linked item
Details of the item linked to.
object (anyOf 2)nullAlternative
relationshipJSONOptional
relationship (anyOf 1)stringAlternativeDescription of the relationship between the issue and the linked item.
relationship (anyOf 2)nullAlternative
selfJSONOptional
self (anyOf 1)stringAlternativeThe URL of the link.
Format: uri
self (anyOf 2)nullAlternative

Referenced models: Get remote issue link by ID — response body — application The application the linked item is in, Get remote issue link by ID — response body — object The linked item

Get remote issue link by ID — response body — application The application the linked item is in

FieldTypePresenceDescription and constraints
$objectRootThe application the linked item is in.
Additional keys: allowed
nameJSONOptional
name (anyOf 1)stringAlternativeThe name of the application. Used in conjunction with the (remote) object icon title to display a tooltip for the link's icon. The tooltip takes the format "\[application name\] icon title". Blank items are excluded from the tooltip title. If both items are blank, the icon tooltop displays as "Web Link". Grouping and sorting of links may place links without an application name last.
name (anyOf 2)nullAlternative
typeJSONOptional
type (anyOf 1)stringAlternativeThe name-spaced type of the application, used by registered rendering apps.
type (anyOf 2)nullAlternative

Get remote issue link by ID — response body — object The linked item

FieldTypePresenceDescription and constraints
$objectRootThe linked item.
Additional keys: allowed
iconJSONOptional
icon (anyOf 1)ModelAlternativeExpand Get remote issue link by ID — response body — object The linked item icon An icon If no icon is defined:
Details of the icon for the item. If no icon is defined, the default link icon is used in Jira.
icon (anyOf 2)nullAlternative
statusJSONOptional
status (anyOf 1)ModelAlternativeExpand Get remote issue link by ID — response body — object The linked item status The status of the item
The status of the item.
status (anyOf 2)nullAlternative
summaryJSONOptional
summary (anyOf 1)stringAlternativeThe summary details of the item.
summary (anyOf 2)nullAlternative
titleJSONOptional
title (anyOf 1)stringAlternativeThe title of the item.
title (anyOf 2)nullAlternative
urlJSONOptional
url (anyOf 1)stringAlternativeThe URL of the item.
url (anyOf 2)nullAlternative

Referenced models: Get remote issue link by ID — response body — object The linked item icon An icon If no icon is defined:, Get remote issue link by ID — response body — object The linked item status The status of the item

Get remote issue link by ID — response body — object The linked item icon An icon If no icon is defined:

FieldTypePresenceDescription and constraints
$objectRootAn icon. If no icon is defined:

* for a status icon, no status icon displays in Jira.
* for the remote object icon, the default link icon displays in Jira.
Additional keys: allowed
linkJSONOptional
link (anyOf 1)stringAlternativeThe URL of the tooltip, used only for a status icon. If not set, the status icon in Jira is not clickable.
link (anyOf 2)nullAlternative
titleJSONOptional
title (anyOf 1)stringAlternativeThe title of the icon. This is used as follows:

* For a status icon it is used as a tooltip on the icon. If not set, the status icon doesn't display a tooltip in Jira.
* For the remote object icon it is used in conjunction with the application name to display a tooltip for the link's icon. The tooltip takes the format "\[application name\] icon title". Blank itemsare excluded from the tooltip title. If both items are blank, the icon tooltop displays as "Web Link".
title (anyOf 2)nullAlternative
url16x16JSONOptional
url16x16 (anyOf 1)stringAlternativeThe URL of an icon that displays at 16x16 pixel in Jira.
url16x16 (anyOf 2)nullAlternative

Get remote issue link by ID — response body — object The linked item status The status of the item

FieldTypePresenceDescription and constraints
$objectRootThe status of the item.
Additional keys: allowed
iconJSONOptional
icon (anyOf 1)ModelAlternativeExpand Get remote issue link by ID — response body — object The linked item icon An icon If no icon is defined:
Details of the icon representing the status. If not provided, no status icon displays in Jira.
icon (anyOf 2)nullAlternative
resolvedJSONOptional
resolved (anyOf 1)booleanAlternativeWhether the item is resolved. If set to "true", the link to the issue is displayed in a strikethrough font, otherwise the link displays in normal font.
resolved (anyOf 2)nullAlternative

Referenced models: Get remote issue link by ID — response body — object The linked item icon An icon If no icon is defined:

Update remote issue link by ID — request body — body

FieldTypePresenceDescription and constraints
$objectRootDetails of a remote issue link.
Additional keys: allowed
applicationModelOptionalExpand Update remote issue link by ID — request body — body application
Details of the remote application the linked item is in. For example, trello.
globalIdstringOptionalAn identifier for the remote item in the remote system. For example, the global ID for a remote item in Confluence would consist of the app ID and page ID, like this: `appId=456&pageId=123`.

Setting this field enables the remote issue link details to be updated or deleted using remote system and item details as the record identifier, rather than using the record's Jira ID.

The maximum length is 255 characters.
objectModelRequired within parentExpand Update remote issue link by ID — request body — body object
Details of the item linked to.
relationshipstringOptionalDescription of the relationship between the issue and the linked item. If not set, the relationship description "links to" is used in Jira.

Referenced models: Update remote issue link by ID — request body — body application, Update remote issue link by ID — request body — body object

Update remote issue link by ID — request body — body application

FieldTypePresenceDescription and constraints
$objectRootThe application the linked item is in.
Additional keys: allowed
namestringOptionalThe name of the application. Used in conjunction with the (remote) object icon title to display a tooltip for the link's icon. The tooltip takes the format "\[application name\] icon title". Blank items are excluded from the tooltip title. If both items are blank, the icon tooltop displays as "Web Link". Grouping and sorting of links may place links without an application name last.
typestringOptionalThe name-spaced type of the application, used by registered rendering apps.

Update remote issue link by ID — request body — body object

FieldTypePresenceDescription and constraints
$objectRootThe linked item.
Additional keys: allowed
iconModelOptionalExpand Update remote issue link by ID — request body — body object icon
Details of the icon for the item. If no icon is defined, the default link icon is used in Jira.
statusModelOptionalExpand Update remote issue link by ID — request body — body object status
The status of the item.
summarystringOptionalThe summary details of the item.
titlestringRequired within parentThe title of the item.
urlstringRequired within parentThe URL of the item.

Referenced models: Update remote issue link by ID — request body — body object icon, Update remote issue link by ID — request body — body object status

Update remote issue link by ID — request body — body object icon

FieldTypePresenceDescription and constraints
$objectRootAn icon. If no icon is defined:

* for a status icon, no status icon displays in Jira.
* for the remote object icon, the default link icon displays in Jira.
Additional keys: allowed
linkstringOptionalThe URL of the tooltip, used only for a status icon. If not set, the status icon in Jira is not clickable.
titlestringOptionalThe title of the icon. This is used as follows:

* For a status icon it is used as a tooltip on the icon. If not set, the status icon doesn't display a tooltip in Jira.
* For the remote object icon it is used in conjunction with the application name to display a tooltip for the link's icon. The tooltip takes the format "\[application name\] icon title". Blank itemsare excluded from the tooltip title. If both items are blank, the icon tooltop displays as "Web Link".
url16x16stringOptionalThe URL of an icon that displays at 16x16 pixel in Jira.

Update remote issue link by ID — request body — body object status

FieldTypePresenceDescription and constraints
$objectRootThe status of the item.
Additional keys: allowed
iconModelOptionalExpand Update remote issue link by ID — request body — body object icon
Details of the icon representing the status. If not provided, no status icon displays in Jira.
resolvedbooleanOptionalWhether the item is resolved. If set to "true", the link to the issue is displayed in a strikethrough font, otherwise the link displays in normal font.

Referenced models: Update remote issue link by ID — request body — body object icon

Report an issue with this page

Necessary

Required for sign-in, security, authorization, and remembering your choices.

Always active

Analytics

Helps us understand which product and documentation features are useful.

Performance diagnostics

Uses performance tracing and privacy-masked session replay to diagnose problems.

You can change these choices at any time from Cookie settings.