Magidoc

getProjects
Query

Lists projects the caller can access, with search, filters, sorting, and cursor pagination. Supports specific IDs, ownership, hierarchy, archive and template state, and custom-field filters.

Arguments

#

workspaceId

ID !
Non-null

workspaceIds

[ID !]

When provided, overrides workspaceId as the set of workspaces to fetch projects from. Empty array means all accessible workspaces. Each workspace is access-checked independently. Used by dashboard cross-workspace filters.

first = 20

last

before

after

searchParams

specificIds

[ID !]

excludedIds

[ID !]

includeTemplates

archived

templatesOnly

includePublic = true

publicOnly

includePrivate

When true, workspace system admins, or workspace admins with enterpriseSecurity and allowAdminsToSeeAllProjects enabled, can bypass project membership filters.

includeReadOnly

includeArchived

rootProjectId

userId

User whose share and public-access rules define visibility; this does not filter project ownership.

ownerIds

[ID !]

Return projects owned by at least one of these user IDs.

customFieldFilters

Distinct custom fields are ANDed; entries for the same customFieldId are ORed. Duplicate stored values for one field are resolved last-wins.

isDraftMode

Filter by draft mode. Draft projects are hidden from most Hive views until published. true returns only draft projects, false returns only published (non-draft) projects, omitted returns both. Every returned project also carries isDraftMode.

Response

#

Returns ProjectConnection !.

Example

#