Créer un nouveau projet

Pour créer un nouveau projet, vous pouvez utiliser la mutation suivante :

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

Exemple de réponse

En cas de succès, la mutation renverra les détails du projet nouvellement créé :

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

Créer à partir d'un modèle

Pour créer un projet à partir d'un modèle existant, vous pouvez ajouter un templateId optionnel à la mutation.

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

Exemple avancé avec modèle

Voici un exemple complet montrant toutes les options disponibles lors de la création à partir d'un modèle :

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

Vérifier l'état de création

Pour vérifier l'état de votre création de projet dans la file d'attente, vous pouvez utiliser la requête suivante :

query {
  copyProjectStatus {
    newProjectName
    isTemplate
    isActive
    queuePosition
    totalQueues
  }
}

Cette requête renverra l'état de votre création de projet dans la file d'attente.

Paramètres d'entrée

CreateProjectInput

Valeurs de ProjectCategory

TodoCoverConfigInput

Si vous souhaitez configurer le fonctionnement des images de couverture des tâches dans votre projet, vous pouvez fournir le paramètre coverConfig :

Valeurs de ImageFit : COVER, CONTAIN, FILL, SCALE_DOWN

Valeurs de ImageSelectionType : FIRST (première image), LAST (dernière image)

Valeurs de ImageSource : DESCRIPTION (depuis la description de la tâche), COMMENTS (depuis les commentaires), CUSTOM_FIELD (depuis un champ personnalisé)

Champs de réponse

La mutation createProject renvoie un objet Projet avec les champs disponibles suivants :

Remarque : Vous pouvez demander n'importe quelle combinaison de ces champs dans votre réponse.

Remarques importantes

• Vous devez avoir un accès de niveau OWNER, ADMIN ou MEMBER à l'entreprise pour créer des projets
• Lors de la création à partir d'un modèle, le modèle ne peut pas avoir plus de 250 000 tâches
• L'utilisateur créant est automatiquement assigné comme OWNER du projet
• Les noms de projet sont automatiquement dépouillés des espaces
• Le paramètre coverConfig ne fonctionne actuellement que lors de la création à partir d'un modèle

Réponses d'erreur

Entreprise non trouvée

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

Modèle non trouvé

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

Modèle trop volumineux

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

Permission refusée

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