API

활동 수정

작성일 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" }
``