Maak een Nieuw Project

Om een nieuw project te maken, kun je de volgende mutatie gebruiken:

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

Voorbeeld van een Antwoord

Bij succes zal de mutatie de details van het nieuw aangemaakte project retourneren:

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

Maak vanuit een Sjabloon

Om een project vanuit een bestaand sjabloon te maken, kun je een optionele templateId aan de mutatie toevoegen.

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

Geavanceerd Voorbeeld met Sjabloon

Hier is een compleet voorbeeld dat alle beschikbare opties toont bij het maken vanuit een sjabloon:

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

Controleer de Creatiestatus

Om de status van je projectcreatie in de wachtrij te controleren, kun je de volgende query gebruiken:

query {
  copyProjectStatus {
    newProjectName
    isTemplate
    isActive
    queuePosition
    totalQueues
  }
}

Deze query zal de status van je projectcreatie in de wachtrij retourneren.

Invoervariabelen

CreateProjectInput

ProjectCategory Waarden

TodoCoverConfigInput

Als je wilt configureren hoe todo-coverafbeeldingen in je project werken, kun je de coverConfig parameter opgeven:

ImageFit Waarden: COVER, CONTAIN, FILL, SCALE_DOWN

ImageSelectionType Waarden: FIRST (eerste afbeelding), LAST (laatste afbeelding)

ImageSource Waarden: DESCRIPTION (van todo-beschrijving), COMMENTS (van opmerkingen), CUSTOM_FIELD (van een aangepast veld)

Antwoordvelden

De createProject mutatie retourneert een Project-object met de volgende beschikbare velden:

Opmerking: Je kunt elke combinatie van deze velden in je antwoord aanvragen.

Belangrijke Opmerkingen

• Je moet OWNER, ADMIN, of MEMBER niveau-toegang tot het bedrijf hebben om projecten te creëren
• Bij het maken vanuit een sjabloon mag het sjabloon niet meer dan 250.000 todo's bevatten
• De aanmaakgebruiker wordt automatisch toegewezen als de project OWNER
• Projectnamen worden automatisch ontdaan van spaties
• De coverConfig parameter is momenteel alleen functioneel bij het maken vanuit een sjabloon

Foutantwoorden

Bedrijf Niet Gevonden

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

Sjabloon Niet Gevonden

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

Sjabloon Te Groot

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

Toegang Geweigerd

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