Crear un Nuevo Proyecto

Para crear un nuevo proyecto, puedes usar la siguiente mutación:

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
  }
}

Ejemplo de Respuesta

Al tener éxito, la mutación devolverá los detalles del proyecto recién creado:

{
  "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"
    }
  }
}

Crear desde una Plantilla

Para crear un proyecto a partir de una plantilla existente, puedes agregar un templateId opcional a la mutación.

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

Ejemplo Avanzado con Plantilla

Aquí hay un ejemplo completo que muestra todas las opciones disponibles al crear desde una plantilla:

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 el Estado de Creación

Para verificar el estado de la creación de tu proyecto en la cola, puedes usar la siguiente consulta:

query {
  copyProjectStatus {
    newProjectName
    isTemplate
    isActive
    queuePosition
    totalQueues
  }
}

Esta consulta devolverá el estado de la creación de tu proyecto en la cola.

Parámetros de Entrada

CreateProjectInput

Valores de ProjectCategory

TodoCoverConfigInput

Si deseas configurar cómo funcionan las imágenes de portada de todo en tu proyecto, puedes proporcionar el parámetro coverConfig:

Valores de ImageFit: COVER, CONTAIN, FILL, SCALE_DOWN

Valores de ImageSelectionType: FIRST (primera imagen), LAST (última imagen)

Valores de ImageSource: DESCRIPTION (de la descripción del todo), COMMENTS (de comentarios), CUSTOM_FIELD (de un campo personalizado)

Campos de Respuesta

La mutación createProject devuelve un objeto Project con los siguientes campos disponibles:

Nota: Puedes solicitar cualquier combinación de estos campos en tu respuesta.

Notas Importantes

• Debes tener acceso de nivel OWNER, ADMIN, o MEMBER a la empresa para crear proyectos
• Al crear desde una plantilla, la plantilla no puede tener más de 250,000 todos
• El usuario que crea se asigna automáticamente como el OWNER del proyecto
• Los nombres de los proyectos se recortan automáticamente de espacios en blanco
• El coverConfig parámetro actualmente solo es funcional al crear desde una plantilla

Respuestas de Error

Empresa No Encontrada

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

Plantilla No Encontrada

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

Plantilla Demasiado Grande

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

Permiso Denegado

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