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:
- getResourceTags(workspaceId, tagType: role) → find resourceTagId for e.g. "Designer"
- getUserTags(workspaceId, resourceTagId:
, tagType: role) → list all users/placeholders with that role
Arguments
#
Response
#
Returns [UserTag !].
Example
#
Previous
getTimesheetsToApprove
Next
getUserTimeEntries