Deletes a tag and its snapshot. The branch it was taken from is not affected. Triggers the tag.deleted webhook.
HTTP
DELETE /tags/{tagId}Access: Session token only. API keys get 403 with insufficient_scope.
Role: Project manager.
Path parameters #
| Parameter | Description |
|---|---|
tagId | The id of the tag. |
Response 204 #
No content.
Errors #
| Status | error | When |
|---|---|---|
| 401 | unauthenticated | The token is missing or not valid. |
| 403 | forbidden | You are not a manager of the project. |
| 404 | not_found | The tag does not exist, you have no access to its project, or tagId is not a UUID. |
| 429 | rate_limited | Too many requests, see Rate limiting. |
See Errors for the error format.