---

프로젝트 이름 변경

기존 프로젝트의 이름 및 기타 속성을 업데이트합니다. 이름이 변경되면 프로젝트 슬러그는 새 이름을 기반으로 자동으로 재생성됩니다.

기본 예제

mutation RenameProject {
  editProject(input: {
    projectId: "project_abc123"
    name: "Q2 Marketing Campaign"
  }) {
    id
    name
    slug
  }
}

고급 예제

mutation EditProjectAdvanced {
  editProject(input: {
    projectId: "project_abc123"
    name: "Q2 Marketing Campaign"
    description: "Campaign for Q2 product launch"
    color: "#3B82F6"
    icon: "campaign"
    category: MARKETING
    todoAlias: "Task"
    hideRecordCount: false
  }) {
    id
    name
    slug
    description
    color
    icon
    category
    todoAlias
    hideRecordCount
  }
}

입력 매개변수

EditProjectInput

매개변수	유형	필수	설명
projectId	String!	✅ 예	편집할 프로젝트의 ID
name	String	아니오	프로젝트의 새 이름
slug	String	아니오	사용자 정의 URL 친화적인 슬러그 (제공되지 않으면 자동 생성됨)
description	String	아니오	프로젝트 설명
color	String	아니오	프로젝트의 헥스 색상 코드 (예: #3B82F6)
icon	String	아니오	프로젝트의 아이콘 식별자
category	ProjectCategory	아니오	프로젝트 카테고리
todoAlias	String	아니오	이 프로젝트의 기록에 대한 사용자 정의 이름
hideRecordCount	Boolean	아니오	UI에서 기록 수를 숨길지 여부
showTimeSpentInTodoList	Boolean	아니오	목록에서 시간 추적 표시
showTimeSpentInProject	Boolean	아니오	프로젝트 보기에서 시간 추적 표시
image	ImageInput	아니오	프로젝트 이미지/표지
todoFields	[TodoFieldInput]	아니오	사용자 정의 필드 구성
coverConfig	TodoCoverConfigInput	아니오	표지 표시 구성
features	[ProjectFeatureInput]	아니오	프로젝트의 기능 전환
sequenceCustomFieldId	String	아니오	기록 순서를 위해 사용할 사용자 정의 필드

ProjectCategory 값

값	설명
PERSONAL	개인 프로젝트
BUSINESS	비즈니스 프로젝트
MARKETING	마케팅 캠페인
DEVELOPMENT	개발 프로젝트
DESIGN	디자인 프로젝트
OPERATIONS	운영 작업
SALES	판매 활동
SUPPORT	지원 티켓
FINANCE	재무 추적
HR	인사 관리
LEGAL	법적 문제
PROCUREMENT	조달 프로세스

응답 필드

업데이트된 프로젝트 객체를 모든 필드와 함께 반환합니다. 주요 필드는 다음과 같습니다:

필드	유형	설명
id	String!	프로젝트 ID
name	String!	프로젝트 이름
slug	String!	URL 친화적인 슬러그
description	String	프로젝트 설명
color	String	헥스 색상 코드
icon	String	아이콘 식별자
category	ProjectCategory	프로젝트 카테고리
todoAlias	String	사용자 정의 기록 이름
hideRecordCount	Boolean!	기록 수 가시성 설정
createdAt	DateTime!	생성 타임스탬프
updatedAt	DateTime!	마지막 업데이트 타임스탬프

필수 권한

역할	프로젝트 편집 가능
OWNER	✅ 예
ADMIN	✅ 예
MEMBER	❌ 아니오

오류 응답

프로젝트를 찾을 수 없음

{
  "errors": [{
    "message": "Project was not found.",
    "extensions": {
      "code": "PROJECT_NOT_FOUND"
    }
  }]
}

권한 부족

{
  "errors": [{
    "message": "You don't have permission to edit this project",
    "extensions": {
      "code": "FORBIDDEN"
    }
  }]
}

중요 사항

• 슬러그 생성: 프로젝트 슬러그는 이름이 변경될 때 자동으로 생성됩니다. 사용자 정의 슬러그를 제공할 수도 있습니다.
• 슬러그 충돌: 슬러그가 기존 회사 슬러그와 충돌하는 경우 시스템은 숫자를 추가합니다 (예: my-project-1).
• HTML 정리: 보안을 위해 설명 필드에서 HTML 태그가 자동으로 제거됩니다.
• 부분 업데이트: projectId를 제외한 모든 필드는 선택 사항입니다 - 업데이트하려는 필드만 제공하십시오.
• 카테고리: 카테고리 필드에 ProjectCategory 열거형 값을 사용하십시오.
• 이미지 처리: ImageInput을 통해 프로젝트 이미지를 업로드, 업데이트 또는 제거하는 것을 지원합니다.

관련 작업

• 프로젝트 생성 - 새 프로젝트 생성
• 프로젝트 목록 - 모든 프로젝트 가져오기
• 프로젝트 삭제 - 프로젝트 삭제
• 프로젝트 보관 - 프로젝트 보관/비보관