API

활동 수정

작성일 2026.03.24 | 수정일 2026.03.25

PATCH/crm-core/v1/activities/:activityId

Parameters

:activityId*— 활동 고유 아이디

활동 정보를 수정합니다. MEMBER 이상 권한이 필요합니다.

Body Params

Name	Type	Description
subject	string	활동 제목
description	string	활동 설명
relatedRecordIds	Array<String>	관련 레코드 ID 목록
scheduledAt	date	예정 일시 (ISO 8601)
completedAt	date	완료 일시 (ISO 8601)
dueDate	date	마감 일시 (ISO 8601)
assignedMemberIds	Array<String>	담당자 멤버 ID 목록
outcome	string	결과 - COMPLETED, CANCELLED, RESCHEDULED, NO_ANSWER, PENDING 중 하나
outcomeNote	string	결과 메모
durationMinutes	number	소요 시간(분)
metadata	Object	추가 메타데이터
ownerId	string	활동 소유자 멤버 ID. 미입력 시 현재 멤버 ID로 자동 설정
visibility	string	활동 공개 범위 (PRIVATE(기본값) 또는 PUBLIC)

Response

Name	Type	Required	Description
activityId	string	*	활동 고유 아이디
accountId	string	*	계정 고유 아이디
recordId	string	*	레코드 ID. "CALENDAR"인 경우 일반 일정입니다.
activityType	string	*	활동 유형
subject	string	*	활동 제목
description	string		활동 설명
scheduledAt	date		예정 일시
dueDate	date		마감 일시
assignedMemberIds	Array<String>		담당자 목록
durationMinutes	number		소요 시간
metadata	Object		메타데이터
ownerId	string	*	활동 소유자 멤버 ID
visibility	string	*	활동 공개 범위 (PRIVATE 또는 PUBLIC)
dateCreated	date	*	최초 생성 날짜
dateUpdated	date	*	최근 수정 날짜

Structure

Request Structure

{
  "subject": "고객 미팅",
  "description": "설명 텍스트",
  "relatedRecordIds": [
    "샘플값"
  ],
  "scheduledAt": "2026-03-24T09:00:00.000Z",
  "completedAt": "2026-03-24T09:00:00.000Z",
  "dueDate": "2026-03-24T09:00:00.000Z",
  "assignedMemberIds": [
    "샘플값"
  ],
  "outcome": "샘플값",
  "outcomeNote": "샘플값",
  "durationMinutes": 30,
  "metadata": {
    "key": "value"
  },
  "ownerId": "MEM20260324090000ABCDEFGHIJKLMNO",
  "visibility": "PRIVATE"
}

Response Structure

{
  "activityId": "ACT20260324090000ABCDEFGHIJKLMNO",
  "accountId": "24010100001234",
  "recordId": "REC20260324090000ABCDEFGHIJKLMNO",
  "activityType": "MEETING",
  "subject": "고객 미팅",
  "description": "설명 텍스트",
  "scheduledAt": "2026-03-24T09:00:00.000Z",
  "dueDate": "2026-03-24T09:00:00.000Z",
  "assignedMemberIds": [
    "샘플값"
  ],
  "durationMinutes": 30,
  "metadata": {
    "key": "value"
  },
  "ownerId": "MEM20260324090000ABCDEFGHIJKLMNO",
  "visibility": "PRIVATE",
  "dateCreated": "2026-03-24T09:00:00.000Z",
  "dateUpdated": "2026-03-24T09:00:00.000Z"
}