Обновите имя существующего проекта в Blue
Переименование проекта
Обновляет имя и другие свойства существующего проекта. Когда имя изменяется, слаг проекта будет автоматически сгенерирован на основе нового имени.
Простой пример
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
}
}
Входные параметры
Параметр |
Тип |
Обязательный |
Описание |
projectId |
String! |
✅ Да |
Идентификатор проекта для редактирования |
name |
String |
Нет |
Новое имя для проекта |
slug |
String |
Нет |
Пользовательский слаг, удобный для URL (автоматически генерируется, если не указан) |
description |
String |
Нет |
Описание проекта |
color |
String |
Нет |
Шестнадцатичный код цвета для проекта (например, #3B82F6) |
icon |
String |
Нет |
Идентификатор иконки для проекта |
category |
ProjectCategory |
Нет |
Категория проекта |
todoAlias |
String |
Нет |
Пользовательское имя для записей в этом проекте |
hideRecordCount |
Boolean |
Нет |
Скрыть количество записей в пользовательском интерфейсе |
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! |
Идентификатор проекта |
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.
Связанные операции