Create a release link

POST

/api/v4/projects/{id}/releases/{tag_name}/assets/links

• GitLab REST API

Creates an asset link for a specified release.

Authorizations

• http
• oauth2

Parameters

Path Parameters

id

required

One of:

string

string

integer

integer

The ID or URL-encoded path of the project

tag_name

required

string

The tag associated with the release

Request Body ^required

Media type application/json

object

name

required

The name of the link. Link names must be unique in the release

string

nullable

url

required

The URL of the link. Link URLs must be unique in the release.

string

nullable

direct_asset_path

Optional path for a direct asset link

string

nullable

filepath

Deprecated: optional path for a direct asset link

string

nullable

link_type

The type of the link: other, runbook, image, or package. Defaults to other

string

default: other nullable

Allowed values: other runbook image package

Responses

201

Created

Media type application/json

object

id

integer format: int64

name

string

url

string

direct_asset_url

string

link_type

string

Example

{
  "id": 1,
  "name": "app-v1.0.dmg",
  "url": "https://gitlab.example.com/root/app/-/jobs/688/artifacts/raw/bin/app-v1.0.dmg",
  "direct_asset_url": "https://gitlab.example.com/root/app/-/releases/v1.0/downloads/app-v1.0.dmg",
  "link_type": "other"
}

400

Bad request

401

Unauthorized

404

Not Found