Create a New Project

To create a new project, you can use the following mutation:

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

Response Example

Upon success, the mutation will return the newly created project details:

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

Create from a Template

To create a project from an existing template, you can add an optional templateId to the mutation.

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

Advanced Example with Template

Here's a complete example showing all available options when creating from a template:

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

Check Creation Status

To check the status of your project creation in the queue, you can use the following query:

query {
  copyProjectStatus {
    newProjectName
    isTemplate
    isActive
    queuePosition
    totalQueues
  }
}

This query will return the status of your project creation in the queue.

Input Parameters

CreateProjectInput

ProjectCategory Values

TodoCoverConfigInput

If you want to configure how todo cover images work in your project, you can provide the coverConfig parameter:

ImageFit Values: COVER, CONTAIN, FILL, SCALE_DOWN

ImageSelectionType Values: FIRST (first image), LAST (last image)

ImageSource Values: DESCRIPTION (from todo description), COMMENTS (from comments), CUSTOM_FIELD (from a custom field)

Response Fields

The createProject mutation returns a Project object with the following available fields:

Note: You can request any combination of these fields in your response.

Important Notes

• You must have OWNER, ADMIN, or MEMBER level access to the company to create projects
• When creating from a template, the template cannot have more than 250,000 todos
• The creating user is automatically assigned as the project OWNER
• Project names are automatically trimmed of whitespace
• The coverConfig parameter is currently only functional when creating from a template

Error Responses

Company Not Found

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

Template Not Found

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

Template Too Large

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

Permission Denied

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