Criar um Novo Projeto

Para criar um novo projeto, você pode usar a seguinte mutação:

mutation {
  createProject(
    input: {
      name: "YOUR PROJECT NEW NAME"
      companyId: "YOUR COMPANY ID OR SLUG"
      description: "Project description"
      color: "#3B82F6"
      icon: "briefcase"
      category: GENERAL
    }
  ) {
    id
    name
    slug
    description
    color
    icon
    category
  }
}

Exemplo de Resposta

Em caso de sucesso, a mutação retornará os detalhes do projeto recém-criado:

{
  "data": {
    "createProject": {
      "id": "newly-created-project-id",
      "name": "YOUR PROJECT NEW NAME",
      "slug": "your-project-new-name",
      "description": "Project description",
      "color": "#3B82F6",
      "icon": "briefcase",
      "category": "GENERAL"
    }
  }
}

Criar a Partir de um Modelo

Para criar um projeto a partir de um modelo existente, você pode adicionar um templateId opcional à mutação.

mutation {
  createProject(
    input: {
      templateId: "YOUR TEMPLATE ID OR SLUG"
      name: "YOUR PROJECT NEW NAME"
      companyId: "YOUR COMPANY ID OR SLUG"
    }
  ) {
    id
  }
}

Exemplo Avançado com Modelo

Aqui está um exemplo completo mostrando todas as opções disponíveis ao criar a partir de um modelo:

mutation {
  createProject(
    input: {
      templateId: "marketing-template"
      name: "Q1 Marketing Campaign"
      companyId: "acme-corp"
      description: "Marketing initiatives for Q1 2024"
      color: "#10B981"
      icon: "megaphone"
      category: MARKETING
      coverConfig: {
        enabled: true
        fit: COVER
        imageSelectionType: FIRST
        source: DESCRIPTION
      }
    }
  ) {
    id
    name
    slug
    description
    color
    icon
    category
  }
}

Verificar Status da Criação

Para verificar o status da criação do seu projeto na fila, você pode usar a seguinte consulta:

query {
  copyProjectStatus {
    newProjectName
    isTemplate
    isActive
    queuePosition
    totalQueues
  }
}

Essa consulta retornará o status da criação do seu projeto na fila.

Parâmetros de Entrada

CreateProjectInput

Valores de ProjectCategory

TodoCoverConfigInput

Se você quiser configurar como as imagens de capa de tarefas funcionam em seu projeto, pode fornecer o parâmetro coverConfig:

Valores de ImageFit: COVER, CONTAIN, FILL, SCALE_DOWN

Valores de ImageSelectionType: FIRST (primeira imagem), LAST (última imagem)

Valores de ImageSource: DESCRIPTION (da descrição da tarefa), COMMENTS (dos comentários), CUSTOM_FIELD (de um campo personalizado)

Campos de Resposta

A mutação createProject retorna um objeto Project com os seguintes campos disponíveis:

Nota: Você pode solicitar qualquer combinação desses campos em sua resposta.

Notas Importantes

• Você deve ter acesso de nível OWNER, ADMIN ou MEMBER à empresa para criar projetos
• Ao criar a partir de um modelo, o modelo não pode ter mais de 250.000 tarefas
• O usuário que cria é automaticamente designado como o OWNER do projeto
• Os nomes dos projetos são automaticamente removidos de espaços em branco
• O parâmetro coverConfig atualmente só é funcional ao criar a partir de um modelo

Respostas de Erro

Empresa Não Encontrada

{
  "errors": [{
    "message": "Company not found",
    "extensions": {
      "code": "NOT_FOUND"
    }
  }]
}

Modelo Não Encontrado

{
  "errors": [{
    "message": "Template not found",
    "extensions": {
      "code": "NOT_FOUND"
    }
  }]
}

Modelo Muito Grande

{
  "errors": [{
    "message": "Template cannot have more than 250000 todos",
    "extensions": {
      "code": "VALIDATION_ERROR"
    }
  }]
}

Permissão Negada

{
  "errors": [{
    "message": "You do not have permission to create projects in this company",
    "extensions": {
      "code": "FORBIDDEN"
    }
  }]
}