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

EditProjectInput

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

Asistente IA

Las respuestas son generadas por IA y pueden contener errores.

¿Cómo puedo ayudarte?

Pregúntame cualquier cosa sobre Blue o esta documentación.

Enter para enviar • Shift+Enter para nueva línea • ⌘I para abrir