TimeZest Resources

TimeZest Resources

The resources domain is TimeZest's combined view of everything bookable — agents and teams together in one list. It is the right starting point when a dispatcher has not named a specific technician or team and you need to survey the pool first.

Domain & Tools

Enter the domain with timezest_navigate to resources.

Tool	Purpose
timezest_resources_list	List all resources (agents and teams) available for scheduling

timezest_resources_list accepts:

• pageSize — results per page (1–100, default 50)
• type — agent or team to filter by resource type
• filter — a TQL filter string (e.g. active:true)

Each resource entry indicates whether it is an agent or a team, so a single call surveys the whole bookable surface.

Resources vs Agents/Teams Domains

Use the resources domain when	Use agents / teams when
You want a combined survey of everything bookable	You already know it is an agent or a team
The dispatcher said "whoever's available"	The dispatcher named a person or team
Producing a roster or capacity report	Fetching detail for one named resource

timezest_resources_list is list-only — there is no timezest_resources_get. To fetch full detail for one resource, drop into the agents or teams domain and use its _get tool.

Common Workflows

Survey the bookable pool

1. timezest_navigate to resources.
2. Call timezest_resources_list with filter: "active:true".
3. Group the result by type (agents vs teams) to give the dispatcher the full menu.

Resolve a vague request

1. List resources with active:true.
2. Narrow with type: "agent" or type: "team" if the dispatcher leaned one way.
3. Once a candidate is chosen, switch to the agents or teams domain for full detail before booking.

Build a resource roster

1. List with pageSize: 100 to capture the full pool.
2. Report a roster: each resource's name, type, and active status.

Edge Cases

• List-only domain — There is no get-by-id here; use agents or teams for detail.
• Mixed types — A single result set contains both agents and teams; always check the type of each entry before treating it as one or the other.
• Pagination — Large MSPs exceed 50 resources; raise pageSize or page through for a complete roster.

Best Practices

• Use resources for surveys and rosters; use agents / teams for named lookups and detail.
• Always filter active:true for booking work — inactive resources cannot be scheduled.
• Treat the resource list as the menu, not the booking target — the actual scheduling request still books a specific agentId or teamId.

Related Skills

• agents-and-teams — Detail lookups for a named agent or team
• scheduling — Booking technicians against PSA tickets