Magidoc

getResourceTags
Query

List resource tags (resourcing roles or custom user tags) available in a workspace.

Use this FIRST when the user asks about roles, resourcing roles, or custom tags — you need the tag _id values returned here before you can look up which users or placeholders hold a given role or tag via getUserTags.

Parameters:

  • workspaceId: The ID of the workspace (required)
  • tagType: Filter by tag kind. • role — resourcing roles used in the resourcing / capacity-planning module (e.g. "Designer", "Engineer") • custom — workspace-defined custom tags applied to users Leave unset to return all tag types.
  • searchParams: Optional name search to narrow results
  • first / after: Pagination cursors (default page size applies)

Returns: A paginated connection of ResourceTag objects, each with _id, name, and type. After finding the right tag _id, call getUserTags with that resourceTagId to get the users or placeholders assigned to it.

Arguments

#

workspaceId

ID !
Non-null

first = 20

last

before

after

searchParams

specificIds = []

[ID !]

excludedIds = []

[ID !]

Response

#

Returns ResourceTagConnection !.

Example

#