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.

请求示例

Shell

JavaScript

Java

Swift

curl --location -g --request POST 'http:///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"
}'

响应示例

200 - 成功示例

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

请求参数

Path 参数

Body 参数application/json

示例

返回响应

🟢200Returned if the remote issue link is updated.

application/json

Body

🟢201Returned if the remote issue link is created.

🟠400Returned if the request is invalid.

🟠401Returned if the authentication credentials are incorrect or missing.

🟠403Returned if the user does not have permission to link issues.

🟠404Returned if the issue is not found or the user does not have permission to view the issue.

修改于 2023-07-12 08:28:11

Get remote issue links

Delete remote issue link by global ID