Settings → Developers에서 발급한 키를 Authorization: Bearer dr_live_<12자리 16진수>_<64자리 16진수> 형태로 전송합니다. 키는 명시적인 범위를
가지며 — 각 엔드포인트에 필요한 범위가 해당 엔드포인트에 명시되어 있습니다. 전체 키는 발급 시점에 딱 한
번만 표시되며 다시 조회할 수 없습니다 — 이후에는 keyId 접두어만 표시됩니다. 폐기된
키는 바로 다음 요청부터 인증에 실패합니다.
누가 그룹에 속하는지 정하는 규칙입니다. 연락처는 conditions에 해당하고
(operator로 연결), requiredConditions의 모든 조건에 해당하며,
excludeConditions의 어느 것에도 해당하지 않을 때 그룹에 속합니다. 각 목록에는
조건을 최대 20개까지 넣을 수 있고, 세 목록을 통틀어 조건이 하나 이상 있어야 합니다
(없으면 422 EMPTY_FILTER). 수신 거부 연락처는 멤버가 되지 않습니다.
그룹 조건을 참고하세요.
저장된 규칙을 저장된 그대로 나타내며, 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/create-segment","slug":"/ko/api-reference/create-segment","pageMetadata":{"title":"그룹 만들기","description":"규칙으로 그룹 하나를 만듭니다. Idempotency-Key로 재시도가 안전합니다","openapi":"api-reference/openapi.ko.yaml POST /api/preview/segments","href":"/ko/api-reference/create-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: \"규칙으로 그룹 하나를 만듭니다. Idempotency-Key로 재시도가 안전합니다\"\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":"규칙으로 그룹 하나를 만듭니다. Idempotency-Key로 재시도가 안전합니다","openapi":"api-reference/openapi.ko.yaml POST /api/preview/segments","href":"/ko/api-reference/create-segment"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"createSegment","tags":["Audiences"],"summary":"그룹 만들기","description":"규칙으로 그룹 하나를 만듭니다. Idempotency-Key로 재시도가 안전합니다","security":["b22edfca-aaff-43fd-8d68-8b14d0a240ca"],"parameters":["c6a5e590-c40b-4e98-8157-6668d482662e"],"requestBody":"dffeb8a0-cbbf-438a-bbd4-b04bc2426662","responses":{"201":"7549a7b1-b734-42ea-842e-3fb89a9fc322","400":"d2db613a-6467-40b9-82d2-616486cdbe8c","401":"a08c8dc7-5a15-45a7-a4a7-2ad6239f952d","403":"54924e96-f991-4dbd-bab7-fa1bc3c0c4a7","404":"293b9820-12c2-463c-9cb5-dee7d2d1ae83","409":"14154ff1-0b02-4227-98db-c82054dfc54e","422":"8718d36c-dea5-44ae-a8be-76ef4ffd9d02","429":"c9a15021-bad9-4955-990b-31c887433097","500":"21eec7ed-264e-4447-b979-b51ea9fbde58","503":"aeb8a518-bc54-4142-ba37-a7f7d7961f99"},"x-codeSamples":[{"lang":"bash","label":"curl","source":"curl -X POST 'https://docurise.io/api/preview/segments' \\\n -H 'Authorization: Bearer dr_live_\u003ckeyId>_\u003csecret>' \\\n -H 'Idempotency-Key: 550e8400-e29b-41d4-a716-446655440000' \\\n -H 'Content-Type: application/json' \\\n -d '{\n \"name\": \"뉴스레터 독자 중 최근 활동한 사람\",\n \"filter\": {\n \"operator\": \"AND\",\n \"conditions\": [{ \"field\": \"tag\", \"operator\": \"has\", \"value\": \"newsletter\" }],\n \"requiredConditions\": [{ \"field\": \"consent\", \"operator\": \"active\" }],\n \"excludeConditions\": [{ \"field\": \"last_active\", \"operator\": \"inactive_for_days\", \"value\": 90 }]\n }\n }'\n"}],"method":"post","type":"path","servers":["922ffeb3-bf70-4258-a4df-09fc83e1b8f2"],"path":"/api/preview/segments","baseUrlOptions":["https://docurise.io"],"title":"그룹 만들기","codeSamples":[{"label":"curl","lang":"bash","source":"curl -X POST 'https://docurise.io/api/preview/segments' \\\n -H 'Authorization: Bearer dr_live_\u003ckeyId>_\u003csecret>' \\\n -H 'Idempotency-Key: 550e8400-e29b-41d4-a716-446655440000' \\\n -H 'Content-Type: application/json' \\\n -d '{\n \"name\": \"뉴스레터 독자 중 최근 활동한 사람\",\n \"filter\": {\n \"operator\": \"AND\",\n \"conditions\": [{ \"field\": \"tag\", \"operator\": \"has\", \"value\": \"newsletter\" }],\n \"requiredConditions\": [{ \"field\": \"consent\", \"operator\": \"active\" }],\n \"excludeConditions\": [{ \"field\": \"last_active\", \"operator\": \"inactive_for_days\", \"value\": 90 }]\n }\n }'\n"}],"requiredOnlyExamples":false,"requestExampleType":"codeSamples","responseExampleType":"generated"},"dependencies":{"parameters":{"c6a5e590-c40b-4e98-8157-6668d482662e":{"name":"Idempotency-Key","in":"header","required":true,"description":"이 생성 시도를 식별하는 클라이언트 생성 고유 문자열(255자 이하)입니다. 위의 \"멱등성\" 항목을 참고하세요.","schema":{"type":"string","maxLength":255,"isRequired":true,"description":"이 생성 시도를 식별하는 클라이언트 생성 고유 문자열(255자 이하)입니다. 위의 \"멱등성\" 항목을 참고하세요.","uniqueKey":"","typeLabel":"string"},"example":"550e8400-e29b-41d4-a716-446655440000"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["name","filter"],"additionalProperties":false,"properties":{"name":{"type":"string","minLength":1,"maxLength":100,"description":"그룹 이름. 앞뒤 공백을 제거하고 유니코드 정규화(NFC)한 뒤 1~100자여야 하며 NUL 문자를 포함할 수 없습니다. 이름은 고유하지 않아도 됩니다.","example":"뉴스레터 독자 중 최근 활동한 사람","isRequired":true,"uniqueKey":"name","typeLabel":"string"},"filter":{"type":"object","required":["operator","conditions"],"additionalProperties":false,"description":"누가 그룹에 속하는지 정하는 규칙입니다. 연락처는 `conditions`에 해당하고\n(`operator`로 연결), `requiredConditions`의 모든 조건에 해당하며,\n`excludeConditions`의 어느 것에도 해당하지 않을 때 그룹에 속합니다. 각 목록에는\n조건을 최대 20개까지 넣을 수 있고, 세 목록을 통틀어 조건이 하나 이상 있어야 합니다\n(없으면 `422 EMPTY_FILTER`). 수신 거부 연락처는 멤버가 되지 않습니다.\n[그룹 조건](/ko/api-reference/group-conditions)을 참고하세요.\n","properties":{"operator":{"type":"string","enum":["AND","OR"],"description":"`conditions`의 조건을 연결하는 방식. `AND`(모두 해당) 또는 `OR`(하나라도 해당).","isRequired":true,"uniqueKey":"filter.operator","typeLabel":"enum\u003cstring>"},"conditions":{"type":"array","maxItems":20,"items":{"type":"object","required":["field"],"additionalProperties":true,"description":"규칙의 조건 하나입니다. 조건 타입을 나타내는 필수 `field`와 그 타입이 받는 키(예:\n`operator`, `value`)로 이루어진 객체입니다. 20가지 타입, 각 타입의 키와 허용 값, 필요한\nid를 찾는 방법은 [그룹 조건](/ko/api-reference/group-conditions)에 있습니다. 두 곳의\n내용이 어긋나지 않도록 이 스키마에는 `field`만 적었습니다. 서버는 모든 조건을\n엄격하게 검사합니다. 알 수 없는 키, 잘못된 값, 타입이 허용하지 않는 키 조합은 경로가\n표시된 `400 VALIDATION_ERROR`입니다. `custom_field` 조건은\n`422 CONDITION_NOT_SUPPORTED`로 거부되며, 들어 있는 목록에서 일부 연락처에 잘못된 답을\n내는 일부 조건 형태(그룹 조건 문서 참고)도 마찬가지입니다.\n","properties":{"field":{"type":"string","enum":["tag","document_view","consent","cta_click","email_open","email_link_click","has_phone","form_submission","payment_status","first_seen","last_active","group_membership","tier_access","days_since_purchase","repeat_bounce","course_last_access","kakao_reachable","course_progress","location","checkout_abandoned"],"description":"조건 타입.","isRequired":true,"uniqueKey":"filter.conditions.items.[INDEX].field","typeLabel":"enum\u003cstring>"}},"example":{"field":"tag","operator":"has","value":"newsletter"},"uniqueKey":"filter.conditions.items.[INDEX]","typeLabel":"object"},"description":"기본 조건 목록. `requiredConditions`나 `excludeConditions`에 조건이 있으면 비어 있어도 됩니다.","isRequired":true,"uniqueKey":"filter.conditions","typeLabel":"object[]"},"requiredConditions":{"type":"array","maxItems":20,"items":{"type":"object","required":["field"],"additionalProperties":true,"description":"규칙의 조건 하나입니다. 조건 타입을 나타내는 필수 `field`와 그 타입이 받는 키(예:\n`operator`, `value`)로 이루어진 객체입니다. 20가지 타입, 각 타입의 키와 허용 값, 필요한\nid를 찾는 방법은 [그룹 조건](/ko/api-reference/group-conditions)에 있습니다. 두 곳의\n내용이 어긋나지 않도록 이 스키마에는 `field`만 적었습니다. 서버는 모든 조건을\n엄격하게 검사합니다. 알 수 없는 키, 잘못된 값, 타입이 허용하지 않는 키 조합은 경로가\n표시된 `400 VALIDATION_ERROR`입니다. `custom_field` 조건은\n`422 CONDITION_NOT_SUPPORTED`로 거부되며, 들어 있는 목록에서 일부 연락처에 잘못된 답을\n내는 일부 조건 형태(그룹 조건 문서 참고)도 마찬가지입니다.\n","properties":{"field":{"type":"string","enum":["tag","document_view","consent","cta_click","email_open","email_link_click","has_phone","form_submission","payment_status","first_seen","last_active","group_membership","tier_access","days_since_purchase","repeat_bounce","course_last_access","kakao_reachable","course_progress","location","checkout_abandoned"],"description":"조건 타입.","isRequired":true,"uniqueKey":"filter.requiredConditions.items.[INDEX].field","typeLabel":"enum\u003cstring>"}},"example":{"field":"tag","operator":"has","value":"newsletter"},"uniqueKey":"filter.requiredConditions.items.[INDEX]","typeLabel":"object"},"description":"모든 멤버가 추가로 만족해야 하는 조건. `operator`와 상관없이 항상 AND로 적용됩니다.","uniqueKey":"filter.requiredConditions","typeLabel":"object[]"},"excludeConditions":{"type":"array","maxItems":20,"items":{"type":"object","required":["field"],"additionalProperties":true,"description":"규칙의 조건 하나입니다. 조건 타입을 나타내는 필수 `field`와 그 타입이 받는 키(예:\n`operator`, `value`)로 이루어진 객체입니다. 20가지 타입, 각 타입의 키와 허용 값, 필요한\nid를 찾는 방법은 [그룹 조건](/ko/api-reference/group-conditions)에 있습니다. 두 곳의\n내용이 어긋나지 않도록 이 스키마에는 `field`만 적었습니다. 서버는 모든 조건을\n엄격하게 검사합니다. 알 수 없는 키, 잘못된 값, 타입이 허용하지 않는 키 조합은 경로가\n표시된 `400 VALIDATION_ERROR`입니다. `custom_field` 조건은\n`422 CONDITION_NOT_SUPPORTED`로 거부되며, 들어 있는 목록에서 일부 연락처에 잘못된 답을\n내는 일부 조건 형태(그룹 조건 문서 참고)도 마찬가지입니다.\n","properties":{"field":{"type":"string","enum":["tag","document_view","consent","cta_click","email_open","email_link_click","has_phone","form_submission","payment_status","first_seen","last_active","group_membership","tier_access","days_since_purchase","repeat_bounce","course_last_access","kakao_reachable","course_progress","location","checkout_abandoned"],"description":"조건 타입.","isRequired":true,"uniqueKey":"filter.excludeConditions.items.[INDEX].field","typeLabel":"enum\u003cstring>"}},"example":{"field":"tag","operator":"has","value":"newsletter"},"uniqueKey":"filter.excludeConditions.items.[INDEX]","typeLabel":"object"},"description":"연락처를 제외하는 조건. 하나라도 해당하는 연락처는 빠집니다. 일부 조건 형태는 여기서 거부됩니다(`422 CONDITION_NOT_SUPPORTED`). [그룹 조건](/ko/api-reference/group-conditions)을 참고하세요.","uniqueKey":"filter.excludeConditions","typeLabel":"object[]"}},"isRequired":true,"uniqueKey":"filter","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"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}]}},"examples":{"Example":{"title":"Example","value":{"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}]}}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"7549a7b1-b734-42ea-842e-3fb89a9fc322":{"description":"그룹을 만들었습니다. `memberCount`는 생성 시점의 실시간 수입니다.","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"},"d2db613a-6467-40b9-82d2-616486cdbe8c":{"description":"`INVALID_JSON`(본문이 JSON이 아님), `IDEMPOTENCY_KEY_REQUIRED`,\n`IDEMPOTENCY_KEY_TOO_LONG` 또는 `VALIDATION_ERROR`(`name`이나 `filter`가 잘못됨.\n`message`는 잘못된 부분의 경로로 시작하며, 예를 들어 `name:`이나\n`filter.conditions.2.value:`입니다. 원인에는 `name`이 없거나 비어 있음, 이름이\n100자 초과, NUL 문자, 본문·규칙·조건의 알 수 없는 키, 잘못된 값이나 타입, 조건이\n20개를 넘는 목록, UUID가 아닌 id, 조건이 허용하지 않는 키 조합이 있습니다).\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"},"example":{"error":{"code":"VALIDATION_ERROR","message":"filter.conditions.0.value: Number must be less than or equal to 365","retryable":false}},"examples":{"Example":{"title":"Example","value":{"error":{"code":"VALIDATION_ERROR","message":"filter.conditions.0.value: Number must be less than or equal to 365","retryable":false}}}},"exampleType":"examples"}},"exampleType":"examples"},"a08c8dc7-5a15-45a7-a4a7-2ad6239f952d":{"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"},"54924e96-f991-4dbd-bab7-fa1bc3c0c4a7":{"description":"`PAST_DUE_RESTRICTED`, `PLAN_REQUIRED` 또는 `INSUFFICIENT_SCOPE`(키에 `segments:write` 범위가 없습니다).","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"},"293b9820-12c2-463c-9cb5-dee7d2d1ae83":{"description":"API는 일부 계정에서만 사용이 가능하며, 요금제와는 별개입니다. 사용할 수\n있어야 하는 계정이라면 DocuRise 담당자에게 문의하세요 (`code: 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"},"14154ff1-0b02-4227-98db-c82054dfc54e":{"description":"`IDEMPOTENCY_KEY_CONFLICT`(재시도 불가: 같은 키가 이미 다른 본문으로 사용되었습니다.\n새 키를 사용하세요) 또는 `IDEMPOTENCY_KEY_IN_PROGRESS`(재시도 가능: 이 키의 요청이\n아직 처리 중입니다. `retryAfterSeconds`가 대기 시간을 안내합니다).\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"},"8718d36c-dea5-44ae-a8be-76ef4ffd9d02":{"description":"요청 형식은 올바르지만 규칙을 사용할 수 없습니다. 아무것도 만들어지지 않았으며,\n어느 것도 그대로 재시도해서는 해결되지 않습니다.\n`EMPTY_FILTER`: 규칙의 세 목록 어디에도 조건이 없습니다.\n`CONDITION_NOT_SUPPORTED`: API가 아직 받지 않는 조건 타입(`custom_field`)이거나,\n그 조건이 들어 있는 목록에서 일부 연락처에 잘못된 답을 내는 조건 형태입니다(그룹\n조건 문서 참고). `details`는 `{ field, path }`이고, 두 번째 경우에는\n`{ operator, invertTo }`가 더해집니다(대신 쓸 수 있는 연산자가 없으면 `invertTo`는\n없습니다).\n`REFERENCE_NOT_FOUND`: 조건에 내 계정에 없는 id가 들어 있습니다(알 수 없는 id,\n삭제되었거나 휴지통에 있는 id, 다른 사람의 id는 모두 구분되지 않습니다).\n`details`는 `{ path, kind }`이고 `kind`는 `document`, `product`, `tier`, `cta`,\n`folder`, `broadcast`, `step` 중 하나입니다.\n`TAG_NOT_FOUND`: `tag` 조건이 내 계정에 없는 태그 이름을 가리킵니다(이름은 대소문자를\n포함해 정확히 일치해야 합니다). `details`는 `{ tag }`입니다. 태그 이름은\n`GET /api/preview/tags`로 확인하세요.\n`GROUP_REFERENCE_NOT_FOUND`: `group_membership` 조건이 내 계정에 없는 그룹을\n가리킵니다. `details`는 `{ groupIds }`입니다.\n`GROUP_LIMIT_REACHED`: 계정이 그룹 100개 한도에 도달했습니다. `details`는\n`{ limit }`입니다. 쓰지 않는 그룹을 대시보드에서 삭제한 뒤 새\n`Idempotency-Key`로 다시 시도하세요.\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":{"emptyFilter":{"title":"emptyFilter","value":{"error":{"code":"EMPTY_FILTER","message":"The filter has no conditions. Add at least one condition, or the group would match every contact","retryable":false}}},"conditionNotSupported":{"title":"conditionNotSupported","value":{"error":{"code":"CONDITION_NOT_SUPPORTED","message":"The custom_field condition is not supported through the API yet. Remove it from the filter","retryable":false,"details":{"field":"custom_field","path":"filter.conditions.1"}}}},"referenceNotFound":{"title":"referenceNotFound","value":{"error":{"code":"REFERENCE_NOT_FOUND","message":"A condition refers to something that is not in your account","retryable":false,"details":{"path":"filter.conditions.0.documentId","kind":"document"}}}},"tagNotFound":{"title":"tagNotFound","value":{"error":{"code":"TAG_NOT_FOUND","message":"A tag condition names a tag that is not in your account","retryable":false,"details":{"tag":"newsletter"}}}},"groupReferenceNotFound":{"title":"groupReferenceNotFound","value":{"error":{"code":"GROUP_REFERENCE_NOT_FOUND","message":"A group condition refers to a group that is not in your account","retryable":false,"details":{"groupIds":["9c1e4a7b-2d3f-4e58-a6b0-5f8d7c3e1a24"]}}}},"groupLimitReached":{"title":"groupLimitReached","value":{"error":{"code":"GROUP_LIMIT_REACHED","message":"This account has reached its group limit","retryable":false,"details":{"limit":100}}}}},"exampleType":"examples"}},"exampleType":"examples"},"c9a15021-bad9-4955-990b-31c887433097":{"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"},"21eec7ed-264e-4447-b979-b51ea9fbde58":{"description":"`INTERNAL_ERROR`(재시도 가능). 서버 측 오류이며 원인은 응답에 포함되지 않습니다. 같은 `Idempotency-Key`로 재시도하세요.","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"},"aeb8a518-bc54-4142-ba37-a7f7d7961f99":{"description":"서버 측 의존 서비스가 일시적으로 중단되었습니다(`RATE_LIMIT_UNAVAILABLE` 또는\n`SERVICE_UNAVAILABLE`). 요청이나 키의 문제가 아닙니다. 항상 재시도할 수 있으며,\n`retryAfterSeconds`가 있으면 그 시간만큼 기다리세요.\n서비스가 너무 바빠 생성을 시작하지 못한 경우에도 `SERVICE_UNAVAILABLE`이 반환됩니다.\n이때는 아무것도 만들어지지 않았으며, 같은 `Idempotency-Key`로 안전하게 재시도할 수\n있습니다. 그룹 엔드포인트는 매우 무거운 규칙의 인원을 약 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":{"b22edfca-aaff-43fd-8d68-8b14d0a240ca":{"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/create-segment","matchLevel":1},"ko":{"href":"/ko/api-reference/create-segment","matchLevel":0}}},"lastModified":"2026-10-26T16:11:33.621Z","originalFileLocation":"ko/api-reference/create-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=\"규칙으로 그룹 하나를 만듭니다. Idempotency-Key로 재시도가 안전합니다\">\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=\"규칙으로 그룹 하나를 만듭니다. Idempotency-Key로 재시도가 안전합니다\">\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/create-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+%EB%A7%8C%EB%93%A4%EA%B8%B0\u0026amp;description=%EA%B7%9C%EC%B9%99%EC%9C%BC%EB%A1%9C+%EA%B7%B8%EB%A3%B9+%ED%95%98%EB%82%98%EB%A5%BC+%EB%A7%8C%EB%93%AD%EB%8B%88%EB%8B%A4.+Idempotency-Key%EB%A1%9C+%EC%9E%AC%EC%8B%9C%EB%8F%84%EA%B0%80+%EC%95%88%EC%A0%84%ED%95%A9%EB%8B%88%EB%8B%A4\u0026amp;theme=53f5ca0b0069a8a509ebc847\u0026amp;signature=cdaf1593267f6678342ff21f1551507bb0d6afa1bf7a8674169bd54eb36ba578\">\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=\"규칙으로 그룹 하나를 만듭니다. Idempotency-Key로 재시도가 안전합니다\">\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+%EB%A7%8C%EB%93%A4%EA%B8%B0\u0026amp;description=%EA%B7%9C%EC%B9%99%EC%9C%BC%EB%A1%9C+%EA%B7%B8%EB%A3%B9+%ED%95%98%EB%82%98%EB%A5%BC+%EB%A7%8C%EB%93%AD%EB%8B%88%EB%8B%A4.+Idempotency-Key%EB%A1%9C+%EC%9E%AC%EC%8B%9C%EB%8F%84%EA%B0%80+%EC%95%88%EC%A0%84%ED%95%A9%EB%8B%88%EB%8B%A4\u0026amp;theme=53f5ca0b0069a8a509ebc847\u0026amp;signature=cdaf1593267f6678342ff21f1551507bb0d6afa1bf7a8674169bd54eb36ba578\">\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/create-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/create-segment.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ko\" href=\"https://docurise.io/docs/ko/api-reference/create-segment\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://docurise.io/docs/api-reference/create-segment\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://docurise.io/docs/api-reference/create-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/create-segment#webpage\",\"url\":\"https://docurise.io/docs/ko/api-reference/create-segment\",\"name\":\"그룹 만들기\",\"description\":\"규칙으로 그룹 하나를 만듭니다. Idempotency-Key로 재시도가 안전합니다\",\"dateModified\":\"2026-10-26T16:11:33.621Z\",\"isPartOf\":{\"@id\":\"https://docurise.io/docs#website\"},\"breadcrumb\":{\"@id\":\"https://docurise.io/docs/ko/api-reference/create-segment#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docurise.io/docs/ko/api-reference/create-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/create-segment\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docurise.io/docs/ko/api-reference/create-segment#apireference\",\"headline\":\"그룹 만들기\",\"name\":\"그룹 만들기\",\"description\":\"규칙으로 그룹 하나를 만듭니다. Idempotency-Key로 재시도가 안전합니다\",\"url\":\"https://docurise.io/docs/ko/api-reference/create-segment\",\"mainEntityOfPage\":{\"@id\":\"https://docurise.io/docs/ko/api-reference/create-segment#webpage\"},\"dateModified\":\"2026-10-26T16:11:33.621Z\",\"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/create-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":"그룹 목록 조회","description":"연락처 그룹과 각 그룹의 멤버 수를 조회합니다 (수치만 제공, 연락처 정보 없음)","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":"그룹 조건","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"]}