-`ref` (required) - Create tag using commit SHA, another tag name, or branch name.
| `id` | integer/string | yes | The ID or [URL-encoded path of the project](README.md#namespaced-path-encoding) owned by the authenticated user |
-`message` (optional) - Creates annotated tag.
| `tag_name` | string | yes | The name of a tag |
-`release_description` (optional) - Add release notes to the Git tag and store it in the GitLab database.
| `ref` | string | yes | Create tag using commit SHA, another tag name, or branch name |
| `message` | string | no | Creates annotated tag |
| `release_description` | string | no | Add release notes to the Git tag and store it in the GitLab database |
```shell
```shell
curl --request POST --header"PRIVATE-TOKEN: <your_access_token>""https://gitlab.example.com/api/v4/projects/5/repository/tags?tag_name=test&ref=master"
curl --request POST --header"PRIVATE-TOKEN: <your_access_token>""https://gitlab.example.com/api/v4/projects/5/repository/tags?tag_name=test&ref=master"