API

개체 삭제

작성일 2026.04.23 | 수정일 2026.04.23

DELETE/crm-core/v1/entities/{entityId}
개체를 휴지통으로 이동(소프트 삭제)합니다. 삭제된 개체는 30일간 보관되며 POST /crm-core/v1/entities/{entityId}/restore로 복원 가능합니다. 개체에 속한 레코드는 즉시 삭제되지 않으며 함께 복구됩니다. MEMBER 이상 권한이 필요합니다.

Path Params

NameTypeRequiredDescription
entityIdstring*삭제할 개체의 고유 ID

Response

성공 시 본문 없이 HTTP 200을 반환합니다.

코드 예제

await fetch('https://api.solapi.com/crm-core/v1/entities/' + entityId, {
  method: 'DELETE',
  headers: { 'Authorization': 'Bearer ' + TOKEN }
});
import requests

requests.delete(
f'https://api.solapi.com/crm-core/v1/entities/{entity_id}',
headers={'Authorization': f'Bearer {TOKEN}'}
)

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

lightbulb

삭제된 개체는 30일 후 GC(Garbage Collection)에 의해 **영구 삭제**됩니다. 영구 삭제 전 강제 제거는 `DELETE /crm-core/v1/entities/{entityId}/permanent`를 사용하세요(OWNER 전용).