활동 수정
작성일 2026.03.24 | 수정일 2026.04.14
PATCH/crm-core/v1/activities/{activityId}
활동을 수정합니다. MEMBER 이상의 권한이 필요하며, 본인 소유 활동만 수정 가능합니다.
Path Params| Name | Type | Required | Description |
| ------ | ------ | ------ | ------ | | activityId | string | * | 활동 고유 아이디 |Body Params| Name | Type | Required | Description |
| ------ | ------ | ------ | ------ | | subject | string | | 활동 제목 | | description | string | | 활동 설명 | | relatedRecordIds | Array\ | | 관련 레코드 ID 목록 | | scheduledAt | date | | 예정 일시 (ISO 8601) | | completedAt | date | | 완료 일시 (ISO 8601) | | dueDate | date | | 마감 일시 (ISO 8601) | | assignedMemberId | string | | 담당자 멤버 ID (단수, 하위 호환). assignedMemberIds와 함께 사용 시 assignedMemberIds가 우선됩니다. | | assignedMemberIds | Array\ | | 담당자 멤버 ID 목록 | | outcome | string | | 활동 결과 - COMPLETED, CANCELLED, RESCHEDULED, NO_ANSWER, PENDING 중 하나 | | outcomeNote | string | | 활동 결과 메모 | | durationMinutes | number | | 소요 시간(분) | | metadata | Object | | 추가 메타데이터 |Response| Name | Type | Required | Description |
| ------ | ------ | ------ | ------ | | activityId | string | | 활동 고유 ID | | accountId | string | | 계정 고유 ID | | recordId | string | | 레코드 ID. "CALENDAR"인 경우 일반 일정입니다. | | activityType | string | | 활동 유형 | | subject | string | | 활동 제목 | | description | string | | 활동 설명 | | scheduledAt | date | | 예정 일시 | | completedAt | date | | 완료 일시 | | dueDate | date | | 마감 일시 | | assignedMemberId | string | | 담당자 멤버 ID (단수, 하위 호환) | | assignedMemberIds | Array\ | | 담당자 목록 | | outcome | string | | 활동 결과 상태 | | outcomeNote | string | | 활동 결과 메모 | | durationMinutes | number | | 소요 시간 | | metadata | Object | | 메타데이터 | | ownerId | string | | 활동 소유자 멤버 ID | | visibility | string | | 활동 공개 범위 (PRIVATE 또는 PUBLIC) | | dateCreated | date | | 최초 생성 날짜 | | dateUpdated | date | | 최근 수정 날짜 |Structure
``json Request Structure
{
"subject": "고객 미팅 일정 (수정)",
"description": "미팅 내용을 업데이트함",
"scheduledAt": "2026-03-24T10:00:00.000Z",
"dueDate": "2026-03-24T18:00:00.000Z",
"assignedMemberIds": ["member_1"],
"outcome": "COMPLETED",
"outcomeNote": "성공적으로 계약 체결",
"durationMinutes": 45
}
json Response Structure
{
"activityId": "ACT20260324090000ABCDEFGHIJKLMNO",
"accountId": "24010100001234",
"recordId": "REC20260324090000ABCDEFGHIJKLMNO",
"activityType": "MEETING",
"subject": "고객 미팅 일정 (수정)",
"description": "미팅 내용을 업데이트함",
"scheduledAt": "2026-03-24T10:00:00.000Z",
"dueDate": "2026-03-24T18:00:00.000Z",
"assignedMemberId": "member_1",
"assignedMemberIds": ["member_1"],
"outcome": "COMPLETED",
"outcomeNote": "성공적으로 계약 체결",
"durationMinutes": 45,
"metadata": {},
"ownerId": "MEM20260324090000ABCDEFGHIJKLMNO",
"visibility": "PRIVATE",
"dateCreated": "2026-03-24T09:00:00.000Z",
"dateUpdated": "2026-03-24T10:00:00.000Z"
}
``