Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.hellocobi.com/llms.txt

Use this file to discover all available pages before exploring further.

Important: The shop tag model has dependencies on both the shop and tag models. The shop_id field must reference an existing shop and the tag_id field must reference an existing tag. It’s recommended to upload shop and tag data before uploading shop tag mappings.

​
Schema

{
  "type": "object",
  "required": ["shop_tag_id", "shop_id", "tag_id"],
  "properties": {
    "shop_tag_id": {
      "type": "string",
      "format": "uuid",
      "description": "Unique identifier for the shop tag mapping"
    },
    "shop_id": {
      "type": "string",
      "format": "uuid",
      "description": "ID of the shop (must reference an existing shop)"
    },
    "tag_id": {
      "type": "string",
      "format": "uuid",
      "description": "ID of the tag (must reference an existing tag)"
    },
    "created": {
      "type": "string",
      "format": "date-time",
      "nullable": true,
      "description": "Timestamp when the record was created"
    },
    "updated": {
      "type": "string",
      "format": "date-time",
      "nullable": true,
      "description": "Timestamp when the record was last updated"
    },
    "is_deleted": {
      "type": "boolean",
      "nullable": true,
      "description": "Flag indicating if the record is marked as deleted"
    }
  }
}

​
Field Descriptions

​
Required Fields

FieldTypeFormatDescription
shop_tag_idstringUUIDUnique identifier for the shop tag mapping
shop_idstringUUIDID of the shop (must reference an existing shop)
tag_idstringUUIDID of the tag (must reference an existing tag)

​
Optional Fields

FieldTypeFormatDescription
createdstringdate-timeTimestamp when the record was created
updatedstringdate-timeTimestamp when the record was last updated
is_deletedboolean-Flag indicating if the record is marked as deleted

​
Example

{
  "shop_tag_id": "550e8400-e29b-41d4-a716-446655440000",
  "shop_id": "550e8400-e29b-41d4-a716-446655440001",
  "tag_id": "550e8400-e29b-41d4-a716-446655440002",
  "created": "2023-01-15T14:30:00Z",
  "updated": "2023-06-22T09:15:30Z",
  "is_deleted": false
}

​
Best Practices

  1. UUID Format: Use valid UUID v4 format for all ID fields
  2. Data Dependencies: Ensure shop_id references an existing shop and tag_id references an existing tag
  3. Data Consistency: Ensure consistent data across all shop tag mapping records
Need help? Contact our support team at [email protected]