---

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