Crea un Nuovo Progetto

Per creare un nuovo progetto, puoi utilizzare la seguente mutazione:

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

Esempio di Risposta

In caso di successo, la mutazione restituirà i dettagli del progetto appena creato:

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

Crea da un Modello

Per creare un progetto da un modello esistente, puoi aggiungere un templateId opzionale alla mutazione.

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

Esempio Avanzato con Modello

Ecco un esempio completo che mostra tutte le opzioni disponibili quando si crea da un modello:

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

Controlla lo Stato di Creazione

Per controllare lo stato della creazione del tuo progetto in coda, puoi utilizzare la seguente query:

query {
  copyProjectStatus {
    newProjectName
    isTemplate
    isActive
    queuePosition
    totalQueues
  }
}

Questa query restituirà lo stato della creazione del tuo progetto in coda.

Parametri di Input

CreateProjectInput

Valori di ProjectCategory

TodoCoverConfigInput

Se desideri configurare come funzionano le immagini di copertura dei todo nel tuo progetto, puoi fornire il parametro coverConfig:

Valori di ImageFit: COVER, CONTAIN, FILL, SCALE_DOWN

Valori di ImageSelectionType: FIRST (prima immagine), LAST (ultima immagine)

Valori di ImageSource: DESCRIPTION (dalla descrizione del todo), COMMENTS (dai commenti), CUSTOM_FIELD (da un campo personalizzato)

Campi di Risposta

La mutazione createProject restituisce un oggetto Project con i seguenti campi disponibili:

Nota: Puoi richiedere qualsiasi combinazione di questi campi nella tua risposta.

Note Importanti

• Devi avere accesso di livello OWNER, ADMIN o MEMBER all'azienda per creare progetti
• Quando crei da un modello, il modello non può avere più di 250.000 todo
• L'utente che crea è automaticamente assegnato come OWNER del progetto
• I nomi dei progetti vengono automaticamente trimmati dagli spazi bianchi
• Il parametro coverConfig attualmente funziona solo quando si crea da un modello

Risposte di Errore

Azienda Non Trovata

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

Modello Non Trovato

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

Modello Troppo Grande

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

Permesso Negato

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