Settings → Developers에서 발급한 키를 Authorization: Bearer dr_live_<12자리 16진수>_<64자리 16진수> 형태로 전송합니다. 키는 명시적인 범위를
가지며 — 각 엔드포인트에 필요한 범위가 해당 엔드포인트에 명시되어 있습니다. 전체 키는 발급 시점에 딱 한
번만 표시되며 다시 조회할 수 없습니다 — 이후에는 keyId 접두어만 표시됩니다. 폐기된
키는 바로 다음 요청부터 인증에 실패합니다.
DocumentSummary에 설명, 만료 정보, 두 허용 목록이 포함된 보호 방식 요약, revision을 더한 것입니다.
status는 방문자가 실제로 겪는 상태입니다(목록의 값과 같으며 expired를 포함합니다). 성공한
PATCH /api/preview/documents/{id}가 반환하는 본문이기도 합니다.
상태입니다. live(공개 중, 방문자가 열 수 있음), draft(초안, 아직 게시하지 않은 포스트나 폼), inactive(비활성, 직접 껐거나 Notion 페이지를 더 이상 읽을 수 없는 등의 이유로 자동으로 꺼짐), expired(만료, 만료일이 지남) 중 하나입니다.
이 설정의 버전을 나타냅니다(밀리초 단위의 ISO 8601 UTC 타임스탬프). ETag 헤더로도 전달되며, PATCH할 때 본문의 revision으로 그대로 보내세요. 값의 의미는 해석하지 말고 그대로 사용하세요.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"DocuRise Developer Docs","colors":{"primary":"#DA350B","light":"#FF3C00","dark":"#AE2D13"},"logo":"https://mintcdn.com/docu-rise/ClhhLqgPXOXvt7Zz/logo.png?fit=max\u0026auto=format\u0026n=ClhhLqgPXOXvt7Zz\u0026q=85\u0026s=b73379a7630a12945d164a128a6ddb12","favicon":"https://mintcdn.com/docu-rise/uxv1U4cKVTA4xM3l/favicon.png?fit=max\u0026auto=format\u0026n=uxv1U4cKVTA4xM3l\u0026q=85\u0026s=0b88e688751814cb08931184873ba0be","appearance":{"default":"light","strict":true},"navbar":{"primary":{"type":"button","label":"Dashboard","href":"https://docurise.io/dashboard"}},"footer":{"socials":{}},"styling":{"latex":false},"navigation":{"languages":[{"language":"en","href":""},{"language":"ko","href":"ko"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"docu-rise","hasAudioNarration":false,"actualSubdomain":"docu-rise","customDomains":["docurise.io"],"gitSource":{"type":"github","owner":"ireneshlee814","repo":"docurise","deployBranch":"master","contentDirectory":"docs-content","isPrivate":true,"mountPath":"","label":""},"chroma":{"latestBuiltDeploymentHistoryId":"6adf7b89b80f21f061134342","collectionId":"820b1d78-0643-45b9-befb-138aad9e313e","liveDeploymentHistoryId":"6adf7b89b80f21f061134342","schemaVersion":"v3"},"entitlements":{"AI_CHAT":{"status":"DISABLED"},"WEB_MCP":{"status":"DISABLED"},"NARRATION":{"status":"DISABLED"}},"buildId":"6adf7b89b80f21f061134342","clientVersion":"0.0.3966","searchFilterCounts":[{"language":"en","tag":"API Reference","count":27},{"language":"ko","tag":"API Reference","count":27},{"language":"en","tag":"Documents","count":8},{"language":"ko","tag":"문서","count":8},{"language":"en","tag":"Audiences","count":7},{"language":"en","tag":"Guides","count":7},{"language":"ko","tag":"오디언스","count":7},{"language":"ko","tag":"가이드","count":7},{"language":"en","tag":"Instagram","count":4},{"language":"ko","tag":"Instagram","count":4},{"language":"en","tag":"Email","count":3},{"language":"en","tag":"Get Started","count":3},{"language":"ko","tag":"이메일","count":3},{"language":"ko","tag":"시작하기","count":3},{"language":"en","tag":"Contacts","count":2},{"language":"en","tag":"Reference","count":2},{"language":"en","tag":"AI Apps","count":2},{"language":"ko","tag":"연락처","count":2},{"language":"ko","tag":"레퍼런스","count":2},{"language":"ko","tag":"AI 앱","count":2}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-v7-file-tree","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"pause-universal-search-reconcile","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"per-site-search-delta","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-private-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-nav-generations","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"isAtlas":false,"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"ko/api-reference/get-document","slug":"/ko/api-reference/get-document","pageMetadata":{"title":"문서 조회","description":"문서 하나를 만료 정보, 보호 방식 요약, 변경할 때 다시 보낼 revision(ETag)과 함께 조회합니다","openapi":"api-reference/openapi.ko.yaml GET /api/preview/documents/{id}","href":"/ko/api-reference/get-document"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"문서 하나를 만료 정보, 보호 방식 요약, 변경할 때 다시 보낼 revision(ETag)과 함께 조회합니다\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"문서 조회","description":"문서 하나를 만료 정보, 보호 방식 요약, 변경할 때 다시 보낼 revision(ETag)과 함께 조회합니다","openapi":"api-reference/openapi.ko.yaml GET /api/preview/documents/{id}","href":"/ko/api-reference/get-document"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"getDocument","tags":["Documents"],"summary":"문서 조회하기","description":"문서 하나를 만료 정보, 보호 방식 요약, 변경할 때 다시 보낼 revision(ETag)과 함께 조회합니다","security":["53dbb0c6-d032-4b33-8ab5-4a3df663c240"],"responses":{"200":"8005858b-dda2-4c30-87b7-8ad4bb38d86e","401":"8df97aaa-deee-46b0-a9ce-d2c53e9c0e03","403":"b93bf7c3-5790-44c6-983d-b461734f383e","404":"70868563-7fb5-4e94-87fc-5a8e9aa70205","429":"9e079a3d-bdc9-4f29-883c-86475b0370c1","500":"593c2253-616e-4326-9087-be4023469ae9","503":"dbaee487-1c7a-4dc1-a48d-5dc4b74418c9"},"x-codeSamples":[{"lang":"bash","label":"cURL","source":"curl -i \"https://docurise.io/api/preview/documents/7f1c0f7e-3c5e-4b1a-9d34-2f0a5b6c8d90\" \\\n -H \"Authorization: Bearer $DOCURISE_API_KEY\"\n"}],"method":"get","type":"path","servers":["922ffeb3-bf70-4258-a4df-09fc83e1b8f2"],"path":"/api/preview/documents/{id}","baseUrlOptions":["https://docurise.io"],"title":"문서 조회하기","codeSamples":[{"label":"cURL","lang":"bash","source":"curl -i \"https://docurise.io/api/preview/documents/7f1c0f7e-3c5e-4b1a-9d34-2f0a5b6c8d90\" \\\n -H \"Authorization: Bearer $DOCURISE_API_KEY\"\n"}],"requiredOnlyExamples":false,"requestExampleType":"codeSamples","responseExampleType":"generated"},"dependencies":{"parameters":{"25d3dfeb-a283-4cec-8095-2956c61308a0":{"name":"id","in":"path","required":true,"description":"문서 ID입니다.","schema":{"type":"string","format":"uuid","isRequired":true,"description":"문서 ID입니다.","uniqueKey":"","typeLabel":"string\u003cuuid>"}}},"responses":{"8005858b-dda2-4c30-87b7-8ad4bb38d86e":{"description":"문서입니다.","headers":{"ETag":{"description":"따옴표로 감싼 `revision`입니다. `PATCH` 본문에 `revision`으로 보내세요. 일반 타임스탬프로 보내거나, 이 헤더 값을 그대로 복사해도 됩니다. 게이트웨이나 프록시가 응답을 압축하면서 ETag를 약한 형식 `W/\"...\"`으로 바꾸는 경우도 마찬가지입니다. `If-Match`로 보내지 마세요.","schema":{"type":"string","example":"\"2026-10-04T01:02:03.456Z\""}}},"content":{"application/json":{"schema":{"type":"object","description":"`DocumentSummary`에 설명, 만료 정보, 두 허용 목록이 포함된 보호 방식 요약, `revision`을 더한 것입니다.\n`status`는 방문자가 실제로 겪는 상태입니다(목록의 값과 같으며 `expired`를 포함합니다). 성공한\n`PATCH /api/preview/documents/{id}`가 반환하는 본문이기도 합니다.\n","required":["description","expiry","protection","revision","id","title","kind","status","url","createdAt","updatedAt","expiresAt"],"example":{"id":"7f1c0f7e-3c5e-4b1a-9d34-2f0a5b6c8d90","title":"Pricing deck","kind":"pdf","status":"live","url":"https://docurise.io/v/pricing-deck","createdAt":"2026-09-30T12:00:00.000Z","updatedAt":"2026-10-01T08:30:00.000Z","expiresAt":"2026-12-31T00:00:00.000Z","description":"Q4 pricing","expiry":{"type":"fixed_date","expiresAt":"2026-12-31T00:00:00.000Z","days":null},"protection":{"accessMode":"public","requireEmail":true,"requireEmailVerification":false,"passwordProtected":false,"allowedEmails":[],"allowedDomains":[]},"revision":"2026-10-01T08:30:00.000Z"},"properties":{"id":{"type":"string","format":"uuid","description":"문서의 id입니다.","isRequired":true,"uniqueKey":"id","typeLabel":"string\u003cuuid>"},"title":{"type":"string","description":"문서 제목입니다.","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"kind":{"type":"string","enum":["notion","pdf","upload","post","form"],"description":"문서가 무엇으로 이루어져 있는지 나타냅니다: `notion`, `pdf`, `upload`(업로드한 파일), `post`, `form`.","isRequired":true,"uniqueKey":"kind","typeLabel":"enum\u003cstring>"},"status":{"type":"string","enum":["live","draft","inactive","expired"],"description":"상태입니다. `live`(공개 중, 방문자가 열 수 있음), `draft`(초안, 아직 게시하지 않은 포스트나 폼), `inactive`(비활성, 직접 껐거나 Notion 페이지를 더 이상 읽을 수 없는 등의 이유로 자동으로 꺼짐), `expired`(만료, 만료일이 지남) 중 하나입니다.","isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"url":{"type":"string","format":"uri","description":"공개 공유 링크입니다.","isRequired":true,"uniqueKey":"url","typeLabel":"string\u003curi>"},"createdAt":{"type":"string","format":"date-time","description":"문서를 만든 시각(RFC 3339, UTC)입니다.","isRequired":true,"uniqueKey":"createdAt","typeLabel":"string\u003cdate-time>"},"updatedAt":{"type":"string","format":"date-time","description":"문서를 마지막으로 바꾼 시각(RFC 3339, UTC)입니다.","isRequired":true,"uniqueKey":"updatedAt","typeLabel":"string\u003cdate-time>"},"expiresAt":{"oneOf":[{"type":"string","format":"date-time","description":"고정 만료일이며, 없으면 `null`입니다. 열람자별(상대) 만료는 단일 날짜가 없으므로 여기서는 `null`입니다. 단일 문서 응답의 `expiry`를 확인하세요.","isRequired":true,"uniqueKey":"expiresAt.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","description":"고정 만료일이며, 없으면 `null`입니다. 열람자별(상대) 만료는 단일 날짜가 없으므로 여기서는 `null`입니다. 단일 문서 응답의 `expiry`를 확인하세요.","isRequired":true,"uniqueKey":"expiresAt.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"expiresAt","typeLabel":"string\u003cdate-time> | null"},"description":{"oneOf":[{"type":"string","description":"문서의 부제목이며, 설정하지 않았으면 `null`입니다.","isRequired":true,"uniqueKey":"description.oneOf.0","typeLabel":"string"},{"type":"null","description":"문서의 부제목이며, 설정하지 않았으면 `null`입니다.","isRequired":true,"uniqueKey":"description.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"description","typeLabel":"string | null"},"expiry":{"type":"object","required":["type","expiresAt","days"],"properties":{"type":{"type":"string","enum":["none","fixed_date","relative"],"description":"`relative`는 열람자별로 만료되며, 열람자가 처음 연 뒤 `days`일이 지나면 만료됩니다.","isRequired":true,"uniqueKey":"expiry.type","typeLabel":"enum\u003cstring>"},"expiresAt":{"oneOf":[{"type":"string","format":"date-time","description":"`fixed_date`일 때만 값이 있고, 그 외에는 `null`입니다.","isRequired":true,"uniqueKey":"expiry.expiresAt.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","description":"`fixed_date`일 때만 값이 있고, 그 외에는 `null`입니다.","isRequired":true,"uniqueKey":"expiry.expiresAt.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"expiry.expiresAt","typeLabel":"string\u003cdate-time> | null"},"days":{"oneOf":[{"type":"integer","description":"`relative`일 때만 값이 있고, 그 외에는 `null`입니다.","isRequired":true,"uniqueKey":"expiry.days.oneOf.0","typeLabel":"integer"},{"type":"null","description":"`relative`일 때만 값이 있고, 그 외에는 `null`입니다.","isRequired":true,"uniqueKey":"expiry.days.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"expiry.days","typeLabel":"integer | null"}},"description":"문서가 만료되는 시점입니다.","isRequired":true,"uniqueKey":"expiry","typeLabel":"object"},"protection":{"type":"object","description":"문서가 어떻게 보호되는지입니다. 이메일과 허용 목록 필드는 `PATCH`로 변경하며, 비밀번호와 접근 방식은 여기서 읽기 전용입니다. 비밀번호는 포함되지 않습니다.","required":["accessMode","requireEmail","requireEmailVerification","passwordProtected","allowedEmails","allowedDomains"],"properties":{"accessMode":{"type":"string","enum":["public","specific"],"description":"`public`(링크가 있는 누구나) 또는 `specific`(허용된 이메일과 도메인만).","isRequired":true,"uniqueKey":"protection.accessMode","typeLabel":"enum\u003cstring>"},"requireEmail":{"type":"boolean","description":"열람자에게 이메일을 요구합니다(리드 게이트).","isRequired":true,"uniqueKey":"protection.requireEmail","typeLabel":"boolean"},"requireEmailVerification":{"type":"boolean","description":"문서를 열기 전에 방문자가 이메일로 받은 링크를 눌러 이메일 주소를 확인해야 하는지 여부입니다. 이메일 입력이 필요한 상태(`requireEmail` 또는 `accessMode: specific`)일 때만 적용됩니다.","isRequired":true,"uniqueKey":"protection.requireEmailVerification","typeLabel":"boolean"},"passwordProtected":{"type":"boolean","description":"열람자가 비밀번호를 입력해야 합니다. 비밀번호 자체는 절대 반환되지 않습니다.","isRequired":true,"uniqueKey":"protection.passwordProtected","typeLabel":"boolean"},"allowedEmails":{"type":"array","items":{"type":"string","format":"email","uniqueKey":"protection.allowedEmails.items.[INDEX]","typeLabel":"string\u003cemail>"},"description":"입장이 허용된 소문자 이메일 주소입니다(`accessMode`가 `specific`일 때 적용).","isRequired":true,"uniqueKey":"protection.allowedEmails","typeLabel":"string\u003cemail>[]"},"allowedDomains":{"type":"array","items":{"type":"string","uniqueKey":"protection.allowedDomains.items.[INDEX]","typeLabel":"string"},"description":"입장이 허용된 소문자 도메인입니다(`accessMode`가 `specific`일 때 적용). 정확히 일치하는 도메인만 해당합니다.","isRequired":true,"uniqueKey":"protection.allowedDomains","typeLabel":"string[]"}},"isRequired":true,"uniqueKey":"protection","typeLabel":"object"},"revision":{"type":"string","description":"이 설정의 버전을 나타냅니다(밀리초 단위의 ISO 8601 UTC 타임스탬프). `ETag` 헤더로도 전달되며, `PATCH`할 때 본문의 `revision`으로 그대로 보내세요. 값의 의미는 해석하지 말고 그대로 사용하세요.","isRequired":true,"uniqueKey":"revision","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"id":"7f1c0f7e-3c5e-4b1a-9d34-2f0a5b6c8d90","title":"Pricing deck","kind":"pdf","status":"live","url":"https://docurise.io/v/pricing-deck","createdAt":"2026-09-30T12:00:00.000Z","updatedAt":"2026-10-01T08:30:00.000Z","expiresAt":"2026-12-31T00:00:00.000Z","description":"Q4 pricing","expiry":{"type":"fixed_date","expiresAt":"2026-12-31T00:00:00.000Z","days":null},"protection":{"accessMode":"public","requireEmail":true,"requireEmailVerification":false,"passwordProtected":false,"allowedEmails":[],"allowedDomains":[]},"revision":"2026-10-01T08:30:00.000Z"}}},"exampleType":"generated"}},"exampleType":"generated"},"8df97aaa-deee-46b0-a9ce-d2c53e9c0e03":{"description":"누락되었거나 형식이 잘못되었거나 폐기된 API 키입니다(`code: UNAUTHORIZED`).","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","retryable"],"properties":{"code":{"type":"string","description":"안정적인 기계 판독용 에러 코드입니다 — `message`가 아니라 이 값을 기준으로 분기하세요.","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"사람이 읽을 수 있는 상세 설명입니다. 예고 없이 문구가 바뀔 수 있습니다.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"retryable":{"type":"boolean","description":"동일한 요청을 재시도했을 때 성공할 가능성이 있는지 여부입니다.","isRequired":true,"uniqueKey":"error.retryable","typeLabel":"boolean"},"retryAfterSeconds":{"type":"integer","description":"구체적인 백오프 힌트가 있는 경우에만 존재합니다.","uniqueKey":"error.retryAfterSeconds","typeLabel":"integer"},"details":{"type":"object","description":"일부 특정 코드에만 존재합니다:\n- `PROTECTION_RULE_CONFLICT`: `{ rule: string }`, 요청을 거부한 보호 규칙입니다\n (`form`, `restricted_access`, `paid_lead_gate`, `free_lead_gate` 또는 `form_no_access_controls`).\n 열려 있는 값입니다. 새 값을 허용하세요.\n- `NEXT_POST_RULE_EXISTS`: `{ ruleId: string }`, 이미 있는 \"다음 게시물\" 규칙입니다.\n- `NOTION_FETCH_FAILED`: `{ notionErrorCode: string }`, 다음 중 하나입니다:\n `NOTION_ERROR_PRIVATE`, `NOTION_ERROR_NOT_FOUND`,\n `NOTION_ERROR_NETWORK`, `NOTION_ERROR_RATE_LIMIT`,\n `NOTION_ERROR_TEMPORARILY_UNAVAILABLE`,\n `NOTION_ERROR_PAGE_REJECTED`, `NOTION_ERROR_UNKNOWN`.\n- `HTML_REJECTED`: `{ reason: string }`, `too_large`, `css_rejected`, `invalid` 중 하나입니다.\n 열려 있는 값입니다. 새 값을 허용하세요.\n- `CONDITION_NOT_SUPPORTED`: `{ field: string, path: string }`, 받지 않는 조건 타입과 그 조건이\n 요청에서 있는 위치입니다. 그 위치에서 거부된 조건 형태에는 `operator: string`이,\n `requiredConditions`에서 대신 쓸 수 있는 연산자가 있으면 `invertTo: string`도 더해집니다.\n- `REFERENCE_NOT_FOUND`: `{ path: string, kind: string }`, 알 수 없는 id가 요청에서 있는 위치와\n 그 id가 가리키는 대상(`document`, `product`, `tier`, `cta`, `folder`, `broadcast`, `step`)입니다.\n 열려 있는 값입니다. 새 값을 허용하세요.\n- `TAG_NOT_FOUND`(그룹 규칙에서): `{ tag: string }`, 존재하지 않는 태그 이름입니다.\n- `GROUP_REFERENCE_NOT_FOUND`: `{ groupIds: string[] }`, 계정에 없는 그룹 id입니다.\n- `GROUP_LIMIT_REACHED`: `{ limit: integer }`, API로 계정이 만들 수 있는 그룹의 최대 개수입니다.\n","uniqueKey":"error.details","typeLabel":"object"}},"description":"오류 정보입니다. API의 모든 오류 응답에 들어 있으며 `code`, `message`, `retryable`을 담고, 일부 코드에는 `retryAfterSeconds`와 `details`도 담깁니다.","isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>","retryable":true,"retryAfterSeconds":123,"details":{}}}}},"exampleType":"generated"}},"exampleType":"generated"},"b93bf7c3-5790-44c6-983d-b461734f383e":{"description":"`PAST_DUE_RESTRICTED`, `PLAN_REQUIRED` 또는 `INSUFFICIENT_SCOPE`(키에 `documents:read` 범위가 없습니다).","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","retryable"],"properties":{"code":{"type":"string","description":"안정적인 기계 판독용 에러 코드입니다 — `message`가 아니라 이 값을 기준으로 분기하세요.","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"사람이 읽을 수 있는 상세 설명입니다. 예고 없이 문구가 바뀔 수 있습니다.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"retryable":{"type":"boolean","description":"동일한 요청을 재시도했을 때 성공할 가능성이 있는지 여부입니다.","isRequired":true,"uniqueKey":"error.retryable","typeLabel":"boolean"},"retryAfterSeconds":{"type":"integer","description":"구체적인 백오프 힌트가 있는 경우에만 존재합니다.","uniqueKey":"error.retryAfterSeconds","typeLabel":"integer"},"details":{"type":"object","description":"일부 특정 코드에만 존재합니다:\n- `PROTECTION_RULE_CONFLICT`: `{ rule: string }`, 요청을 거부한 보호 규칙입니다\n (`form`, `restricted_access`, `paid_lead_gate`, `free_lead_gate` 또는 `form_no_access_controls`).\n 열려 있는 값입니다. 새 값을 허용하세요.\n- `NEXT_POST_RULE_EXISTS`: `{ ruleId: string }`, 이미 있는 \"다음 게시물\" 규칙입니다.\n- `NOTION_FETCH_FAILED`: `{ notionErrorCode: string }`, 다음 중 하나입니다:\n `NOTION_ERROR_PRIVATE`, `NOTION_ERROR_NOT_FOUND`,\n `NOTION_ERROR_NETWORK`, `NOTION_ERROR_RATE_LIMIT`,\n `NOTION_ERROR_TEMPORARILY_UNAVAILABLE`,\n `NOTION_ERROR_PAGE_REJECTED`, `NOTION_ERROR_UNKNOWN`.\n- `HTML_REJECTED`: `{ reason: string }`, `too_large`, `css_rejected`, `invalid` 중 하나입니다.\n 열려 있는 값입니다. 새 값을 허용하세요.\n- `CONDITION_NOT_SUPPORTED`: `{ field: string, path: string }`, 받지 않는 조건 타입과 그 조건이\n 요청에서 있는 위치입니다. 그 위치에서 거부된 조건 형태에는 `operator: string`이,\n `requiredConditions`에서 대신 쓸 수 있는 연산자가 있으면 `invertTo: string`도 더해집니다.\n- `REFERENCE_NOT_FOUND`: `{ path: string, kind: string }`, 알 수 없는 id가 요청에서 있는 위치와\n 그 id가 가리키는 대상(`document`, `product`, `tier`, `cta`, `folder`, `broadcast`, `step`)입니다.\n 열려 있는 값입니다. 새 값을 허용하세요.\n- `TAG_NOT_FOUND`(그룹 규칙에서): `{ tag: string }`, 존재하지 않는 태그 이름입니다.\n- `GROUP_REFERENCE_NOT_FOUND`: `{ groupIds: string[] }`, 계정에 없는 그룹 id입니다.\n- `GROUP_LIMIT_REACHED`: `{ limit: integer }`, API로 계정이 만들 수 있는 그룹의 최대 개수입니다.\n","uniqueKey":"error.details","typeLabel":"object"}},"description":"오류 정보입니다. API의 모든 오류 응답에 들어 있으며 `code`, `message`, `retryable`을 담고, 일부 코드에는 `retryAfterSeconds`와 `details`도 담깁니다.","isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>","retryable":true,"retryAfterSeconds":123,"details":{}}}}},"exampleType":"generated"}},"exampleType":"generated"},"70868563-7fb5-4e94-87fc-5a8e9aa70205":{"description":"`DOCUMENT_NOT_FOUND`: 이 계정에 해당하는 문서가 없습니다(알 수 없는 ID, 잘못된 형식의 ID, 다른 사람의\nID는 모두 구분되지 않습니다). API를 사용할 수 없는 계정이면\n`NOT_FOUND`입니다.\n","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","retryable"],"properties":{"code":{"type":"string","description":"안정적인 기계 판독용 에러 코드입니다 — `message`가 아니라 이 값을 기준으로 분기하세요.","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"사람이 읽을 수 있는 상세 설명입니다. 예고 없이 문구가 바뀔 수 있습니다.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"retryable":{"type":"boolean","description":"동일한 요청을 재시도했을 때 성공할 가능성이 있는지 여부입니다.","isRequired":true,"uniqueKey":"error.retryable","typeLabel":"boolean"},"retryAfterSeconds":{"type":"integer","description":"구체적인 백오프 힌트가 있는 경우에만 존재합니다.","uniqueKey":"error.retryAfterSeconds","typeLabel":"integer"},"details":{"type":"object","description":"일부 특정 코드에만 존재합니다:\n- `PROTECTION_RULE_CONFLICT`: `{ rule: string }`, 요청을 거부한 보호 규칙입니다\n (`form`, `restricted_access`, `paid_lead_gate`, `free_lead_gate` 또는 `form_no_access_controls`).\n 열려 있는 값입니다. 새 값을 허용하세요.\n- `NEXT_POST_RULE_EXISTS`: `{ ruleId: string }`, 이미 있는 \"다음 게시물\" 규칙입니다.\n- `NOTION_FETCH_FAILED`: `{ notionErrorCode: string }`, 다음 중 하나입니다:\n `NOTION_ERROR_PRIVATE`, `NOTION_ERROR_NOT_FOUND`,\n `NOTION_ERROR_NETWORK`, `NOTION_ERROR_RATE_LIMIT`,\n `NOTION_ERROR_TEMPORARILY_UNAVAILABLE`,\n `NOTION_ERROR_PAGE_REJECTED`, `NOTION_ERROR_UNKNOWN`.\n- `HTML_REJECTED`: `{ reason: string }`, `too_large`, `css_rejected`, `invalid` 중 하나입니다.\n 열려 있는 값입니다. 새 값을 허용하세요.\n- `CONDITION_NOT_SUPPORTED`: `{ field: string, path: string }`, 받지 않는 조건 타입과 그 조건이\n 요청에서 있는 위치입니다. 그 위치에서 거부된 조건 형태에는 `operator: string`이,\n `requiredConditions`에서 대신 쓸 수 있는 연산자가 있으면 `invertTo: string`도 더해집니다.\n- `REFERENCE_NOT_FOUND`: `{ path: string, kind: string }`, 알 수 없는 id가 요청에서 있는 위치와\n 그 id가 가리키는 대상(`document`, `product`, `tier`, `cta`, `folder`, `broadcast`, `step`)입니다.\n 열려 있는 값입니다. 새 값을 허용하세요.\n- `TAG_NOT_FOUND`(그룹 규칙에서): `{ tag: string }`, 존재하지 않는 태그 이름입니다.\n- `GROUP_REFERENCE_NOT_FOUND`: `{ groupIds: string[] }`, 계정에 없는 그룹 id입니다.\n- `GROUP_LIMIT_REACHED`: `{ limit: integer }`, API로 계정이 만들 수 있는 그룹의 최대 개수입니다.\n","uniqueKey":"error.details","typeLabel":"object"}},"description":"오류 정보입니다. API의 모든 오류 응답에 들어 있으며 `code`, `message`, `retryable`을 담고, 일부 코드에는 `retryAfterSeconds`와 `details`도 담깁니다.","isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>","retryable":true,"retryAfterSeconds":123,"details":{}}}}},"exampleType":"generated"}},"exampleType":"generated"},"9e079a3d-bdc9-4f29-883c-86475b0370c1":{"description":"속도 제한에 걸렸습니다 (`code: RATE_LIMITED`, 항상 재시도 가능): `Retry-After` 헤더와 `X-RateLimit-*` 헤더를 참고하세요. 또는 동시에 실행 중인 요청이 너무 많습니다 (`code: TOO_MANY_CONCURRENT_REQUESTS`, 항상 재시도 가능): `Retry-After`는 `1`이고 `X-RateLimit-*` 헤더는 없습니다.","headers":{"Retry-After":{"schema":{"type":"integer"}},"X-RateLimit-Limit":{"schema":{"type":"integer"}},"X-RateLimit-Remaining":{"schema":{"type":"integer"}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"제한이 초기화되는 유닉스 타임스탬프(초)입니다."}},"content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","retryable"],"properties":{"code":{"type":"string","description":"안정적인 기계 판독용 에러 코드입니다 — `message`가 아니라 이 값을 기준으로 분기하세요.","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"사람이 읽을 수 있는 상세 설명입니다. 예고 없이 문구가 바뀔 수 있습니다.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"retryable":{"type":"boolean","description":"동일한 요청을 재시도했을 때 성공할 가능성이 있는지 여부입니다.","isRequired":true,"uniqueKey":"error.retryable","typeLabel":"boolean"},"retryAfterSeconds":{"type":"integer","description":"구체적인 백오프 힌트가 있는 경우에만 존재합니다.","uniqueKey":"error.retryAfterSeconds","typeLabel":"integer"},"details":{"type":"object","description":"일부 특정 코드에만 존재합니다:\n- `PROTECTION_RULE_CONFLICT`: `{ rule: string }`, 요청을 거부한 보호 규칙입니다\n (`form`, `restricted_access`, `paid_lead_gate`, `free_lead_gate` 또는 `form_no_access_controls`).\n 열려 있는 값입니다. 새 값을 허용하세요.\n- `NEXT_POST_RULE_EXISTS`: `{ ruleId: string }`, 이미 있는 \"다음 게시물\" 규칙입니다.\n- `NOTION_FETCH_FAILED`: `{ notionErrorCode: string }`, 다음 중 하나입니다:\n `NOTION_ERROR_PRIVATE`, `NOTION_ERROR_NOT_FOUND`,\n `NOTION_ERROR_NETWORK`, `NOTION_ERROR_RATE_LIMIT`,\n `NOTION_ERROR_TEMPORARILY_UNAVAILABLE`,\n `NOTION_ERROR_PAGE_REJECTED`, `NOTION_ERROR_UNKNOWN`.\n- `HTML_REJECTED`: `{ reason: string }`, `too_large`, `css_rejected`, `invalid` 중 하나입니다.\n 열려 있는 값입니다. 새 값을 허용하세요.\n- `CONDITION_NOT_SUPPORTED`: `{ field: string, path: string }`, 받지 않는 조건 타입과 그 조건이\n 요청에서 있는 위치입니다. 그 위치에서 거부된 조건 형태에는 `operator: string`이,\n `requiredConditions`에서 대신 쓸 수 있는 연산자가 있으면 `invertTo: string`도 더해집니다.\n- `REFERENCE_NOT_FOUND`: `{ path: string, kind: string }`, 알 수 없는 id가 요청에서 있는 위치와\n 그 id가 가리키는 대상(`document`, `product`, `tier`, `cta`, `folder`, `broadcast`, `step`)입니다.\n 열려 있는 값입니다. 새 값을 허용하세요.\n- `TAG_NOT_FOUND`(그룹 규칙에서): `{ tag: string }`, 존재하지 않는 태그 이름입니다.\n- `GROUP_REFERENCE_NOT_FOUND`: `{ groupIds: string[] }`, 계정에 없는 그룹 id입니다.\n- `GROUP_LIMIT_REACHED`: `{ limit: integer }`, API로 계정이 만들 수 있는 그룹의 최대 개수입니다.\n","uniqueKey":"error.details","typeLabel":"object"}},"description":"오류 정보입니다. API의 모든 오류 응답에 들어 있으며 `code`, `message`, `retryable`을 담고, 일부 코드에는 `retryAfterSeconds`와 `details`도 담깁니다.","isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>","retryable":true,"retryAfterSeconds":123,"details":{}}}}},"exampleType":"generated"}},"exampleType":"generated"},"593c2253-616e-4326-9087-be4023469ae9":{"description":"`INTERNAL_ERROR`: 예기치 않은 오류. 재시도 가능하며 원인은 반환되지 않습니다.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","retryable"],"properties":{"code":{"type":"string","description":"안정적인 기계 판독용 에러 코드입니다 — `message`가 아니라 이 값을 기준으로 분기하세요.","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"사람이 읽을 수 있는 상세 설명입니다. 예고 없이 문구가 바뀔 수 있습니다.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"retryable":{"type":"boolean","description":"동일한 요청을 재시도했을 때 성공할 가능성이 있는지 여부입니다.","isRequired":true,"uniqueKey":"error.retryable","typeLabel":"boolean"},"retryAfterSeconds":{"type":"integer","description":"구체적인 백오프 힌트가 있는 경우에만 존재합니다.","uniqueKey":"error.retryAfterSeconds","typeLabel":"integer"},"details":{"type":"object","description":"일부 특정 코드에만 존재합니다:\n- `PROTECTION_RULE_CONFLICT`: `{ rule: string }`, 요청을 거부한 보호 규칙입니다\n (`form`, `restricted_access`, `paid_lead_gate`, `free_lead_gate` 또는 `form_no_access_controls`).\n 열려 있는 값입니다. 새 값을 허용하세요.\n- `NEXT_POST_RULE_EXISTS`: `{ ruleId: string }`, 이미 있는 \"다음 게시물\" 규칙입니다.\n- `NOTION_FETCH_FAILED`: `{ notionErrorCode: string }`, 다음 중 하나입니다:\n `NOTION_ERROR_PRIVATE`, `NOTION_ERROR_NOT_FOUND`,\n `NOTION_ERROR_NETWORK`, `NOTION_ERROR_RATE_LIMIT`,\n `NOTION_ERROR_TEMPORARILY_UNAVAILABLE`,\n `NOTION_ERROR_PAGE_REJECTED`, `NOTION_ERROR_UNKNOWN`.\n- `HTML_REJECTED`: `{ reason: string }`, `too_large`, `css_rejected`, `invalid` 중 하나입니다.\n 열려 있는 값입니다. 새 값을 허용하세요.\n- `CONDITION_NOT_SUPPORTED`: `{ field: string, path: string }`, 받지 않는 조건 타입과 그 조건이\n 요청에서 있는 위치입니다. 그 위치에서 거부된 조건 형태에는 `operator: string`이,\n `requiredConditions`에서 대신 쓸 수 있는 연산자가 있으면 `invertTo: string`도 더해집니다.\n- `REFERENCE_NOT_FOUND`: `{ path: string, kind: string }`, 알 수 없는 id가 요청에서 있는 위치와\n 그 id가 가리키는 대상(`document`, `product`, `tier`, `cta`, `folder`, `broadcast`, `step`)입니다.\n 열려 있는 값입니다. 새 값을 허용하세요.\n- `TAG_NOT_FOUND`(그룹 규칙에서): `{ tag: string }`, 존재하지 않는 태그 이름입니다.\n- `GROUP_REFERENCE_NOT_FOUND`: `{ groupIds: string[] }`, 계정에 없는 그룹 id입니다.\n- `GROUP_LIMIT_REACHED`: `{ limit: integer }`, API로 계정이 만들 수 있는 그룹의 최대 개수입니다.\n","uniqueKey":"error.details","typeLabel":"object"}},"description":"오류 정보입니다. API의 모든 오류 응답에 들어 있으며 `code`, `message`, `retryable`을 담고, 일부 코드에는 `retryAfterSeconds`와 `details`도 담깁니다.","isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>","retryable":true,"retryAfterSeconds":123,"details":{}}}}},"exampleType":"generated"}},"exampleType":"generated"},"dbaee487-1c7a-4dc1-a48d-5dc4b74418c9":{"description":"서버 측 의존성이 일시적으로 다운되었습니다(`RATE_LIMIT_UNAVAILABLE` 또는\n`SERVICE_UNAVAILABLE`). 요청이나 키의 문제가 아니며, 항상 재시도 가능합니다 —\n`retryAfterSeconds`가 있으면 그에 따르세요. 그룹 엔드포인트(`POST /segments`,\n`POST /segments/preview`, `GET /segments/{id}`)는 매우 무거운 규칙의 인원을 약 10초\n안에 셀 수 없을 때도 이 코드를 반환합니다. 규칙을 단순하게 만들거나 다시 시도하세요.\n","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","retryable"],"properties":{"code":{"type":"string","description":"안정적인 기계 판독용 에러 코드입니다 — `message`가 아니라 이 값을 기준으로 분기하세요.","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"사람이 읽을 수 있는 상세 설명입니다. 예고 없이 문구가 바뀔 수 있습니다.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"retryable":{"type":"boolean","description":"동일한 요청을 재시도했을 때 성공할 가능성이 있는지 여부입니다.","isRequired":true,"uniqueKey":"error.retryable","typeLabel":"boolean"},"retryAfterSeconds":{"type":"integer","description":"구체적인 백오프 힌트가 있는 경우에만 존재합니다.","uniqueKey":"error.retryAfterSeconds","typeLabel":"integer"},"details":{"type":"object","description":"일부 특정 코드에만 존재합니다:\n- `PROTECTION_RULE_CONFLICT`: `{ rule: string }`, 요청을 거부한 보호 규칙입니다\n (`form`, `restricted_access`, `paid_lead_gate`, `free_lead_gate` 또는 `form_no_access_controls`).\n 열려 있는 값입니다. 새 값을 허용하세요.\n- `NEXT_POST_RULE_EXISTS`: `{ ruleId: string }`, 이미 있는 \"다음 게시물\" 규칙입니다.\n- `NOTION_FETCH_FAILED`: `{ notionErrorCode: string }`, 다음 중 하나입니다:\n `NOTION_ERROR_PRIVATE`, `NOTION_ERROR_NOT_FOUND`,\n `NOTION_ERROR_NETWORK`, `NOTION_ERROR_RATE_LIMIT`,\n `NOTION_ERROR_TEMPORARILY_UNAVAILABLE`,\n `NOTION_ERROR_PAGE_REJECTED`, `NOTION_ERROR_UNKNOWN`.\n- `HTML_REJECTED`: `{ reason: string }`, `too_large`, `css_rejected`, `invalid` 중 하나입니다.\n 열려 있는 값입니다. 새 값을 허용하세요.\n- `CONDITION_NOT_SUPPORTED`: `{ field: string, path: string }`, 받지 않는 조건 타입과 그 조건이\n 요청에서 있는 위치입니다. 그 위치에서 거부된 조건 형태에는 `operator: string`이,\n `requiredConditions`에서 대신 쓸 수 있는 연산자가 있으면 `invertTo: string`도 더해집니다.\n- `REFERENCE_NOT_FOUND`: `{ path: string, kind: string }`, 알 수 없는 id가 요청에서 있는 위치와\n 그 id가 가리키는 대상(`document`, `product`, `tier`, `cta`, `folder`, `broadcast`, `step`)입니다.\n 열려 있는 값입니다. 새 값을 허용하세요.\n- `TAG_NOT_FOUND`(그룹 규칙에서): `{ tag: string }`, 존재하지 않는 태그 이름입니다.\n- `GROUP_REFERENCE_NOT_FOUND`: `{ groupIds: string[] }`, 계정에 없는 그룹 id입니다.\n- `GROUP_LIMIT_REACHED`: `{ limit: integer }`, API로 계정이 만들 수 있는 그룹의 최대 개수입니다.\n","uniqueKey":"error.details","typeLabel":"object"}},"description":"오류 정보입니다. API의 모든 오류 응답에 들어 있으며 `code`, `message`, `retryable`을 담고, 일부 코드에는 `retryAfterSeconds`와 `details`도 담깁니다.","isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>","retryable":true,"retryAfterSeconds":123,"details":{}}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"53dbb0c6-d032-4b33-8ab5-4a3df663c240":{"apiKey":{"type":"http","scheme":"bearer","bearerFormat":"dr_live_\u003ckeyId>_\u003csecret>","description":"Settings → Developers에서 발급한 키를 `Authorization: Bearer\ndr_live_\u003c12자리 16진수>_\u003c64자리 16진수>` 형태로 전송합니다. 키는 명시적인 범위를\n가지며 — 각 엔드포인트에 필요한 범위가 해당 엔드포인트에 명시되어 있습니다. 전체 키는 발급 시점에 딱 한\n번만 표시되며 다시 조회할 수 없습니다 — 이후에는 `keyId` 접두어만 표시됩니다. 폐기된\n키는 바로 다음 요청부터 인증에 실패합니다.\n","scopes":[],"schemeName":"apiKey"}}},"servers":{"922ffeb3-bf70-4258-a4df-09fc83e1b8f2":{"url":"https://docurise.io","description":"프로덕션"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"dr_live_\u003ckeyId>_\u003csecret>","description":"Settings → Developers에서 발급한 키를 `Authorization: Bearer\ndr_live_\u003c12자리 16진수>_\u003c64자리 16진수>` 형태로 전송합니다. 키는 명시적인 범위를\n가지며 — 각 엔드포인트에 필요한 범위가 해당 엔드포인트에 명시되어 있습니다. 전체 키는 발급 시점에 딱 한\n번만 표시되며 다시 조회할 수 없습니다 — 이후에는 `keyId` 접두어만 표시됩니다. 폐기된\n키는 바로 다음 요청부터 인증에 실패합니다.\n","scopes":[],"schemeName":"apiKey"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Settings → Developers에서 발급한 키를 `Authorization: Bearer\ndr_live_\u003c12자리 16진수>_\u003c64자리 16진수>` 형태로 전송합니다. 키는 명시적인 범위를\n가지며 — 각 엔드포인트에 필요한 범위가 해당 엔드포인트에 명시되어 있습니다. 전체 키는 발급 시점에 딱 한\n번만 표시되며 다시 조회할 수 없습니다 — 이후에는 `keyId` 접두어만 표시됩니다. 폐기된\n키는 바로 다음 요청부터 인증에 실패합니다.\n","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"apiKey","name":"Authorization"}],"title":"apiKey"}]},"originalFileLocation":"api-reference/openapi.ko.yaml"},"subdomain":"docu-rise","siteName":"DocuRise Developer Docs","title":"문서 조회 - DocuRise Developer Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/api-reference/get-document","matchLevel":1},"ko":{"href":"/ko/api-reference/get-document","matchLevel":0}}},"lastModified":"2026-10-07T07:23:09.806Z","originalFileLocation":"ko/api-reference/get-document.mdx","locale":"ko"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=\"light\";if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"light\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"문서 하나를 만료 정보, 보호 방식 요약, 변경할 때 다시 보낼 revision(ETag)과 함께 조회합니다\">\u003cmeta data-mint-head name=\"application-name\" content=\"DocuRise Developer Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/docu-rise/PjNyTTc63ErGT2fG/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/docs/mintlify-assets/_mintlify/favicons/docu-rise/PjNyTTc63ErGT2fG/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/docu-rise/PjNyTTc63ErGT2fG/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/docu-rise/PjNyTTc63ErGT2fG/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/docu-rise/PjNyTTc63ErGT2fG/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/docu-rise/PjNyTTc63ErGT2fG/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/docu-rise/PjNyTTc63ErGT2fG/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/docu-rise/PjNyTTc63ErGT2fG/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/docu-rise/PjNyTTc63ErGT2fG/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"문서 조회 - DocuRise Developer Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"문서 하나를 만료 정보, 보호 방식 요약, 변경할 때 다시 보낼 revision(ETag)과 함께 조회합니다\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"DocuRise Developer Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docurise.io/docs/ko/api-reference/get-document\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://docu-rise.mintlify.app/_mintlify/api/og/v2?division=%EB%AC%B8%EC%84%9C\u0026amp;title=%EB%AC%B8%EC%84%9C+%EC%A1%B0%ED%9A%8C\u0026amp;description=%EB%AC%B8%EC%84%9C+%ED%95%98%EB%82%98%EB%A5%BC+%EB%A7%8C%EB%A3%8C+%EC%A0%95%EB%B3%B4%2C+%EB%B3%B4%ED%98%B8+%EB%B0%A9%EC%8B%9D+%EC%9A%94%EC%95%BD%2C+%EB%B3%80%EA%B2%BD%ED%95%A0+%EB%95%8C+%EB%8B%A4%EC%8B%9C+%EB%B3%B4%EB%82%BC+revision%28ETag%29%EA%B3%BC+%ED%95%A8%EA%BB%98+%EC%A1%B0%ED%9A%8C%ED%95%A9%EB%8B%88%EB%8B%A4\u0026amp;theme=53f5ca0b0069a8a509ebc847\u0026amp;signature=9b5f97fd55a36413b0a2710b91c7c2b06d59300e823e760069c3565e56e8b759\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"문서 조회 - DocuRise Developer Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"문서 하나를 만료 정보, 보호 방식 요약, 변경할 때 다시 보낼 revision(ETag)과 함께 조회합니다\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://docu-rise.mintlify.app/_mintlify/api/og/v2?division=%EB%AC%B8%EC%84%9C\u0026amp;title=%EB%AC%B8%EC%84%9C+%EC%A1%B0%ED%9A%8C\u0026amp;description=%EB%AC%B8%EC%84%9C+%ED%95%98%EB%82%98%EB%A5%BC+%EB%A7%8C%EB%A3%8C+%EC%A0%95%EB%B3%B4%2C+%EB%B3%B4%ED%98%B8+%EB%B0%A9%EC%8B%9D+%EC%9A%94%EC%95%BD%2C+%EB%B3%80%EA%B2%BD%ED%95%A0+%EB%95%8C+%EB%8B%A4%EC%8B%9C+%EB%B3%B4%EB%82%BC+revision%28ETag%29%EA%B3%BC+%ED%95%A8%EA%BB%98+%EC%A1%B0%ED%9A%8C%ED%95%A9%EB%8B%88%EB%8B%A4\u0026amp;theme=53f5ca0b0069a8a509ebc847\u0026amp;signature=9b5f97fd55a36413b0a2710b91c7c2b06d59300e823e760069c3565e56e8b759\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/docs/mintlify-assets/_mintlify/favicons/docu-rise/PjNyTTc63ErGT2fG/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"DocuRise Developer Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#DA350B\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docurise.io/docs/ko/api-reference/get-document\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/ko/api-reference/get-document.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ko\" href=\"https://docurise.io/docs/ko/api-reference/get-document\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://docurise.io/docs/api-reference/get-document\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://docurise.io/docs/api-reference/get-document\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docurise.io/#organization\",\"name\":\"DocuRise Developer Docs\",\"url\":\"https://docurise.io\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/docu-rise/ClhhLqgPXOXvt7Zz/logo.png?fit=max\u0026auto=format\u0026n=ClhhLqgPXOXvt7Zz\u0026q=85\u0026s=b73379a7630a12945d164a128a6ddb12\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docurise.io/docs#website\",\"name\":\"DocuRise Developer Docs\",\"url\":\"https://docurise.io/docs\",\"publisher\":{\"@id\":\"https://docurise.io/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docurise.io/docs/ko/api-reference/get-document#webpage\",\"url\":\"https://docurise.io/docs/ko/api-reference/get-document\",\"name\":\"문서 조회\",\"description\":\"문서 하나를 만료 정보, 보호 방식 요약, 변경할 때 다시 보낼 revision(ETag)과 함께 조회합니다\",\"dateModified\":\"2026-10-07T07:23:09.806Z\",\"isPartOf\":{\"@id\":\"https://docurise.io/docs#website\"},\"breadcrumb\":{\"@id\":\"https://docurise.io/docs/ko/api-reference/get-document#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docurise.io/docs/ko/api-reference/get-document#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"문서\",\"item\":\"https://docurise.io/docs/ko/api-reference/create-document\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"문서 조회\",\"item\":\"https://docurise.io/docs/ko/api-reference/get-document\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docurise.io/docs/ko/api-reference/get-document#apireference\",\"headline\":\"문서 조회\",\"name\":\"문서 조회\",\"description\":\"문서 하나를 만료 정보, 보호 방식 요약, 변경할 때 다시 보낼 revision(ETag)과 함께 조회합니다\",\"url\":\"https://docurise.io/docs/ko/api-reference/get-document\",\"mainEntityOfPage\":{\"@id\":\"https://docurise.io/docs/ko/api-reference/get-document#webpage\"},\"dateModified\":\"2026-10-07T07:23:09.806Z\",\"publisher\":{\"@id\":\"https://docurise.io/#organization\"},\"isPartOf\":{\"@id\":\"https://docurise.io/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"DocuRise Developer Docs\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"DocuRise Developer Docs","nav":{"global":null,"languages":[{"language":"en","pages":[{"title":"en","href":"/api-reference/get-document"}]},{"language":"ko","tabs":[{"tab":"가이드","icon":"book-open","pages":[{"title":"가이드","href":"/ko"}]},{"tab":"API Reference","icon":"code","groups":[{"group":"문서","pages":[{"title":"문서 생성","openapi":"api-reference/openapi.ko.yaml POST /api/preview/documents","href":"/ko/api-reference/create-document"},{"title":"문서 목록","description":"내가 소유한 문서를 필터와 커서 페이지네이션으로 조회합니다","openapi":"api-reference/openapi.ko.yaml GET /api/preview/documents","href":"/ko/api-reference/list-documents"},{"title":"문서 조회","openapi":"api-reference/openapi.ko.yaml GET /api/preview/documents/{id}","href":"/ko/api-reference/get-document"},{"title":"문서 수정","description":"초안 포스트나 폼을 게시하고, 문서를 일시정지하거나 다시 켜고, 만료일과 이메일 보호 설정을 변경합니다. GET이 반환하는 `revision` 또는 `ETag`를 그대로 복사해 요청 본문에 보내는 문서 revision으로 보호됩니다","openapi":"api-reference/openapi.ko.yaml PATCH /api/preview/documents/{id}","href":"/ko/api-reference/update-document"},{"title":"문서 분석 조회","openapi":"api-reference/openapi.ko.yaml GET /api/preview/documents/{id}/analytics","href":"/ko/api-reference/get-document-analytics"},{"title":"문서 채널별 분석 조회","openapi":"api-reference/openapi.ko.yaml GET /api/preview/documents/{id}/analytics/channels","href":"/ko/api-reference/get-document-analytics-channels"},{"title":"폼 퍼널 조회","openapi":"api-reference/openapi.ko.yaml GET /api/preview/documents/{id}/analytics/funnel","href":"/ko/api-reference/get-form-funnel"},{"title":"인기 문서 순위 조회","openapi":"api-reference/openapi.ko.yaml GET /api/preview/analytics/documents","href":"/ko/api-reference/list-top-documents"}]},{"group":"폴더","pages":[{"title":"폴더 및 강의 목록 조회","openapi":"api-reference/openapi.ko.yaml GET /api/preview/folders","href":"/ko/api-reference/list-folders"}]},{"group":"상품","pages":[{"title":"상품 목록 조회","openapi":"api-reference/openapi.ko.yaml GET /api/preview/products","href":"/ko/api-reference/list-products"}]},{"group":"오디언스","pages":[{"title":"태그 목록 조회","openapi":"api-reference/openapi.ko.yaml GET /api/preview/tags","href":"/ko/api-reference/list-tags"},{"title":"태그 만들기","openapi":"api-reference/openapi.ko.yaml POST /api/preview/tags","href":"/ko/api-reference/create-tag"},{"title":"그룹 목록 조회","openapi":"api-reference/openapi.ko.yaml GET /api/preview/segments","href":"/ko/api-reference/list-segments"},{"title":"그룹 만들기","openapi":"api-reference/openapi.ko.yaml POST /api/preview/segments","href":"/ko/api-reference/create-segment"},{"title":"그룹 규칙 미리보기","openapi":"api-reference/openapi.ko.yaml POST /api/preview/segments/preview","href":"/ko/api-reference/preview-segment"},{"title":"그룹 조회","openapi":"api-reference/openapi.ko.yaml GET /api/preview/segments/{id}","href":"/ko/api-reference/get-segment"},{"title":"그룹 조건","href":"/ko/api-reference/group-conditions"}]},{"group":"연락처","pages":[{"title":"연락처에 태그 추가","openapi":"api-reference/openapi.ko.yaml PUT /api/preview/contacts/{contactId}/tags/{tagName}","href":"/ko/api-reference/add-contact-tag"},{"title":"연락처에서 태그 제거","openapi":"api-reference/openapi.ko.yaml DELETE /api/preview/contacts/{contactId}/tags/{tagName}","href":"/ko/api-reference/remove-contact-tag"}]},{"group":"이메일","pages":[{"title":"이메일 1회성 발송 목록 조회","openapi":"api-reference/openapi.ko.yaml GET /api/preview/email/broadcasts","href":"/ko/api-reference/list-email-broadcasts"},{"title":"1회성 발송 인사이트 조회","openapi":"api-reference/openapi.ko.yaml GET /api/preview/email/broadcasts/{id}/insights","href":"/ko/api-reference/get-broadcast-insights"},{"title":"자동화 목록 조회","openapi":"api-reference/openapi.ko.yaml GET /api/preview/automations","href":"/ko/api-reference/list-automations"}]},{"group":"Instagram","pages":[{"title":"Instagram 규칙 생성","openapi":"api-reference/openapi.ko.yaml POST /api/preview/instagram/rules","href":"/ko/api-reference/create-instagram-rule"},{"title":"Instagram 규칙 목록","openapi":"api-reference/openapi.ko.yaml GET /api/preview/instagram/rules","href":"/ko/api-reference/list-instagram-rules"},{"title":"Instagram 규칙 조회","openapi":"api-reference/openapi.ko.yaml GET /api/preview/instagram/rules/{id}","href":"/ko/api-reference/get-instagram-rule"},{"title":"Instagram 규칙 수정","openapi":"api-reference/openapi.ko.yaml PATCH /api/preview/instagram/rules/{id}","href":"/ko/api-reference/update-instagram-rule"}]},{"group":"계정","pages":[{"title":"호출 중인 키 확인","openapi":"api-reference/openapi.ko.yaml GET /api/preview/whoami","href":"/ko/api-reference/whoami"}]}]}]}]},"title":"문서 조회 - DocuRise Developer Docs","buildId":"dpl_3DJU2xKhT5gDPFQL5Tqv7AFnkWsF","deploymentId":"dpl_3DJU2xKhT5gDPFQL5Tqv7AFnkWsF","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-DsGgv5pK.js","utils-B0h6ZXi-.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-IgrnFwPw.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-C49-TBER.js","snippetPresets-BPHn-9OB.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-CGBwAHwX.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BjABHCCH.js","shallow-C0Uj5sOI.js","getApiPlaygroundDisplay-BnYiIeY4.js","CodeSnippet-BJWWrlBw.js","CodeSnippets-bxE5aDye.js","Page-BBU7roUf.js","getPastedJson-BAjriezQ.js","icon-BqcS52QC.js","MethodPill-BPGyN9me.js","DuplicateIcon-CCf2giLL.js","createIcon-CVH8aNt2.js","DynamicMarkdown-BklwmxA6.js","SectionHeading-DYCZQFxh.js","axios-vUo_bRtp.js","Markdown-D26rHnOC.js","clsx-DkiOUx4h.js","lib--scc4DXi.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-DI8jfVGc.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-DwJy-csb.js"]}