Create or update remote issue link

POST

/rest/api/3/issue/{issueIdOrKey}/remotelink

Creates or updates a remote issue link for an issue.

If a globalId is provided and a remote issue link with that global ID is found it is updated. Any fields without values in the request are set to null. Otherwise, the remote issue link is created.

This operation requires issue linking to be active.

This operation can be accessed anonymously.

Permissions required:

Browse projects and Link issues project permission for the project that the issue is in.

If issue-level security is configured, issue-level security permission to view the issue.

Request

Path Params

Body Params application/json

Examples

Responses

🟢200OK

application/json

Returned if the remote issue link is updated.

Body

🟢201Created

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Record Not Found

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST '/rest/api/3/issue//remotelink' \
--header 'Content-Type: application/json' \
--data-raw '{
    "application": {
        "name": "My Acme Tracker",
        "type": "com.acme.tracker"
    },
    "globalId": "system=http://www.mycompany.com/support&id=1",
    "object": {
        "icon": {
            "title": "Support Ticket",
            "url16x16": "http://www.mycompany.com/support/ticket.png"
        },
        "status": {
            "icon": {
                "link": "http://www.mycompany.com/support?id=1&details=closed",
                "title": "Case Closed",
                "url16x16": "http://www.mycompany.com/support/resolved.png"
            },
            "resolved": true
        },
        "summary": "Customer support issue",
        "title": "TSTSUP-111",
        "url": "http://www.mycompany.com/support?id=1"
    },
    "relationship": "causes"
}'

Response Example

200 - Success

{"id":10000,"self":"https://your-domain.atlassian.net/rest/api/issue/MKY-1/remotelink/10000"}

Modified at 2025-07-16 07:18:01

Get remote issue links

Delete remote issue link by ID