身份別與技能標籤

建立或修改組員前，依商家查詢可用標籤，再將標籤 ID 帶入 enrollment 請求。

查詢端點

Method	Path	用途
GET	/v1/identity-tags/{merchantId}	查詢商家可用的啟用中身份別
GET	/v1/skill-tags/{merchantId}	查詢商家可用的啟用中技能標籤

兩支端點都以可讀取的 merchantId 查詢，回傳 data 陣列。標籤包含 id、name、color、scope、createdTime、updatedTime 與 usage；scope 指出標籤所屬範圍。若商家不在 Service Account 可存取範圍，API 會回傳 403。

用於組員資料

身份別以 identityTagId 指定；技能標籤是選填的 skills 陣列，每筆包含 tagId 與整數 level（1–5）：

{
  "identityTagId": "65107fa0-4284-46a5-82f7-b3657f660ed1",
  "skills": [
    {"tagId": "4f2b126d-eccf-44aa-b98a-dd2ac1879d12", "level": 3}
  ]
}

請使用目標商家查得的標籤 ID；不要只憑名稱或假設不同商家的 ID 相同。建立組員時不帶 skills 表示沒有技能；修改 profile 時不帶 skills 會清除既有技能，因此要保留的指派也必須送回。詳見組員資料及新增員工範例。

完整回應格式與限制請參考 Identity Tag API 和 Skill Tag API。