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
}
}
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
}
}
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
}
}
`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
, ellerMEMBER
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"
}
}]
}