API

파일 삭제

작성일 2026.03.18 | 수정일 2026.03.18

DELETE/storage/v1/files/:fileId

Parameters

fileId— 삭제할 파일 ID

파일을 삭제합니다. 다른 리소스에서 참조 중인 파일은 삭제할 수 없습니다.

Response

Name	Type	Required	Description
fileId	string	*	파일 고유 ID (접두사: ST01FZ, 32자)
accountId	string	*	계정 고유 ID
name	string	*	파일명
originalName	string		원본 파일명
url	string	*	파일 접근 URL (S3)
type	string	*	파일 타입
link	string\|null		파일 연결 URL
width	number		이미지 가로 크기 (px)
height	number		이미지 세로 크기 (px)
fileSize	number	*	파일 크기 (bytes)
references	array	*	파일 참조 목록 (업로드 직후에는 빈 배열)
dateCreated	string	*	생성일시 (ISO 8601)
dateUpdated	string	*	수정일시 (ISO 8601)

Structure

Response

{
  "fileId": "ST01FZ_abc12345678901234567890",
  "accountId": "12345678901234",
  "name": "프로모션 배너",
  "originalName": "NyT7u.jpg",
  "url": "https://coolsms-storage.s3.ap-northeast-2.amazonaws.com/12345678901234/ST01FZ_abc12345678901234567890",
  "type": "KAKAO",
  "link": "https://example.com/promotion",
  "width": 800,
  "height": 400,
  "fileSize": 102400,
  "references": [],
  "dateCreated": "2024-07-01T12:00:00.000Z",
  "dateUpdated": "2024-07-01T12:00:00.000Z"
}