Settings → Developers에서 발급한 키를 Authorization: Bearer dr_live_<12자리 16진수>_<64자리 16진수> 형태로 전송합니다. 키는 명시적인 범위를
가지며 — 각 엔드포인트에 필요한 범위가 해당 엔드포인트에 명시되어 있습니다. 전체 키는 발급 시점에 딱 한
번만 표시되며 다시 조회할 수 없습니다 — 이후에는 keyId 접두어만 표시됩니다. 폐기된
키는 바로 다음 요청부터 인증에 실패합니다.
저장된 규칙을 저장된 그대로 나타내며, GET /api/preview/segments/{id}가 반환하는
값입니다. 보낼 수 있는 규칙인 GroupFilter와 달리 목록 길이에 제한이 없고, 조건은
모든 타입일 수 있습니다(StoredGroupCondition). 저장된 그룹은 API의 규칙을 따르지 않기 때문입니다. 규칙 없이 저장된 그룹은 {}로
반환됩니다.
{"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-segment","slug":"/ko/api-reference/get-segment","pageMetadata":{"title":"그룹 조회","description":"그룹 하나를 규칙과 실시간 멤버 수와 함께 조회합니다","openapi":"api-reference/openapi.ko.yaml GET /api/preview/segments/{id}","href":"/ko/api-reference/get-segment"},"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: \"그룹 하나를 규칙과 실시간 멤버 수와 함께 조회합니다\"\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":"그룹 하나를 규칙과 실시간 멤버 수와 함께 조회합니다","openapi":"api-reference/openapi.ko.yaml GET /api/preview/segments/{id}","href":"/ko/api-reference/get-segment"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"getSegment","tags":["Audiences"],"summary":"그룹 조회","description":"그룹 하나를 규칙과 실시간 멤버 수와 함께 조회합니다","security":["9a7e35b3-8344-4657-81a1-44046dee0dc9"],"responses":{"200":"81f040ca-d4f8-4827-a7a1-075661550a67","401":"525c8411-732b-412c-95f1-8125da215890","403":"1991f477-42ad-496b-9cd4-2036815f6ba9","404":"6370c6ac-7a0b-45e2-bee0-7f23ad779ac0","429":"2a629d92-deb7-4f46-83e3-51a9f3d0934a","500":"bcc16294-b290-49ba-9494-367d371be6a2","503":"d3ce87ca-bca8-4140-9b6a-a26e8ae0d1e8"},"x-codeSamples":[{"lang":"bash","label":"curl","source":"curl 'https://docurise.io/api/preview/segments/3d2b8a64-5e0f-4c71-b9a2-1f7e6c4d8a05' \\\n -H 'Authorization: Bearer dr_live_\u003ckeyId>_\u003csecret>'\n"}],"method":"get","type":"path","servers":["922ffeb3-bf70-4258-a4df-09fc83e1b8f2"],"path":"/api/preview/segments/{id}","baseUrlOptions":["https://docurise.io"],"title":"그룹 조회","codeSamples":[{"label":"curl","lang":"bash","source":"curl 'https://docurise.io/api/preview/segments/3d2b8a64-5e0f-4c71-b9a2-1f7e6c4d8a05' \\\n -H 'Authorization: Bearer dr_live_\u003ckeyId>_\u003csecret>'\n"}],"requiredOnlyExamples":false,"requestExampleType":"codeSamples","responseExampleType":"generated"},"dependencies":{"parameters":{"9f039d45-2c1e-4a37-b51b-aee607a410c6":{"name":"id","in":"path","required":true,"description":"그룹 id. `GET /api/preview/segments`나 `POST /api/preview/segments`의 응답에서 얻습니다.","schema":{"type":"string","format":"uuid","isRequired":true,"description":"그룹 id. `GET /api/preview/segments`나 `POST /api/preview/segments`의 응답에서 얻습니다.","uniqueKey":"","typeLabel":"string\u003cuuid>"}}},"responses":{"81f040ca-d4f8-4827-a7a1-075661550a67":{"description":"그룹.","content":{"application/json":{"schema":{"type":"object","required":["id","name","filter","memberCount","createdAt"],"description":"규칙과 실시간 멤버 수를 가진 그룹. 멤버 정보는 절대 반환하지 않습니다.","properties":{"id":{"type":"string","format":"uuid","description":"그룹 id.","isRequired":true,"uniqueKey":"id","typeLabel":"string\u003cuuid>"},"name":{"type":"string","description":"그룹 이름.","isRequired":true,"uniqueKey":"name","typeLabel":"string"},"filter":{"type":"object","additionalProperties":true,"description":"저장된 규칙을 저장된 그대로 나타내며, `GET /api/preview/segments/{id}`가 반환하는\n값입니다. 보낼 수 있는 규칙인 `GroupFilter`와 달리 목록 길이에 제한이 없고, 조건은\n모든 타입일 수 있습니다(`StoredGroupCondition`). 저장된 그룹은 API의 규칙을 따르지 않기 때문입니다. 규칙 없이 저장된 그룹은 `{}`로\n반환됩니다.\n","properties":{"operator":{"type":"string","enum":["AND","OR"],"description":"`conditions`의 조건을 연결하는 방식. `AND`(모두 해당) 또는 `OR`(하나라도 해당).","uniqueKey":"filter.operator","typeLabel":"enum\u003cstring>"},"conditions":{"type":"array","items":{"type":"object","required":["field"],"additionalProperties":true,"description":"저장된 규칙의 조건 하나를 저장된 그대로 나타냅니다. 보낼 수 있는 조건인\n`GroupCondition`과 달리 `field`는 모든 조건 타입일 수 있으며, API가\n만들 수 없는 `custom_field`도 포함됩니다. 각 타입의 키는\n[그룹 조건](/ko/api-reference/group-conditions)에 있습니다.\n","properties":{"field":{"type":"string","description":"조건 타입. 그룹 조건 문서의 20가지 타입 중 하나이거나 `custom_field`입니다.","isRequired":true,"uniqueKey":"filter.conditions.items.[INDEX].field","typeLabel":"string"}},"example":{"field":"custom_field","questionId":"q9f2k1x7ab","operator":"exists"},"uniqueKey":"filter.conditions.items.[INDEX]","typeLabel":"object"},"description":"기본 조건 목록.","uniqueKey":"filter.conditions","typeLabel":"object[]"},"requiredConditions":{"type":"array","items":{"type":"object","required":["field"],"additionalProperties":true,"description":"저장된 규칙의 조건 하나를 저장된 그대로 나타냅니다. 보낼 수 있는 조건인\n`GroupCondition`과 달리 `field`는 모든 조건 타입일 수 있으며, API가\n만들 수 없는 `custom_field`도 포함됩니다. 각 타입의 키는\n[그룹 조건](/ko/api-reference/group-conditions)에 있습니다.\n","properties":{"field":{"type":"string","description":"조건 타입. 그룹 조건 문서의 20가지 타입 중 하나이거나 `custom_field`입니다.","isRequired":true,"uniqueKey":"filter.requiredConditions.items.[INDEX].field","typeLabel":"string"}},"example":{"field":"custom_field","questionId":"q9f2k1x7ab","operator":"exists"},"uniqueKey":"filter.requiredConditions.items.[INDEX]","typeLabel":"object"},"description":"모든 멤버가 추가로 만족해야 하는 조건.","uniqueKey":"filter.requiredConditions","typeLabel":"object[]"},"excludeConditions":{"type":"array","items":{"type":"object","required":["field"],"additionalProperties":true,"description":"저장된 규칙의 조건 하나를 저장된 그대로 나타냅니다. 보낼 수 있는 조건인\n`GroupCondition`과 달리 `field`는 모든 조건 타입일 수 있으며, API가\n만들 수 없는 `custom_field`도 포함됩니다. 각 타입의 키는\n[그룹 조건](/ko/api-reference/group-conditions)에 있습니다.\n","properties":{"field":{"type":"string","description":"조건 타입. 그룹 조건 문서의 20가지 타입 중 하나이거나 `custom_field`입니다.","isRequired":true,"uniqueKey":"filter.excludeConditions.items.[INDEX].field","typeLabel":"string"}},"example":{"field":"custom_field","questionId":"q9f2k1x7ab","operator":"exists"},"uniqueKey":"filter.excludeConditions.items.[INDEX]","typeLabel":"object"},"description":"연락처를 제외하는 조건.","uniqueKey":"filter.excludeConditions","typeLabel":"object[]"}},"isRequired":true,"uniqueKey":"filter","typeLabel":"object"},"memberCount":{"type":"integer","minimum":0,"description":"지금 그룹에 속한 연락처의 실시간 수(수신 거부 연락처 제외). 수치만 제공하며 연락처 자체는 반환하지 않습니다.","isRequired":true,"uniqueKey":"memberCount","typeLabel":"integer"},"createdAt":{"type":"string","format":"date-time","description":"그룹을 만든 시각. UTC 기준 RFC 3339.","isRequired":true,"uniqueKey":"createdAt","typeLabel":"string\u003cdate-time>"}},"uniqueKey":"","typeLabel":"object"},"example":{"id":"3d2b8a64-5e0f-4c71-b9a2-1f7e6c4d8a05","name":"뉴스레터 독자 중 최근 활동한 사람","filter":{"operator":"AND","conditions":[{"field":"tag","operator":"has","value":"newsletter"}],"requiredConditions":[{"field":"consent","operator":"active"}],"excludeConditions":[{"field":"last_active","operator":"inactive_for_days","value":90}]},"memberCount":124,"createdAt":"2026-10-22T03:14:15.926Z"},"examples":{"Example":{"title":"Example","value":{"id":"3d2b8a64-5e0f-4c71-b9a2-1f7e6c4d8a05","name":"뉴스레터 독자 중 최근 활동한 사람","filter":{"operator":"AND","conditions":[{"field":"tag","operator":"has","value":"newsletter"}],"requiredConditions":[{"field":"consent","operator":"active"}],"excludeConditions":[{"field":"last_active","operator":"inactive_for_days","value":90}]},"memberCount":124,"createdAt":"2026-10-22T03:14:15.926Z"}}},"exampleType":"examples"}},"exampleType":"examples"},"525c8411-732b-412c-95f1-8125da215890":{"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"},"1991f477-42ad-496b-9cd4-2036815f6ba9":{"description":"`PAST_DUE_RESTRICTED`, `PLAN_REQUIRED` 또는 `INSUFFICIENT_SCOPE`(키에 `automations: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"},"6370c6ac-7a0b-45e2-bee0-7f23ad779ac0":{"description":"`GROUP_NOT_FOUND`: 이 계정에 해당 그룹이 없습니다(알 수 없거나, 형식이 잘못되었거나,\n다른 사람의 id는 모두 구분되지 않습니다). API를 사용할 수 없는 계정이면 `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"},"2a629d92-deb7-4f46-83e3-51a9f3d0934a":{"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"},"bcc16294-b290-49ba-9494-367d371be6a2":{"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"},"d3ce87ca-bca8-4140-9b6a-a26e8ae0d1e8":{"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":{"9a7e35b3-8344-4657-81a1-44046dee0dc9":{"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-segment","matchLevel":1},"ko":{"href":"/ko/api-reference/get-segment","matchLevel":0}}},"lastModified":"2026-10-26T16:11:33.620Z","originalFileLocation":"ko/api-reference/get-segment.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=\"그룹 하나를 규칙과 실시간 멤버 수와 함께 조회합니다\">\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=\"그룹 하나를 규칙과 실시간 멤버 수와 함께 조회합니다\">\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-segment\">\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=%EC%98%A4%EB%94%94%EC%96%B8%EC%8A%A4\u0026amp;title=%EA%B7%B8%EB%A3%B9+%EC%A1%B0%ED%9A%8C\u0026amp;description=%EA%B7%B8%EB%A3%B9+%ED%95%98%EB%82%98%EB%A5%BC+%EA%B7%9C%EC%B9%99%EA%B3%BC+%EC%8B%A4%EC%8B%9C%EA%B0%84+%EB%A9%A4%EB%B2%84+%EC%88%98%EC%99%80+%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=dbcc4d81219b65e3d92213ffded6ea9d1b5192e24b51d0d0f2bc8286869500bf\">\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=\"그룹 하나를 규칙과 실시간 멤버 수와 함께 조회합니다\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://docu-rise.mintlify.app/_mintlify/api/og/v2?division=%EC%98%A4%EB%94%94%EC%96%B8%EC%8A%A4\u0026amp;title=%EA%B7%B8%EB%A3%B9+%EC%A1%B0%ED%9A%8C\u0026amp;description=%EA%B7%B8%EB%A3%B9+%ED%95%98%EB%82%98%EB%A5%BC+%EA%B7%9C%EC%B9%99%EA%B3%BC+%EC%8B%A4%EC%8B%9C%EA%B0%84+%EB%A9%A4%EB%B2%84+%EC%88%98%EC%99%80+%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=dbcc4d81219b65e3d92213ffded6ea9d1b5192e24b51d0d0f2bc8286869500bf\">\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-segment\">\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-segment.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ko\" href=\"https://docurise.io/docs/ko/api-reference/get-segment\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://docurise.io/docs/api-reference/get-segment\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://docurise.io/docs/api-reference/get-segment\">\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-segment#webpage\",\"url\":\"https://docurise.io/docs/ko/api-reference/get-segment\",\"name\":\"그룹 조회\",\"description\":\"그룹 하나를 규칙과 실시간 멤버 수와 함께 조회합니다\",\"dateModified\":\"2026-10-26T16:11:33.620Z\",\"isPartOf\":{\"@id\":\"https://docurise.io/docs#website\"},\"breadcrumb\":{\"@id\":\"https://docurise.io/docs/ko/api-reference/get-segment#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docurise.io/docs/ko/api-reference/get-segment#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"오디언스\",\"item\":\"https://docurise.io/docs/ko/api-reference/list-tags\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"그룹 조회\",\"item\":\"https://docurise.io/docs/ko/api-reference/get-segment\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docurise.io/docs/ko/api-reference/get-segment#apireference\",\"headline\":\"그룹 조회\",\"name\":\"그룹 조회\",\"description\":\"그룹 하나를 규칙과 실시간 멤버 수와 함께 조회합니다\",\"url\":\"https://docurise.io/docs/ko/api-reference/get-segment\",\"mainEntityOfPage\":{\"@id\":\"https://docurise.io/docs/ko/api-reference/get-segment#webpage\"},\"dateModified\":\"2026-10-26T16:11:33.620Z\",\"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-segment"}]},{"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":"문서 목록","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":"문서 수정","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":"그룹 규칙 미리보기","description":"아무것도 저장하지 않고 규칙에 맞는 연락처 수를 셉니다","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":"그룹 조건","description":"그룹 규칙에 쓸 수 있는 모든 조건: 무엇과 일치하는지, 키와 값, 필요한 id를 어디서 찾는지","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"]}