---

Lijst alle Projecten

De projectList query stelt je in staat om projecten op te halen met krachtige filter-, sorteermogelijkheden en paginering.

Basis Voorbeeld

query ProjectListQuery {
  projectList(filter: { companyIds: ["ENTER COMPANY ID"] }) {
    items {
      id
      uid
      slug
      name
      description
      archived
      color
      icon
      createdAt
      updatedAt
      allowNotification
      position
      unseenActivityCount
      todoListsMaxPosition
      lastAccessedAt
      isTemplate
      automationsCount
      totalFileCount
      totalFileSize
      todoAlias
    }
    pageInfo {
      totalPages
      totalItems
      page
      perPage
      hasNextPage
      hasPreviousPage
    }
  }
}

Geavanceerd Voorbeeld met Filteren en Sorteren

query FilteredProjectList {
  projectList(
    filter: {
      companyIds: ["company-123", "company-456"]
      archived: false
      isTemplate: false
      search: "marketing"
      inProject: true
      folderId: null  # Get root-level projects only
    }
    sort: [position_ASC, name_ASC]
    skip: 0
    take: 50
  ) {
    items {
      id
      name
      slug
      position
      archived
    }
    totalCount
    pageInfo {
      totalItems
      hasNextPage
    }
  }
}

Projectvelden

De volgende tabel beschrijft alle beschikbare velden voor elk project in de ProjectListQuery:

Veld	Type	Beschrijving
id	ID!	Unieke identificatie voor het project
uid	String!	Gebruiksvriendelijke unieke identificatie voor het project
slug	String!	URL-vriendelijke naam van het project
name	String!	Weergavenaam van het project
description	String	Korte beschrijving van het project
archived	Boolean	Boolean die aangeeft of het project gearchiveerd is
color	String	Kleur geassocieerd met het project voor visuele identificatie
icon	String	Pictogram geassocieerd met het project voor visuele identificatie
image	Image	Project omslagafbeelding object
createdAt	DateTime!	Tijdstempel wanneer het project is aangemaakt
updatedAt	DateTime!	Tijdstempel wanneer het project voor het laatst is bijgewerkt
allowNotification	Boolean!	Boolean die aangeeft of meldingen zijn ingeschakeld voor het project
position	Float!	Numerieke waarde die de positie van het project in een lijst vertegenwoordigt
unseenActivityCount	Int!	Aantal ongelezen activiteiten in het project
todoListsMaxPosition	Float!	Maximale positie waarde voor todo-lijsten in het project
lastAccessedAt	DateTime	Tijdstempel wanneer het project voor het laatst is geopend
isTemplate	Boolean!	Boolean die aangeeft of het project een sjabloon is
isOfficialTemplate	Boolean!	Boolean die aangeeft of dit een officiële Blue-sjabloon is
automationsCount(isActive: Boolean)	Int!	Aantal automatiseringen geassocieerd met het project
totalFileCount	Int	Totaal aantal bestanden in het project
totalFileSize	Float	Totale grootte van alle bestanden in het project (in bytes)
todoAlias	String	Aangepaste alias voor "todo" gebruikt in het project
category	ProjectCategory!	Projectcategorie (CRM, MARKETING, enz.)
hideEmailFromRoles	[UserAccessLevel!]	Array van rollen die e-mailadressen moeten verbergen
hideStatusUpdate	Boolean	Boolean voor het verbergen van statusupdates
company	Company!	Volledige bedrijfsobjectdetails
accessLevel(userId: String)	UserAccessLevel	Verkrijg het toegangsniveau van de gebruiker voor het specifieke project
folder	Folder	Map die dit project bevat
features	[ProjectFeature!]	Array van ingeschakelde projectfuncties
sequenceCustomField	CustomField	Aangepast veld gebruikt voor volgnummering
coverConfig	TodoCoverConfig	Configuratie voor todo omslagafbeeldingen
hideRecordCount	Boolean	Of recordaantallen moeten worden verborgen
showTimeSpentInTodoList	Boolean	Of de tijd die aan todo-lijsten is besteed moet worden weergegeven
showTimeSpentInProject	Boolean	Of de tijd die aan het project is besteed moet worden weergegeven
todoFields	[TodoField]	Aangepaste todo velddefinities

Opmerking: Je kunt elke combinatie van deze velden aanvragen in je GraphQL-query.

Paginering Velden

Het pageInfo object biedt pagineringsdetails voor de queryresultaten:

Veld	Type	Beschrijving
totalPages	Int	Totaal aantal pagina's met resultaten
totalItems	Int	Totaal aantal projecten dat overeenkomt met de query
page	Int	Huidig paginanummer
perPage	Int	Aantal items per pagina
hasNextPage	Boolean!	Boolean die aangeeft of er een volgende pagina met resultaten is
hasPreviousPage	Boolean!	Boolean die aangeeft of er een vorige pagina met resultaten is

Queryparameters

Filteropties (ProjectListFilter)

Parameter	Type	Vereist	Beschrijving
companyIds	[String!]!	✅ Ja	Array van bedrijfs-ID's of slugs om binnen te zoeken
ids	[String!]	Nee	Filter op specifieke project-ID's
archived	Boolean	Nee	Filter op gearchiveerde status (waar/onwaar)
isTemplate	Boolean	Nee	Filter sjabloonprojecten (waar/onwaar)
search	String	Nee	Zoek projecten op naam (hoofdlettergevoelig)
folderId	String	Nee	Filter op map-ID. Gebruik null voor projecten op rootniveau
inProject	Boolean	Nee	Filter op gebruikerslidmaatschap. Zie opmerking hieronder

Opmerking over inProject filter:

• true of undefined: Retourneert projecten waarvan de gebruiker lid is
• false: Retourneert projecten waar de gebruiker NIET in is (vereist toestemming van de bedrijfs eigenaar)
• Mapfiltering (folderId) werkt alleen wanneer inProject niet false is

Sorteeropties (ProjectSort)

Waarde	Beschrijving
id_ASC	Sorteer op ID oplopend
id_DESC	Sorteer op ID aflopend
name_ASC	Sorteer op naam oplopend (A-Z)
name_DESC	Sorteer op naam aflopend (Z-A)
createdAt_ASC	Sorteer op aanmaakdatum (oudste eerst)
createdAt_DESC	Sorteer op aanmaakdatum (nieuwste eerst)
updatedAt_ASC	Sorteer op laatste update (oudste eerst)
updatedAt_DESC	Sorteer op laatste update (nieuwste eerst)
position_ASC	Sorteer op positie oplopend*
position_DESC	Sorteer op positie aflopend*

*Positiesortering is alleen beschikbaar wanneer projecten worden bekeken waarvan de gebruiker lid is (inProject !== false)

Paginering Parameters

Parameter	Type	Standaard	Beschrijving
skip	Int	0	Aantal records om over te slaan
take	Int	20	Aantal records om terug te geven

Belangrijke Opmerkingen

1. Standaardgedrag voor niet-lid projecten (inProject: false):

   • Sluit gearchiveerde projecten uit, tenzij archived filter expliciet is ingesteld
   • Sluit sjabloonprojecten uit, tenzij isTemplate filter expliciet is ingesteld

2. Beperkingen van mapfiltering:

   • Werkt alleen bij het tonen van projecten van de gebruiker
   • Kan niet worden gebruikt met inProject: false
   • Gebruik folderId: null om projecten te krijgen die niet in een map staan

3. Sorteerfallback:

   • Positiesortering wordt genegeerd bij het bekijken van niet-lid projecten
   • Valt terug op naam sortering in dergelijke gevallen

4. Verouderde parameters:

   • orderBy, after, before, first, last zijn verouderd
   • Gebruik sort, skip, en take in plaats daarvan