API

추적 키 수정

작성일 2026.03.24 | 수정일 2026.03.25

PATCH/crm-core/v1/tracking-keys/:trackingKeyId

Parameters

:trackingKeyId*— 추적 키 고유 아이디

추적 키의 정보를 수정합니다. MEMBER 이상 권한이 필요합니다.

Body Params

Name	Type	Description
name	string	추적 키 이름 (최대 128자)
allowedDomains	Array<String>	허용 도메인 목록
defaultEntityId	string	기본 개체 ID
permissions	Object	권한 설정
createRecords	boolean	레코드 생성 허용 여부
trackEvents	boolean	이벤트 추적 허용 여부

Response

Name	Type	Required	Description
trackingKeyId	string	*	추적 키 고유 아이디
accountId	string	*	계정 고유 아이디
name	string	*	추적 키 이름
keyPrefix	string	*	키 접두사
allowedDomains	Array<String>		허용 도메인 목록
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"
}