Actualiza el nombre de un proyecto existente en Blue
Renombrar un Proyecto
Actualiza el nombre y otras propiedades de un proyecto existente. Cuando se cambia el nombre, el slug del proyecto se regenerará automáticamente en función del nuevo nombre.
Ejemplo Básico
mutation RenameProject {
editProject(input: {
projectId: "project_abc123"
name: "Q2 Marketing Campaign"
}) {
id
name
slug
}
}
Ejemplo Avanzado
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
}
}
Parámetros de Entrada
Parámetro |
Tipo |
Requerido |
Descripción |
projectId |
String! |
✅ Sí |
El ID del proyecto a editar |
name |
String |
No |
El nuevo nombre para el proyecto |
slug |
String |
No |
Slug personalizado amigable con URL (se genera automáticamente si no se proporciona) |
description |
String |
No |
Descripción del proyecto |
color |
String |
No |
Código de color hexadecimal para el proyecto (por ejemplo, #3B82F6) |
icon |
String |
No |
Identificador de icono para el proyecto |
category |
ProjectCategory |
No |
Categoría del proyecto |
todoAlias |
String |
No |
Nombre personalizado para los registros en este proyecto |
hideRecordCount |
Boolean |
No |
Si se deben ocultar los recuentos de registros en la interfaz de usuario |
showTimeSpentInTodoList |
Boolean |
No |
Mostrar seguimiento de tiempo en listas |
showTimeSpentInProject |
Boolean |
No |
Mostrar seguimiento de tiempo en la vista del proyecto |
image |
ImageInput |
No |
Imagen/cobertura del proyecto |
todoFields |
[TodoFieldInput] |
No |
Configuraciones de campos personalizados |
coverConfig |
TodoCoverConfigInput |
No |
Configuración de visualización de la portada |
features |
[ProjectFeatureInput] |
No |
Alternancias de funciones para el proyecto |
sequenceCustomFieldId |
String |
No |
Campo personalizado a utilizar para la secuenciación de registros |
Valores de ProjectCategory
Valor |
Descripción |
PERSONAL |
Proyectos personales |
BUSINESS |
Proyectos de negocios |
MARKETING |
Campañas de marketing |
DEVELOPMENT |
Proyectos de desarrollo |
DESIGN |
Proyectos de diseño |
OPERATIONS |
Tareas operativas |
SALES |
Actividades de ventas |
SUPPORT |
Tickets de soporte |
FINANCE |
Seguimiento financiero |
HR |
Recursos humanos |
LEGAL |
Asuntos legales |
PROCUREMENT |
Procesos de adquisición |
Campos de Respuesta
Devuelve el objeto Proyecto actualizado con todos los campos. Los campos clave incluyen:
Campo |
Tipo |
Descripción |
id |
String! |
ID del proyecto |
name |
String! |
Nombre del proyecto |
slug |
String! |
Slug amigable con URL |
description |
String |
Descripción del proyecto |
color |
String |
Código de color hexadecimal |
icon |
String |
Identificador de icono |
category |
ProjectCategory |
Categoría del proyecto |
todoAlias |
String |
Nombre de registro personalizado |
hideRecordCount |
Boolean! |
Configuración de visibilidad del recuento de registros |
createdAt |
DateTime! |
Marca de tiempo de creación |
updatedAt |
DateTime! |
Marca de tiempo de la última actualización |
Permisos Requeridos
Rol |
Puede Editar Proyecto |
OWNER |
✅ Sí |
ADMIN |
✅ Sí |
MEMBER |
❌ No |
Respuestas de Error
Proyecto No Encontrado
{
"errors": [{
"message": "Project was not found.",
"extensions": {
"code": "PROJECT_NOT_FOUND"
}
}]
}
Permisos Insuficientes
{
"errors": [{
"message": "You don't have permission to edit this project",
"extensions": {
"code": "FORBIDDEN"
}
}]
}
Notas Importantes
- Generación de Slug: Los slugs de los proyectos se generan automáticamente cuando se cambian los nombres. También puedes proporcionar un slug personalizado.
- Conflictos de Slug: Si un slug entra en conflicto con los slugs de la empresa existentes, el sistema añadirá números (por ejemplo,
my-project-1
).
- Desinfección de HTML: Las etiquetas HTML se eliminan automáticamente de los campos de descripción por razones de seguridad.
- Actualizaciones Parciales: Todos los campos son opcionales excepto
projectId
- solo proporciona los campos que deseas actualizar.
- Categorías: Utiliza los valores del enum ProjectCategory para el campo de categoría.
- Manejo de Imágenes: Soporta la carga, actualización o eliminación de imágenes de proyectos a través de ImageInput.
Operaciones Relacionadas