추적 키 수정
작성일 2026.03.24 | 수정일 2026.04.14
PATCH/crm-core/v1/tracking-keys/:trackingKeyIdParameters:trackingKeyId— 추적 키 고유 아이디
추적 키의 정보를 수정합니다. MEMBER 이상 권한이 필요합니다.
Body Params
| Name | Type | Required | Description |
|---|---|---|---|
| name | string | 추적 키 이름 (최대 128자) | |
| allowedDomains | Array | 허용 도메인 목록 | |
| defaultEntityId | string | 기본 개체 ID | |
| permissions | Object | 권한 설정 | |
| createRecords | boolean | 레코드 생성 허용 여부 | |
| trackEvents | boolean | 이벤트 추적 허용 여부 |
Response
| Name | Type | Required | Description |
|---|---|---|---|
| trackingKeyId | string | 추적 키 고유 아이디 | |
| accountId | string | 계정 고유 아이디 | |
| name | string | 추적 키 이름 | |
| keyPrefix | string | 키 접두사 | |
| allowedDomains | Array | 허용 도메인 목록 | |
| defaultEntityId | string | 기본 개체 ID | |
| permissions | Object | 권한 설정 | |
| createRecords | boolean | 레코드 생성 허용 여부 | |
| trackEvents | boolean | 이벤트 추적 허용 여부 | |
| isActive | boolean | 활성 상태 | |
| lastUsedAt | date | 마지막 사용 일시 | |
| dateCreated | date | 최초 생성 날짜 | |
| dateUpdated | date | * | 최근 수정 날짜 |
Structure
Request Structure⎘{
"name": "샘플",
"allowedDomains": [
"샘플값"
],
"defaultEntityId": "ID_SAMPLE_12345",
"permissions": {
"createRecords": true,
"trackEvents": true
}
}Response Structure⎘{
"trackingKeyId": "TK20260324090000ABCDEFGHIJKLMNOP",
"accountId": "24010100001234",
"name": "샘플",
"keyPrefix": "샘플값",
"allowedDomains": [
"샘플값"
],
"defaultEntityId": "ID_SAMPLE_12345",
"permissions": {
"createRecords": true,
"trackEvents": true
},
"isActive": true,
"lastUsedAt": "2026-03-24T09:00:00.000Z",
"dateCreated": "2026-03-24T09:00:00.000Z",
"dateUpdated": "2026-03-24T09:00:00.000Z"
}