Tags

Get all tags for a store

get

Authorizations

APIKey

AuthorizationstringRequired

An API Key token generated in the Dashboard in the format 'APIKey TOKEN_HERE'.

Path parameters

storeIdstring · flake-idRequiredExample: 411486491630370816

Responses

200

OK

application/json

idstring · flake-idRequiredExample: 411486491630370816

store_idstring · flake-idRequiredExample: 411486491630370816

created_atstring · date-timeRequired

When the tag was created

namestringRequired

The unique name for the tag.

slugstringRequired

The unique slug for the tag.

descriptionstring · nullableOptional

The description of the tag.

image_urlstring · nullableOptional

The Image URL associated with the tag.

enabledbooleanRequired

Indicates whether this tag is enabled.

updated_atstring · nullableOptional

When the tag was last updated.

default

Error response

application/json

get

/v1/stores/{storeId}/tags

HTTPcURLJavaScriptPython

GET /v1/stores/{storeId}/tags HTTP/1.1
Authorization: YOUR_API_KEY
Accept: */*

[
  {
    "id": "411486491630370816",
    "store_id": "411486491630370816",
    "created_at": "2026-02-18T16:13:27.081Z",
    "created_by": {
      "type": "anonymous",
      "id": "411486491630370816"
    },
    "name": "text",
    "slug": "text",
    "description": null,
    "image_url": null,
    "enabled": true,
    "updated_at": null,
    "updated_by": {
      "type": "anonymous",
      "id": "411486491630370816"
    }
  }
]

Create a new tag

post

Authorizations

APIKey

AuthorizationstringRequired

An API Key token generated in the Dashboard in the format 'APIKey TOKEN_HERE'.

Path parameters

storeIdstring · flake-idRequiredExample: 411486491630370816

Body

application/jsontext/jsonapplication/*+json

namestring · nullableOptional

slugstring · nullableOptional

descriptionstring · nullableOptional

enabledboolean · nullableOptional

Responses

200

OK

application/json

idstring · flake-idRequiredExample: 411486491630370816

store_idstring · flake-idRequiredExample: 411486491630370816

created_atstring · date-timeRequired

When the tag was created

namestringRequired

The unique name for the tag.

slugstringRequired

The unique slug for the tag.

descriptionstring · nullableOptional

The description of the tag.

image_urlstring · nullableOptional

The Image URL associated with the tag.

enabledbooleanRequired

Indicates whether this tag is enabled.

updated_atstring · nullableOptional

When the tag was last updated.

default

Error response

application/json

post

/v1/stores/{storeId}/tags

HTTPcURLJavaScriptPython

POST /v1/stores/{storeId}/tags HTTP/1.1
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 59

{
  "name": null,
  "slug": null,
  "description": null,
  "enabled": null
}

application/jsontext/jsonapplication/*+json

{
  "id": "411486491630370816",
  "store_id": "411486491630370816",
  "created_at": "2026-02-18T16:13:27.081Z",
  "created_by": {
    "type": "anonymous",
    "id": "411486491630370816"
  },
  "name": "text",
  "slug": "text",
  "description": null,
  "image_url": null,
  "enabled": true,
  "updated_at": null,
  "updated_by": {
    "type": "anonymous",
    "id": "411486491630370816"
  }
}

Get a tag by an ID

get

Authorizations

APIKey

AuthorizationstringRequired

An API Key token generated in the Dashboard in the format 'APIKey TOKEN_HERE'.

Path parameters

storeIdstring · flake-idRequiredExample: 411486491630370816

tagIdstring · flake-idRequiredExample: 411486491630370816

Responses

200

OK

application/json

idstring · flake-idRequiredExample: 411486491630370816

store_idstring · flake-idRequiredExample: 411486491630370816

created_atstring · date-timeRequired

When the tag was created

namestringRequired

The unique name for the tag.

slugstringRequired

The unique slug for the tag.

descriptionstring · nullableOptional

The description of the tag.

image_urlstring · nullableOptional

The Image URL associated with the tag.

enabledbooleanRequired

Indicates whether this tag is enabled.

updated_atstring · nullableOptional

When the tag was last updated.

default

Error response

application/json

get

/v1/stores/{storeId}/tags/{tagId}

HTTPcURLJavaScriptPython

GET /v1/stores/{storeId}/tags/{tagId} HTTP/1.1
Authorization: YOUR_API_KEY
Accept: */*

{
  "id": "411486491630370816",
  "store_id": "411486491630370816",
  "created_at": "2026-02-18T16:13:27.081Z",
  "created_by": {
    "type": "anonymous",
    "id": "411486491630370816"
  },
  "name": "text",
  "slug": "text",
  "description": null,
  "image_url": null,
  "enabled": true,
  "updated_at": null,
  "updated_by": {
    "type": "anonymous",
    "id": "411486491630370816"
  }
}

Delete a tag by ID

delete

Authorizations

APIKey

AuthorizationstringRequired

An API Key token generated in the Dashboard in the format 'APIKey TOKEN_HERE'.

Path parameters

storeIdstring · flake-idRequiredExample: 411486491630370816

tagIdstring · flake-idRequiredExample: 411486491630370816

Responses

204

No Content

default

Error response

application/json

delete

/v1/stores/{storeId}/tags/{tagId}

HTTPcURLJavaScriptPython

DELETE /v1/stores/{storeId}/tags/{tagId} HTTP/1.1
Authorization: YOUR_API_KEY
Accept: */*

No content

Update a tag by ID

patch

Authorizations

APIKey

AuthorizationstringRequired

An API Key token generated in the Dashboard in the format 'APIKey TOKEN_HERE'.

Path parameters

storeIdstring · flake-idRequiredExample: 411486491630370816

tagIdstring · flake-idRequiredExample: 411486491630370816

Body

application/jsontext/jsonapplication/*+json

namestring · nullableOptional

slugstring · nullableOptional

descriptionstring · nullableOptional

enabledboolean · nullableOptional

Responses

200

OK

application/json

idstring · flake-idRequiredExample: 411486491630370816

store_idstring · flake-idRequiredExample: 411486491630370816

created_atstring · date-timeRequired

When the tag was created

namestringRequired

The unique name for the tag.

slugstringRequired

The unique slug for the tag.

descriptionstring · nullableOptional

The description of the tag.

image_urlstring · nullableOptional

The Image URL associated with the tag.

enabledbooleanRequired

Indicates whether this tag is enabled.

updated_atstring · nullableOptional

When the tag was last updated.

default

Error response

application/json

patch

/v1/stores/{storeId}/tags/{tagId}

HTTPcURLJavaScriptPython

PATCH /v1/stores/{storeId}/tags/{tagId} HTTP/1.1
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 59

{
  "name": null,
  "slug": null,
  "description": null,
  "enabled": null
}

application/jsontext/jsonapplication/*+json

{
  "id": "411486491630370816",
  "store_id": "411486491630370816",
  "created_at": "2026-02-18T16:13:27.081Z",
  "created_by": {
    "type": "anonymous",
    "id": "411486491630370816"
  },
  "name": "text",
  "slug": "text",
  "description": null,
  "image_url": null,
  "enabled": true,
  "updated_at": null,
  "updated_by": {
    "type": "anonymous",
    "id": "411486491630370816"
  }
}

Get upload URL for tag image

get

Gets a pre-signed upload URL for uploading an image to a tag

Authorizations

APIKey

AuthorizationstringRequired

An API Key token generated in the Dashboard in the format 'APIKey TOKEN_HERE'.

Path parameters

storeIdstring · flake-idRequiredExample: 411486491630370816

tagIdstring · flake-idRequiredExample: 411486491630370816

Responses

200

OK

application/json

idstringRequired

The ID of the direct image upload URL.

upload_urlstringRequired

The URL to upload the image to.

default

Error response

application/json

get

/v1/stores/{storeId}/tags/{tagId}/image-upload-url

HTTPcURLJavaScriptPython

GET /v1/stores/{storeId}/tags/{tagId}/image-upload-url HTTP/1.1
Authorization: YOUR_API_KEY
Accept: */*

{
  "id": "text",
  "upload_url": "text"
}

Finish tag image upload

post

Finishes an image upload for a tag

Authorizations

APIKey

AuthorizationstringRequired

An API Key token generated in the Dashboard in the format 'APIKey TOKEN_HERE'.

Path parameters

storeIdstring · flake-idRequiredExample: 411486491630370816

tagIdstring · flake-idRequiredExample: 411486491630370816

Body

application/jsontext/jsonapplication/*+json

image_idstringRequired

The ID of the uploaded image returned by the server.

Responses

204

No Content

default

Error response

application/json

post

/v1/stores/{storeId}/tags/{tagId}/image-upload-finish

HTTPcURLJavaScriptPython

POST /v1/stores/{storeId}/tags/{tagId}/image-upload-finish HTTP/1.1
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 19

{
  "image_id": "text"
}

application/jsontext/jsonapplication/*+json

No content

Delete tag image

delete

Deletes an image for a tag

Authorizations

APIKey

AuthorizationstringRequired

An API Key token generated in the Dashboard in the format 'APIKey TOKEN_HERE'.

Path parameters

storeIdstring · flake-idRequiredExample: 411486491630370816

tagIdstring · flake-idRequiredExample: 411486491630370816

Responses

204

No Content

default

Error response

application/json

delete

/v1/stores/{storeId}/tags/{tagId}/image

HTTPcURLJavaScriptPython

DELETE /v1/stores/{storeId}/tags/{tagId}/image HTTP/1.1
Authorization: YOUR_API_KEY
Accept: */*

No content