API

첨부파일 업로드

작성일 2026.03.24 | 수정일 2026.03.25

POST/crm-core/v1/documents/:documentId/attachments

Parameters

documentId*— 문서 고유 아이디

문서에 첨부파일을 업로드합니다. multipart/form-data 형식으로 전송합니다.

허용되는 파일 형식: PDF, DOC, DOCX, XLS, XLSX, HWP, JPG, PNG, GIF, WEBP, TXT.
이미지 파일 최대 10MB, 문서 파일 최대 20MB. 문서당 최대 20개의 첨부파일을 등록할 수 있습니다.

Body Params

Name	Type	Required	Description
file	File	*	업로드할 파일 (multipart/form-data)

Response

Name	Type	Required	Description
attachment	Object	*	업로드된 첨부파일 정보
fileId	string	*	파일 고유 아이디
fileName	string	*	파일 이름
fileSize	number	*	파일 크기 (바이트)
mimeType	string	*	MIME 타입
url	string	*	파일 URL (서명된 URL)
uploadedAt	date	*	업로드 일시
uploadedBy	string		업로드한 멤버 ID

Structure

Response Structure

{
  "attachment": {
    "fileId": "FILE20260324090000ABCDEFGHIJKLMN",
    "fileName": "document.pdf",
    "fileSize": 20,
    "mimeType": "application/pdf",
    "url": "https://storage.solapi.com/files/sample.pdf",
    "uploadedAt": "2026-03-24T09:00:00.000Z",
    "uploadedBy": "샘플값"
  }
}