Admin APIAdmin Dashboard API
DELETE /ai/admin/dashboard/{campaignNo}/admin-held-applicants
불러온 크리에이터 삭제 (선택/전체)
불러온 크리에이터 삭제
리스트 관리에서 불러온 크리에이터(sourceType=ADMIN_ADDED)를 하드 삭제합니다. 한 API로 선택 삭제와 전체 삭제를 모두 처리합니다.
- 선택 삭제:
applicationIds에 체크한 행의 ID를 넣습니다. - 전체 삭제:
deleteAll: true. 이 캠페인에서 삭제할 수 있는 행을 모두 지웁니다.
삭제 대상 조건 ("담아두기만 한" 행)
아래를 모두 만족하는 행만 삭제됩니다. 조건에 맞지 않는 행은 지우지 않고 skippedApplicationIds로 돌려줍니다. 그런 행은 기존 제외(ELIMINATED)로 처리하세요.
sourceType = ADMIN_ADDED(직접 신청한 행은 대상 아님)- 협업 단가를 한 번도 보내지 않음 (단가 제안 이력 없음)
- 선정·제안 상태가 아님 (
selectionStatus,businessSelectionStatus모두SELECTED/PROPOSAL아님) - 계약·배송·크리에이터 예산·정산·검수 제출물·최종 제출물이 하나도 없음
삭제되면 함께 사라지는 것
매칭 정보(노출가·추천사·적합도), 추천사 이력, 연락 로그 등 신청에 딸린 행이 같이 삭제됩니다. 다른 캠페인의 리스트 관리에서 이 크리에이터에게 붙던 기리스트 칩 판정에서도 이 캠페인이 빠집니다. 되돌릴 수 없으니 필요하면 다시 불러오세요.
광고주 대시보드에 노출(adminVisible=true) 중인 행도 조건만 맞으면 삭제되고, 광고주 화면에서도 사라집니다.
HTTP 요청
DELETE /ai/admin/dashboard/{campaignNo}/admin-held-applicants
Authorization: Bearer {access_token}
Content-Type: application/jsonPath Parameters
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
campaignNo | Long | 예 | 캠페인 번호 |
Request Body
선택 삭제
{
"applicationIds": [101, 102, 103]
}전체 삭제
{
"deleteAll": true
}| 필드 | 타입 | 필수 | 설명 |
|---|---|---|---|
applicationIds | List<Long> | 조건부 | 삭제할 신청 ID (리스트 관리 items[].applicationId). deleteAll=true면 무시 |
deleteAll | Boolean | 조건부 | true면 이 캠페인의 삭제 가능한 행 전체 삭제 |
둘 중 하나는 반드시 있어야 합니다. applicationIds가 비어 있고 deleteAll도 true가 아니면 400을 반환합니다. 빈 목록을 보냈다고 전체 삭제가 되지는 않습니다.
응답
성공 응답 (200 OK)
{
"status": 200,
"code": null,
"message": "2명 삭제, 1명은 단가 제안·선정 등 진행 이력이 있어 삭제하지 않았습니다.",
"data": {
"deletedCount": 2,
"deletedApplicationIds": [101, 103],
"skippedApplicationIds": [102],
"message": "2명 삭제, 1명은 단가 제안·선정 등 진행 이력이 있어 삭제하지 않았습니다."
}
}응답 필드 설명
| 필드 | 타입 | 설명 |
|---|---|---|
deletedCount | Integer | 삭제된 신청 수 |
deletedApplicationIds | List<Long> | 삭제된 신청 ID |
skippedApplicationIds | List<Long> | 조건에 맞지 않아 건너뛴 신청 ID (다른 캠페인 ID·없는 ID·데모 후보 ID 포함). 전체 삭제에서는 항상 빈 배열 |
message | String | 결과 메시지 |
에러 응답
| 상태 코드 | 설명 |
|---|---|
400 | applicationIds와 deleteAll 모두 없음 |
401 / 403 | 인증 실패 / 관리자 아님 |
404 | 캠페인을 찾을 수 없음 |
데모(목업) 후보는 이 API로 지울 수 없습니다. 데모 후보 삭제를 사용하세요.