• Backlog
  • Board
  • Epic
  • Issue
  • Sprint
  • Development Information
  • Feature Flags
  • Deployments
  • Builds
  • Security Information
  • Operations
  • DevOps Components
Cloud
Jira Software Cloud / Reference / REST API

Remote Links

Postman Collection
OpenAPI

APIs related to integrating Remote Links data with Jira Software. These APIs are available to Atlassian Connect apps. To use these APIs you must have the Remote Link module in your app's descriptor. Read more about Jira Software modules here.

Module

The Remote Link module allows third-party providers to add a generic link through a public REST API and associate it with Jira issues or services.

Supplied remote link information will be presented in the right sidebar of the new Jira issue view under Releases.

This module also provides actions, which allows users to perform an action on the remote link.

Note that the module key and name are not private and should therefore not contain any sensitive or personally identifiable information.

Example Module

An example can also be found at jira-data-provider-sample-addon, which has an atlassian-connect.json.

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 { "modules": { "jiraRemoteLinkInfoProvider": { "homeUrl": "https://my-remotelink-provider.com", "logoUrl": "https://my-remotelink-provider.com/images/logo.svg", "documentationUrl": "https://my-remotelink-provider.com/docs/jira-integration", "actions": [ { "actionId": "action-1", "actionLabel": { "value": { "value": "Acknowledge" } }, "templateUrl": "https://my-remotelink-provider.com/ack/{ack-id}" } ], "name": { "value": "My Remote Link Provider" }, "key": "remotelink-integration" } } }

Properties

PropertytypeDescriptionRequired
keystringA key to identify this module. Must match ^[a-zA-Z0-9-]+$ pattern, with a max length of 100Yes
nameobject (i18N)A human readable name. This object supports internationalization.Yes
homeUrlstringURL to the provider’s homepageYes
logoUrlstringOptional URL to the provider’s logo, which will be displayed in the UI
documentationUrlstringOptional URL to documentation about the provider’s Jira integration
actionsobjectOptional actions that can be performed by Jira users on the remote link

Actions object

PropertytypeDescriptionRequired
actionIdstringA key to identify a specific action. Used for associating a specific Remote link to an action of this ID.
The actionId of an action must be unique across all actions.
Yes
actionLabelobjectThe actionLabel of an Action is shown visibly to the User alongside the Remote Link.Yes
templateUrlstringThe templateUrl of an Action is a template where strings can be substituted into the URL for a specific Remote Link.
Strings used in the templateUrl must be passed in via an attribute map when associating an action with a remote link.
Yes

ActionLabel Object

PropertytypeDescriptionRequired
valueobject (i18n)The label shown on the UI. This object supports internationalization.Yes
POST

Submit Remote Link data

Update / insert Remote Link data.

Remote Links are identified by their ID, existing Remote Link data for the same ID will be replaced if it exists and the updateSequenceId of existing data is less than the incoming data.

Submissions are performed asynchronously. Submitted data will eventually be available in Jira; most updates are available within a short period of time, but may take some time during peak load and/or maintenance times. The getRemoteLinkById operation can be used to confirm that data has been stored successfully (if needed).

In the case of multiple Remote Links being submitted in one request, each is validated individually prior to submission. Details of which Remote LInk failed submission (if any) are available in the response object.

Only Connect apps that define the jiraRemoteLinkInfoProvider module can access this resource. This resource requires the 'WRITE' scope for Connect apps.

Data Security Policy: Not exempt from app access rules
Scopes

Connect app scope requiredWRITE

Request

Header parameters

Authorization

string

Required

Request bodyapplication/json

Remote Links data to submit.

properties

Properties

remoteLinks

array<RemoteLinkData>

Required
providerMetadata

ProviderMetadata

Responses

Submission accepted. Each submitted Remote Link that is of a valid format will be eventually available in Jira.

Details of which Remote Links were submitted and which failed submission (due to data format problems etc.) are available in the response object.

application/json

object

The result of a successful submitRemoteLinks request.

POST/rest/remotelinks/1.0/bulk
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 curl --request POST \ --url 'https://your-domain.atlassian.net/rest/remotelinks/1.0/bulk' \ --header 'Accept: application/json' \ --header 'Content-Type: application/json' \ --data '{ "properties": { "accountId": "account-234", "projectId": "project-123" }, "remoteLinks": [ { "schemaVersion": "1.0", "id": "111-222-333", "updateSequenceNumber": 1523494301448, "displayName": "Remote Link #42", "url": "<string>", "type": "security", "description": "Remote Link #42 with more information in this description", "lastUpdated": "2018-01-20T23:27:25.000Z", "associations": [ { "associationType": "issueKeys", "values": [ "ABC-123", "ABC-456" ] } ], "status": { "appearance": "inprogress", "label": "ANOMALOUS" }, "actionIds": [ "action-111-222-333", "action-444-555-666" ], "attributeMap": {} } ], "providerMetadata": { "product": "Opsgenie 6.10.2" } }'
202Response
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 { "acceptedRemoteLinks": [ "111-222-333", "444-555-666" ], "rejectedRemoteLinks": {}, "unknownAssociations": [ { "associationType": "issueKeys", "values": [ "ABC-123", "ABC-456" ] } ] }
DEL

Bulk delete all Remote Links data that match the given request.

One or more query params must be supplied to specify Properties to delete by. Optional param _updateSequenceNumber is no longer supported. If more than one Property is provided, data will be deleted that matches ALL of the Properties (e.g. treated as an AND).

See the documentation for the submitRemoteLinks operation for more details.

e.g. DELETE /bulkByProperties?accountId=account-123&repoId=repo-345

Deletion is performed asynchronously. The getRemoteLinkById operation can be used to confirm that data has been deleted successfully (if needed).

Only Connect apps that define the jiraRemoteLinkInfoProvider module, and on-premise integrations, can access this resource. This resource requires the 'DELETE' scope for Connect apps.

Data Security Policy: Not exempt from app access rules
Scopes

Connect app scope requiredDELETE

_updateSequenceNumber

integer

params

object

Authorization

string

Required

Delete accepted. Data will eventually be removed from Jira.

DEL/rest/remotelinks/1.0/bulkByProperties
1 2 curl --request DELETE \ --url 'https://your-domain.atlassian.net/rest/remotelinks/1.0/bulkByProperties'
GET

Retrieve the currently stored Remote Link data for the given ID.

The result will be what is currently stored, ignoring any pending updates or deletes.

Only Connect apps that define the jiraRemoteLinkInfoProvider module, and on-premise integrations, can access this resource. This resource requires the 'READ' scope for Connect apps.

Data Security Policy: Not exempt from app access rules
Scopes

Connect app scope requiredREAD

remoteLinkId

string

Required
Authorization

string

Required

The Remote Link data currently stored for the given ID.

application/json

RemoteLinkData

Data related to a single Remote Link.

GET/rest/remotelinks/1.0/remotelink/{remoteLinkId}
1 2 3 curl --request GET \ --url 'https://your-domain.atlassian.net/rest/remotelinks/1.0/remotelink/{remoteLinkId}' \ --header 'Accept: application/json'
200Response
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 { "schemaVersion": "1.0", "id": "111-222-333", "updateSequenceNumber": 1523494301448, "displayName": "Remote Link #42", "url": "<string>", "type": "security", "description": "Remote Link #42 with more information in this description", "lastUpdated": "2018-01-20T23:27:25.000Z", "associations": [ { "associationType": "issueKeys", "values": [ "ABC-123", "ABC-456" ] } ], "status": { "appearance": "inprogress", "label": "ANOMALOUS" }, "actionIds": [ "action-111-222-333", "action-444-555-666" ], "attributeMap": {} }
DEL

Delete the Remote Link data currently stored for the given ID.

Deletion is performed asynchronously. The getRemoteLinkById operation can be used to confirm that data has been deleted successfully (if needed).

Only Connect apps that define the jiraRemoteLinkInfoProvider module, and on-premise integrations, can access this resource. This resource requires the 'DELETE' scope for Connect apps.

Data Security Policy: Not exempt from app access rules
Scopes

Connect app scope requiredDELETE

remoteLinkId

string

Required
_updateSequenceNumber

integer

Authorization

string

Required

Delete has been accepted. Data will eventually be removed from Jira if it exists.

DEL/rest/remotelinks/1.0/remotelink/{remoteLinkId}
1 2 curl --request DELETE \ --url 'https://your-domain.atlassian.net/rest/remotelinks/1.0/remotelink/{remoteLinkId}'

Rate this page: