Skapa projekt med Blue API.


Skapa ett Nytt Projekt

För att skapa ett nytt projekt kan du använda följande 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
  }
}
icon: lightbulb

Kom ihåg att inkludera de nödvändiga rubrikerna i din begäran:

- `X-Bloo-Token-ID`: Ditt API-token-ID
- `X-Bloo-Token-Secret`: Ditt API-token-hemlighet
- `X-Bloo-Company-ID`: Ditt företags-ID
- `Content-Type: application/json`

Exempel på Svar

Vid framgång kommer mutation att returnera detaljer om det nyss skapade projektet:

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

Skapa från en Mall

För att skapa ett projekt från en befintlig mall kan du lägga till en valfri templateId till mutation.

mutation {
  createProject(
    input: {
      templateId: "YOUR TEMPLATE ID OR SLUG"
      name: "YOUR PROJECT NEW NAME"
      companyId: "YOUR COMPANY ID OR SLUG"
    }
  ) {
    id
  }
}
Att skapa ett projekt från en mall kommer inte att skapa projektet omedelbart. Istället kommer din projekt skapelse att sättas i kö.

Avancerat Exempel med Mall

Här är ett komplett exempel som visar alla tillgängliga alternativ när du skapar från en mall:

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
  }
}
icon: warning
`coverConfig` parametern fungerar för närvarande endast när du skapar ett projekt från en mall. För projekt som skapats från grunden måste du använda `editProject` mutation efter skapelsen för att konfigurera todo omslagsbilder.

Kontrollera Skapelsestatus

För att kontrollera statusen för din projekt skapelse i kön kan du använda följande fråga:

query {
  copyProjectStatus {
    newProjectName
    isTemplate
    isActive
    queuePosition
    totalQueues
  }
}

Denna fråga kommer att returnera statusen för din projekt skapelse i kön.

Indata Parametrar

CreateProjectInput

Parameter Typ Obligatorisk Beskrivning
name String ✅ Ja Projektets namn. URL:er kommer att tas bort från namnet.
companyId String ✅ Ja ID eller slug för företaget där projektet kommer att skapas.
description String Nej En beskrivning av projektet.
color String Nej Projektfärg i hex-format (t.ex. "#3B82F6").
icon String Nej Ikonidentifierare för projektet (t.ex. "portfölj", "raket").
category ProjectCategory Nej Projektkategori. Standardvärde är GENERAL om inget anges.
templateId String Nej ID för ett befintligt projekt att använda som mall.
coverConfig TodoCoverConfigInput Nej Konfiguration för todo omslagsbilder (fungerar för närvarande endast med mallbaserad skapelse).

ProjectCategory Värden

Värde Beskrivning
CRM Projekt för kundrelationshantering
CROSS_FUNCTIONAL Projekt för tvärfunktionella team
CUSTOMER_SUCCESS Initiativ för kundframgång
DESIGN Design- och kreativa projekt
ENGINEERING Ingenjörs- och utvecklingsprojekt
GENERAL Allmänna projekt (standard)
HR Projekt för personalresurser
IT IT-projekt
MARKETING Marknadsföringskampanjer och initiativ
OPERATIONS Projekt för drift och logistik
PRODUCT Projekt för produktledning
SALES Försäljnings- och affärsutvecklingsprojekt

TodoCoverConfigInput

Om du vill konfigurera hur todo omslagsbilder fungerar i ditt projekt kan du ange coverConfig parametern:

Parameter Typ Obligatorisk Beskrivning
enabled Boolean ✅ Ja Om omslagsbilder är aktiverade för todos
fit ImageFit ✅ Ja Hur bilder ska passa i omslagsområdet
imageSelectionType ImageSelectionType ✅ Ja Vilken bild som ska väljas från tillgängliga alternativ
source ImageSource ✅ Ja Var bilderna ska hämtas ifrån
sourceId String Nej Specifik källidentifierare (t.ex. anpassat fält-ID)

ImageFit Värden: COVER, CONTAIN, FILL, SCALE_DOWN

ImageSelectionType Värden: FIRST (första bilden), LAST (sista bilden)

ImageSource Värden: DESCRIPTION (från todo-beskrivning), COMMENTS (från kommentarer), CUSTOM_FIELD (från ett anpassat fält)

Svarsfält

createProject mutation returnerar ett Projektobjekt med följande tillgängliga fält:

Fält Typ Beskrivning
id ID! Unik identifierare för projektet
name String! Projektets namn
slug String! URL-vänlig projektidentifierare
description String Projektbeskrivning
color String Projektfärg i hex-format
icon String Ikonidentifierare
category ProjectCategory Projektkategori enum-värde
companyId String! ID för företaget
createdAt DateTime! Tidsstämpel för skapelse
updatedAt DateTime! Tidsstämpel för senaste uppdatering
archived Boolean! Om projektet är arkiverat
isTemplate Boolean! Om detta är ett mallprojekt

Obs: Du kan begära vilken kombination av dessa fält i ditt svar.

Viktiga Noter

  • Du måste ha OWNER, ADMIN, eller MEMBER nivååtkomst till företaget för att skapa projekt
  • När du skapar från en mall får mallen inte ha mer än 250 000 todos
  • Den skapande användaren tilldelas automatiskt som projektets OWNER
  • Projektens namn trimmas automatiskt från blanksteg
  • coverConfig parametern är för närvarande endast funktionell när du skapar från en mall

Fel Svar

Företag Inte Hittat

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

Mall Inte Hittad

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

Mall För Stor

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

Behörighet Nekad

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

AI-assistent

Svar genereras med hjälp av AI och kan innehålla misstag.

Hur kan jag hjälpa dig?

Fråga mig vad som helst om Blue eller denna dokumentation.

Tryck Enter för att skicka • Shift+Enter för ny rad • ⌘I för att öppna