문서로 건너뛰기
MCP 서버

내보내기

워크스페이스 전체의 zip.

내보내기 도구

도구하는 일
getExportPreview내보내기를 지금 시작할 수 있는지, 다음은 언제 가능한지, 아직 만들어지는 내보내기, 내보내기에 얼마나 담길지.
listExports워크스페이스의 내보내기를 최신순으로, 상태와 진행 정도와 크기와 함께 보여 줍니다.
getExportid로 지정한 내보내기 하나.
startExport워크스페이스 전체의 zip 만들기를 하루에 한 번 시작합니다. 확인 코드를 요청하며, 앱 채팅에서는 항상 먼저 묻습니다.

워크스페이스 소유자나 모든 권한을 가진 역할의 멤버만, 모든 주소로 연결된 클라이언트를 통해 내보낼 수 있습니다. 모든 도구에 threads:read가 필요합니다.

zip을 반환하는 도구는 없습니다. 앱의 내보내기 페이지, REST API의 GET /exports/{id}/content, SDK의 exports.download, 명령줄의 openemail exports download로 다운로드하세요.

이 서버의 일부 도구는 REST API가 인증 코드로 보호하는 변경을 하며, 같은 코드를 요구합니다. 클라이언트가 최근 60분 안에 코드를 인증하지 않았고, 사용자가 계정 → 연결된 앱에서 그 클라이언트에 대해 60분 동안 변경 허용을 고르지도 않았다면, 이런 도구는 Refused (step_up_required):로 시작하는 결과를 반환하고 아무것도 바꾸지 않습니다. emptyAudience는 코드를 요구하지 않습니다. 코드를 요구하는 도구 목록과 코드를 요청하고 인증하는 방법은 API의 인증 페이지에 있습니다.

레퍼런스

getExportPreview

범위threads:read앱의 어시스턴트가 묻지 않고 실행합니다툴킷workspace

Whether this workspace can be exported now, when the next export can start, the export still being made, and how much an export would hold: conversations, attachments, contacts, audiences, calendar events, templates, rules, labels, notes and addresses.

입력

입력을 받지 않습니다.

다른 사용처

API
GET /exports/preview
SDK
exports.preview()

listExports

범위threads:read앱의 어시스턴트가 묻지 않고 실행합니다툴킷workspace

The exports of this workspace, newest first, with their status, progress, size and when each is deleted. A ready one is downloaded on the Export page of the app or with GET /exports/{id}/content on the REST API.

입력

limitinteger
1 이상100 이하
offsetinteger
0 이상

다른 사용처

API
GET /exportsGET /exports/{id}
SDK
exports.list()exports.get()

getExport

범위threads:read앱의 어시스턴트가 묻지 않고 실행합니다툴킷workspace

One export by its id: its status, its progress through the conversations, its size and when it is deleted.

입력

idstring필수
1~128자

다른 사용처

API
GET /exportsGET /exports/{id}
SDK
exports.list()exports.get()

startExport

범위threads:read앱의 어시스턴트가 항상 먼저 확인합니다툴킷workspace

Start making a zip of the whole workspace, as Export now on the Export page does. It is made in the background, one at a time and once a day, and kept for a year. Ask the person first.

입력

입력을 받지 않습니다.

다른 사용처

API
POST /exports
SDK
exports.start()