Tag

Version 1.0

Serves as the foundation for managing tags. Tags are labels or keywords that can be associated with various entities, providing a way to categorize and organize them.

# Endpoints
POST
/v1/tags# Create a single tag
GET
/v1/tags# Retrieve all tags
GET
/v1/tags/123456789# Retrieve a single tag
PATCH
/v1/tags/123456789# Update a single tag
DELETE
/v1/tags/123456789# Delete a single tag
GET
/v1/tags/123456789/products# Retrieve all products with a specific tag
POST
/v1/tags/123456789/products# Associate a product with a tag
DELETE
/v1/tags/123456789/products/987654321# Disassociate a product from a tag

Tag Entity

  • Name
    id
    Type
    string
    Required
    Description

    Every tag is assigned a unique identifier - an unsigned 64-bit integer known as the Tag ID. This specific number is exclusive and distinct across the entire system, ensuring an unparalleled level of uniqueness.

  • Name
    name
    Type
    string
    Required
    Description

    The name or label of the tag.

  • Name
    created_at
    Type
    timestamp
    Description

    This property indicates the time in ISO 8601 when the tag was created.

  • Name
    updated_at
    Type
    timestamp
    Description

    This property indicates the time in ISO 8601 when the tag was last updated.

  • Name
    created_by
    Type
    foreignId
    Description

    This property indicates the user who created the tag.

  • Name
    updated_by
    Type
    foreignId
    Description

    This property indicates the user who recently updated the tag.

The Tag Entity

JSON
{
  "id": "123456789",
  "name": "Example Tag",
  "created_at": "2024-01-07T12:30:00Z",
  "updated_at": "2024-01-07T14:45:00Z",
  "created_by": "123456789",
  "updated_by": "123456789"
}

Create a Single Tag

This endpoint allows you to create a single tag.

Required Fields

  • Name
    name
    Type
    string
    Required
    Description

Examples

Create a single tag

POST
/v1/tags
curl --request POST \
  --url https://api.example.com/v1/tags \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "Example Tag"
  }'

Create a single tag

POST
/v1/tags
curl --request POST \
  --url https://api.example.com/v1/tags \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "Example Tag"
  }'
JSON
{
  "id": "123456789",
  "name": "Example Tag",
  "created_at": "2024-01-07T12:30:00Z",
  "updated_at": "2024-01-07T14:45:00Z",
  "created_by": "123456789",
  "updated_by": "123456789"
}

Retrieve all Tags

This endpoint allows you to retrieve all tags.

Examples

Retrieve all tags

GET
/v1/tags
curl --request GET \
  --url https://api.example.com/v1/tags

Retrieve all tags

GET
/v1/tags
curl --request GET \
  --url https://api.example.com/v1/tags
JSON
[
    {
        "id": "123456789",
        "name": "Example Tag",
        "created_at": "2024-01-07T12:30:00Z",
        "updated_at": "2024-01-07T14:45:00Z",
        "created_by": "123456789",
        "updated_by": "123456789"
    },
    {
        "id": "987654321",
        "name": "Example Tag 2",
        "created_at": "2024-01-07T12:30:00Z",
        "updated_at": "2024-01-07T14:45:00Z",
        "created_by": "123456789",
        "updated_by": "123456789"
    }
]

Retrieve a Single Tag

This endpoint allows you to retrieve a single tag.

Required Parameters

  • Name
    id
    Type
    string
    Required
    Description

Examples

Retrieve a single tag

GET
/v1/tags/123456789
curl --request GET \
  --url https://api.example.com/v1/tags/123456789

Retrieve a single tag

GET
/v1/tags/123456789
curl --request GET \
  --url https://api.example.com/v1/tags/123456789
JSON
{
  "id": "123456789",
  "name": "Example Tag",
  "created_at": "2024-01-07T12:30:00Z",
  "updated_at": "2024-01-07T14:45:00Z",
  "created_by": "123456789",
  "updated_by": "123456789"
}

Update a Single Tag

This endpoint allows you to update a single tag.

Required Parameters

  • Name
    id
    Type
    string
    Required
    Description

Examples

Update a single tag

PATCH
/v1/tags/123456789
curl --request PATCH \
  --url https://api.example.com/v1/tags/123456789 \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "New Tag Name"
  }'

Update a single tag

PATCH
/v1/tags/123456789
curl --request PATCH \
  --url https://api.example.com/v1/tags/123456789 \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "New Tag Name"
  }'
JSON
{
  "id": "123456789",
  "name": "New Tag Name",
  "created_at": "2024-01-07T12:30:00Z",
  "updated_at": "2024-01-07T14:45:00Z",
  "created_by": "123456789",
  "updated_by": "123456789"
}

Delete a Single Tag

This endpoint allows you to delete a single tag.

Required Parameters

  • Name
    id
    Type
    string
    Required
    Description

Examples

Delete a single tag

DELETE
/v1/tags/123456789
curl --request DELETE \
  --url https://api.example.com/v1/tags/123456789

Delete a single tag

DELETE
/v1/tags/123456789
curl --request DELETE \
  --url https://api.qooly.io/v1/tags/123456789
JSON
{}

Retrieve all Products in a Tag

This endpoint allows you to retrieve all products in a tag. It returns an array of Product Entity.

Required Parameters

  • Name
    id
    Type
    string
    Required
    Description

Examples

Retrieve all products in a tag

GET
/v1/tags/123456789/products
curl --request GET \
  --url https://api.qooly.io/v1/tags/123456789/products

Retrieve all products in a tag

GET
/v1/tags/123456789/products
curl --request GET \
  --url https://api.qooly.io/v1/tags/123456789/products
JSON
[
  {
      "id": "123456789",
      "brand_id": "987654321",
      "metadata_id": "456789012",
      "image_id": "789012345",
      "is_tangible": true,
      "has_details": false,
      "has_pricing": false,
      "is_organized": true,
      "is_published": false,
      "needs_review": true,
      "out_of_sync": false,
      "syncing_paused_at": null,
      "status": "DRAFT",
      "name": "Sample Product",
      "model_type": "Simple",
      "product_code": "ABC123",
      "product_category": "Electronics",
      "product_type": "Gadget",
      "product_lifecycle_status": "Active",
      "weight": "1.5",
      "weight_unit": "kg",
      "size_unit": "cm",
      "length": "10",
      "width": "5",
      "height": "15",
      "country_of_origin": "US",
      "commodity_description": "A high-quality electronic gadget.",
      "taxable": false,
      "tax_code": "TAX123",
      "created_at": "2024-01-07T12:30:00Z",
      "updated_at": "2024-01-07T14:45:00Z",
      "created_by": "789012345",
      "updated_by": "123456789"
  },
  {
      "id": "987654321",
      "brand_id": "987654321",
      "metadata_id": "456789012",
      "image_id": "789012345",
      "is_tangible": true,
      "has_details": false,
      "has_pricing": false,
      "is_organized": true,
      "is_published": false,
      "needs_review": true,
      "out_of_sync": false,
      "syncing_paused_at": null,
      "status": "DRAFT",
      "name": "Sample Product 2",
      "model_type": "Simple",
      "product_code": "123ABC",
      "product_category": "Electronics",
      "product_type": "Gadget",
      "product_lifecycle_status": "Active",
      "weight": "1.5",
      "weight_unit": "kg",
      "size_unit": "cm",
      "length": "10",
      "width": "5",
      "height": "15",
      "country_of_origin": "US",
      "commodity_description": "Another description.",
      "taxable": false,
      "tax_code": "TAX123",
      "created_at": "2024-01-07T12:30:00Z",
      "updated_at": "2024-01-07T14:45:00Z",
      "created_by": "789012345",
      "updated_by": "123456789"
  }
]

Create a Single Product in a Tag

This endpoint allows you to add products in a tag.

Required Parameters

  • Name
    id
    Type
    string
    Required
    Description
  • Name
    product_id
    Type
    string
    Required
    Description

Examples

Create a single product in a tag

POST
/v1/tags/123456789/products
curl --request POST \
  --url https://api.qooly.io/v1/tags/123456789/products \
  --data '{
    "product_id": "123456789"
  }'

Create a single product in a tag

POST
/v1/tags/123456789/products
curl --request POST \
  --url https://api.qooly.io/v1/tags/123456789/products \
  --data '{
    "product_id": "123456789"
  }'
JSON
  {}

Delete a Single Product in a Tag

This endpoint allows you to remove products in a tag.

Required Parameters

  • Name
    id
    Type
    string
    Required
    Description
  • Name
    product_id
    Type
    string
    Required
    Description

Examples

Delete a single product in a tag

DELETE
/v1/tags/123456789/products
curl --request DELETE \
  --url https://api.qooly.io/v1/tags/123456789/products \
  --data '{
    "product_id": "123456789"
  }'

Delete a single product in a tag

DELETE
/v1/tags/123456789/products
curl --request DELETE \
  --url https://api.qooly.io/v1/tags/123456789/products \
  --data '{
    "product_id": "123456789"
  }'
JSON
  {}