---
title: "내용 수정 중 문서 데이터 변경"
method: PATCH
path: "/documents/{documentId}/modification"
tags: ["USER API"]
---

# 내용 수정 중 문서 데이터 변경

`PATCH /documents/{documentId}/modification`

## Path parameters

- `documentId` string, required

## Request body

- PatchDocumentModificationRequestDto
  - `title` string — 문서의 제목
  - `fileOpenPassword` string, nullable — 완료 문서 비밀번호 - null로 해제 가능
  - `file` FileRefDocumentFileInDocumentRequestDto
    - `fileId` string, required — 파일 ID
    - `token` string, required — 파일 토큰
  - `participants` ParticipantInPatchModificationDto[] — 참여자 목록. 2단계 병합: (1) 배열 멤버십은 통째 교체 — 기존 참여자는 id로 매칭, id 생략은 신규, 배열에서 누락한 기존 id는 삭제. (2) 각 참여자 내부는 부분 병합 — 생략한 스칼라(name/role/signingDuration 등)·nested(fields/attachmentRequests/checkboxFieldGroups)는 현재값 보존, []로 보내면 해제, verification은 null로 보내면 해제. (요청자 소유 항목은 requesterInputs/requesterAttachments로 분리되어 영향받지 않는다.)
    - `id` string — 기존 참여자의 서버 ID. 생략 시 신규 참여자로 처리됨.
    - `type` 'SIGNER' | 'VIEWER' — 참여자 타입. 신규 참여자(id 생략)는 필수, 기존 참여자(id 지정)는 생략 시 현재 type 보존.
    - `role` string — 참여자의 역할(dataLabel). 생략 시 기존 역할 보존.
    - `name` string — 참여자 이름
    - `requesterMessage` string, nullable — 참여자에게 전달할 남길말
    - `locale` 'ko' | 'en' | 'zh-CN' | 'ja' | 'vi' — 참여자가 사용할 언어
    - `signingOrder` number — 참여 순서
    - `signingDuration` number — 참여 유효 기간(분). 생략 시 기존 값 보존.
    - `signingMethod` SigningMethodInCreateDocumentRequestDto
      - `type` 'KAKAO' | 'EMAIL' | 'SECURE_LINK', required — 참여 수단 종류
      - `value` string, required — 참여자의 참여 수단 (이메일 또는 휴대전화번호)
    - `manuallyViewing` boolean — 수동 열람 여부 (VIEWER)
    - `attachmentRequests` AttachmentRequestInCreateDocumentRequestDto[] — 이 참여자의 첨부 요청 목록. 부재=보존, []=해제.
      - `name` string, required — 첨부파일 이름 (특수문자 /?<>\":*|₩ 이 포함된 이름은 사용할 수 없습니다)
      - `message` string, nullable — 첨부파일에 대한 설명
      - `required` boolean — 필수 여부
    - `verification` VerificationInCreateDocumentRequestDto
      - `password` PasswordInCreateDocumentRequestDto
        - `value` string, required — 비밀번호
        - `hint` string, nullable — 비밀번호 힌트
      - `mobileIdentification` MobileIdentificationInCreateDocumentRequestDto
        - `name` string, required — 휴대폰 본인 인증의 명의자 이름
        - `phoneNumber` string, required — 휴대폰 본인 인증의 명의자 전화번호
        - `allowOptions` string[] — 휴대폰 본인 인증 옵션
      - `dCert` DCertInCreateDocumentRequestDto
        - `name` string, required — 법인 공동인증서 인증 법인명
        - `bizNumber` string, required — 법인 공동인증서 인증 사업자등록번호
    - `fields` unknown[] — 이 참여자 소유 필드 목록. 부재=보존, []=해제.
      - unknown
    - `checkboxFieldGroups` CheckboxGroupInCreateDocumentRequestDto[] — 이 참여자 소유 체크박스 그룹 목록. 부재=보존, []=해제.
      - `groupLabel` string, required — 그룹 라벨
      - `minCheckRequired` 0 | 1, required — 최소 선택 개수. 현재는 0 또는 1만 지원합니다.
      - `maxCheckLimit` number, nullable — 최대 선택 개수. 현재는 1또는 null만 지원합니다. null은 최대 개수까지 선택가능함을 뜻합니다.
  - `requesterInputs` union[] — 요청자의 입력 전체 교체 (id 매칭/생략/누락)
    - union
      - TextInPatchModificationDto
        - `dataLabel` string — 데이터 라벨
        - `type` string, required — 요청자 입력 타입 (예시 값으로 고정되어 있습니다)
        - `position` PositionInCreateDocumentRequestDto, required
          - `x` number, required — 입력란의 가로 좌표
          - `y` number, required — 입력란의 세로 좌표
          - `page` integer, required — 입력란이 위치할 페이지
        - `size` SizeInCreateDocumentRequestDto, required
          - `width` number, required — 입력란의 너비
          - `height` number, required — 입력란의 높이
        - `textStyle` TextFieldStyleInCreateDocumentRequestDto, required
          - `size` 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 24 | 30 | 36 | 48 | 60, required — 텍스트 크기
          - `font` 'NOTO_SANS' | 'NOTO_SERIF', required — 텍스트 글자체
          - `align` 'LEFT' | 'CENTER' | 'RIGHT' — 텍스트 정렬
        - `value` string, required — 텍스트 박스에 입력될 값
        - `id` string — 기존 항목의 서버 ID. 생략 시 신규 입력으로 처리됨.
      - CheckboxInPatchModificationDto
        - `dataLabel` string — 데이터 라벨
        - `type` string, required — 요청자 입력 타입 (예시 값으로 고정되어 있습니다)
        - `position` PositionInCreateDocumentRequestDto, required
          - `x` number, required — 입력란의 가로 좌표
          - `y` number, required — 입력란의 세로 좌표
          - `page` integer, required — 입력란이 위치할 페이지
        - `size` SizeInCreateDocumentRequestDto, required
          - `width` number, required — 입력란의 너비
          - `height` number, required — 입력란의 높이
        - `value` boolean, required — 체크 여부
        - `id` string — 기존 항목의 서버 ID. 생략 시 신규 입력으로 처리됨.
      - ImageInPatchModificationDto
        - `dataLabel` string — 데이터 라벨
        - `type` string, required — 요청자 입력 타입 (예시 값으로 고정되어 있습니다)
        - `position` PositionInCreateDocumentRequestDto, required
          - `x` number, required — 입력란의 가로 좌표
          - `y` number, required — 입력란의 세로 좌표
          - `page` integer, required — 입력란이 위치할 페이지
        - `size` SizeInCreateDocumentRequestDto, required
          - `width` number, required — 입력란의 너비
          - `height` number, required — 입력란의 높이
        - `value` RequesterImageInfoInCreateDocumentRequestDto, required
          - `base64` string, required — 이미지 데이터를 base64로 인코딩한 문자열
        - `id` string — 기존 항목의 서버 ID. 생략 시 신규 입력으로 처리됨.
  - `requesterAttachments` RequesterAttachmentInPatchModificationDto[] — 요청자 첨부파일 전체 교체 (id 매칭/생략/누락)
    - `name` string, required — 첨부파일 이름 (특수문자 /?<>\":*|₩ 이 포함된 이름은 사용할 수 없습니다)
    - `file` FileInfoInCreateDocumentRequestDto, required
      - `fileId` string, required — 파일 업로드 API 를 통해 얻은 파일 ID
      - `token` string, required — 파일 업로드 API 를 통해 얻은 파일 토큰
      - `name` string, required — 첨부파일명 (확장자 제외, 특수문자 /?<>\":*|₩ 이 포함된 이름은 사용할 수 없습니다)
    - `id` string — 기존 항목의 서버 ID. 생략 시 신규 첨부로 처리됨.
  - `carbonCopies` CarbonCopy[] — 참조자 연락처 전체 교체 (id 없음)
    - `contact` string, required — 참조자 연락처 (이메일 주소 또는 휴대전화번호)
    - `locale` 'ko' | 'en' | 'zh-CN' | 'ja' | 'vi' — 참조자 언어
  - `seal` DocumentSealInCreateDocumentRequestDto
    - `integritySeal` IntegritySealInCreateDocumentRequestDto, required
      - `enabled` boolean, required — 진본 증명 도장 활성화 여부
      - `position` 'TOP_LEFT' | 'TOP_RIGHT' | 'BOTTOM_LEFT' | 'BOTTOM_RIGHT', required — 진본 증명 도장 위치

## Response `200`

- DocumentModificationDto
  - `id` string, required — 문서 ID
  - `title` string, required — 문서의 제목
  - `status` 'MODIFYING', required — 수정중 문서 상태
  - `fileOpenPassword` string, nullable, required — 완료문서(.pdf) 비밀번호
  - `file` PdfFileInDocumentResponseDto, required
    - `downloadUrl` string, required — 다운로드 링크(유효시간: 10분)
  - `participants` object[], required — 참여자 정보 (POST /documents 페이로드와 동일 구조 + 각 항목에 id)
    - `id` string — 기존 항목의 서버 ID. PATCH 시 생략하면 신규 항목으로 처리됨. 응답에는 항상 포함.
    - `type` 'SIGNER' | 'VIEWER' — 참여자 타입
    - `role` string — 참여자의 역할
    - `name` string, required — 참여자 이름 (특수문자 /?<>\":*|₩ 이 포함된 이름은 사용할 수 없습니다)
    - `requesterMessage` string, nullable — 참여자에게 전달할 남길말
    - `locale` 'ko' | 'en' | 'zh-CN' | 'ja' | 'vi' — 참여자가 사용할 언어
    - `signingOrder` integer, required — 참여 순서. 순서 없이 참여하려면 모두 1로 설정하세요.
    - `signingDuration` integer — 참여자의 참여 유효 기간 (분) * 미지정시 기본값 20160분 (14일)
    - `signingMethod` SigningMethodInCreateDocumentRequestDto, required
      - `type` 'KAKAO' | 'EMAIL' | 'SECURE_LINK', required — 참여 수단 종류
      - `value` string, required — 참여자의 참여 수단 (이메일 또는 휴대전화번호)
    - `attachmentRequests` AttachmentRequestInCreateDocumentRequestDto[] — 첨부파일 요청 정보
      - `name` string, required — 첨부파일 이름 (특수문자 /?<>\":*|₩ 이 포함된 이름은 사용할 수 없습니다)
      - `message` string, nullable — 첨부파일에 대한 설명
      - `required` boolean — 필수 여부
    - `verification` VerificationInCreateDocumentRequestDto
      - `password` PasswordInCreateDocumentRequestDto
        - `value` string, required — 비밀번호
        - `hint` string, nullable — 비밀번호 힌트
      - `mobileIdentification` MobileIdentificationInCreateDocumentRequestDto
        - `name` string, required — 휴대폰 본인 인증의 명의자 이름
        - `phoneNumber` string, required — 휴대폰 본인 인증의 명의자 전화번호
        - `allowOptions` string[] — 휴대폰 본인 인증 옵션
      - `dCert` DCertInCreateDocumentRequestDto
        - `name` string, required — 법인 공동인증서 인증 법인명
        - `bizNumber` string, required — 법인 공동인증서 인증 사업자등록번호
    - `fields` union[] — 참여자 필드 정보 (VIEWER 타입 참여자는 필드를 가질 수 없음)
      - union
        - TextFieldInCreateDocumentRequestDto
          - `dataLabel` string — 데이터 라벨
          - `type` string, required — 필드 타입 (TEXT로 요청해야 합니다)
          - `required` boolean — 필수 여부
          - `size` TextFieldSizeInCreateDocumentRequestDto, required
            - `width` number, required — 입력란의 너비
            - `height` number, required — 입력란의 높이
          - `position` union, required — 입력란의 위치. 좌표(x,y,page) 또는 anchor 중 하나만 지정
            - CoordinatePositionInCreateDocumentRequestDto
              - …
            - AnchorPositionInCreateDocumentRequestDto
              - …
          - `textStyle` TextFieldStyleInCreateDocumentRequestDto, required
            - `size` 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 24 | 30 | 36 | 48 | 60, required — 텍스트 크기
            - `font` 'NOTO_SANS' | 'NOTO_SERIF', required — 텍스트 글자체
            - `align` 'LEFT' | 'CENTER' | 'RIGHT' — 텍스트 정렬
          - `format` union — 입력 형식 (정규 표현식 등)
            - PhoneNumberFormatInCreateDocumentRequestDto
              - …
            - BankAccountNumberFormatInCreateDocumentRequestDto
              - …
            - BizNumberFormatInCreateDocumentRequestDto
              - …
            - RegexFormatInCreateDocumentRequestDto
              - …
          - `prefilledValue` string, nullable — 사전 입력값
        - CheckboxFieldInCreateDocumentRequestDto
          - `dataLabel` string — 데이터 라벨. 그룹 라벨과 함께 사용할 수 없습니다.
          - `type` string, required — 필드 타입 (CHECKBOX로 요청해야 합니다)
          - `required` boolean — 필수 여부 - 체크박스가 그룹에 속하는 경우 무시됩니다.
          - `size` CheckboxFieldSizeInCreateDocumentRequestDto, required
            - `width` number, required — 입력란의 너비
          - `position` PositionInCreateDocumentRequestDto, required
            - `x` number, required — 입력란의 가로 좌표
            - `y` number, required — 입력란의 세로 좌표
            - `page` integer, required — 입력란이 위치할 페이지
          - `valueDescription` string — 체크박스 내용, 체크박스를 호버하거나 한번에 선택할때 서명자에게 노출됩니다.
          - `enableOneClick` boolean — 체크박스를 한번에 선택(체크) 할 수 있는 여부, 문서 서명시 활성화된 체크박스는 서명자가 확인 후 한번에 체크할 수 있습니다.
          - `prefilledValue` boolean, nullable — 사전 입력값
          - `groupLabel` string — 그룹 라벨
        - SignatureFieldInCreateDocumentRequestDto
          - `dataLabel` string — 데이터 라벨
          - `type` string, required — 필드 타입 (SIGNATURE로 요청해야 합니다)
          - `required` boolean, required — 필수 여부 - type이 `SIGNATURE`일 경우는 무조건 true가 됩니다.
          - `signatureTypes` string[], required — 서명 타입
          - `allowedGenerationMethods` string[] — 서명 생성 방식
          - `size` SignatureFieldSizeInCreateDocumentRequestDto
            - `width` number, required — 입력란의 너비
            - `height` number, required — 입력란의 높이
          - `position` union, required — 입력란의 위치. 좌표(x,y,page) 또는 anchor 중 하나만 지정
            - CoordinatePositionInCreateDocumentRequestDto
              - …
            - AnchorPositionInCreateDocumentRequestDto
              - …
          - `enableOneClick` boolean — 한번에 서명 활성화 여부
        - SigningDateInCreateDocumentRequestDto
          - `dataLabel` string — 데이터 라벨
          - `type` string, required — 필드 타입 (SIGNING_DATE로 요청해야 합니다)
          - `size` SigningDateFieldSizeInCreateDocumentRequestDto, required
            - `width` number, required — 입력란의 너비
            - `height` number, required — 입력란의 높이
          - `position` PositionInCreateDocumentRequestDto, required
            - `x` number, required — 입력란의 가로 좌표
            - `y` number, required — 입력란의 세로 좌표
            - `page` integer, required — 입력란이 위치할 페이지
          - `textStyle` TextFieldStyleInCreateDocumentRequestDto, required
            - `size` 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 24 | 30 | 36 | 48 | 60, required — 텍스트 크기
            - `font` 'NOTO_SANS' | 'NOTO_SERIF', required — 텍스트 글자체
            - `align` 'LEFT' | 'CENTER' | 'RIGHT' — 텍스트 정렬
          - `displayFormat` 'YYYY-MM-DD' | 'YYYY/DD/MM' | 'YYYY.MM.DD' | 'YYYYMMDD' | 'YYYY년 MM월 DD일' | 'DD-MM-YYYY' | 'DD/MM/YYYY' | 'DD.MM.YYYY' | 'DDMMYYYY' | 'DD일 MM월 YYYY년' | 'MM-DD-YYYY' | 'MM/DD/YYYY' | 'MM.DD.YYYY' | 'MMDDYYYY' | 'MM월 DD일 YYYY년' | 'YYYY/MM/DD' | 'YYYY-DD-MM' | 'YYYY.DD.MM' | 'YYYYDDMM' | 'YYYY년 DD일 MM월' | 'YY-MM-DD' | 'YY/MM/DD' | 'YY.MM.DD' | 'YYMMDD' | 'YY년 MM월 DD일' | 'DD-MM-YY' | 'DD/MM/YY' | 'DD.MM.YY' | 'DDMMYY' | 'DD일 MM월 YY년' | 'MM-DD-YY' | 'MM/DD/YY' | 'MM.DD.YY' | 'MMDDYY' | 'MM월 DD일 YY년' | 'YY-DD-MM' | 'YY/DD/MM' | 'YY.DD.MM' | 'YYDDMM' | 'YY년 DD일 MM월', required — 날짜 표기 형식
        - ImageFieldInCreateDocumentRequestDto
          - `dataLabel` string — 데이터 라벨
          - `type` string, required — 필드 타입 (IMAGE로 요청해야 합니다)
          - `required` boolean — 필수 여부
          - `size` SizeInCreateDocumentRequestDto, required
            - `width` number, required — 입력란의 너비
            - `height` number, required — 입력란의 높이
          - `position` PositionInCreateDocumentRequestDto, required
            - `x` number, required — 입력란의 가로 좌표
            - `y` number, required — 입력란의 세로 좌표
            - `page` integer, required — 입력란이 위치할 페이지
        - DateFieldInCreateDocumentRequestDto
          - `dataLabel` string — 데이터 라벨
          - `type` string, required — 필드 타입 (DATE로 요청해야 합니다)
          - `required` boolean — 필수 여부
          - `size` SizeInCreateDocumentRequestDto, required
            - `width` number, required — 입력란의 너비
            - `height` number, required — 입력란의 높이
          - `position` PositionInCreateDocumentRequestDto, required
            - `x` number, required — 입력란의 가로 좌표
            - `y` number, required — 입력란의 세로 좌표
            - `page` integer, required — 입력란이 위치할 페이지
          - `textStyle` TextFieldStyleInCreateDocumentRequestDto, required
            - `size` 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 24 | 30 | 36 | 48 | 60, required — 텍스트 크기
            - `font` 'NOTO_SANS' | 'NOTO_SERIF', required — 텍스트 글자체
            - `align` 'LEFT' | 'CENTER' | 'RIGHT' — 텍스트 정렬
          - `displayFormat` 'YYYY-MM-DD' | 'YYYY/DD/MM' | 'YYYY.MM.DD' | 'YYYYMMDD' | 'YYYY년 MM월 DD일' | 'DD-MM-YYYY' | 'DD/MM/YYYY' | 'DD.MM.YYYY' | 'DDMMYYYY' | 'DD일 MM월 YYYY년' | 'MM-DD-YYYY' | 'MM/DD/YYYY' | 'MM.DD.YYYY' | 'MMDDYYYY' | 'MM월 DD일 YYYY년' | 'YYYY/MM/DD' | 'YYYY-DD-MM' | 'YYYY.DD.MM' | 'YYYYDDMM' | 'YYYY년 DD일 MM월' | 'YY-MM-DD' | 'YY/MM/DD' | 'YY.MM.DD' | 'YYMMDD' | 'YY년 MM월 DD일' | 'DD-MM-YY' | 'DD/MM/YY' | 'DD.MM.YY' | 'DDMMYY' | 'DD일 MM월 YY년' | 'MM-DD-YY' | 'MM/DD/YY' | 'MM.DD.YY' | 'MMDDYY' | 'MM월 DD일 YY년' | 'YY-DD-MM' | 'YY/DD/MM' | 'YY.DD.MM' | 'YYDDMM' | 'YY년 DD일 MM월', required — 날짜 표기 형식
          - `prefilledValue` string, nullable — 사전 입력값 (ISO 8601 형식)
        - DropdownFieldInCreateDocumentRequestDto
          - `dataLabel` string — 데이터 라벨
          - `type` string, required — 필드 타입 (DROPDOWN으로 요청해야 합니다)
          - `required` boolean — 필수 여부
          - `size` SizeInCreateDocumentRequestDto, required
            - `width` number, required — 입력란의 너비
            - `height` number, required — 입력란의 높이
          - `position` PositionInCreateDocumentRequestDto, required
            - `x` number, required — 입력란의 가로 좌표
            - `y` number, required — 입력란의 세로 좌표
            - `page` integer, required — 입력란이 위치할 페이지
          - `options` DropdownOptionInCreateDocumentRequestDto[], required — 드롭다운 옵션 목록
            - `value` string, required — 드롭다운 옵션 값
          - `textStyle` TextFieldStyleInCreateDocumentRequestDto, required
            - `size` 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 24 | 30 | 36 | 48 | 60, required — 텍스트 크기
            - `font` 'NOTO_SANS' | 'NOTO_SERIF', required — 텍스트 글자체
            - `align` 'LEFT' | 'CENTER' | 'RIGHT' — 텍스트 정렬
          - `prefilledValue` string, nullable — 사전 입력값
        - NameFieldInCreateDocumentRequestDto
          - `dataLabel` string — 데이터 라벨
          - `type` string, required — 필드 타입 (NAME으로 요청해야 합니다)
          - `required` boolean — 필수 여부
          - `size` SizeInCreateDocumentRequestDto, required
            - `width` number, required — 입력란의 너비
            - `height` number, required — 입력란의 높이
          - `position` PositionInCreateDocumentRequestDto, required
            - `x` number, required — 입력란의 가로 좌표
            - `y` number, required — 입력란의 세로 좌표
            - `page` integer, required — 입력란이 위치할 페이지
          - `textStyle` TextFieldStyleInCreateDocumentRequestDto, required
            - `size` 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 24 | 30 | 36 | 48 | 60, required — 텍스트 크기
            - `font` 'NOTO_SANS' | 'NOTO_SERIF', required — 텍스트 글자체
            - `align` 'LEFT' | 'CENTER' | 'RIGHT' — 텍스트 정렬
        - CompanyNameFieldInCreateDocumentRequestDto
          - `dataLabel` string — 데이터 라벨
          - `type` string, required — 필드 타입 (COMPANY_NAME으로 요청해야 합니다)
          - `required` boolean — 필수 여부
          - `size` SizeInCreateDocumentRequestDto, required
            - `width` number, required — 입력란의 너비
            - `height` number, required — 입력란의 높이
          - `position` PositionInCreateDocumentRequestDto, required
            - `x` number, required — 입력란의 가로 좌표
            - `y` number, required — 입력란의 세로 좌표
            - `page` integer, required — 입력란이 위치할 페이지
          - `textStyle` TextFieldStyleInCreateDocumentRequestDto, required
            - `size` 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 24 | 30 | 36 | 48 | 60, required — 텍스트 크기
            - `font` 'NOTO_SANS' | 'NOTO_SERIF', required — 텍스트 글자체
            - `align` 'LEFT' | 'CENTER' | 'RIGHT' — 텍스트 정렬
          - `prefilledValue` string, nullable — 사전 입력값
        - AddressFieldInCreateDocumentRequestDto
          - `dataLabel` string — 데이터 라벨
          - `type` string, required — 필드 타입 (ADDRESS로 요청해야 합니다)
          - `required` boolean — 필수 여부
          - `size` SizeInCreateDocumentRequestDto, required
            - `width` number, required — 입력란의 너비
            - `height` number, required — 입력란의 높이
          - `position` PositionInCreateDocumentRequestDto, required
            - `x` number, required — 입력란의 가로 좌표
            - `y` number, required — 입력란의 세로 좌표
            - `page` integer, required — 입력란이 위치할 페이지
          - `textStyle` TextFieldStyleInCreateDocumentRequestDto, required
            - `size` 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 24 | 30 | 36 | 48 | 60, required — 텍스트 크기
            - `font` 'NOTO_SANS' | 'NOTO_SERIF', required — 텍스트 글자체
            - `align` 'LEFT' | 'CENTER' | 'RIGHT' — 텍스트 정렬
          - `prefilledValue` AddressPrefilledValueInCreateDocumentRequestDto
            - `address1` string, required — 기본 주소
            - `address2` string, nullable — 상세 주소
            - `city` string, nullable — 시군구
            - `province` string, required — 도시
            - `zip` string, required — 우편번호
            - `country` 'KR', required — 나라
    - `checkboxFieldGroups` CheckboxGroupInCreateDocumentRequestDto[] — 체크박스 그룹
      - `groupLabel` string, required — 그룹 라벨
      - `minCheckRequired` 0 | 1, required — 최소 선택 개수. 현재는 0 또는 1만 지원합니다.
      - `maxCheckLimit` number, nullable — 최대 선택 개수. 현재는 1또는 null만 지원합니다. null은 최대 개수까지 선택가능함을 뜻합니다.
  - `requesterInputs` union[], required — 요청자의 입력 (POST /documents 페이로드와 동일 구조 + 각 항목에 id)
    - union
      - object
        - `id` string — 기존 항목의 서버 ID. PATCH 시 생략하면 신규 항목으로 처리됨. 응답에는 항상 포함.
        - `dataLabel` string — 데이터 라벨
        - `type` string, required — 요청자 입력 타입 (예시 값으로 고정되어 있습니다)
        - `position` PositionInCreateDocumentRequestDto, required
          - `x` number, required — 입력란의 가로 좌표
          - `y` number, required — 입력란의 세로 좌표
          - `page` integer, required — 입력란이 위치할 페이지
        - `size` SizeInCreateDocumentRequestDto, required
          - `width` number, required — 입력란의 너비
          - `height` number, required — 입력란의 높이
        - `textStyle` TextFieldStyleInCreateDocumentRequestDto, required
          - `size` 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 24 | 30 | 36 | 48 | 60, required — 텍스트 크기
          - `font` 'NOTO_SANS' | 'NOTO_SERIF', required — 텍스트 글자체
          - `align` 'LEFT' | 'CENTER' | 'RIGHT' — 텍스트 정렬
        - `value` string, required — 텍스트 박스에 입력될 값
      - object
        - `id` string — 기존 항목의 서버 ID. PATCH 시 생략하면 신규 항목으로 처리됨. 응답에는 항상 포함.
        - `dataLabel` string — 데이터 라벨
        - `type` string, required — 요청자 입력 타입 (예시 값으로 고정되어 있습니다)
        - `position` PositionInCreateDocumentRequestDto, required
          - `x` number, required — 입력란의 가로 좌표
          - `y` number, required — 입력란의 세로 좌표
          - `page` integer, required — 입력란이 위치할 페이지
        - `size` SizeInCreateDocumentRequestDto, required
          - `width` number, required — 입력란의 너비
          - `height` number, required — 입력란의 높이
        - `value` boolean, required — 체크 여부
      - object
        - `id` string — 기존 항목의 서버 ID. PATCH 시 생략하면 신규 항목으로 처리됨. 응답에는 항상 포함.
        - `dataLabel` string — 데이터 라벨
        - `type` string, required — 요청자 입력 타입 (예시 값으로 고정되어 있습니다)
        - `position` PositionInCreateDocumentRequestDto, required
          - `x` number, required — 입력란의 가로 좌표
          - `y` number, required — 입력란의 세로 좌표
          - `page` integer, required — 입력란이 위치할 페이지
        - `size` SizeInCreateDocumentRequestDto, required
          - `width` number, required — 입력란의 너비
          - `height` number, required — 입력란의 높이
        - `value` RequesterImageInfoInCreateDocumentRequestDto, required
          - `base64` string, required — 이미지 데이터를 base64로 인코딩한 문자열
  - `requesterAttachments` object[], required — 요청자 첨부파일 정보 (POST /documents 페이로드와 동일 구조 + 각 항목에 id)
    - `id` string — 기존 항목의 서버 ID. PATCH 시 생략하면 신규 항목으로 처리됨. 응답에는 항상 포함.
    - `name` string, required — 첨부파일 이름 (특수문자 /?<>\":*|₩ 이 포함된 이름은 사용할 수 없습니다)
    - `file` FileInfoInCreateDocumentRequestDto, required
      - `fileId` string, required — 파일 업로드 API 를 통해 얻은 파일 ID
      - `token` string, required — 파일 업로드 API 를 통해 얻은 파일 토큰
      - `name` string, required — 첨부파일명 (확장자 제외, 특수문자 /?<>\":*|₩ 이 포함된 이름은 사용할 수 없습니다)
  - `carbonCopies` CarbonCopy[], required — 참조자 연락처 정보 (POST /documents 페이로드와 동일 구조)
    - `contact` string, required — 참조자 연락처 (이메일 주소 또는 휴대전화번호)
    - `locale` 'ko' | 'en' | 'zh-CN' | 'ja' | 'vi' — 참조자 언어
  - `seal` DocumentSealInDocumentResponseDto, required
    - `integritySeal` IntegritySealInDocumentResponseDto, required
      - `enabled` boolean, required — 진본 증명 도장 활성화 여부
      - `position` 'TOP_LEFT' | 'TOP_RIGHT' | 'BOTTOM_LEFT' | 'BOTTOM_RIGHT', required — 진본 증명 도장 위치
  - `requester` RequesterInDocumentResponseDto, required
    - `email` string, required — 요청자 이메일
    - `name` string, required — 요청자 이름
  - `currentSigningOrder` integer, required — 현재 참여 차례 (read-only — PATCH 미지원)
  - `signings` SigningInDocumentResponseDto[], required — 입력된 서명, 열람 완료된 참여자 리스트 (read-only — PATCH 미지원)
    - `participantId` string, required — 참여한 참여자 ID
    - `signedAt` string, date-time, required — 참여한 시간
  - `abort` AbortInDocumentResponseDto, required
    - `type` 'REJECTION' | 'SIGNING_CANCELLATION' | 'REQUEST_CANCELLATION', required — 중단 종류: * `REJECTION` - 거절됨 * `SIGNING_CANCELLATION` - 참여 취소됨 * `REQUEST_CANCELLATION` - 요청 취소됨
    - `message` string, required — 중단 사유
    - `abortedAt` string, date-time, required — 중단 시점
    - `participantId` string, nullable, required — 중단한 참여자 ID (거절 또는 참여 취소 시)
  - `createdAt` string, date, required — 문서 생성 시간 (read-only)
  - `updatedAt` string, date, required — 마지막 업데이트 시간 (read-only)
  - `startedAt` string, date, nullable, required — 참여 요청 시간 (read-only)

## Other responses

- `422` — 수정 중 상태가 아님

---

[API](https://skmtc.net/modusign/apis/modusign-api.md) · [All operations](https://skmtc.net/modusign/apis/modusign-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/modusign/modusign-api/versions/5772e872cbf9/schema)