Skip to main content
POST
Create Tag

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Create a lightweight tag that points to an exact commit SHA.

Create-tag request body describing the new tag and the commit it points to.

name
string
required

Tag name. Must be a valid Git ref name and must not start with refs/.

Example:

"v1.0.0"

target
string
required

Full 40-character commit SHA the tag should point to.

Example:

"a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2"

Response

Tag creation result.

Result of creating a tag.

message
string
required

Human-readable result message.

Example:

"tag created"

name
string
required

Tag name.

Example:

"v1.0.0"

sha
string
required

Commit SHA the tag points to.

Example:

"a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2"