Add latest changes from gitlab-org/gitlab@13-1-stable-ee

1 files changed, 25 insertions, 11 deletions

diff --git a/doc/api/releases/links.md b/doc/api/releases/links.md
index f380ba5a1b2..35cb66e59a1 100644
--- a/doc/api/releases/links.md
+++ b/doc/api/releases/links.md
@@ -1,6 +1,12 @@
+---
+stage: Release
+group: Release Management
+info: To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/engineering/ux/technical-writing/#designated-technical-writers
+---
+
 # Release links API
 
-> [Introduced](https://gitlab.com/gitlab-org/gitlab-foss/issues/41766) in GitLab 11.7.
+> [Introduced](https://gitlab.com/gitlab-org/gitlab-foss/-/issues/41766) in GitLab 11.7.
 
 Using this API you can manipulate GitLab's [Release](../../user/project/releases/index.md) links. For manipulating other Release assets, see [Release API](index.md).
 GitLab supports links to `http`, `https`, and `ftp` assets.
@@ -32,13 +38,15 @@ Example response:
       "id":2,
       "name":"awesome-v0.2.msi",
       "url":"http://192.168.10.15:3000/msi",
-      "external":true
+      "external":true,
+      "link_type":"other"
    },
    {
       "id":1,
       "name":"awesome-v0.2.dmg",
       "url":"http://192.168.10.15:3000",
-      "external":true
+      "external":true,
+      "link_type":"other"
    }
 ]
 ```
@@ -70,7 +78,8 @@ Example response:
    "id":1,
    "name":"awesome-v0.2.dmg",
    "url":"http://192.168.10.15:3000",
-   "external":true
+   "external":true,
+   "link_type":"other"
 }
 ```
 
@@ -87,7 +96,8 @@ POST /projects/:id/releases/:tag_name/assets/links
 | `id`          | integer/string | yes      | The ID or [URL-encoded path of the project](../README.md#namespaced-path-encoding). |
 | `tag_name`    | string         | yes      | The tag associated with the Release. |
 | `name`        | string         | yes      | The name of the link. |
-| `url`        | string         | yes      | The URL of the link. |
+| `url`         | string         | yes      | The URL of the link. |
+| `link_type`        | string         | no       | The type of the link: `other`, `runbook`, `image`, `package`. Defaults to `other`. |
 
 Example request:
 
@@ -106,7 +116,8 @@ Example response:
    "id":1,
    "name":"awesome-v0.2.dmg",
    "url":"http://192.168.10.15:3000",
-   "external":true
+   "external":true,
+   "link_type":"other"
 }
 ```
 
@@ -122,9 +133,10 @@ PUT /projects/:id/releases/:tag_name/assets/links/:link_id
 | ------------- | -------------- | -------- | --------------------------------------- |
 | `id`          | integer/string | yes      | The ID or [URL-encoded path of the project](../README.md#namespaced-path-encoding). |
 | `tag_name`    | string         | yes      | The tag associated with the Release. |
-| `link_id`    | integer         | yes      | The ID of the link. |
+| `link_id`     | integer         | yes      | The ID of the link. |
 | `name`        | string         | no | The name of the link. |
-| `url`        | string         | no | The URL of the link. |
+| `url`         | string         | no | The URL of the link. |
+| `link_type`        | string         | no       | The type of the link: `other`, `runbook`, `image`, `package`. Defaults to `other`. |
 
 NOTE: **NOTE**
 You have to specify at least one of `name` or `url`
@@ -132,7 +144,7 @@ You have to specify at least one of `name` or `url`
 Example request:
 
 ```shell
-curl --request PUT --data name="new name" --header "PRIVATE-TOKEN: n671WNGecHugsdEDPsyo" "https://gitlab.example.com/api/v4/projects/24/releases/v0.1/assets/links/1"
+curl --request PUT --data name="new name" --data link_type="runbook" --header "PRIVATE-TOKEN: n671WNGecHugsdEDPsyo" "https://gitlab.example.com/api/v4/projects/24/releases/v0.1/assets/links/1"
 ```
 
 Example response:
@@ -142,7 +154,8 @@ Example response:
    "id":1,
    "name":"new name",
    "url":"http://192.168.10.15:3000",
-   "external":true
+   "external":true,
+   "link_type":"runbook"
 }
 ```
 
@@ -173,6 +186,7 @@ Example response:
    "id":1,
    "name":"new name",
    "url":"http://192.168.10.15:3000",
-   "external":true
+   "external":true,
+   "link_type":"other"
 }
 ```