---
title: "Delete a Remote Link by ID"
method: DELETE
path: "/rest/remotelinks/1.0/remotelink/{remoteLinkId}"
tags: ["Remote Links"]
---

# Delete a Remote Link by ID

`DELETE /rest/remotelinks/1.0/remotelink/{remoteLinkId}`

## Request

- Base URL: `https://your-domain.atlassian.net`
- URL: `https://your-domain.atlassian.net/rest/remotelinks/1.0/remotelink/{remoteLinkId}`
- Auth: one of:
  - HTTP basic
  - OAuth 2
    - Authorization code: `https://auth.atlassian.com/authorize`
    - Token URL: `https://auth.atlassian.com/oauth/token` scopes: `delete:remote-link-info:jira`

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).

## Path parameters

- `remoteLinkId` string, required

## Query parameters

- `_updateSequenceNumber` integer

## Response `202`

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

## Other responses

- `401`: Missing a JWT token, or token is invalid.
- `403`: The JWT token used does not correspond to an app that defines the `jiraRemoteLinkInfoProvider` module, or the app does not define the 'DELETE' scope.
- `429`: API rate limit has been exceeded.
- `503`: Service is unavailable due to maintenance or other reasons.
- `default`: An unknown error has occurred.

## Changes

- **2026-07-13** `4e108d54b990`: 2 info
  - the endpoint scheme security `OAuth2` was added to the API
  - the endpoint scheme security `basicAuth` was added to the API
- **2022-09-25** `ac057c9cf7e5`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/atlassian/apis/jira-software-cloud-api/changes/rest/remotelinks/1.0/remotelink/:remoteLinkId/delete.md)

---

[API](https://skmtc.dev/atlassian/apis/jira-software-cloud-api.md) - [All operations](https://skmtc.dev/atlassian/apis/jira-software-cloud-api/llms.txt) - [OpenAPI document](https://skmtc.dev/atlassian/apis/jira-software-cloud-api/revisions/4e108d54b990?raw)
