API

개체 조회

작성일 2026.03.24 | 수정일 2026.04.14

GET/crm-core/v1/entities/:entityId
특정 개체의 상세 정보를 조회합니다.

Response

NameTypeRequiredDescription
entityIdstring개체 고유 아이디
accountIdstring계정 고유 아이디
namestring개체 이름
slugstring개체 슬러그
descriptionstring개체 설명
propertyIdsArray속성 ID 목록
viewSettingsObject보기 설정
viewSettings.modestring보기 모드 (TABLE, BOARD, CALENDAR)
viewSettings.tableObject테이블 보기 설정
viewSettings.table.pageSizenumber페이지당 표시 개수 (기본값: 25)
viewSettings.boardObject보드 보기 설정
viewSettings.board.groupByPropertyIdstring그룹핑 기준 속성 ID
viewSettings.board.sumPropertyIdstring합계 속성 ID
viewSettings.board.weightPropertyIdstring가중치 속성 ID
viewSettings.board.aggregationTypestring집계 유형
viewSettings.board.sortByPropertyIdstring정렬 기준 속성 ID
viewSettings.board.sortOrderstring정렬 방향
viewSettings.board.closedWonValuesArray성공 종료 값 목록
viewSettings.board.closedLostValuesArray실패 종료 값 목록
viewSettings.calendarObject캘린더 보기 설정
viewSettings.calendar.datePropertyIdstring날짜 속성 ID
viewSettings.calendar.titlePropertyIdstring제목 속성 ID
viewSettings.calendar.colorPropertyIdstring색상 속성 ID
recordAccessstring레코드 접근 권한 (PUBLIC\ENTITY_OWNER_ONLY\ADMIN_ONLY)
ownerIdstring개체 소유자 멤버 ID
insightWidgetsArray인사이트 위젯 설정 목록
createdBystring생성한 멤버 ID
updatedBystring마지막으로 수정한 멤버 ID
prioritynumber정렬 우선순위
dateCreateddate최초 생성 날짜
dateUpdateddate*최근 수정 날짜

StructureResponse Structure⎘

{
  "entityId": "ENT20260324090000ABCDEFGHIJKLMNO",
  "accountId": "24010100001234",
  "name": "샘플",
  "slug": "sample-slug",
  "description": "설명 텍스트",
  "propertyIds": ["샘플값"],
  "viewSettings": {
    "mode": "TABLE",
    "table": { "pageSize": 20 },
    "board": {
      "groupByPropertyId": "ID_SAMPLE_12345",
      "sumPropertyId": "ID_SAMPLE_12345",
      "sortOrder": "DESC"
    },
    "calendar": {
      "datePropertyId": "ID_SAMPLE_12345",
      "titlePropertyId": "ID_SAMPLE_12345",
      "colorPropertyId": "ID_SAMPLE_12345"
    }
  },
  "recordAccess": "PUBLIC",
  "ownerId": "MEM20260324090000ABCDEFGHIJKLMNO",
  "insightWidgets": [],
  "createdBy": "MEM20260324090000ABCDEFGHIJKLMNO",
  "updatedBy": "MEM20260324090000ABCDEFGHIJKLMNO",
  "priority": 1,
  "dateCreated": "2026-03-24T09:00:00.000Z",
  "dateUpdated": "2026-03-24T09:00:00.000Z"
}