API

관계 유형 삭제

작성일 2026.04.23 | 수정일 2026.04.23

DELETE/crm-core/v1/relationships/types/{relationshipTypeId}
관계 유형을 영구 삭제한다. 권한 요구: MEMBER 이상.

Path Params

NameTypeRequiredDescription
relationshipTypeIdstring관계 유형 ID (CRMRT1...)

Response

NameTypeRequiredDescription
relationshipTypeIdstring삭제된 관계 유형 ID

Structure

코드 예제

const id = 'CRMRT1260423091530123RTP11122233';
const response = await fetch(https://api.solapi.com/crm-core/v1/relationships/types/${id}, {
  method: 'DELETE',
  headers: { 'Authorization': 'Bearer ' + TOKEN }
});
const data = await response.json();
import requests

type_id = 'CRMRT1260423091530123RTP11122233'
response = requests.delete(
f'https://api.solapi.com/crm-core/v1/relationships/types/{type_id}',
headers={'Authorization': f'Bearer {TOKEN}'}
)
data = response.json()

curl -X DELETE 'https://api.solapi.com/crm-core/v1/relationships/types/CRMRT1260423091530123RTP11122233' \
  -H 'Authorization: Bearer YOUR_TOKEN'

lightbulb

관계 유형 삭제는 해당 유형의 기존 관계 인스턴스를 자동으로 정리하지 않는다. 유형을 삭제한 뒤에도 기존 관계 도큐먼트는 `relationshipTypeId`가 존재하지 않는 유령 상태로 남을 수 있으므로, 삭제 전 `GET /relationships/list?relationshipTypeId=...`로 남은 인스턴스를 확인하고 선정리하는 것을 권장한다.

lightbulb

존재하지 않는 관계 유형 ID를 요청하면 404가 반환된다. 삭제 성공 시 플랜 사용량(`relationshipTypes.maxPerEntity`)이 즉시 감소한다.