세그먼트 삭제
작성일 2026.04.23 | 수정일 2026.04.23
DELETE/crm-core/v1/segments/{segmentId}
세그먼트와 그에 연결된 segment_members 캐시를 함께 제거한다. 세그먼트 자체만 삭제되며 레코드는 영향을 받지 않는다. 계정당 요금제 사용량 카운터(segments.max)도 함께 감소한다. 삭제 후에는 동일 ID로 재참조할 수 없다. 권한: MEMBER 이상.
Path Params
| Name | Type | Required | Description |
|---|---|---|---|
| segmentId | string | * | 삭제할 세그먼트 ID |
Structure
코드 예제
const response = await fetch('https://api.solapi.com/crm-core/v1/segments/CRMSG1260423091530123SGM11122233', {
method: 'DELETE',
headers: { 'Authorization': 'Bearer ' + TOKEN }
});
const { segmentId } = await response.json();
import requests
response = requests.delete(
'https://api.solapi.com/crm-core/v1/segments/CRMSG1260423091530123SGM11122233',
headers={'Authorization': f'Bearer {TOKEN}'}
)
data = response.json()
curl -X DELETE 'https://api.solapi.com/crm-core/v1/segments/CRMSG1260423091530123SGM11122233' \
-H 'Authorization: Bearer YOUR_TOKEN'
lightbulb
세그먼트에 자동화가 연결되어 있으면(즉 `automations` 배열이 비어 있지 않으면) 세그먼트 삭제 전에 먼저 수정 API로 `automations`를 비우거나 연결된 자동화 쪽에서 세그먼트 참조를 제거하는 것을 권장한다. 연결된 자동화를 정리하지 않고 삭제하면 자동화의 참조 세그먼트가 유실되어 해당 자동화는 대상 없이 실행되지 않는 상태가 된다.
lightbulb
삭제 작업은 `segment_members` 컬렉션의 멤버 매핑도 함께 제거한다. 매우 큰 세그먼트(수십만 건 이상)를 삭제하는 경우 응답이 다소 지연될 수 있다.