Tag¶

Tags mark commits with a version label. Through the API you can list, create, and delete repository tags, and manage protected tag rules (restricting who can create, delete, or modify which tags).

Objects¶

Identification¶

• A repository is identified by owner + repo, and a tag by tag_name.
• Creating and modifying protected rules specify the matching rules in the request body; only deletion and details use tag_name.

Common tasks¶

Notes¶

• Regular tags use /tags and protected tags use /protected_tags. The two path groups are parallel; deleting from the wrong group does not raise a semantic error, but the result is completely different.
• Both creating and modifying protected rules use the same path …/protected_tags without {tag_name}, distinguished by method (POST to create, PUT to modify); only deletion and details include {tag_name}.
• When a tag name contains special characters such as /, escape it according to path parameter rules; otherwise it will be treated as a multi-level path.
• A Release is published by tag. Creating a tag and creating a Release are two steps: first create the tag, then create the version in the Release section.

Endpoint list¶

This module has 8 endpoints.