Renomear Projeto

Atualize o nome de um projeto existente no Blue

Copy page in markdown for LLMs

Renomear um Projeto

Atualiza o nome e outras propriedades de um projeto existente. Quando o nome é alterado, o slug do projeto será regenerado automaticamente com base no novo nome.

Exemplo Básico

mutation RenameProject {
  editProject(input: {
    projectId: "project_abc123"
    name: "Q2 Marketing Campaign"
  }) {
    id
    name
    slug
  }
}

Exemplo Avançado

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	Obrigatório	Descrição
`projectId`	String!	✅ Sim	O ID do projeto a ser editado
`name`	String	Não	O novo nome para o projeto
`slug`	String	Não	Slug amigável para URL (gerado automaticamente se não fornecido)
`description`	String	Não	Descrição do projeto
`color`	String	Não	Código de cor hexadecimal para o projeto (ex: #3B82F6)
`icon`	String	Não	Identificador do ícone para o projeto
`category`	ProjectCategory	Não	Categoria do projeto
`todoAlias`	String	Não	Nome personalizado para registros neste projeto
`hideRecordCount`	Boolean	Não	Se deve ocultar contagens de registros na interface
`showTimeSpentInTodoList`	Boolean	Não	Exibir rastreamento de tempo em listas
`showTimeSpentInProject`	Boolean	Não	Exibir rastreamento de tempo na visualização do projeto
`image`	ImageInput	Não	Imagem/capa do projeto
`todoFields`	[TodoFieldInput]	Não	Configurações de campos personalizados
`coverConfig`	TodoCoverConfigInput	Não	Configuração de exibição da capa
`features`	[ProjectFeatureInput]	Não	Alternâncias de recursos para o projeto
`sequenceCustomFieldId`	String	Não	Campo personalizado a ser usado para sequenciamento de registros

Valores de ProjectCategory

Valor	Descrição
`PERSONAL`	Projetos pessoais
`BUSINESS`	Projetos de negócios
`MARKETING`	Campanhas de marketing
`DEVELOPMENT`	Projetos de desenvolvimento
`DESIGN`	Projetos de design
`OPERATIONS`	Tarefas operacionais
`SALES`	Atividades de vendas
`SUPPORT`	Chamadas de suporte
`FINANCE`	Acompanhamento financeiro
`HR`	Recursos humanos
`LEGAL`	Questões legais
`PROCUREMENT`	Processos de aquisição

Campos de Resposta

Retorna o objeto Projeto atualizado com todos os campos. Os campos principais incluem:

Campo	Tipo	Descrição
`id`	String!	ID do projeto
`name`	String!	Nome do projeto
`slug`	String!	Slug amigável para URL
`description`	String	Descrição do projeto
`color`	String	Código de cor hexadecimal
`icon`	String	Identificador do ícone
`category`	ProjectCategory	Categoria do projeto
`todoAlias`	String	Nome personalizado do registro
`hideRecordCount`	Boolean!	Configuração de visibilidade da contagem de registros
`createdAt`	DateTime!	Timestamp de criação
`updatedAt`	DateTime!	Timestamp da última atualização

Permissões Necessárias

Papel	Pode Editar Projeto
`OWNER`	✅ Sim
`ADMIN`	✅ Sim
`MEMBER`	❌ Não

Respostas de Erro

Projeto Não Encontrado

{
  "errors": [{
    "message": "Project was not found.",
    "extensions": {
      "code": "PROJECT_NOT_FOUND"
    }
  }]
}

Permissões Insuficientes

{
  "errors": [{
    "message": "You don't have permission to edit this project",
    "extensions": {
      "code": "FORBIDDEN"
    }
  }]
}

Notas Importantes

Geração de Slug: Slugs de projeto são gerados automaticamente quando os nomes mudam. Você também pode fornecer um slug personalizado.
Conflitos de Slug: Se um slug conflitar com slugs de empresa existentes, o sistema anexará números (ex: my-project-1).
Sanitização de HTML: Tags HTML são automaticamente removidas dos campos de descrição por motivos de segurança.
Atualizações Parciais: Todos os campos são opcionais, exceto projectId - forneça apenas os campos que deseja atualizar.
Categorias: Use os valores do enum ProjectCategory para o campo de categoria.
Manipulação de Imagem: Suporta upload, atualização ou remoção de imagens de projeto via ImageInput.

Operações Relacionadas

Criar Projeto - Crie um novo projeto
Listar Projetos - Obtenha todos os projetos
Excluir Projeto - Exclua um projeto
Arquivar Projeto - Arquivar/desarquivar projetos