Создание нового проекта

Чтобы создать новый проект, вы можете использовать следующую мутацию:

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

Пример ответа

При успешном выполнении мутация вернет детали вновь созданного проекта:

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

Создание из шаблона

Чтобы создать проект из существующего шаблона, вы можете добавить необязательный templateId к мутации.

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

Расширенный пример с шаблоном

Вот полный пример, показывающий все доступные параметры при создании из шаблона:

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

Проверка статуса создания

Чтобы проверить статус создания вашего проекта в очереди, вы можете использовать следующий запрос:

query {
  copyProjectStatus {
    newProjectName
    isTemplate
    isActive
    queuePosition
    totalQueues
  }
}

Этот запрос вернет статус создания вашего проекта в очереди.

Входные параметры

CreateProjectInput

Значения ProjectCategory

TodoCoverConfigInput

Если вы хотите настроить, как работают обложки задач в вашем проекте, вы можете предоставить параметр coverConfig:

Значения ImageFit: COVER, CONTAIN, FILL, SCALE_DOWN

Значения ImageSelectionType: FIRST (первое изображение), LAST (последнее изображение)

Значения ImageSource: DESCRIPTION (из описания задачи), COMMENTS (из комментариев), CUSTOM_FIELD (из пользовательского поля)

Поля ответа

Мутация createProject возвращает объект Project с следующими доступными полями:

Примечание: Вы можете запросить любую комбинацию этих полей в вашем ответе.

Важные заметки

• У вас должен быть доступ уровня OWNER, ADMIN или MEMBER к компании, чтобы создавать проекты
• При создании из шаблона шаблон не может содержать более 250,000 задач
• Создающий пользователь автоматически назначается как OWNER проекта
• Названия проектов автоматически очищаются от пробелов
• Параметр coverConfig в настоящее время работает только при создании из шаблона

Ошибки ответов

Компания не найдена

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

Шаблон не найден

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

Шаблон слишком большой

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

Доступ запрещен

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