API

관계 삭제

작성일 2026.04.23 | 수정일 2026.04.23

DELETE/crm-core/v1/relationships/{relationshipId}
관계 인스턴스를 영구 삭제한다. 삭제 후 소스·대상 레코드의 세그먼트 멤버십이 자동 재평가된다. 권한 요구: MEMBER 이상.

Path Params

NameTypeRequiredDescription
relationshipIdstring관계 ID (CRMRL1...)

Response

NameTypeRequiredDescription
relationshipIdstring삭제된 관계 ID

Structure

코드 예제

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

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

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

lightbulb

삭제한 관계는 복구할 수 없다. 존재하지 않는 관계 ID를 요청하면 404가 반환된다. 관계 삭제는 플랜 사용량(`relationships.max`)을 즉시 감소시킨다.