Mettre à jour le nom d'un projet existant dans Blue
Renommer un projet
Met à jour le nom et d'autres propriétés d'un projet existant. Lorsque le nom est modifié, le slug du projet sera automatiquement régénéré en fonction du nouveau nom.
Exemple de base
mutation RenameProject {
editProject(input: {
projectId: "project_abc123"
name: "Q2 Marketing Campaign"
}) {
id
name
slug
}
}
Exemple avancé
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
}
}
Paramètres d'entrée
Paramètre |
Type |
Requis |
Description |
projectId |
String! |
✅ Oui |
L'ID du projet à modifier |
name |
String |
Non |
Le nouveau nom pour le projet |
slug |
String |
Non |
Slug personnalisé compatible avec l'URL (généré automatiquement si non fourni) |
description |
String |
Non |
Description du projet |
color |
String |
Non |
Code couleur hexadécimal pour le projet (ex: #3B82F6) |
icon |
String |
Non |
Identifiant d'icône pour le projet |
category |
ProjectCategory |
Non |
Catégorie du projet |
todoAlias |
String |
Non |
Nom personnalisé pour les enregistrements dans ce projet |
hideRecordCount |
Boolean |
Non |
Indique si les comptes d'enregistrements doivent être masqués dans l'interface utilisateur |
showTimeSpentInTodoList |
Boolean |
Non |
Afficher le suivi du temps dans les listes |
showTimeSpentInProject |
Boolean |
Non |
Afficher le suivi du temps dans la vue du projet |
image |
ImageInput |
Non |
Image/couverture du projet |
todoFields |
[TodoFieldInput] |
Non |
Configurations de champs personnalisés |
coverConfig |
TodoCoverConfigInput |
Non |
Configuration d'affichage de la couverture |
features |
[ProjectFeatureInput] |
Non |
Bascules de fonctionnalités pour le projet |
sequenceCustomFieldId |
String |
Non |
Champ personnalisé à utiliser pour le séquençage des enregistrements |
Valeurs de ProjectCategory
Valeur |
Description |
PERSONAL |
Projets personnels |
BUSINESS |
Projets d'affaires |
MARKETING |
Campagnes marketing |
DEVELOPMENT |
Projets de développement |
DESIGN |
Projets de design |
OPERATIONS |
Tâches opérationnelles |
SALES |
Activités de vente |
SUPPORT |
Tickets de support |
FINANCE |
Suivi financier |
HR |
Ressources humaines |
LEGAL |
Questions juridiques |
PROCUREMENT |
Processus d'approvisionnement |
Champs de réponse
Renvoie l'objet Projet mis à jour avec tous les champs. Les champs clés incluent :
Champ |
Type |
Description |
id |
String! |
ID du projet |
name |
String! |
Nom du projet |
slug |
String! |
Slug compatible avec l'URL |
description |
String |
Description du projet |
color |
String |
Code couleur hexadécimal |
icon |
String |
Identifiant d'icône |
category |
ProjectCategory |
Catégorie du projet |
todoAlias |
String |
Nom d'enregistrement personnalisé |
hideRecordCount |
Boolean! |
Paramètre de visibilité du compte d'enregistrement |
createdAt |
DateTime! |
Horodatage de création |
updatedAt |
DateTime! |
Horodatage de la dernière mise à jour |
Permissions requises
Rôle |
Peut modifier le projet |
OWNER |
✅ Oui |
ADMIN |
✅ Oui |
MEMBER |
❌ Non |
Réponses d'erreur
Projet non trouvé
{
"errors": [{
"message": "Project was not found.",
"extensions": {
"code": "PROJECT_NOT_FOUND"
}
}]
}
Permissions insuffisantes
{
"errors": [{
"message": "You don't have permission to edit this project",
"extensions": {
"code": "FORBIDDEN"
}
}]
}
Notes importantes
- Génération de slug : Les slugs de projet sont générés automatiquement lorsque le nom change. Vous pouvez également fournir un slug personnalisé.
- Conflits de slug : Si un slug entre en conflit avec des slugs d'entreprise existants, le système ajoutera des numéros (ex :
my-project-1
).
- Assainissement HTML : Les balises HTML sont automatiquement supprimées des champs de description pour des raisons de sécurité.
- Mises à jour partielles : Tous les champs sont optionnels, sauf
projectId
- fournissez uniquement les champs que vous souhaitez mettre à jour.
- Catégories : Utilisez les valeurs de l'énumération ProjectCategory pour le champ de catégorie.
- Gestion des images : Prend en charge le téléchargement, la mise à jour ou la suppression d'images de projet via ImageInput.
Opérations connexes