Skip to main content
Tag names must not start with refs/ — the SDK handles ref resolution automatically.

Options

string
required
Tag name (e.g. v1.0.0). Must not start with refs/.
string
required
Commit SHA the tag should point to.
object[]
Ordered per-ref policy rules ({ pattern, ops? }) embedded in the per-call JWT. First match wins. Python: ref_policies. Go: RefPolicies with type storage.RefPolicyList. See the Branch Protection guide.

Response

string
The created tag name
string
The resolved commit SHA the tag points to
string
Confirmation message from the API