API

개체 수정

작성일 2026.03.24 | 수정일 2026.03.25

PATCH/crm-core/v1/entities/:entityId

Parameters

:entityId*— 개체 고유 아이디

기존 CRM 개체의 정보를 수정합니다. OWNER 권한이 필요합니다.

Body Params

Name	Type	Description
name	string	개체 이름
slug	string	개체 슬러그 (URL 친화적 식별자)
description	string	개체 설명
propertyIds	Array<String>	속성 ID 목록
viewSettings	Object	보기 설정
mode	string	보기 모드 (TABLE, BOARD, CALENDAR)
table	Object	테이블 보기 설정
pageSize	number	페이지당 표시 개수
board	Object	보드 보기 설정
groupByPropertyId	string	그룹핑 기준 속성 ID
sumPropertyId	string	합계 속성 ID
weightPropertyId	string	가중치 속성 ID
aggregationType	string	집계 유형
sortByPropertyId	string	정렬 기준 속성 ID
sortOrder	string	정렬 방향
closedWonValues	Array<String>	성공 종료 값 목록
closedLostValues	Array<String>	실패 종료 값 목록
calendar	Object	캘린더 보기 설정
datePropertyId	string	날짜 속성 ID
titlePropertyId	string	제목 속성 ID
colorPropertyId	string	색상 속성 ID

Response

Name	Type	Required	Description
entityId	string	*	개체 고유 아이디
accountId	string	*	계정 고유 아이디
name	string	*	개체 이름
slug	string	*	개체 슬러그
description	string		개체 설명
propertyIds	Array<String>		속성 ID 목록
viewSettings	Object		보기 설정
ownerId	string		개체 소유자 멤버 ID
dateCreated	date	*	최초 생성 날짜
dateUpdated	date	*	최근 수정 날짜

Structure

Request Structure

{
  "name": "샘플",
  "slug": "sample-slug",
  "description": "설명 텍스트",
  "propertyIds": [
    "샘플값"
  ],
  "viewSettings": {
    "mode": "TABLE"
  }
}

Response Structure

{
  "entityId": "ENT20260324090000ABCDEFGHIJKLMNO",
  "accountId": "24010100001234",
  "name": "샘플",
  "slug": "sample-slug",
  "description": "설명 텍스트",
  "propertyIds": [
    "샘플값"
  ],
  "viewSettings": {
    "key": "value"
  },
  "ownerId": "MEM20260324090000ABCDEFGHIJKLMNO",
  "dateCreated": "2026-03-24T09:00:00.000Z",
  "dateUpdated": "2026-03-24T09:00:00.000Z"
}