API

속성 수정

작성일 2026.03.24 | 수정일 2026.04.14

PATCH/crm-core/v1/properties/{propertyId}

기존 속성의 정보를 수정합니다. OWNER 권한이 필요합니다.

Path Params| Name | Type | Required | Description |

| ------ | ------ | ------ | ------ | | propertyId | string | * | 속성 고유 아이디 |

Body Params| Name | Type | Required | Description |

| ------ | ------ | ------ | ------ | | entityId | string | | 개체 고유 아이디 | | name | string | | 속성 이름 | | description | string | | 속성 설명 | | fieldType | string | | 속성 유형 (TEXT, TEXTAREA, NUMBER, PHONE, EMAIL, CHECKBOX, MULTI_CHECKBOX, DATE, DATETIME, DROPDOWN, RADIO, URL) | | propertyGroupId | string | | 속성 그룹 ID | | key | string | | 속성 키 — 소문자 영문으로 시작, 영소문자·숫자·언더스코어 허용, 최대 63자 | | options | Array\ | | 선택지 목록 | | options[].label | string | | 선택지 라벨 | | options[].value | string | | 선택지 값 | | options[].priority | number | | 정렬 순서 |

Response| Name | Type | Required | Description |

| ------ | ------ | ------ | ------ | | propertyId | string | | 속성 고유 아이디 | | accountId | string | | 계정 고유 아이디 | | entityId | string | | 개체 ID | | name | string | | 속성 이름 | | description | string | | 속성 설명 | | fieldType | string | | 속성 유형 | | propertyGroupId | string | | 속성 그룹 ID | | key | string | | 속성 키 (null 가능) | | isMasked | boolean | | 마스킹 처리 여부 | | options | Array\ | | 선택지 목록 | | options[].label | string | | 선택지 라벨 | | options[].value | string | | 선택지 값 | | options[].priority | number | | 정렬 순서 | | createdBy | string | | 생성한 멤버 ID | | updatedBy | string | | 최근 수정한 멤버 ID | | dateCreated | date | | 최초 생성 날짜 | | dateUpdated | date | | 최근 수정 날짜 |

Structure

json Request Structure
{
  "name": "샘플",
  "description": "설명 텍스트",
  "fieldType": "TEXT",
  "propertyGroupId": "ID_SAMPLE_12345",
  "key": "sample_key",
  "options": [
    {
      "label": "라벨",
      "value": "샘플값",
      "priority": 1
    }
  ]
}
json Response Structure
{
  "propertyId": "PROP20260324090000ABCDEFGHIJKLM",
  "accountId": "24010100001234",
  "entityId": "ENT20260324090000ABCDEFGHIJKLMNO",
  "name": "샘플",
  "description": "설명 텍스트",
  "fieldType": "TEXT",
  "propertyGroupId": "ID_SAMPLE_12345",
  "key": "sample_key",
  "isMasked": false,
  "options": [
    {
      "label": "라벨",
      "value": "샘플값",
      "priority": 1
    }
  ],
  "createdBy": "MEM20260101000000ABCDEFGHIJKLMNO",
  "updatedBy": "MEM20260101000000ABCDEFGHIJKLMNO",
  "dateCreated": "2026-03-24T09:00:00.000Z",
  "dateUpdated": "2026-03-24T09:00:00.000Z"
}