Utwórz nowy projekt

Aby utworzyć nowy projekt, możesz użyć następującej mutacji:

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

Przykład odpowiedzi

Po pomyślnym wykonaniu, mutacja zwróci szczegóły nowo utworzonego projektu:

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

Utwórz z szablonu

Aby utworzyć projekt z istniejącego szablonu, możesz dodać opcjonalny templateId do mutacji.

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

Zaawansowany przykład z szablonu

Oto kompletny przykład pokazujący wszystkie dostępne opcje podczas tworzenia z szablonu:

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

Sprawdź status tworzenia

Aby sprawdzić status tworzenia swojego projektu w kolejce, możesz użyć następującego zapytania:

query {
  copyProjectStatus {
    newProjectName
    isTemplate
    isActive
    queuePosition
    totalQueues
  }
}

To zapytanie zwróci status tworzenia twojego projektu w kolejce.

Parametry wejściowe

CreateProjectInput

Wartości ProjectCategory

TodoCoverConfigInput

Jeśli chcesz skonfigurować, jak działają obrazy okładek zadań w twoim projekcie, możesz podać parametr coverConfig:

Wartości ImageFit: COVER, CONTAIN, FILL, SCALE_DOWN

Wartości ImageSelectionType: FIRST (pierwszy obraz), LAST (ostatni obraz)

Wartości ImageSource: DESCRIPTION (z opisu zadania), COMMENTS (z komentarzy), CUSTOM_FIELD (z pola niestandardowego)

Pola odpowiedzi

Mutacja createProject zwraca obiekt projektu z następującymi dostępnymi polami:

Uwaga: Możesz zażądać dowolnej kombinacji tych pól w swojej odpowiedzi.

Ważne uwagi

• Musisz mieć dostęp na poziomie OWNER, ADMIN lub MEMBER do firmy, aby tworzyć projekty
• Podczas tworzenia z szablonu, szablon nie może mieć więcej niż 250 000 zadań
• Użytkownik tworzący jest automatycznie przypisywany jako OWNER projektu
• Nazwy projektów są automatycznie przycinane z białych znaków
• Parametr coverConfig obecnie działa tylko podczas tworzenia z szablonu

Odpowiedzi błędów

Firma nie znaleziona

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

Szablon nie znaleziony

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

Szablon za duży

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

Odrzucone uprawnienia

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