List all project repository tags

GET

/api/v4/projects/{id}/repository/tags

Lists all repository tags from a project, sorted by update date and time in descending order.

Authorizations

http
oauth2

Parameters

Path Parameters

required

One of:

string
integer

string

The ID or URL-encoded path of the project

Query Parameters

sort

string

default: desc nullable

Allowed values: asc desc

Return tags sorted in updated by asc or desc order.

order_by

string

default: updated nullable

Allowed values: name updated version

Return tags ordered by name, updated, version fields.

search

string

nullable

Return list of tags matching the search criteria

page_token

string

nullable

Name of tag to start the pagination from

page

integer

default: 1 nullable

Current page number

Example

per_page

integer

default: 20 nullable

Number of items per page

Example

Responses

200

application/json

object

name

string

message

string

target

string

commit

object

string

short_id

string

created_at

string format: date-time

parent_ids

Array<string>

title

string

message

string

author_name

string

author_email

string

authored_date

string format: date-time

committer_name

string

committer_email

string

committed_date

string format: date-time

trailers

object

extended_trailers

object

web_url

string

release

object

tag_name

string

description

string

protected

boolean

created_at

string format: date-time

Example

{
  "name": "v1.0.0",
  "message": "Release v1.0.0",
  "target": "2695effb5807a22ff3d138d593fd856244e155e7",
  "commit": {
    "id": "2695effb5807a22ff3d138d593fd856244e155e7",
    "short_id": "2695effb",
    "created_at": "2017-07-26T11:08:53.000+02:00",
    "parent_ids": [
      "2a4b78934375d7f53875269ffd4f45fd83a84ebe"
    ],
    "title": "Initial commit",
    "message": "Initial commit",
    "author_name": "John Smith",
    "author_email": "john@example.com",
    "authored_date": "2012-05-28T04:42:42-07:00",
    "committer_name": "Jack Smith",
    "committer_email": "jack@example.com",
    "committed_date": "2012-05-28T04:42:42-07:00",
    "trailers": {
      "Merged-By": "Jane Doe janedoe@gitlab.com"
    },
    "extended_trailers": {
      "Signed-off-by": [
        "John Doe <johndoe@gitlab.com>",
        "Jane Doe <janedoe@gitlab.com>"
      ]
    },
    "web_url": "https://gitlab.example.com/janedoe/gitlab-foss/-/commit/ed899a2f4b50b4370feeea94676502b42383c746"
  },
  "release": {
    "tag_name": "1.0.0",
    "description": "Amazing release. Wow"
  },
  "protected": true,
  "created_at": "2023-10-12T02:16:52.000Z"
}

400

Bad Request

403

Unauthenticated

404

Not found

422

Unprocessable entity

503

Service unavailable