본문으로 건너뛰기

연락처 태그

목록 조회​

GET /contact-tags — 워크스페이스에 정의된 연락처 태그 카탈로그를 cursor pagination으로 조회합니다.

  • Scope: contact-tags:read
  • 쿼리: limit(기본 50, 최대 100), cursor

특정 연락처에 부여된 태그가 아니라 워크스페이스 전체의 태그 정의 목록입니다. 정렬은 created_at 내림차순입니다.

curl "https://api.talk.zeroworks.ai/api/public/v1/contact-tags?limit=50" \
  -H "Authorization: Bearer ztpat_..."

응답

{
  "success": true,
  "data": [
    {
      "id": "t1a2b3c4-...",
      "name": "vip",
      "color": "#ff0000",
      "usage_count": 12,
      "created_at": "2026-01-01T00:00:00Z",
      "updated_at": "2026-05-01T10:00:00Z"
    },
    {
      "id": "t5d6e7f8-...",
      "name": "신규문의",
      "usage_count": 0,
      "created_at": "2026-01-02T00:00:00Z",
      "updated_at": "2026-01-02T00:00:00Z"
    }
  ],
  "meta": { "has_more": false }
}

color는 미지정 시 null이 아니라 키가 생략됩니다 ("color" in tag로 판별). 위 예시의 두 번째 태그가 색상 미지정 상태입니다. usage_count는 해당 태그가 부여된 연락처 수입니다.