Magidoc

getUserTags
Query

Find user/placeholder assignments for a given resourcing role or custom tag.

Call getResourceTags first to discover available roles/tags and their _id values, then pass resourceTagId here to retrieve everyone assigned to that role or tag.

Parameters:

  • workspaceId: The ID of the workspace (required)
  • resourceTagId: Filter to a specific role or tag _id (obtain from getResourceTags)
  • tagType: Filter by assignment kind. • role — resourcing role assignments • custom — custom tag assignments
  • userId: Narrow results to a single user's assignments
  • placeholderId: Narrow results to a single placeholder's assignments

Returns: Array of UserTag records. Each record contains: • userId (set when the assignee is a real workspace user) • placeholderId (set when the assignee is a resourcing placeholder) • resourceTagId — the tag/role that was assigned • tagType — role or custom

Typical flow:

  1. getResourceTags(workspaceId, tagType: role) → find resourceTagId for e.g. "Designer"
  2. getUserTags(workspaceId, resourceTagId: , tagType: role) → list all users/placeholders with that role

Arguments

#

workspaceId

ID !
Non-null

userId

placeholderId

resourceTagId

Response

#

Returns [UserTag !].

Example

#