Skip to content

Powered by Grav CMS + Helios Theme

Tags

The flat half of the catalog taxonomy.

The flat half of the taxonomy. Tags are assigned to products through the product body's tags list, not from here.

List tags

GET /api/v1/kahunacart/tags Permission kahunacart.settings

Every catalog tag with its label, slug, translation overrides and how many products wear it. Tags are the flat half of the taxonomy and are assigned from the product side, through tags on create_product or update_product.

Create a tag

POST /api/v1/kahunacart/tags Permission kahunacart.settings

Create a tag. The slug is derived from the label when omitted. You rarely need this: sending an unknown label in a product's tags list creates the tag as a side effect, which is how the admin's type-to-add input works.

Parameters

Name Type Description
label required string
slug optional string Derived from the label when omitted
translations optional object

Update a tag

PATCH /api/v1/kahunacart/tags/{id} Permission kahunacart.settings

Rename a tag, change its slug, or replace its translation overrides.

Parameters

Name Type Description
id required integer Tag id
label optional string
slug optional string
translations optional object

Delete a tag

DELETE /api/v1/kahunacart/tags/{id} Permission kahunacart.settings

Delete a tag and every assignment of it, and report how many products were carrying it. Those products keep every other tag they had; nothing else in the catalog moves.

Parameters

Name Type Description
id required integer Tag id