레코드 일괄 삭제
작성일 2026.04.23 | 수정일 2026.04.23
POST/crm-core/v1/records/bulk/delete
여러 레코드를 1회 요청으로 일괄 삭제합니다. 기본은 소프트 삭제(휴지통 이동)이며 permanent: true로 영구 삭제 가능합니다. 한 번에 최대 1000개. MEMBER 이상 권한이 필요합니다.
Body Params
| Name | Type | Required | Description |
|---|---|---|---|
| recordIds | Array | 삭제할 레코드 ID 목록 (최대 1000개) | |
| permanent | boolean | 영구 삭제 여부. 기본 false(휴지통 이동) |
Response
| Name | Type | Required | Description |
|---|---|---|---|
| deletedCount | number | 실제 삭제된 레코드 수 |
Structure
코드 예제
const response = await fetch('https://api.solapi.com/crm-core/v1/records/bulk/delete', {
method: 'POST',
headers: {
'Authorization': 'Bearer ' + TOKEN,
'Content-Type': 'application/json'
},
body: JSON.stringify({
recordIds: ['CRMRC1260423081530123REC11122233'],
permanent: false
})
});
const result = await response.json();
import requests
response = requests.post(
'https://api.solapi.com/crm-core/v1/records/bulk/delete',
headers={'Authorization': f'Bearer {TOKEN}'},
json={'recordIds': ['CRMRC1260423081530123REC11122233'], 'permanent': False}
)
result = response.json()
curl -X POST 'https://api.solapi.com/crm-core/v1/records/bulk/delete' \
-H 'Authorization: Bearer YOUR_TOKEN' \
-H 'Content-Type: application/json' \
-d '{"recordIds":["CRMRC1260423081530123REC11122233"],"permanent":false}'
lightbulb
`permanent: true`는 되돌릴 수 없습니다. 관련 활동·이벤트 요약·관계도 함께 제거됩니다. 프로덕션 환경에서는 기본값(false)로 휴지통에 보관 후 필요 시 GC에 맡기는 것을 권장합니다.