Waafir
이 페이지는 사람의 검토를 기다리는 기계 번역입니다. 오류가 있을 수 있습니다.

waafir-dataroom 참조

waafir-dataroom 서버는 이번 릴리스의 안정적인 API 인터페이스입니다. 이 서버는 데이터룸을 읽고 관리하기 위한 아래 도구들을 제공하며, 도구는 용도별로 읽기 도구, 폴더 도구, 파일 도구(파일 수명 주기 및 파일 버전), 문서 텍스트 도구, 권한 도구, Q&A 도구로 분류됩니다.

연결: https://app.waafir.io/api/mcp/waafir 또는 영역 서버 https://app.waafir.io/api/mcp/waafir-dataroom — 설정을 참조하세요.

도구 이름. 아래의 각 도구는 waafir가 나열하는 이름(예: dataroom_list_files)을 제목으로 합니다. 영역 서버는 각 제목 아래에 "영역 엔드포인트 이름"으로 표시된 이전 이름(예: list_files)을 나열하며, 클라이언트가 그 이름으로 호출해도 waafir는 여전히 이를 받아들입니다. 도구 설명이나 결과에서 다음에 호출할 다른 도구를 지정하는 경우(next_step, restore_with, undo_with), 연결된 엔드포인트가 나열하는 방식대로 그 이름을 표시합니다. 이 페이지의 설명은 영역 엔드포인트 이름을 사용합니다.

접근 제어 방식

이 페이지에서 토큰은 어시스턴트가 사용하는 자격 증명, 즉 로그인으로 생성된 연결 또는 개인 액세스 토큰을 뜻합니다. 둘 다 범위와 선택적인 데이터룸 목록을 가지며, 같은 방식으로 제한됩니다.

모든 도구는 토큰 소유자로서 실행되며 제품 UI가 적용하는 것과 동일한 규칙으로 제한됩니다. MCP를 통한 더 느슨한 경로는 없습니다. 모든 호출에는 두 가지 관문이 적용됩니다.

  • 범위. 각 도구에는 최소 범위가 명시되어 있습니다. 읽기 도구에는 read, 폴더 및 파일 변경에는 write, 권한 부여 도구에는 admin이 필요합니다. 필요한 범위보다 낮은 토큰에는 해당 도구가 표시되지 않으며, 호출하면 FORBIDDEN 오류로 거부됩니다(실패가 보고되는 방식 참조). 범위는 누적됩니다. write는 read를 포함하고, admin은 둘 다 포함합니다.
  • 데이터룸 범위 지정. 토큰이 특정 데이터룸으로 제한된 경우, 허용 목록 밖의 데이터룸을 참조하는 호출은 모두 거부되며, 범위가 지정된 토큰은 열 수 없는 데이터룸을 목록으로 조회하는 것조차 할 수 없습니다. 검사는 리소스가 속한 데이터룸을 기준으로 하므로, 데이터룸 A로 범위가 지정된 토큰은 같은 조직 안이라도 데이터룸 B의 파일이나 폴더에 결코 접근할 수 없습니다.

또한 폴더 및 파일 변경에는 해당 데이터룸의 딜 팀 역할이 필요하며(투자자는 변경할 수 없음), 권한 도구는 추가로 토큰 소유자가 조직의 관리자 또는 매니저여야 합니다. 폴더나 파일 삭제는 항상 소프트 삭제입니다. 행은 삭제됨으로 표시되어 보존 및 감사를 위해 유지되며, 물리적으로 제거되지 않습니다. 모든 변경은 제품 UI가 기록하는 것과 같은 감사 이벤트로 기록되므로, 감사 로그에서 MCP 작업과 UI 작업은 구별되지 않습니다.

식별자(dataroom_id, folder_id, file_id, user_id)는 UUID입니다.

결과에 포함된 신뢰할 수 없는 텍스트

일부 결과에는 Waafir가 작성하지 않은 텍스트가 포함됩니다. 문서에 대한 AI 출력, 문서 자체의 텍스트, 또는 투자자나 동료가 작성한 내용입니다. 이러한 결과에는 untrusted_content: { source, fields, notice }가 추가되며, 같은 { source, fields }가 _meta["io.waafir/untrusted"] 아래에도 들어갑니다. source는 "document" 또는 "third-party"입니다. fields는 이 결과에서 그러한 텍스트가 담긴 경로(예: answer 또는 questions[].responses[].body)를 나열하며, 결과에 해당 경로의 값이 있을 때만 나열됩니다. 이 필드들은 데이터로 취급하고, 절대 어시스턴트에 대한 지시로 취급하지 마세요.

표시되는 도구는 dataroom_get_file_text, dataroom_get_file_metadata, dataroom_list_questions, dataroom_get_question, dataroom_list_kb_articles, dataroom_get_kb_article, dataroom_edit_question, dataroom_answer_question, dataroom_delete_question, dataroom_delete_answer 및 dataroom_publish_kb_article의 미리보기(투자자의 제목), dataroom_get_update, dataroom_edit_update_draft, dataroom_get_published_update, dataroom_list_file_comments, dataroom_list_my_notifications, mi_get_profile, 그리고 dataroom_apply_organise를 제외한 모든 AI 도구입니다. 파일 이름은 표시되지 않습니다.

실패가 보고되는 방식

도구 실패는 HTTP 상태가 아닙니다. 도구가 호출을 거부해도 HTTP 응답은 여전히 200이고 JSON-RPC 엔벨로프는 여전히 성공 엔벨로프입니다. 실패는 결과 안에 담겨 전달되며, 이 결과는 isError: true로 설정되고 텍스트 콘텐츠는 다음과 같습니다.

{ "error": { "code": "CONFLICT", "message": "…" } }

HTTP 상태가 아니라 항상 error.code로 분기하세요. 상태로 분기하는 클라이언트는 이 페이지의 어떤 거부와도 일치하지 않습니다. 데이터룸 도구가 반환하는 코드는 다음과 같습니다.

코드의미조치 방법
INVALID_ARGUMENT인수가 없거나, 형식이 잘못되었거나, 유효한 id가 아님인수를 수정하고 재시도
FORBIDDEN토큰은 유효하지만 허용되지 않음 — 범위가 너무 낮거나, 전달한 dataroom_id가 데이터룸 허용 목록 밖에 있거나, 소유자의 역할이 이를 허용하지 않음접근 권한을 요청하거나 올바른 범위의 토큰 사용
NOT_FOUND해당 레코드가 없거나 본인의 것이 아님. 파일이나 폴더 id를 받는 대부분의 도구는 토큰의 허용 목록 밖에 있는 데이터룸의 항목에 대해서도 존재하지 않는 id와 정확히 같게 이 코드로 응답함id를 확인하고, 토큰의 범위가 해당 항목의 데이터룸으로 지정되어 있는지 확인
CONFLICT이해되었고 허용되었지만, 데이터룸이 이를 수행할 수 있는 상태가 아님메시지를 읽고 차단 요인을 해결한 후 재시도
TOO_LARGE입력이 크기 제한을 초과함입력을 나누기
QUOTA_EXCEEDED계량 한도를 모두 사용했거나, 조직의 구독이 만료됨누군가 구매하거나 업그레이드해야 함 — 재시도로는 해결되지 않음
UPSTREAM_ERROR다운스트림 서비스 실패 — 저장된 문서를 가져올 수 없었거나 텍스트 추출에 실패함일시적. 나중에 재시도한 후에 치명적 오류로 판단
UNAVAILABLEWaafir가 지금은 요청을 처리할 수 없음: 파일이 아직 검사 중이거나, 저장된 파일을 검사를 위해 읽을 수 없었거나, 읽기를 감사 로그에 기록할 수 없어 기록 없이 공개하는 대신 콘텐츠를 보류함일시적. 나중에 재시도
INTERNAL예기치 않은 실패재시도하지 말고 에스컬레이션

나중에 재시도해야 하는 두 코드를 "실패"로 뭉뚱그리지 마세요. UPSTREAM_ERROR와 UNAVAILABLE은 현재 get_file_text에서 반환되며, 포기하라가 아니라 다시 요청하라는 뜻입니다. OK가 아닌 모든 결과를 최종 상태로 취급하는 클라이언트는 일시적인 문제를 영구적인 실패로 만들어 버립니다. 이 표는 바로 그 실수를 막기 위해 존재합니다. 또한 UNAVAILABLE은 의도적인 거부라는 점에 유의하세요. Waafir는 감사 기록 없이 문서의 텍스트를 넘겨주기보다 차라리 보류합니다.

아직 검사 중인 파일. Waafir는 새로 업로드된 모든 파일과 모든 새 버전을 콘텐츠를 제공하기 전에 검사합니다. 검사가 끝날 때까지 파일의 콘텐츠를 읽는 도구는 error.reason과 함께 UNAVAILABLE을 반환합니다.

{ "error": { "code": "UNAVAILABLE", "reason": "ACTIVATION_PENDING", "message": "This file is still being checked. Try again shortly." } }

이는 일시적입니다. 잠시 기다린 후 다시 호출하세요. 이전 릴리스에서는 이 경우 CONFLICT를 반환했습니다. 메시지가 아니라 error.reason으로 분기하세요. 검사에는 다른 결과가 두 가지 더 있습니다. 데이터룸 도구에서는 이 두 결과에 reason이 없으며, 메시지가 괄호 안의 코드로 끝납니다.

  • 차단됨: 파일이 콘텐츠 검사를 통과하지 못했습니다. INVALID_ARGUMENT가 반환되며 메시지는 (ACTIVATION_BLOCKED)로 끝납니다. 이 파일은 다시 시도해도 성공할 수 없습니다.
  • 읽을 수 없음: 저장된 파일을 검사를 위해 읽을 수 없었습니다. UNAVAILABLE이 반환되며 메시지는 (CONTENT_UNREADABLE)로 끝납니다. 나중에 재시도하세요.

차단하는 레코드가 있으면 message에 그 레코드가 표시됩니다. 전송 수준의 실패, 즉 알 수 없는 서버 이름, 누락되었거나 취소된 연결 또는 토큰, 구매하지 않은 유료 추가 기능은 실제 HTTP 상태이며 설정에 나와 있습니다.

페이지네이션

어떤 목록 도구도 제한 없는 배열을 반환하지 않습니다. 목록을 반환하는 모든 도구는 선택적인 limit과 offset을 받으며, 행과 함께 pagination 객체를 반환합니다.

필드의미
limit실제로 적용된 페이지 크기
offset실제로 적용된 오프셋
count이 페이지에 있는 행 수
has_more이 페이지 이후에 행이 더 있으면 true
next_offset다음 페이지에 전달할 offset. 결과가 완전하면 null
total창 뒤에 있는 전체 행 수 — 계산 비용이 낮은 경우에만 포함

limit과 offset은 거부되지 않고 범위 안으로 조정됩니다. 최댓값보다 큰 값은 최댓값으로, 최솟값보다 작은 값은 최솟값으로, 값이 없거나 숫자가 아니면 문서에 명시된 기본값으로 반환됩니다. pagination 블록은 항상 실제로 적용된 값을 보고하므로, 요청한 것이 아니라 실제로 받은 것을 확인할 수 있습니다.

결과가 완전한지 판단하려면 has_more를 사용하세요. 정확히 꽉 찬 마지막 페이지에서는 모호해지므로 count === limit으로 추론하지 마세요. 전체 목록을 읽으려면 has_more가 false가 될 때까지 next_offset을 따라가세요.


읽기 도구

read 범위가 필요합니다.

dataroom_list

영역 엔드포인트 이름: list_datarooms

호출자가 접근할 수 있는 데이터룸을 나열합니다. 특정 데이터룸으로 범위가 지정된 토큰의 경우 결과는 해당 허용 목록으로 필터링됩니다. 보관된 데이터룸은 제외됩니다.

  • 입력: limit(선택, 1–200, 기본값 50), offset(선택, 기본값 0).
  • 출력: { datarooms: [{ id, name, description, org_name, created_at }], pagination: { limit, offset, count, has_more, next_offset, total } }.
  • created_at 기준 오래된 순으로 정렬되며, 페이지가 안정적이도록 id로 동순위를 정합니다. total은 허용 목록 필터를 적용한 후 집계한, 이 토큰이 접근할 수 있는 전체 데이터룸 수입니다.

dataroom_get

영역 엔드포인트 이름: get_dataroom

id로 데이터룸 하나를 가져옵니다. 호출자는 해당 데이터룸에 대한 권한이 있어야 하며, 다른 데이터룸으로 범위가 지정된 토큰은 거부됩니다.

  • 입력: dataroom_id(필수).
  • 출력: { dataroom: { id, name } | null }.

dataroom_list_folders

영역 엔드포인트 이름: list_folders

데이터룸의 폴더를 나열합니다. 딜 팀과 투자자의 표시 범위를 준수하므로, 투자자는 읽을 수 있는 폴더만 봅니다. 상위 폴더 아래의 한 단계만 나열하거나, all을 전달하여 전체 트리를 나열합니다. 삭제된 폴더는 제외됩니다.

  • 입력: dataroom_id(필수), parent_folder_id(선택 — 최상위 폴더는 생략), all(선택 불리언 — true이면 데이터룸의 모든 폴더를 나열), limit(선택, 1–500, 기본값 100), offset(선택, 기본값 0).
  • 출력: { folders: [{ id, name, parent_folder_id, created_at }], pagination: { limit, offset, count, has_more, next_offset, total } }.
  • 이름순으로 정렬되며, 페이지가 안정적이도록 id로 동순위를 정합니다. all: true도 페이지네이션됩니다. 큰 트리에서는 한 번의 응답으로 전체 트리를 기대하지 말고 next_offset으로 페이지를 넘기세요.

dataroom_list_files

영역 엔드포인트 이름: list_files

데이터룸의 활성(삭제되지 않은) 파일을 나열하며, 선택적으로 특정 폴더 안의 파일만 나열합니다. 투자자 호출자는 읽기가 허용된 파일만 봅니다. 페이지네이션됩니다.

  • 입력: dataroom_id(필수), folder_id(선택 — 데이터룸 루트의 파일은 생략), limit(선택, 1–200, 기본값 50), offset(선택, 기본값 0), sort_dir(선택, asc | desc, 기본값 desc).
  • 출력: { files: [{ id, name, folder_id, size_bytes, mime_type, created_at, updated_at }], pagination: { limit, offset, count, has_more, next_offset } }.
  • total은 없습니다. 이 경로에서는 일치하는 전체 집합을 세는 비용이 낮지 않기 때문입니다. 페이지를 넘기려면 has_more / next_offset을 사용하세요.

dataroom_get_file_metadata

영역 엔드포인트 이름: get_file_metadata

파일 하나의 메타데이터를 가져옵니다. 이름, MIME 유형, 크기, 폴더 경로, 버전 목록, 그리고 있는 경우 AI 요약/카테고리가 포함됩니다. 파일은 지정한 데이터룸에 속해야 하며, 다른 데이터룸(같은 조직이라도)의 파일은 null을 반환합니다.

  • 입력: dataroom_id(필수), file_id(필수).
  • 출력: { file: { id, name, mime_type, size_bytes, folder_id, folder_path, created_at, updated_at } | null, versions: [{ id, version_number, is_current, created_at }], ai_metadata: { summary, key_points, category, is_redacted } | null }.

영역 엔드포인트 이름: search_dataroom

권한이 있는 단일 데이터룸 안에서 파일 이름으로 파일을 검색합니다(대소문자를 구분하지 않는 부분 문자열 일치). 삭제된 파일은 제외됩니다.

  • 입력: dataroom_id(필수), query(필수, 파일 이름의 부분 문자열), limit(선택, 1–100, 기본값 25), offset(선택, 기본값 0).
  • 출력: { files: [{ id, name, mime_type, size_bytes, created_at }], pagination: { limit, offset, count, has_more, next_offset } }.
  • 최신순으로 정렬되며, 페이지가 안정적이도록 id로 동순위를 정합니다. has_more가 true이면 쿼리와 일치하는 파일이 반환된 것보다 많다는 뜻이므로, next_offset으로 페이지를 넘기거나 쿼리를 좁히세요. total은 없습니다.

데이터룸 도구

dataroom_create

토큰의 조직에 데이터룸을 생성합니다.

  • 범위: write이며, 토큰 소유자가 딜 팀에 속해 있어야 합니다. 특정 데이터룸으로 제한된 토큰이나 연결은 거부되므로(FORBIDDEN, 코드 PAT_ROOM_SCOPED), 데이터룸으로 제한되지 않은 것을 사용하세요.
  • 입력: name(필수, 1–100자). 앞뒤 공백은 잘리며, 공백만으로 된 이름은 거부됩니다(INVALID_ARGUMENT).
  • 출력: { id, name }. id를 폴더 및 파일 도구에 dataroom_id로 전달하세요.
  • 멱등성이 없습니다. 호출할 때마다 새 데이터룸이 생성됩니다. 호출 결과를 받지 못한 경우, 다시 호출하기 전에 dataroom_list로 해당 데이터룸을 찾아보세요. 그렇지 않으면 중복이 생성됩니다.
  • 구독에서 쓰기가 허용되지 않거나 좌석 한도를 초과한 조직은 QUOTA_EXCEEDED로 거부됩니다.

폴더 도구

write 범위와 해당 데이터룸의 딜 팀 역할이 필요합니다.

dataroom_create_folder

영역 엔드포인트 이름: create_folder

데이터룸에 폴더를 생성합니다. 상위 폴더 아래에 중첩하거나, 상위 폴더를 생략하여 데이터룸 루트에 만듭니다. 같은 상위 폴더 아래의 중복 이름은 CONFLICT로 거부됩니다.

  • 입력: dataroom_id(필수), name(필수, 1–255자), parent_folder_id(선택 — 데이터룸 루트이면 null/생략).
  • 출력: { folder: { id, name, parent_folder_id } }. CONFLICT 메시지에 충돌하는 폴더의 id가 표시되므로, 이를 찾기 위해 상위 폴더를 다시 나열할 필요가 없습니다.

dataroom_rename_folder

영역 엔드포인트 이름: rename_folder

폴더 이름을 변경합니다. 폴더는 호출자의 조직에 속해야 합니다.

  • 입력: folder_id(필수), name(필수, 1–255자).
  • 출력: { folder: { id, name } }.

dataroom_delete_folder

영역 엔드포인트 이름: delete_folder

폴더 및 그 하위 트리 전체, 즉 중첩된 모든 하위 폴더와 그 안의 모든 파일을 소프트 삭제합니다. 실제 데이터룸에서는 폴더 id 하나로 수백 개의 문서가 삭제될 수 있으므로, 결과에 제거된 폴더와 파일의 정확한 수가 보고됩니다. 아무것도 삭제하지 않고 이 수만 확인하려면 dry_run: true를 전달하세요. 행은 삭제됨으로 표시될 뿐 물리적으로 제거되지 않으며, 연쇄 삭제 전체를 restore_folder로 되돌릴 수 있습니다.

  • 입력: folder_id(필수), dry_run(선택 불리언 — 미리보기만).
  • 출력: { deleted, dry_run, folder_id, folder_name, affected: { folders, files }, restore_with: "restore_folder" }.
  • 시험 실행은 아무것도 변경하지 않으며 감사 추적에 삭제를 기록하지 않습니다.

dataroom_restore_folder

영역 엔드포인트 이름: restore_folder

delete_folder를 되돌립니다. 폴더와 그 삭제로 함께 제거된 모든 항목을 복원합니다. 그 이전에 별도로 삭제된 항목은 삭제된 상태로 남습니다. 상위 폴더가 아직 삭제된 상태이거나(먼저 상위 폴더를 복원하세요) 그 후 활성 폴더가 같은 이름을 차지한 경우 충돌을 반환하며, 두 경우 모두 메시지에 차단하는 폴더의 id가 표시됩니다.

  • 입력: folder_id(필수), dry_run(선택 불리언 — 미리보기만).
  • 출력: { restored, dry_run, folder_id, folder_name, affected: { folders, files } }.
  • 폴더 삭제는 손실 없이 되돌릴 수 있으며, 이는 파일 삭제와 의도적으로 다릅니다. 연쇄 삭제는 조직의 스토리지 카운터를 움직이지 않고 파일의 검색 인덱스 청크도 삭제하지 않으므로, restore_folder는 아무것도 돌려주지 않으며(차감된 것이 없음) 복원된 파일은 여전히 검색할 수 있습니다. 아래의 delete_file / restore_file은 둘 다 수행합니다. 따라서 문서가 가득한 폴더를 삭제하는 것은 그 문서들을 각각 삭제하는 것과 같은 회계 이벤트가 아닙니다.

dataroom_move_folder

영역 엔드포인트 이름: move_folder

같은 데이터룸 안에서 폴더의 상위 폴더를 변경합니다. 다른 폴더 아래에 중첩하거나 데이터룸 루트로 이동합니다. 폴더를 자기 자신이나 하위 폴더로 이동하는 경우(순환), 다른 데이터룸으로 이동하는 경우, 같은 이름의 형제 폴더가 이미 있는 경우는 거부됩니다.

  • 입력: folder_id(필수), new_parent_folder_id(선택 — 데이터룸 루트이면 null/생략).
  • 출력: { folder: { id, name, parent_folder_id, previous_parent_folder_id } }. 이동을 되돌리려면 previous_parent_folder_id를 new_parent_folder_id로 다시 전달하세요.

파일 도구

파일 변경에는 write 범위가 필요하며, get_file_download_url에는 read와 함께 토큰에 문서 내용 읽기가 필요합니다.

업로드는 중개 방식이며, MCP는 바이트를 전달하지 않습니다. 도구 인수는 JSON이므로 프로토콜에는 바이너리 채널이 없습니다. request_file_upload가 사전 서명된 URL을 발급하면 클라이언트가 그 URL로 콘텐츠를 직접 PUT합니다. 원시 바이너리 본문으로 HTTP PUT을 보낼 수 없는 클라이언트는 업로드를 전혀 완료할 수 없으므로, 시작한 후가 아니라 시작하기 전에 알아 두는 것이 좋습니다.

업로드를 마무리하는 도구는 같은 이름의 파일이 이미 있는지에 따라 달라지지만, 직접 판단할 필요는 없습니다. request_file_upload가 호출할 도구를 지정하는 next_step 필드를 반환합니다.

request_file_upload 반환값의미마무리 도구
is_new_version: false, next_step: "register_file"같은 이름의 활성 파일이 없음 — 버전 1로 대기 중인 레코드가 생성됨register_file
is_new_version: true, next_step: "finalise_file_version"같은 이름의 활성 파일이 있음 — 이 업로드는 그 파일의 새 버전이 됨finalise_file_version

next_step이 지정하는 도구를 호출하세요. register_file은 버전 1만 마무리하고 그 밖의 경우는 거부하므로, 새 버전 분기에서 이를 사용하면 호출이 실패합니다.

dataroom_request_file_upload

영역 엔드포인트 이름: request_file_upload

데이터룸에 있는 파일의 사전 서명된 업로드 URL을 요청합니다. 바이트를 PUT할 URL과 헤더, 파일 id, 그리고 이 업로드를 마무리할 도구인 next_step을 반환합니다. 대상 폴더에 같은 이름의 활성 파일이 이미 있으면 is_new_version이 true이며, 반환된 id와 version_number는 그 기존 파일을 가리킵니다.

  • 범위: write.
  • 입력: dataroom_id(필수), file_name(필수, 확장자 포함), file_size(필수, 정확한 바이트 수, 양의 정수), mime_type(필수), folder_id(선택 — 데이터룸 루트이면 생략).
  • 출력: { upload_url, headers, file_id, s3_key, is_new_version, version_number, next_step } — next_step은 "register_file" 또는 "finalise_file_version"입니다.
  • 이 도구는 바이트를 옮기지 않고 URL만 중개합니다. 오브젝트 스토리지가 구성되어 있지 않으면, 작동할 수 없는 URL을 돌려주는 대신 호출이 즉시 실패합니다.

dataroom_register_file

영역 엔드포인트 이름: register_file

request_file_upload로 받은 URL에 바이트를 PUT한 후 대기 중인 첫 번째 업로드를 마무리합니다. 파일을 활성으로 표시하고, 조직 스토리지를 늘리고, 버전 1을 기록합니다. request_file_upload가 is_new_version: false를 반환했을 때 호출하세요. 그 next_step이 이 도구를 지정합니다.

  • 범위: write.
  • 입력: file_id(필수, request_file_upload에서 받은 대기 중인 id), s3_key(선택), size_bytes(선택 — 생략하면 업로드된 객체에서 산출).
  • 출력: { file_id, status: "active", version_number: 1 }.
  • 버전 1 전용이며, 이를 강제합니다. 이미 활성 상태이거나 이미 버전이 있는 파일은 거부되며, 거부 메시지는 버전 2 이상에 사용할 도구로 finalise_file_version을 지정합니다.
  • 스토리지 키는 서버 측에서 산출되며 클라이언트의 s3_key는 절대 신뢰하지 않습니다. 이 값은 선택 사항이며, 보내는 경우 request_file_upload가 반환한 키와 같아야 하고 그렇지 않으면 호출이 거부됩니다.

dataroom_finalise_file_version

영역 엔드포인트 이름: finalise_file_version

request_file_upload가 is_new_version: true와 함께 반환한 URL에 바이트를 PUT한 후 기존 파일의 새 버전을 마무리합니다. 이는 UI에서 문서를 교체하는 것에 해당하는 MCP 작업이며, 해당 분기에서 next_step이 지정하는 도구입니다.

  • 범위: write.
  • 입력: file_id(필수), version_number(필수 — request_file_upload가 반환한 version_number).
  • 출력: { file_id, version_id, version_number, size_bytes, is_current: true, previous_version_number, previous_version_id, undo_with: "restore_file_version" }.
  • version_number는 이 파일의 다음 버전과 정확히 같아야 합니다. 이 값은 추측되지 않고 검증됩니다. 다른 값은 조용히 기록되지 않고 거부되며, 스토리지 키는 이 값으로부터 서버 측에서 산출됩니다.
  • 새 버전이 현재 버전이 되고 이전 버전은 기록에 보존됩니다. 되돌리려면 previous_version_id를 restore_file_version에 전달하세요.
  • 첫 업로드를 완료하지 않은 파일은 거부되므로, 먼저 register_file로 버전 1을 마무리하세요. 바이트가 아직 실제로 스토리지에 없으면, 내용이 없는 버전을 기록하는 대신 호출이 실패합니다.

dataroom_restore_file_version

영역 엔드포인트 이름: restore_file_version

파일의 이전 버전을 다시 현재 버전으로 만듭니다. finalise_file_version을 되돌리는 작업입니다. 현재 버전 표시를 옮기고 파일이 해당 버전을 가리키도록 하며, 새 버전 행을 만들지 않으므로 버전 기록은 실제로 업로드된 수정본의 정확한 목록으로 유지됩니다.

  • 범위: write.
  • 입력: file_id(필수), version_id(필수 — 이 파일에 속해야 함. get_file_metadata가 파일의 버전 id를 나열함).
  • 출력: { file_id, version_id, version_number, already_current, new_version_created: false }.
  • already_current: true는 해당 버전이 이미 현재 버전이어서 아무것도 변경되지 않았다는 뜻입니다. 실패가 아니라 아무 작업도 하지 않은 것입니다.
  • 별도의 버전 목록 도구는 없습니다. get_file_metadata가 이미 파일의 버전을 id, 번호, 현재 버전 표시와 함께 반환합니다.

dataroom_rename_file

영역 엔드포인트 이름: rename_file

파일 이름을 변경합니다. 메타데이터만 변경합니다. 이 작업은 새 버전을 만들지 않습니다. 버전 관리는 레이블 변경이 아니라 콘텐츠 교체를 위한 것입니다. 이름은 같은 폴더의 활성 파일 사이에서 고유해야 하며, 충돌하면 기존 파일을 지목하는 CONFLICT가 반환됩니다.

  • 범위: write.
  • 입력: file_id(필수), name(필수, 1–255자).
  • 출력: { file_id, name, previous_name, changed }. 반환되는 name은 스토리지에서 다시 읽어 온 값이므로 실제로 저장된 값입니다. 저장된 이름이 바뀌지 않았다면 changed는 false입니다.

dataroom_move_file

영역 엔드포인트 이름: move_file

파일을 같은 데이터룸의 다른 폴더나 데이터룸 루트로 이동합니다. 데이터룸 간 이동은 거부됩니다. 데이터룸은 권한 경계이며, 콘텐츠를 다른 데이터룸으로 옮기면 누가 읽을 수 있는지가 바뀌기 때문입니다. 대상 위치에 같은 이름의 활성 파일이 이미 있으면 이동이 거부됩니다.

  • 범위: write.
  • 입력: file_id(필수), folder_id(선택 — 데이터룸 루트이면 null/생략).
  • 출력: { file_id, name, folder_id, previous_folder_id, moved }. 이동을 되돌리려면 previous_folder_id를 folder_id로 다시 전달하세요.

dataroom_delete_file

영역 엔드포인트 이름: delete_file

파일을 삭제합니다. 결과에는 실제로 삭제된 파일의 이름이 표시되므로, 잘못된 id를 응답에서 확인할 수 있습니다. 파일과 그 버전은 보존 및 감사를 위해 유지되며 지워지지 않고, restore_file로 되살릴 수 있습니다.

  • 범위: write.
  • 입력: file_id(필수).
  • 출력: { file_id, status: "deleted", name, folder_id, restore_with: "restore_file" }.
  • 스토리지는 실제로 완료된 업로드에 대해서만 반환됩니다. 바이트가 도착한 파일은 그 크기만큼 조직의 스토리지 카운터에 반환됩니다. 아직 업로드를 기다리는 파일은 처음부터 요금이 부과되지 않았으므로, 삭제해도 카운터가 전혀 움직이지 않습니다. 이 삭제는 카운터에 중립적이며, 저장한 적 없는 바이트를 환불하는 것이 아닙니다.
  • 삭제하면 파일의 검색 인덱스 청크도 삭제되므로 문서가 즉시 문서 검색에서 사라집니다. restore_file로는 이를 되살릴 수 없습니다. 아래를 참조하세요.
  • 이 도구는 항상 활성 파일만 찾으므로, 같은 id로 두 번째 호출하면 다시 삭제하는 대신 NOT_FOUND를 반환합니다. 한 파일에 대해 스토리지 카운터가 두 번 차감될 수 없습니다.

dataroom_restore_file

영역 엔드포인트 이름: restore_file

delete_file을 되돌립니다. 소프트 삭제된 파일을 다시 활성 상태로 되살리고, 해당 삭제로 되돌려졌던 행과 스토리지 회계를 복원합니다. 파일의 검색 인덱스 청크는 복원하지 않으므로(삭제할 때 제거됨) 파일은 활성 상태이고 다운로드할 수 있지만, 문서 검색에서 다시 찾으려면 재인덱싱해야 합니다. search_index_restored는 항상 false이며, 손실 없는 되돌리기를 암시하지 않고 이 사실을 명시합니다.

  • 범위: write.
  • 입력: file_id(필수).
  • 출력: { restored, file_id, name, folder_id, storage_bytes_restored, search_index_restored: false }.

복원이 거부되는 경우. 충돌을 덮어 감추지 않고 실패하며, 차단하는 행이 있으면 그 행을 지목합니다.

#조건error.code조치 방법
1해당 파일이 없거나 본인의 것이 아님NOT_FOUNDid를 확인하세요.
2파일이 삭제되지 않음 — 이미 활성 상태CONFLICT복원할 것이 없습니다.
3파일의 업로드가 완료되지 않음CONFLICT복원할 것이 없습니다. 바이트가 도착한 적이 없으므로 되살릴 문서가 없습니다. 대신 다시 업로드하세요.
4상위 폴더가 아직 삭제된 상태CONFLICT먼저 restore_folder를 실행하세요. 그러면 함께 삭제된 파일도 되살아납니다.
5그 후 해당 폴더에서 활성 파일이 같은 이름을 차지함CONFLICT그 이름을 가진 파일의 이름을 변경한 후 재시도하세요.

이는 HTTP 상태가 아니라 페이로드 안의 코드입니다. 실패가 보고되는 방식을 참조하세요.

검사는 위의 번호 순서대로 실행되며, 처음 실패한 검사가 보고됩니다. 따라서 업로드 미완료(3)는 찾을 수 없음 및 삭제되지 않음 검사 이후에, 그러나 폴더 및 이름 검사보다 먼저 보고됩니다. 바이트가 도착하지 않은 파일은 폴더나 이름 상황과 관계없이 복원할 수 없으므로, 그 둘을 고치도록 안내할 이유가 없기 때문입니다.

dataroom_get_file_download_url

영역 엔드포인트 이름: get_file_download_url

파일의 단기 다운로드 URL을 받습니다. 호출자는 해당 파일에 대한 권한(파일별 읽기/다운로드 권한)이 있어야 합니다. 이 URL은 브라우저 다운로드로 받는 것과 같은 사본을 제공합니다. 데이터룸이 다운로드에 워터마크를 적용하는 경우 워터마크가 적용되며, 가림 처리된 문서는 조직 외부의 수신자에게 가림 처리된 사본이 제공됩니다. 몇 분 후에 만료됩니다.

  • 범위: read와 함께 토큰에 문서 내용 읽기가 필요합니다. 없으면 호출이 GRANT_REQUIRED로 거부됩니다.
  • 한도: 호출마다 보호된 사본을 준비하므로 토큰당 분당 최대 10회입니다. 초과하면 RATE_LIMITED입니다.
  • 보호된 사본을 제시간에 준비할 수 없으면 호출이 UNAVAILABLE로 거부되고 링크가 제공되지 않습니다. 다시 시도하거나 Waafir에서 다운로드하세요.
  • 입력: file_id(필수).
  • 출력: { download_url, expires_in_seconds }.

문서 텍스트 도구

파일 자체를 다운로드하는 대신 문서의 추출된 텍스트를 읽기 위한 도구 하나입니다.

dataroom_get_file_text

영역 엔드포인트 이름: get_file_text

문서에서 추출된 텍스트를 한 페이지씩 읽습니다. 번호가 매겨진 세그먼트(PDF의 경우 페이지가 아주 길지 않으면 페이지당 세그먼트 하나)와 pagination 블록을 반환하므로, offset으로 긴 문서를 차례로 읽을 수 있습니다.

다음 두 가지 때문에 이 도구는 메타데이터 읽기보다 엄격합니다.

  • 파일을 단순히 볼 수 있는 것이 아니라 다운로드할 수 있는 권한이 있어야 합니다. 보기 전용 권한으로는 충분하지 않으며, 해당 문서에 접근하지 못하도록 제한된 토큰은 거부됩니다.
  • 문서가 가림 처리되었고 호출자가 딜 팀에 속하지 않으면 가림 처리된 버전의 텍스트를 받으며, source가 어느 산출물을 받았는지 알려 줍니다. 외부의 독자에게 원본을 조용히 넘겨주는 일은 결코 없습니다.

성공한 모든 호출은 제품에서 문서를 읽는 것과 같은 기준으로 조직의 감사 로그에 기록됩니다.

  • 범위: read와 함께 토큰에 문서 내용 읽기가 필요합니다. 없으면 호출이 GRANT_REQUIRED로 거부되며, dataroom_get_file_metadata와 dataroom_summarise_file로는 여전히 문서 요약을 받을 수 있습니다.
  • 입력: file_id(필수), dataroom_id(선택 — 제공하면 파일이 속한 데이터룸과 대조하여 검증하며, 일치하지 않으면 파일이 다른 곳에 있음을 확인해 주지 않고 NOT_FOUND로 처리), limit(선택, 1–5, 기본값 3), offset(선택, 기본값 0).
  • 출력: { file_id, file_name, source, segment_max_chars, segments, pagination }. source는 "original" 또는 "redacted"입니다. pagination에는 total이 포함됩니다.
  • 저장된 객체가 없는 파일(본문이 인라인으로 보관되는 메모)은 "no extractable content"와 함께 NOT_FOUND를 반환합니다.
  • 추출할 텍스트가 없는 유형의 파일(예: 압축 파일)은 400으로 거부되며, 50MB를 초과하는 저장 파일은 413(FILE_TOO_LARGE)으로 거부됩니다. 두 경우 모두 파일의 텍스트가 아직 추출되지 않은 경우에만 적용되고(이미 추출된 텍스트가 먼저 제공됨), 문서를 가져오기 전에 거부되며, 어느 쪽도 나중에 재시도할 오류가 아닙니다.
  • 이 도구가 나중에 재시도해야 하는 두 코드를 반환합니다. 저장된 문서를 가져올 수 없거나 텍스트 추출에 실패하면 UPSTREAM_ERROR, 읽기에 대한 감사 기록에 실패하면 UNAVAILABLE이며, 후자의 경우 텍스트는 기록 없이 공개되는 대신 의도적으로 보류됩니다. 두 경우 모두 문서를 읽을 수 없다고 판단하기 전에 한 번 재시도할 가치가 있습니다.

권한 도구

이 도구들은 누가 무엇을 볼 수 있는지를 읽고 변경합니다. 세 가지 읽기 도구에는 read 범위만 필요하며(두 디렉터리 도구에는 추가로 딜 팀 역할이 필요합니다), 네 가지 부여/취소 도구에는 admin 범위와 조직 관리자 또는 매니저인 토큰 소유자가 필요합니다.

토큰은 제한된 파일에 대해 소유자/관리자의 우선 권한을 결코 가지지 않습니다. 앱에서는 조직 소유자나 관리자가 모든 제한된 파일을 볼 수 있지만, 토큰을 통해서는 다른 구성원과 똑같이 본인이 생성했거나 권한을 보유한 파일에만 접근할 수 있습니다. 그러한 파일에 대해 거부된 파일 도구는 존재하지 않는 파일과 같은 텍스트("File not found in the requested dataroom, or not readable by this credential")로 NOT_FOUND를 반환하므로, 응답이 제한된 파일의 존재를 확인해 주는 일은 없습니다.

dataroom_get_file_permissions

영역 엔드포인트 이름: get_file_permissions

파일에 대한 권한 부여(직접 부여 및 폴더에서 상속된 부여)를 나열합니다. UI의 파일 권한 보기와 같습니다.

  • 범위: read.
  • 입력: dataroom_id(필수), file_id(필수), limit(선택, 1–200, 기본값 50), offset(선택, 기본값 0).
  • 출력: { permissions: [{ user_id, can_read, can_download, access_revoked, expires_at, granted_by, created_at, source, source_folder_name?, source_folder_id?, user_email?, user_name?, granted_by_email? }], pagination: { limit, offset, count, has_more, next_offset, total }, identities_visible } (source는 "direct" 또는 "inherited").
  • 권한 부여는 created_at, 그다음 user_id, 그다음 source, 그다음 source_folder_id 순으로 정렬되므로 호출 간에 페이지가 일정하게 유지됩니다. total은 파일에 대한 전체 권한 부여 수입니다.
  • 신원 필드(user_email, user_name, granted_by_email)는 아래 디렉터리 도구와 같은 표시 규칙을 따릅니다. 딜 팀 호출자에게 표시되고, 투자자 신원은 추가로 조직 관리자 또는 매니저여야 하며, 허용되지 않는 경우 해당 키는 null이 아니라 아예 없습니다. identities_visible은 어느 경우에 해당하는지 알려 주며, 권한 부여 자체는 항상 나열됩니다.

dataroom_list_users

영역 엔드포인트 이름: list_dataroom_users

데이터룸에 대한 활성 접근 권한을 보유한 사용자를, 권한 도구에 필요한 user_id 및 각 권한 보유자의 이메일 주소, 이름과 함께 나열합니다. user_id가 필요할 때 보통 가장 먼저 호출하는 도구입니다.

  • 범위: read, 그리고 데이터룸 조직의 딜 팀 역할(팀 페이지와 같은 조건).
  • 입력: dataroom_id(필수), limit(선택, 1–200, 기본값 50), offset(선택, 기본값 0).
  • 출력: { users: [{ user_id, email, name, is_deal_team, org_role, permission, granted_at, expires_at }], pagination: { limit, offset, count, has_more, next_offset, total }, investor_rows_visible }.
  • 조직 관리자 또는 매니저가 아니면 투자자 신원은 생략됩니다. investor_rows_visible은 어느 집합을 받았는지 알려 줍니다.
  • 명시적인 권한 보유자만 나열합니다. 조직 소유자와 관리자는 권한 부여 행 없이 암묵적으로 접근 권한을 가지므로 표시되지 않습니다. 이들은 find_user_by_email로 확인하세요.

dataroom_find_user_by_email

영역 엔드포인트 이름: find_user_by_email

이메일 주소를 권한 도구에 필요한 user_id로 확인하고, 사용자의 조직 역할과 이 데이터룸에서의 현재 권한을 함께 반환합니다.

  • 범위: read, 그리고 데이터룸 조직의 딜 팀 역할. 투자자를 확인하려면 추가로 조직 관리자 또는 매니저여야 합니다.
  • 입력: dataroom_id(필수), email(필수, 대소문자 구분 없이 일치).
  • 출력: { found: true, user: { user_id, email, name, org_role, dataroom_permission } } 또는 { found: false }. dataroom_permission이 null이면 사용자가 조직에는 있지만 아직 이 데이터룸에 대한 접근 권한이 없다는 뜻이므로, 먼저 초대하세요.
  • 이는 전역 디렉터리 조회가 아닙니다. 데이터룸이 속한 조직 내부의 사용자이거나 해당 데이터룸에 대한 유효한 접근 권한을 보유한 사용자만 확인됩니다. 알 수 없는 주소, 테넌시 외부의 사용자, 볼 수 없도록 허용되지 않은 사용자는 모두 동일한 { found: false }를 반환하므로, 부정적인 응답으로 계정의 존재 여부가 드러나지 않습니다.

dataroom_set_file_permissions

영역 엔드포인트 이름: set_file_permissions

파일에 대한 사용자의 읽기/다운로드 권한을 부여하거나 업데이트합니다. read/write 토큰이나 조직 관리자 또는 매니저가 아닌 소유자는 거부됩니다.

  • 범위: admin.
  • 입력: dataroom_id(필수), file_id(필수), user_id(필수), can_read(필수 불리언), can_download(필수 불리언), expires_at(선택 ISO 타임스탬프, 미래 시점이어야 함).
  • 출력: { success: true, effective: { can_read, can_download } } — 파일 제한과 폴더 상속을 반영한 부여 이후의 결정이므로, 요청한 내용과 다를 수 있습니다.
  • 이 도구는 접근 권한을 부여하며 제거할 수는 없습니다. can_read: false를 전달하면 읽기가 거부된 활성 권한 부여가 기록되지만, 다른 권한 부여(조직 구성원 자격, 데이터룸 권한 부여, 폴더 상속)가 여전히 이를 무시할 수 있습니다. 파일에 대한 사용자의 접근 권한을 실제로 제거하려면 revoke_file_permission을 사용하세요.

dataroom_revoke_file_permission

영역 엔드포인트 이름: revoke_file_permission

파일에 대한 사용자의 직접 권한 부여를 제거합니다(소프트 취소: 감사 추적을 위해 행은 보존됨). 사용자에게 해당 파일에 대한 직접 권한 부여가 없었으면 revoked: false를 반환합니다.

  • 범위: admin.
  • 입력: dataroom_id(필수), file_id(필수), user_id(필수).
  • 출력: { success: true, revoked }.
  • 직접 권한 부여에만 영향을 줍니다. 폴더 권한에서 상속된 접근 권한은 영향을 받지 않으며 폴더에서 취소해야 합니다. set_file_permissions로 다시 부여하면 되돌릴 수 있습니다.

dataroom_invite_user

영역 엔드포인트 이름: invite_user_to_dataroom

알려진 사용자에게 지정한 권한 수준으로 데이터룸 수준의 접근 권한을 부여합니다. 이메일 초대가 아니라 직접 접근 권한 부여입니다. 멱등적입니다(upsert).

  • 범위: admin.
  • 입력: dataroom_id(필수), user_id(필수), permission(필수 — viewer, downloader, contributor, manager 중 하나), expires_at(선택 ISO 타임스탬프, 미래 시점이어야 함).
  • 출력: { success: true, grant_id }.

dataroom_remove_user

영역 엔드포인트 이름: remove_user_from_dataroom

사용자의 데이터룸 수준 접근 권한을 취소합니다(소프트 취소: revoked_at을 설정하여 감사 추적을 보존함). 사용자에게 활성 권한 부여가 없었으면 revoked: false를 반환합니다.

  • 범위: admin.
  • 입력: dataroom_id(필수), user_id(필수).
  • 출력: { success: true, revoked }.

데이터룸 관리 도구

폴더 권한 부여, 여러 파일에 대한 일괄 권한 부여, 그리고 데이터룸의 다운로드 워터마크를 다룹니다. 각 도구는 그에 대응하는 Waafir 화면과 같은 검사를 실행하고 같은 행을 기록합니다. 쓰기 작업에는 admin 범위와 조직 관리자인 토큰 소유자가 필요합니다. 수신자는 항상 이메일 주소가 아니라 user_id(find_user_by_email 또는 list_dataroom_users에서 얻음)입니다.

dataroom_get_folder_permissions

폴더에 대한 직접 권한 부여와, 폴더가 제한되어 있는지(자체적으로 또는 제한된 상위 폴더를 통해) 여부를 나열합니다.

  • 범위: read, 그리고 토큰 소유자가 딜 팀에 속해 있어야 합니다.
  • 입력: dataroom_id(필수), folder_id(필수).
  • 출력: { folder_id, restricted, effectively_restricted, permissions: [{ user_id, can_read, can_download, expires_at, access_revoked, user_email?, user_name? }] }. 볼 수 없는 사람의 경우 신원 키가 없습니다.
  • 볼 수 없는 폴더는 존재하지 않는 폴더와 마찬가지로 NOT_FOUND를 반환합니다.

dataroom_set_folder_permissions

사용자에게 폴더 접근 권한을 부여하거나 can_read: false로 거부하며, 선택적으로 하위 트리 전체에 적용합니다.

  • 범위: admin.
  • 입력: dataroom_id, folder_id, grants(필수: [{ user_id, can_read, can_download, expires_at? }]), recursive(기본값 false).
  • 출력: { success: true, recursive, granted, skipped: { count, items } }.
  • 모든 권한 보유자는 이미 데이터룸에 있어야 합니다. 과거의 expires_at은 거부됩니다. 상위 폴더의 거부로 무효화될 권한 부여는 아무것도 기록되기 전에 거부됩니다(CONFLICT). 재귀적 권한 부여는 권한 보유자에게 거부가 설정된 하위 항목을 건너뛰고 skipped에 나열합니다. 권한 보유자는 앱 내 "Access Granted" 알림을 받습니다.

dataroom_revoke_folder_permission

폴더에 대한 사용자의 직접 권한 부여를 취소하거나, 해당 사용자에 대한 거부를 해제합니다.

  • 범위: admin.
  • 입력: dataroom_id, folder_id, user_id(모두 필수).
  • 출력: { success: true, revoked }. revoked: false는 유효한 권한 부여가 없었다는 뜻입니다.
  • 이 작업은 하위 항목으로 전파되지 않습니다. 재귀적 권한 부여가 폴더의 하위 항목에 기록한 권한 부여는 그대로 남습니다.

dataroom_bulk_set_file_permissions

같은 사용자들에게 여러 파일에 대한 접근 권한을 한 번에 부여합니다. mode: "add"(기본값)에서는 추가만 합니다. 생략한 필드가 접근 권한을 빼앗는 일은 없습니다. mode: "replace"에서는 각 권한 부여를 지정한 그대로 덮어쓰므로, 다운로드 권한을 제거하거나, 만료를 지우거나, 취소된 접근 권한을 복원할 수 있습니다. 교체는 두 단계로 진행됩니다. 첫 번째 호출은 미리보기와 confirm_token을 반환하고, 토큰과 함께 다시 호출하면 그 사이에 선택 항목에 대한 권한 부여가 변경되지 않은 한 적용됩니다.

  • 범위: admin.
  • 입력: dataroom_id, file_ids(최대 200개), grants(모두 필수), mode, confirm_token.
  • 출력: { success: true, mode, total_grants, left_revoked_user_ids }.
  • 데이터룸에 없거나 볼 수 없는 파일 id가 있으면 전체 요청이 NOT_FOUND로 거부됩니다.
  • 모든 파일은 데이터룸에 있고 볼 수 있어야 하며, 모든 권한 보유자는 이미 데이터룸에 있어야 합니다. 폴더 거부로 인해 어느 권한 부여라도 무효화된다면, 어떤 파일도 기록되기 전에 전체 요청이 거부됩니다.
  • 권한 보유자의 접근 권한이 취소된 상태였다면 add는 이를 복원하지 않으며, 해당 권한 보유자는 left_revoked_user_ids에 나열됩니다.

dataroom_bulk_revoke_file_permissions

지정한 사용자들의 여러 파일에 대한 직접 권한 부여를 한 번에 취소합니다. 폴더 권한 부여와 데이터룸 접근 권한은 변경되지 않습니다.

  • 범위: admin.
  • 입력: dataroom_id, file_ids(최대 200개), user_ids(모두 필수).
  • 출력: { success: true, revoked_count }.
  • 데이터룸에 없거나 볼 수 없는 파일 id가 있으면 전체 요청이 NOT_FOUND로 거부됩니다.

dataroom_get_watermark_settings

단일 파일 다운로드와 일괄 다운로드에 대한 데이터룸의 다운로드 워터마크 모드를 읽습니다. two_layer(다운로드한 사람의 신원과 다운로드별 IP 및 날짜 레이어) 또는 static(신원만)입니다. 읽기 전용이며, 변경은 Waafir 설정에서 하세요.

  • 범위: read, 그리고 토큰 소유자가 딜 팀에 속한 조직 관리자여야 합니다.
  • 입력: dataroom_id(필수).
  • 출력: { dataroom_id, single, bulk, stored: { single, bulk } }. stored의 null은 데이터룸에서 설정한 적이 없어 기본값이 적용된다는 뜻입니다.

dataroom_archive

데이터룸을 보관하여 데이터룸 목록에서 빠지게 합니다. 두 단계: 첫 번째 호출은 아무것도 변경하지 않고 미리보기(데이터룸 이름과 파일, 폴더, 접근 권한이 있는 사람, 활성 공유 링크의 수)와 confirm_token을 반환합니다. 토큰과 함께 다시 호출하면 보관됩니다.

  • 범위: admin, 그리고 토큰 소유자가 조직 소유자 또는 관리자여야 합니다.
  • 입력: dataroom_id(필수), confirm_token.
  • 출력: { success: true, dataroom_id, name, archived: true, restore_with: 'dataroom_restore' }.
  • 보관해도 누구의 접근 권한이나 권한 부여도 취소되지 않으며, 아무것도 삭제되지 않습니다. 데이터룸은 목록에서 빠지고, 복원될 때까지 데이터룸 수준의 읽기(get_dataroom, list_files, list_folders, 검색, Q&A, AI 질문)는 NOT_FOUND를 반환합니다. 데이터룸 파일로 바로 연결되는 링크는 여전히 열립니다. dataroom_restore로 데이터룸을 되돌릴 수 있으므로 dataroom_id를 보관해 두세요. 마지막 활성 데이터룸은 보관할 수 없습니다(CONFLICT). 데이터룸을 삭제하는 도구는 없습니다.

dataroom_restore

조직이 보관한 데이터룸을 복원합니다. 데이터룸이 목록으로 돌아오며, 보관으로 숨겨졌던 모든 것, 즉 AI 검색, 다이제스트, 투자자 업데이트, Q&A, 데이터룸의 추가 기능도 함께 돌아옵니다. 보관으로 변경된 것이 없으므로 폴더, 파일, 접근 권한은 그대로입니다. 한 번 호출하며 확인 단계는 없습니다.

  • 범위: admin, 그리고 토큰 소유자가 조직 소유자 또는 관리자여야 합니다.
  • 입력: dataroom_id(필수): dataroom_archive가 반환한 id.
  • 출력: { success: true, dataroom_id, name, archived: false }.
  • 보관되지 않은 데이터룸은 거부됩니다(CONFLICT, 코드 NOT_ARCHIVED). Waafir 지원팀이 보관했거나 조직과 함께 보관된 데이터룸은 거부되며(CONFLICT, 코드 SUPPORT_RESTORE_ONLY), 지원팀만 복원할 수 있습니다.
  • 구독이 비활성 상태이거나 팀이 시트 한도를 초과한 동안에는 거부됩니다.

dataroom_rename

데이터룸의 이름을 변경합니다.

  • 범위: write, 그리고 토큰 소유자가 딜 팀에 속해 있어야 합니다.
  • 입력: dataroom_id, name(모두 필수). 이름은 앞뒤 공백이 제거되며 1–100자여야 합니다.
  • 출력: { success: true, dataroom_id, name }.
  • 감사 추적에는 이전 이름과 새 이름이 기록됩니다.

팀 도구

조직의 팀은 조직 전체에 걸쳐 있으므로, 특정 데이터룸으로 제한된 토큰은 거부됩니다(FORBIDDEN, 코드 PAT_ROOM_SCOPED).

dataroom_team_list_members

조직의 활성 구성원을 나열합니다. 대기 중인 초대는 포함되지 않습니다.

  • 범위: read, 그리고 토큰 소유자가 딜 팀에 속해 있어야 합니다.
  • 입력: 없음.
  • 출력: { members: [{ membership_id, user_id, email, name, role, last_active_at }] }. role은 owner, admin, member 중 하나입니다.

아래의 쓰기 작업에는 소유자가 조직 소유자 또는 관리자인 admin 범위 토큰이 필요합니다. 두 단계로 표시된 네 가지 작업은 첫 번째 호출에서 미리보기와 confirm_token을 반환하며, 그 토큰과 함께 다시 호출해야만 실행됩니다.

dataroom_team_invite_member

이메일로 사람을 초대합니다. 두 단계이며, 확인하면 초대 이메일이 발송됩니다.

  • 범위: admin, 그리고 조직 외부 사람들에게 전송 권한.
  • 입력: email, role(owner, admin 또는 member)(필수), confirm_token.
  • 출력: { membership_id, email, role, status: "pending" }. 초대 링크는 절대 반환되지 않습니다.
  • 소유자만 소유자를 초대할 수 있습니다. 시트 한도와 일일 초대 한도가 적용됩니다.

dataroom_team_change_member_role

활성 구성원의 역할을 변경합니다. 두 단계이며, 미리보기에 이전 역할과 새 역할이 표시됩니다.

  • 범위: admin.
  • 입력: membership_id, role(필수), confirm_token.
  • 출력: { success: true, membership_id, old_role, role }.
  • 소유자의 역할을 변경하거나 소유자로 승격하는 것은 소유자만 할 수 있습니다. 본인의 역할은 변경할 수 없으며, 마지막 소유자는 강등할 수 없습니다.

dataroom_team_remove_member

구성원을 제거하거나 대기 중인 초대를 취소합니다. 두 단계이며, 미리보기에 종료될 구성원의 파일 및 폴더 권한 부여와 공유 링크 수가 표시됩니다.

  • 범위: admin.
  • 입력: membership_id(필수), confirm_token.
  • 출력: { success: true, membership_id, action, file_grants_ended?, folder_grants_ended?, share_links_deactivated? }.
  • 제거하면 이 조직에서 해당 구성원의 권한 부여가 종료되고 그가 만든 공유 링크가 비활성화되며, 거부는 유지됩니다. 소유자만 소유자를 제거할 수 있습니다.

dataroom_team_resend_invite

대기 중인 초대를 새 링크와 함께 다시 보내며, 이전 링크는 작동을 멈춥니다. 두 단계이며, 확인하면 초대 이메일이 발송됩니다.

  • 범위: admin, 그리고 조직 외부 사람들에게 전송 권한.
  • 입력: membership_id(필수), confirm_token.
  • 출력: 첫 번째 호출에서는 미리보기(membership_id, email, role), 확인 후에는 { success: true, membership_id }.
  • 대기 중인 초대만 다시 보낼 수 있습니다. 그 밖의 구성원 자격은 미리보기 단계에서 토큰 없이 거부됩니다. 일일 초대 한도는 확인할 때 차감됩니다.

투자자 및 NDA 도구

투자자 명단, 조직의 NDA, 투자자 기업의 NDA를 다루는 도구입니다. 각 도구는 호출할 때마다 조직 내 토큰 소유자의 현재 역할을 확인하므로, 그 후 강등된 사람이나 도구에 필요한 역할보다 낮게 제한된 토큰은 거부됩니다.

조직 전체를 읽는 도구에는 특정 데이터룸으로 제한되지 않은 토큰이 필요합니다. 명단에는 참여도 분석 읽기를 켜고 생성한 토큰에 대해서만 참여도 정보(누군가 마지막으로 데이터룸을 연 시점, 발송된 초대 이메일 수, 수락한 시점)가 포함됩니다. NDA 면제 링크나 사용자 id는 절대 포함되지 않습니다.

투자자 초대, 투자자의 접근 권한 제거 또는 복원, 권한 변경, 기업 NDA 첨부 또는 취소는 각각 두 단계로 진행됩니다. 첫 번째 호출은 아무것도 변경하지 않고, 정확히 무엇이 일어날지에 대한 미리보기와 confirm_token을 반환합니다. 어시스턴트는 미리보기를 보여 주고, 사용자가 동의한 경우에만 동일한 인수에 해당 confirm_token을 더해 호출을 반복합니다. 토큰은 한 번만 사용할 수 있으며 몇 분 후에 만료됩니다. 그 사이에 미리보기에 표시된 내용이 바뀌면 두 번째 호출이 거부되고 어시스턴트가 다시 확인을 요청합니다.

dataroom_list_investors

조직 또는 하나의 데이터룸에 초대된 투자자를 나열합니다.

  • 범위: read. 역할: 소유자 또는 관리자.
  • 입력: dataroom_id(선택, 특정 데이터룸으로 제한된 토큰의 경우 필수), status(선택: pending, accepted, revoked 또는 access_requested).
  • 출력: { investors: [{ id, email, display_name, role, status, require_nda, nda, investor_org, can_view_monitoring, can_view_updates, expires_at, invited_at }] }. id는 다른 투자자 도구가 받는 초대 id입니다. 참여도 분석 읽기가 있으면 각 행에 engagement: { last_seen_at, send_count, last_sent_at, accepted_at }도 포함됩니다.

dataroom_get_nda

조직의 NDA를 읽습니다. 현재 버전의 제목, 본문, 조항과 버전 기록이 포함됩니다. 조직에 아직 NDA가 없으면 current: null을 반환하며, 읽는다고 해서 NDA가 생성되지는 않습니다.

  • 범위: read. 역할: 딜 팀 구성원.
  • 입력: 없음.
  • 출력: { current, versions, clauses, tally }. 특정 데이터룸으로 제한된 토큰의 경우 tally(서명, 면제, 대기 건수)는 null입니다.

dataroom_list_firm_ndas

조직의 투자자 기업과 각 기업에 유효한 기업 NDA가 있는지를 나열합니다.

  • 범위: read. 역할: 딜 팀 구성원. 특정 데이터룸으로 제한되지 않은 토큰이 필요합니다.
  • 입력: 없음.
  • 출력: { firms: [{ id, name, has_live_nda }] }.

dataroom_get_firm_nda

한 기업이 조직과 맺은 NDA와, 해당 NDA로 첨부할 수 있는 완료된 전자 서명 엔벨로프를 읽습니다.

  • 범위: read. 역할: 딜 팀 구성원. 특정 데이터룸으로 제한되지 않은 토큰이 필요합니다.
  • 입력: investor_org_id(필수).
  • 출력: { agreement, attachable_envelopes }. 기업에 NDA가 없으면 agreement는 null입니다.

dataroom_extend_investor_access

수락된 초대의 접근 기간을 조직의 게스트 링크 만료 기간(변경하지 않았다면 7일)만큼 연장하고, 투자자의 현재 세션도 그 기간 동안 유지합니다. 데이터룸에 대한 초대에만 해당합니다.

  • 범위: write. 역할: 딜 팀 구성원. 필요: 조직 외부 사람들에게 전송.
  • 입력: invite_id(필수).
  • 출력: { invite_id, expires_at, expiry_hours }. 수락되지 않은 초대는 충돌로 거부됩니다.

dataroom_invite_investor

이메일로 투자자를 데이터룸에 초대하거나, 새 역할 또는 NDA 요구 사항으로 다시 초대하거나, 초대를 다시 보냅니다. notify가 false가 아니면 투자자는 개인 링크가 포함된 이메일을 받습니다. 미리보기에는 이 작업이 초대를 생성하는지, 업데이트하는지, 유지하는지, 인수 중 무엇이 무시되는지(다시 보내기는 저장된 역할과 NDA를 유지함), 상태 변경(제거된 투자자는 복원됨), NDA 면제 여부, 이메일 발송 여부가 표시됩니다. 미리보기는 일일 초대 한도를 소비하지 않으며, 발송은 소비합니다.

  • 범위: admin. 역할: 데이터룸 딜 팀의 소유자 또는 관리자. 필요: 조직 외부 사람들에게 전송.
  • 입력: email, dataroom_id(필수), role(viewer 또는 downloader), require_nda, resend, notify, confirm_token.
  • 출력: 첫 번째 호출에서는 미리보기와 confirm_token, 그다음에는 { status: 'sent' | 'added', invite_id, link_expires_at }.

dataroom_revoke_investor_access

투자자의 접근 권한을 제거합니다. 투자자의 현재 세션과 초대된 데이터룸에서의 파일 및 폴더 권한 부여가 종료됩니다. 나중에 복원하면 데이터룸 접근 권한은 돌아오지만 파일 권한 부여는 돌아오지 않습니다.

  • 범위: admin. 역할: 소유자 또는 관리자.
  • 입력: invite_id(필수), confirm_token.
  • 출력: 미리보기와 confirm_token, 그다음에는 { status: 'revoked', invite_id }.

dataroom_reinstate_investor_access

제거된 투자자를 복원하거나 접근 요청을 승인합니다. 데이터룸 접근 권한만 해당합니다.

  • 범위: admin. 역할: 소유자 또는 관리자. 필요: 조직 외부 사람들에게 전송.
  • 입력: invite_id(필수), confirm_token.
  • 출력: 미리보기와 confirm_token, 그다음에는 { status: 'reinstated', invite_id }.

dataroom_set_investor_permissions

초대의 역할, NDA 요구 사항, 모니터링 및 업데이트 접근 권한을 변경합니다. 미리보기에 각 변경 사항이 나열됩니다. NDA를 끄면 사용자 이름으로 면제가 기록되며, 선택적으로 사유와 링크를 포함할 수 있습니다.

  • 범위: admin. 역할: 소유자 또는 관리자.
  • 입력: invite_id(필수), role, require_nda, can_view_monitoring, can_view_updates 중 하나 이상, nda_waiver_reason, nda_waiver_url, confirm_token.
  • 출력: 미리보기와 confirm_token, 그다음에는 { status: 'updated', invite_id, changes }.

dataroom_attach_firm_nda

완료된 전자 서명 엔벨로프를 투자자 기업의 체결된 NDA로, 체결일 및 기간과 함께 기록합니다. 볼 수 있는 엔벨로프라면 무엇이든 첨부할 수 있습니다.

  • 범위: admin. 역할: 소유자 또는 관리자. 특정 데이터룸으로 제한되지 않은 토큰이 필요합니다.
  • 입력: investor_org_id, envelope_id, executed_at, term(필수), confirm_token.
  • 출력: 미리보기와 confirm_token, 그다음에는 { status: 'attached', agreement }.

dataroom_revoke_firm_nda

투자자 기업의 NDA를 취소합니다. Waafir에서 시작되어 아직 서명 진행 중인 NDA는 엔벨로프도 무효화됩니다.

  • 범위: admin. 역할: 소유자 또는 관리자. 특정 데이터룸으로 제한되지 않은 토큰이 필요합니다.
  • 입력: investor_org_id(필수), reason, confirm_token.
  • 출력: 미리보기와 confirm_token, 그다음에는 { status: 'revoked', investor_org_id, envelope_voided }.

투자자 기업 도구

투자자 기업, 즉 투자자 페이지에서와 같이 투자자들이 속한 그룹을 다루는 도구입니다. 각 도구에는 호출할 때마다 확인되는 조직 내 소유자 또는 관리자 역할과, 특정 데이터룸으로 제한되지 않은 토큰이 필요합니다. 알 수 없는 기업, 다른 조직의 기업, 병합되어 사라진 기업은 모두 같은 not-found 응답을 받습니다.

사람을 기업에 넣는 작업과 두 기업을 병합하는 작업은 위의 투자자 도구와 마찬가지로 각각 두 단계로 진행됩니다. 둘 다 사람을 현재 기업에서 다른 기업으로 옮길 수 있습니다. 새로 합류한 기업에 체결된 NDA가 있으면 그때부터 해당 NDA가 그 사람에게 적용되며, NDA를 요구하는 그 사람의 대기 중인 초대는 더 이상 NDA를 요구하지 않습니다. 미리보기에 그러한 초대가 나열되면 토큰에 조직 외부 사람들에게 전송 권한도 필요합니다. 기업에서 사람을 제거하는 기능은 여기에서 제공되지 않습니다.

dataroom_list_investor_firms

조직의 투자자 기업을 도메인, 구성원 수, 딜 팀의 비공개 메모, 기업의 NDA 상태와 함께 나열합니다.

  • 범위: read. 역할: 소유자 또는 관리자.
  • 입력: 없음.
  • 출력: { investor_firms: [{ id, name, canonical_domain, member_count, deal_team_note, firm_nda }] }. deal_team_note는 동료가 작성한 텍스트로 표시됩니다.

dataroom_create_investor_firm

투자자 기업을 생성합니다. member_emails와 canonical_domain을 지정하면, 나열된 사람 중 해당 도메인에 속하고 이미 조직의 데이터룸 중 하나에 초대되었으며 아직 어떤 기업에도 속하지 않은 사람이 구성원이 됩니다. 다른 기업에서 옮겨지는 사람은 없습니다.

  • 범위: admin. 역할: 소유자 또는 관리자.
  • 입력: name(필수), canonical_domain, member_emails(최대 500개, canonical_domain 필요).
  • 출력: { status: 'created', investor_firm: { id, name }, added }.

dataroom_rename_investor_firm

투자자 기업의 이름을 변경합니다.

  • 범위: admin. 역할: 소유자 또는 관리자.
  • 입력: investor_org_id, name(필수).
  • 출력: { status: 'renamed' | 'unchanged', investor_org_id, name }.

dataroom_set_investor_firm_note

기업에 대한 딜 팀의 비공개 메모를 설정하거나 지웁니다. 투자자는 이 메모를 볼 수 없습니다.

  • 범위: admin. 역할: 소유자 또는 관리자.
  • 입력: investor_org_id, note(필수, 빈 문자열이면 지워짐).
  • 출력: { status: 'set' | 'cleared' | 'unchanged', investor_org_id, cleared }.

dataroom_assign_investor_to_firm

이메일로 지정한 투자자를 기업에 넣으며, 현재 속한 기업이 있으면 그 기업에서 옮깁니다. 미리보기에는 투자자가 떠나게 될 기업과, 이제 해당 기업의 NDA로 NDA 단계가 충족될 대기 중인 초대가 표시됩니다. 이미 해당 기업에 속한 사람은 확인 단계 없이 그대로 유지됩니다.

  • 범위: admin. 역할: 소유자 또는 관리자. 필요: 미리보기에 초대가 나열되는 경우 조직 외부 사람들에게 전송.
  • 입력: investor_org_id, email(필수), confirm_token.
  • 출력: 미리보기와 confirm_token, 그다음에는 { status: 'assigned', investor_org_id, email, moved_from, coverage_started }.

dataroom_merge_investor_firms

한 기업을 다른 기업으로 병합합니다. 원본 기업의 모든 구성원이 대상 기업으로 옮겨지며, 원본 기업은 기업 목록에서 사라집니다. 병합은 어시스턴트나 앱에서 되돌릴 수 없습니다. 미리보기에는 옮겨지는 사람들과, 이제 대상 기업의 NDA로 NDA 단계가 충족될 대기 중인 초대가 나열됩니다.

  • 범위: admin. 역할: 소유자 또는 관리자. 필요: 미리보기에 초대가 나열되는 경우 조직 외부 사람들에게 전송.
  • 입력: source_investor_org_id, target_investor_org_id(필수, 서로 달라야 함), confirm_token.
  • 출력: 미리보기와 confirm_token, 그다음에는 { status: 'merged', source_investor_org_id, target_investor_org_id, moved_count, coverage_started_count }.

참여도 도구

누가 무엇을 언제, 얼마나 오래 읽었는지를 다루는 읽기 전용 도구입니다. 이는 이름이 확인된 사람들에 대한 행동 데이터이므로, 모든 도구에 참여도 분석 읽기를 켜고 생성한 토큰과 딜 팀 역할이 필요합니다. 각 도구는 토큰 소유자 본인이 읽을 수 있는 문서만 집계합니다. 데이터룸 도구는 참여도 페이지와 같은 필터를 받습니다: range(또는 from과 to), people, firm_ids, folder_id, tz.

dataroom_get_activity_trail

조직의 접근 로그를 최신순으로 반환합니다. 특정 데이터룸으로 제한되지 않은 토큰이 필요합니다.

  • 범위: read. 입력: counterparty, since, cursor, limit.

dataroom_get_room_engagement

하나의 데이터룸에 대한 점수판, 히트맵, 타임라인과 딜 롤업을 반환합니다.

  • 범위: read. 입력: dataroom_id(필수) 및 필터.

dataroom_get_engagement_scores

하나의 데이터룸에서 각 투자자의 참여도 점수를 순위별로 반환합니다.

  • 범위: read. 입력: dataroom_id(필수) 및 필터.

dataroom_get_investor_engagement

하나의 데이터룸에서 한 투자자의 방문과 열람한 문서를 반환합니다. Waafir에서와 마찬가지로 이 조회는 감사 로그에 기록됩니다.

  • 범위: read. 입력: dataroom_id, email(필수) 및 필터.

dataroom_get_document_engagement

조직 전체에서 거래 상대방별 문서 단위 열람 현황을 반환하며, file_id를 지정하면 해당 문서의 페이지별 소요 시간을 반환합니다. 특정 데이터룸으로 제한되지 않은 토큰이 필요합니다.

  • 범위: read. 입력: counterparty, file_id, weeks, cursor, limit, page_range.

dataroom_get_firm_rollups

조직 전체에서 거래 상대방별 주간 활동을 반환합니다. 특정 데이터룸으로 제한되지 않은 토큰이 필요합니다.

  • 범위: read. 입력: counterparty, weeks, cursor, limit.

Q&A 도구

데이터룸의 투자자 Q&A 스레드를 다루는 읽기 전용 도구 두 가지입니다. 딜 팀 토큰은 여기에서 질문을 게시할 수 없으며, 투자자 본인의 에이전트가 dataroom_ask_question으로 질문합니다(투자자 에이전트 도구 참조).

호출 결과는 토큰 소유자가 누구인지에 따라 달라집니다.

  • 딜 팀 구성원은 질문자의 이메일 주소를 포함해 데이터룸의 모든 스레드를 봅니다.
  • 투자자는 본인이 직접 한 질문만 보며, 이메일 주소는 전혀 보지 못합니다.

첨부 문서는 id와 이름만 반환되며, 내용이나 다운로드 링크는 절대 반환되지 않습니다. 호출자가 볼 수 없는 문서의 이름은 숨겨집니다. 내용이 필요하면 문서 도구를 사용하세요. 문서 도구는 자체 접근 검사를 적용합니다. 데이터룸에 연결되지 않은 조직 전체의 회사 Q&A 질문은 두 도구 모두 반환하지 않습니다.

dataroom_list_questions

영역 엔드포인트 이름: list_questions

권한이 있는 데이터룸 하나의 Q&A 스레드를 최신순으로, 각 스레드의 답변과 함께 나열합니다.

  • 범위: read.
  • 입력: dataroom_id(필수), status(선택 — open, answered 또는 closed), file_id(선택 — 해당 문서에 대해 한 질문만), limit(선택, 1–100, 기본값 25), offset(선택, 기본값 0).
  • 출력: { questions, pagination }. pagination.has_more가 true인 동안 offset으로 페이지를 넘기세요.

dataroom_get_question

영역 엔드포인트 이름: get_question

id로 Q&A 스레드 하나를 모든 답변과 함께 가져옵니다.

  • 범위: read.
  • 입력: dataroom_id(필수), question_id(필수).
  • 출력: { question }.
  • 다른 데이터룸이나 다른 조직의 질문, 또는 투자자의 경우 다른 사람이 한 질문은 NOT_FOUND를 보고합니다. 이 도구는 그러한 id가 존재한다는 사실을 절대 확인해 주지 않습니다.

각 질문에는 { id, dataroom_id, title, body, question_type, status, asked_by, file_id, file_name, created_at, updated_at, responses }가 포함되며, 호출자에게 자격이 있는 경우에 한해 asker_email도 포함됩니다. 투자자의 경우 이 키는 null 값으로 존재하는 것이 아니라 페이로드에서 아예 빠집니다. responses의 각 항목은 { id, body, responded_by, is_ai_draft, created_at, updated_at, attachments }입니다.

dataroom_answer_question (쓰기)

투자자의 질문에 답변합니다. 초안 단계가 없습니다. 투자자는 답변을 즉시 보며, 질문자의 설정이 허용하면 질문자에게 이메일이 발송됩니다. 둘 다 회수할 수 없습니다.

  • 범위: write. 데이터룸의 딜 팀 구성원.
  • 권한: 토큰에 조직 외부 사람들에게 전송이 필요합니다.
  • 입력: dataroom_id, question_id, body(모두 필수), confirm_token.
  • 두 단계. confirm_token 없이 호출하면 아무것도 게시되지 않고 미리보기(질문, 기존 답변 수, 질문자에게 이메일이 발송되는지 여부)와 토큰을 받습니다. 같은 인수와 토큰으로 다시 호출하면 게시됩니다. 그 사이에 새 답변이 달리거나 스레드가 종료되면 호출이 실패하며 다시 미리보기를 해야 합니다.

dataroom_close_question (쓰기)

Q&A 스레드 하나를 종료합니다. 질문자 또는 조직 관리자나 매니저가 종료할 수 있습니다.

  • 범위: write.
  • 입력: dataroom_id, question_id(모두 필수).
  • 출력: { question_id, outcome, kb_draft, kb_draft_skip_reason }.
  • 조직이 AI 비용을 지불하고 AI를 켜 둔 경우, 답변이 있는 스레드를 종료하면 지식 베이스 초안도 대기열에 추가됩니다. 그렇지 않으면 kb_draft는 skipped이며 그 이유가 표시됩니다. 투자자에게는 아무것도 발송되지 않습니다.

dataroom_bulk_close_questions (쓰기)

데이터룸 하나의 스레드를 최대 100개까지 종료합니다. 각 스레드는 개별적으로 판단됩니다.

  • 범위: write.
  • 입력: dataroom_id, question_ids(모두 필수).
  • 출력: { requested, closed, results }. 각 결과의 outcome은 closed, not_found, forbidden 또는 already_closed입니다.

dataroom_edit_question (쓰기)

질문의 제목 및/또는 본문을 편집합니다. 관리자와 매니저만 가능합니다.

  • 범위: write.
  • 입력: dataroom_id, question_id(모두 필수), title, body(최소 하나).
  • 출력: { question_id, title, body }.

dataroom_edit_answer (쓰기)

답변의 텍스트를 편집합니다. 관리자와 매니저만 가능합니다. Waafir에서와 마찬가지로 투자자는 편집 내용을 즉시 보며, 새 이메일은 발송되지 않습니다.

  • 범위: write.
  • 입력: dataroom_id, question_id, response_id, body(모두 필수).
  • 출력: { response_id, question_id, body }.

dataroom_delete_question (쓰기)

Q&A 스레드를 삭제합니다. 투자자는 더 이상 해당 스레드와 답변을 볼 수 없습니다. 관리자와 매니저만 가능합니다.

  • 범위: write.
  • 입력: dataroom_id, question_id(모두 필수), confirm_token.
  • 두 단계. confirm_token 없이 호출하면 아무것도 삭제되지 않고 미리보기와 토큰을 받습니다. 같은 인수와 토큰으로 다시 호출하면 삭제됩니다. 토큰은 한 번만 사용할 수 있으며 몇 분 후에 만료됩니다.

dataroom_delete_answer (쓰기)

스레드의 답변 하나를 삭제합니다. 투자자는 더 이상 해당 답변을 볼 수 없습니다. 관리자와 매니저만 가능합니다.

  • 범위: write.
  • 입력: dataroom_id, question_id, response_id(모두 필수), confirm_token.
  • 두 단계이며, dataroom_delete_question과 같습니다.

dataroom_publish_kb_article (쓰기)

지식 베이스 문서를 게시합니다. 예를 들어 종료된 스레드로부터 만든 초안을 게시할 수 있습니다. 그러면 데이터룸을 볼 수 있는 투자자가 이를 읽을 수 있습니다. 관리자와 매니저만 가능합니다.

  • 범위: write.
  • 입력: dataroom_id, article_id(모두 필수), confirm_token.
  • 두 단계이며, dataroom_delete_question과 같습니다.

투자자 업데이트 도구

이 도구들은 Waafir의 투자자 업데이트 편집기를 그대로 반영하며, 같은 역할 검사를 적용합니다. 모두 데이터룸에 투자자 자료 추가 기능이 필요합니다. 어느 도구도 투자자에게 아무것도 발송하지 않으며, 게시는 Waafir에서 이루어집니다.

dataroom_list_updates

데이터룸의 모든 상태의 투자자 업데이트를 최근 변경순으로 나열합니다.

  • 범위: read. 데이터룸의 딜 팀 구성원.
  • 입력: dataroom_id(필수).
  • 출력: { updates }, 각 항목은 { id, title, period_label, status, version, published_at, updated_at }.

dataroom_create_update (쓰기)

포트폴리오 및/또는 파일(최소 하나)로 업데이트 초안을 생성합니다.

  • 범위: write. 데이터룸의 딜 팀 구성원.
  • 입력: dataroom_id, period_label(모두 필수), title, period_start, period_end, tone_notes, portfolio_ids, file_ids.
  • 출력: { update_id, status, portfolio_count, file_count }. 조직에 속하지 않은 파일과 포트폴리오는 제외되며 집계되지 않습니다.

dataroom_get_update

편집기에 표시되는 그대로 업데이트 하나를 읽습니다.

  • 범위: read. 소유자와 관리자.
  • 입력: dataroom_id, update_id(모두 필수).
  • 출력: { update_id, status, document, latest_generation }. document는 편집 내용이 적용된 최신 생성 초안이며, 첫 생성 전에는 null입니다.

dataroom_get_update_generation

생성 실행의 상태입니다.

  • 범위: read. 소유자와 관리자.
  • 입력: dataroom_id, update_id, generation_id(모두 필수).
  • 출력: { generation_id, status, error_code }. 실패한 실행은 저장된 메시지가 아니라 코드만 반환합니다.

dataroom_generate_update (쓰기)

초안 또는 검토 중인 업데이트의 AI 생성을 시작합니다.

  • 범위: write, 그리고 토큰에 문서 내용 읽기. 실행 시 업데이트의 톤 메모에 따라 선택된 파일 전체를 읽기 때문입니다. 소유자와 관리자.
  • 입력: dataroom_id, update_id(모두 필수).
  • 출력: { generation_id, queued }. dataroom_get_update_generation을 폴링하세요.
  • 유료 플랜과 AI 기능 활성화가 필요하며, 일일 AI 한도에 포함됩니다. 편집기와 분당 5회 생성 한도를 공유합니다.

dataroom_edit_update_draft (쓰기)

편집기에서와 같이, 초안의 생성된 콘텐츠 위에 편집 내용을 저장합니다.

  • 범위: write. 소유자와 관리자.
  • 입력: dataroom_id, update_id, overrides(모두 필수). overrides는 narrative_sections, chart_placements, citations를 받습니다.
  • 출력: { update_id, status, document }. 초안만 편집할 수 있습니다.

dataroom_submit_update_for_review (쓰기)

업데이트 초안을 in_review로 옮깁니다.

  • 범위: write. 관리자와 매니저.
  • 입력: dataroom_id, update_id(모두 필수).
  • 출력: { update_id, status }.
  • 업데이트에 생성된 콘텐츠가 있어야 하며, 실행 중인 생성이 없어야 합니다.

dataroom_publish_update (쓰기)

검토 중인 업데이트를 게시합니다. 데이터룸의 투자자는 즉시 이를 볼 수 있으며 각자 이메일을 받는데, 이는 회수할 수 없습니다.

  • 범위: write. 관리자와 매니저.
  • 권한: 토큰에 조직 외부 사람들에게 전송이 필요합니다.
  • 입력: dataroom_id, update_id(모두 필수), confirm_token.
  • 두 단계. confirm_token 없이 호출하면 아무것도 게시되지 않고 미리보기(업데이트와 이메일을 받을 투자자 수)와 토큰을 받습니다. 같은 인수와 토큰으로 다시 호출하면 게시됩니다. 그 사이에 업데이트나 투자자 목록이 바뀌면 호출이 거부되며 다시 미리보기를 해야 합니다.

dataroom_republish_update (쓰기)

게시된 업데이트를 새 초안 버전으로 복사하며, 이후 이를 편집하고 검토하고 게시합니다. 그때까지는 게시된 버전이 계속 유효합니다.

  • 범위: write. 관리자와 매니저.
  • 입력: dataroom_id, update_id(모두 필수).
  • 출력: 새 초안의 { update_id, status, version }.

시장 인텔리전스 도구

읽기 전용입니다. 시장 인텔리전스 추가 기능(제한이 있는 미리보기로도 작동), 특정 데이터룸으로 제한되지 않은 토큰, 그리고 딜 팀 구성원인 토큰 소유자가 필요합니다.

mi_get_subject

조직의 시장 인텔리전스 회사입니다.

  • 범위: read.
  • 입력: 없음.
  • 출력: { subject, access }. subject는 { id, name }이며, 누군가 Waafir에서 시장 인텔리전스를 열기 전까지는 null입니다.

mi_get_profile

회사의 프로필: 확정된 버전과 작업 중인 초안입니다.

  • 범위: read.
  • 입력: subject_id(필수).
  • 출력: { subject, confirmed, draft, file_names }. 각 필드는 stated(읽어 온 출처인 file_id와 page, 또는 공개 웹 페이지와 그 인용문 포함), entered, not_applicable 또는 null입니다.
  • 데이터룸 문서의 인용문은 반환되지 않습니다. 필요하면 문서 도구로 파일을 읽으세요.

mi_list_matches

회사의 프로필에 맞춰 순위가 매겨진 투자자 목록으로, 가장 적합한 순서입니다.

  • 범위: read.
  • 입력: subject_id(필수).
  • 출력: { profile_version, preliminary, similarity, live, country, caveat, total, matches }. 각 매치는 { entity_id, name, score, penalties, reasons, contacts_available, on_roster, addable }입니다.
  • 미리보기는 상위 3개를 보여 줍니다. 유사도 순위는 플랜에 AI 비용이 포함되고, AI가 켜져 있으며, 일일 AI 한도가 허용할 때만 사용되며, similarity가 어느 경우인지 알려 줍니다.
  • 연락처 정보는 절대 반환되지 않습니다. Waafir 페이지와 분당 30회 한도를 공유합니다.

AI 도구

이 도구들은 Waafir 측에서 AI 작업을 수행하고 AI 클라이언트에 결과를 넘겨줍니다. 인용이 포함된 답변, 요약, 검토, 제안된 폴더 구성안 또는 초안입니다. 클라이언트가 그 결과를 얻기 위해 문서를 다운로드할 필요는 전혀 없습니다. 이 도구들에는 AI 추가 기능이 필요하고, 조직의 일일 AI 예산에 포함되며, 관리자가 AI를 일시 중지하면 함께 일시 중지됩니다. 각 도구는 사용자별로 앱의 해당 버튼과 같은 속도로 제한되며, 반환한 내용을 활동 로그에 기록합니다.

클라이언트가 질문을 작성하는 경우 답변이 문서의 내용을 그대로 옮길 수 있으므로, dataroom_ask, dataroom_draft_answer, dataroom_compare_files에는 dataroom_get_file_text와 마찬가지로 토큰에 문서 내용 읽기가 필요합니다. 이 권한이 없으면 해당 도구는 목록에 표시되지 않으며, 호출하면 GRANT_REQUIRED로 거부됩니다. 나머지 AI 도구는 데이터룸에 대해 정해진 작업을 수행하므로 이 권한 없이도 작동합니다. 모든 결과는 AI 출력이 담긴 필드를 untrusted_content에 표시합니다(결과의 신뢰할 수 없는 텍스트 참조).

토큰 소유자가 열 수 있는 문서만 사용되거나 인용됩니다. 이 도구들은 토큰 자체 조직의 데이터룸에서 작동합니다.

dataroom_ask

데이터룸 하나에 대해 질문하고 근거가 있는 답변을 받습니다.

  • 범위: read, 그리고 토큰에 문서 내용 읽기. 데이터룸의 모든 구성원.
  • 입력: dataroom_id(필수), question(필수).
  • 출력: { dataroom_id, answer, citations }. 인용은 최대 10개이며, 각각 { source_type, id, title, page? }입니다. 문서 텍스트는 반환되지 않으며, 채팅 대화도 저장되지 않습니다.

dataroom_summarise_file

파일 하나의 AI 요약과 핵심 사항을 받습니다.

  • 범위: read. 파일에 대한 다운로드 권한이 있는 딜 팀.
  • 입력: dataroom_id(필수), file_id(필수).
  • 출력: { file_id, file_name, status: "ready", summary, key_points }, 또는 파일에 아직 요약이 없으면 status: "queued". 이 경우 요약(Summarise) 버튼과 마찬가지로 백그라운드에서 요약이 시작되므로, 나중에 다시 호출하세요.

dataroom_list_facts

데이터룸의 문서에서 추출된 검증된 사실과 핵심 조건을 나열합니다.

  • 범위: read. 딜 팀.
  • 입력: dataroom_id(필수), file_id(선택), types(선택), limit(선택, 1–200, 기본값 50), cursor(선택).
  • 출력: { dataroom_id, facts, has_more, next_cursor }. 각 사실은 { id, file_id, file_name, fact_type, value, page, confidence, created_at }입니다. has_more가 true인 동안 다음 페이지를 위해 next_cursor를 cursor로 다시 전달하세요.
  • 토큰에 문서 내용 읽기가 없으면 각 사실의 value는 값 전체 기준으로 최대 20단어(160자)까지만 유지되며, 해당 사실에는 value_truncated가 포함됩니다.

dataroom_compare_files

데이터룸 하나에 있는 두 파일을 비교하여 중요한 차이점을 받습니다.

  • 범위: read, 그리고 토큰에 문서 내용 읽기. 두 파일 모두에 대한 다운로드 권한이 있는 딜 팀.
  • 입력: dataroom_id(필수), file_id_a(필수), file_id_b(필수).
  • 출력: { dataroom_id, file_a, file_b, differences }. 각 파일 항목은 { id, name, truncated }입니다. 매우 긴 문서는 앞부분만 비교되며, truncated가 이를 알려 줍니다. 문서 텍스트는 반환되지 않습니다.
  • 파일의 텍스트가 아직 추출되지 않은 경우, 추출할 텍스트가 없는 유형의 파일은 400으로, 50 MB를 초과하는 저장 파일은 413(FILE_TOO_LARGE)으로, 어느 쪽이든 가져오기 전에 거부됩니다.

dataroom_review

데이터룸의 AI 준비 상태 검토를 실행합니다.

  • 범위: read. 딜 팀.
  • 입력: dataroom_id(필수), force_refresh(선택).
  • 출력: { dataroom_id, cached, readinessScore, presentDocs, missingDocs, flaggedForRedaction, flaggedForRename, flaggedOutOfDate, suggestions }. 최신 상태의 저장된 검토가 있으면 force_refresh가 true가 아닌 한 새 AI 실행 없이 반환됩니다.

dataroom_propose_organise (쓰기)

2단계 중 1단계: 데이터룸의 폴더 구조를 제안합니다. 아무것도 이동하지 않습니다.

  • 범위: write. 소유자 또는 관리자.
  • 입력: dataroom_id(필수).
  • 출력: { dataroom_id, suggestion_id, applied: false, proposed_folders, unchanged_file_ids, files, total_files, accounted_for }.

dataroom_apply_organise (쓰기)

2단계 중 2단계: suggestion_id로 제안을 적용합니다. 저장된 제안이 정확히 그대로 한 번 적용되며, 도중에 편집할 수 없습니다. 토큰 소유자가 이동할 수 없는 파일은 건너뛰고 집계됩니다. 되돌리려면 앱의 정리(Organise) 패널을 사용하세요.

  • 범위: write. 소유자 또는 관리자.
  • 입력: dataroom_id(필수), suggestion_id(필수).
  • 출력: { dataroom_id, suggestion_id, folders_created, files_moved, files_skipped }.

dataroom_draft_answer

데이터룸의 문서를 바탕으로 투자자 질문에 대한 답변 초안을 작성합니다.

  • 범위: read, 그리고 토큰에 문서 내용 읽기. 소유자 또는 관리자.
  • 입력: question_id(필수).
  • 출력: { question_id, draft, is_draft: true, sources }. 초안은 사용자에게만 반환되며, 아무것도 저장, 발송 또는 게시되지 않습니다. 답변은 사람이 앱에서 게시합니다. 조직 수준의 질문은 앱에서 초안을 작성합니다.

준비 상태 및 지식 베이스 도구

읽기 전용입니다. 준비 상태 도구는 점수와 그 근거가 되는 개수만 반환하며, 검토 텍스트는 반환하지 않습니다. 검토 텍스트가 필요하면 dataroom_review를 실행하세요.

dataroom_get_readiness_score

데이터룸 하나의 준비 상태 점수입니다.

  • 범위: read, 그리고 토큰 소유자는 조직 소유자 또는 관리자여야 합니다.
  • 입력: dataroom_id(필수).
  • 출력: { dataroom_id, score, reviewed, questions_total, questions_answered, kb_articles, files_uploaded, present_categories, missing_categories }. score는 0–100이며, 보여 줄 수 있는 AI 검토가 없으면 null입니다.

dataroom_get_readiness_rollup

대시보드에 표시되는 것과 같은, 조직 데이터룸 전체의 준비 상태입니다.

  • 범위: read, 그리고 토큰 소유자는 딜 팀에 속해야 합니다. 특정 데이터룸으로 제한된 토큰은 거부됩니다.
  • 입력: 없음.
  • 출력: { rooms: [{ id, name, investors, reading, updated, status, readinessPct, tone, reviewedAt, presentCount, missingCount, categories }] }. 카테고리별 문서 수에는 토큰 소유자가 읽을 수 있는 문서만 포함됩니다.

dataroom_list_kb_articles

데이터룸의 지식 베이스 문서를, 데이터룸 자체 문서와 조직 전체 문서 모두 나열합니다.

  • 범위: read.
  • 입력: dataroom_id(필수), category, include_drafts(딜 팀 전용).
  • 출력: { articles: [{ id, title, category, published }] }.
  • 공유된 문서를 통해서만 데이터룸에 들어온 사람은 문서를 보지 못합니다. 투자자 토큰은 게시된 문서만 봅니다.

dataroom_get_kb_article

문서 하나를 읽습니다.

  • 범위: read.
  • 입력: dataroom_id, article_id(필수).
  • 출력: { id, title, category, body, published, updated_at }. 토큰 소유자가 딜 팀에 속하지 않으면 초안은 찾을 수 없는 것으로 읽힙니다.

투자자 에이전트 도구

투자자 본인의 에이전트를 위한 도구입니다. 투자자 액세스 토큰으로만 작동하며, 딜 팀 토큰에는 목록에 표시되지도 않고 호출할 수도 없습니다.

투자자 토큰은 다음 공유 도구도 호출할 수 있습니다. 각 도구는 투자자가 데이터룸에서 보는 내용만으로 응답합니다.

  • 데이터룸과 파일: dataroom_list, dataroom_get, dataroom_list_folders, dataroom_list_files, dataroom_get_file_metadata, dataroom_search.
  • 스냅샷: dataroom_list_snapshots와 dataroom_get_snapshot(투자자가 열람하는 스냅샷 대상).
  • 다운로드: dataroom_get_file_download_url. 사본에는 브라우저 다운로드와 마찬가지로 항상 투자자의 신원이 워터마크로 표시됩니다.
  • Q&A와 문서: dataroom_list_questions, dataroom_get_question, dataroom_list_kb_articles, dataroom_get_kb_article. 투자자 본인의 질문과 게시된 문서를 반환합니다.
  • AI: dataroom_ask, dataroom_compare_files, translate_text, translate_file, translate_file_status. 투자자의 번역은 본인만 볼 수 있습니다.

투자자 토큰은 dataroom_get_file_text 사용이 거부됩니다. 일반 텍스트에는 워터마크를 넣을 수 없으므로, 에이전트는 대신 워터마크가 적용된 다운로드를 사용합니다.

AI 비용 부담 주체. 각 AI 호출에는 할당 단위가 소요됩니다. 데이터룸의 조직이 데이터룸별·투자자별 월간 할당량(UTC 기준 월)까지 비용을 부담합니다. 딜 팀이 데이터룸별로 할당량을 설정하며, 기본값은 200단위입니다. 할당량을 초과하면 투자자가 구성원으로 속한 조직이 활성 구독과 AI 활성화 상태인 경우 비용을 부담합니다(투자자가 소유한 조직이 먼저, 그다음 가장 오래된 조직). 둘 다 해당하지 않으면 모델 작업 전에 호출이 QUOTA_EXCEEDED(HTTP 402)로 거부됩니다. 메시지에는 할당량이 재설정되는 날짜가 표시됩니다.

속도 제한. 투자자의 에이전트들은 해당 투자자의 모든 토큰과 연결에 걸쳐 분당 60회의 한도 하나를 공유합니다. 이를 초과하면 호출이 거부되며(HTTP 429) 재시도 전 대기 시간이 안내됩니다.

각 도구는 데이터룸이 투자자에 대해 확인하는 항목을 똑같이 확인합니다. 접근이 만료되거나 취소되지 않았는지, NDA를 수락했는지, 딜 팀의 데이터룸별 에이전트 스위치가 켜져 있는지, 그리고 파일의 경우 투자자에게 해당 파일의 읽기 권한이 있는지입니다. 읽을 수 없는 파일은 찾을 수 없다고 보고되며, 그 이름은 절대 반환되지 않습니다. NDA 수락은 데이터룸에서만 이루어집니다.

dataroom_ask_question (쓰기)

데이터룸 하나에서 딜 팀에 질문합니다. 투자자와 딜 팀만 이를 보며, 딜 팀에 알림이 갑니다.

  • 범위: write.
  • 입력: dataroom_id, title(최소 5자)(필수), description, category, file_id(투자자가 읽을 수 있는 파일).
  • 출력: { question_id, dataroom_id, file_id, status }.

dataroom_list_file_comments

투자자가 파일 하나에서 볼 수 있는 댓글, 즉 본인의 댓글과 그 답글입니다.

  • 범위: read.
  • 입력: dataroom_id, file_id(필수).
  • 출력: { comments: [{ id, content, page, resolved, created_at, author, replies }] }.

dataroom_add_file_comment (쓰기)

투자자가 읽을 수 있는 파일에 댓글을 답니다. 투자자와 딜 팀에게 표시되며, 다른 투자자에게는 절대 표시되지 않습니다.

  • 범위: write.
  • 입력: dataroom_id, file_id, content(필수), page.
  • 출력: { comment_id, file_id, created_at }.

dataroom_reply_file_comment (쓰기)

투자자가 볼 수 있는 댓글에 답글을 답니다. 다른 파일의 댓글은 찾을 수 없다고 보고됩니다.

  • 범위: write.
  • 입력: dataroom_id, file_id, comment_id, content(필수).
  • 출력: { reply_id, comment_id, created_at }.

dataroom_get_my_nda_status

에이전트가 접근할 수 있는 각 데이터룸에서 투자자의 NDA 상태입니다.

  • 범위: read.
  • 입력: 없음.
  • 출력: { rooms: [{ dataroom_id, dataroom_name, basis, accepted, accepted_at, version, accept_step }] }. basis는 org_standard, firm_executed, firm_in_progress, waived 또는 not_required이며, accept_step은 clickthrough, held 또는 none입니다.

dataroom_list_my_notifications

토큰 조직에서 온 투자자의 알림입니다. 초대, 본인 질문에 대한 답변, 폴더 접근 권한 변경이 포함됩니다.

  • 범위: read.
  • 입력: unread_only, limit(1–50, 기본값 20), offset.
  • 출력: { notifications: [{ id, type, title, body, resource_type, resource_id, read, created_at }], unread_count, pagination }.

dataroom_mark_notifications_read (쓰기)

알림을 읽음으로 표시합니다. 나열된 id, 또는 all: true로 모든 알림을 표시합니다.

  • 범위: write.
  • 입력: ids(1–100) 또는 all.
  • 출력: { marked }, 변경된 개수.

dataroom_list_published_updates

데이터룸 하나에서 투자자에게 게시된 투자자 업데이트입니다.

  • 범위: read.
  • 입력: dataroom_id(필수).
  • 출력: { updates: [{ id, title, period_label, version, published_at, unread }] }.
  • 딜 팀이 해당 투자자의 업데이트를 꺼 두었거나, 데이터룸에 투자자 자료 추가 기능이 없으면 거부됩니다.

dataroom_get_published_update

게시된 업데이트 하나를 읽습니다.

  • 범위: read.
  • 입력: dataroom_id, update_id(필수).
  • 출력: { update_id, title, period_label, version, published_at, document }.

스냅샷 도구

스냅샷은 감사 추적을 위해 보관되는, 데이터룸의 폴더와 파일 버전을 고정한 사본입니다. 어떤 도구도 파일 내용이나 다운로드 링크를 반환하지 않으며, 다운로드는 앱에서만 가능합니다. dataroom_get_snapshot과 뷰어 도구는 해당 앱 경로와 마찬가지로 특정 데이터룸으로 제한된 토큰을 거부합니다.

dataroom_list_snapshots

  • 범위: read. 딜 팀은 모든 스냅샷을 보며, 그 밖의 사람은 뷰어로 추가된 스냅샷만 봅니다.
  • 입력: dataroom_id(필수).
  • 출력: { snapshots: [{ id, name, purpose, snapshot_at, file_count, folder_count, viewer_count? }] }.

dataroom_get_snapshot

  • 범위: read, 그리고 스냅샷에 대한 접근 권한.
  • 입력: snapshot_id(필수).
  • 출력: { snapshot, folders: [{ folder_id, parent_folder_id, name }], files: [{ file_id, folder_id, name, size_bytes, mime_type, can_download }], can_manage_viewers }. 토큰 소유자가 현재 볼 수 없는 파일과 폴더는 제외되며, 개수는 나열된 항목과 일치합니다.

dataroom_create_snapshot

데이터룸을 현재 상태 그대로 고정합니다. 데이터룸에서는 아무것도 바뀌지 않습니다.

  • 범위: write, 딜 팀 전용.
  • 입력: dataroom_id, name(필수), purpose, notes.
  • 출력: { snapshot: { id, name, purpose, snapshot_at, file_count, folder_count, viewer_count } }.

dataroom_list_snapshot_viewers

  • 범위: read, 딜 팀 전용.
  • 입력: snapshot_id(필수).
  • 출력: { viewers: [{ viewer_id, email, granted_at, revoked_at, active }] }.

dataroom_grant_snapshot_viewer

이메일 주소로 누군가가 스냅샷을 열 수 있게 합니다. 두 단계입니다. 미리보기에 스냅샷과 주소가 표시됩니다. 이메일은 발송되지 않으므로 직접 알려 주세요.

  • 범위: write, 딜 팀 전용, 그리고 조직 외부 사람들에게 전송 권한.
  • 입력: snapshot_id, email(필수), confirm_token.
  • 출력: { viewer_id, email, active }.

dataroom_revoke_snapshot_viewer

두 단계입니다.

  • 범위: write, 딜 팀 전용.
  • 입력: snapshot_id, viewer_id(필수), confirm_token.
  • 출력: { success: true, viewer_id }.

공유 링크 도구

공유 링크는 이를 가진 사람 누구에게나 데이터룸이나 문서에 대한 접근을 허용하므로, 링크 생성에는 항상 두 단계와 조직 외부 사람들에게 전송 권한이 있는 토큰이 필요합니다. 어떤 도구도 링크의 URL을 나열하지 않습니다.

  • 범위: read, 그리고 토큰 소유자는 조직 소유자 또는 관리자여야 합니다.
  • 입력: dataroom_id(필수), 문서 하나의 활성 링크를 보려면 file_id.
  • 출력: { links: [{ id, kind, file_id?, mode, active, expires_at, has_password, require_nda, domain_allow_list, created_at, admitted_count? }] }.
  • 투자자별 링크는 나열되지 않습니다. 투자자 도구를 참조하세요.

두 단계입니다. 미리보기에는 공유되는 대상, 접근할 수 있는 사람, NDA 규칙, 만료 시점, 다운로드에 워터마크가 적용되는 방식이 표시됩니다. 확인 호출은 같은 인수를 반복해야 하며, 그 사이에 투자자 목록이 바뀌면 다시 확인하세요.

  • 범위: write, 조직 소유자 또는 관리자, 그리고 조직 외부 사람들에게 전송 권한.
  • 입력: dataroom_id, mode(open 또는 restricted)(필수), file_id, expires_in_hours, domain_allow_list, require_nda(기본값 true), confirm_token.
  • 출력: { id, url, mode, active, expires_at, require_nda, file_id }.
  • 제한된 문서는 링크로 공유할 수 없습니다. 비밀번호 옵션은 없습니다.

두 단계입니다. 링크를 사용하는 모든 사람이 즉시 접근 권한을 잃습니다.

  • 범위: write, 조직 소유자 또는 관리자.
  • 입력: dataroom_id, link_id(필수), confirm_token.
  • 출력: { success: true, link_id, status: "revoked" }.