Delete a tag

Deletes a tag.

DELETE

https://api.katapult.io/core/v1/tags/{tag}

If successful, this endpoint will return a 200 OK status.

Scopes

One of the following scopes are required to use this endpoint.

The following arguments are supported for this endpoint.

Name	Type	Default Value
tag Required The tag to delete	Tag Lookup	None

Name

Type

Default Value

tag Required

The tag to delete

None

The following errors may occur during this request.

Details	HTTP status
permission_denied The authenticated identity is not permitted to perform this action	403 Forbidden
tag_not_found No tag was found matching any of the criteria provided in the arguments	404 Not Found

Details

HTTP status

The authenticated identity is not permitted to perform this action

403 Forbidden

No tag was found matching any of the criteria provided in the arguments

404 Not Found

When the request is successful, you can expect an object matching the specification below to be returned.

{
    tag: Tag {
        id: String
        name: String
        color: TagColorsEnum
        created_at: Unix Timestamp
    }
}