Обновите имя существующего проекта в Blue
Copy page in markdown for LLMs
Переименование проекта
Обновляет имя и другие свойства существующего проекта. Когда имя изменяется, слаг проекта будет автоматически сгенерирован на основе нового имени.
Простой пример
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! | ✅ Да | Идентификатор проекта для редактирования |
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.
Связанные операции
- Создать проект - Создать новый проект
- Список проектов - Получить все проекты
- Удалить проект - Удалить проект
- Архивировать проект - Архивировать/разархивировать проекты