Skip to main content
Administrator Guide
Last Updated: 2026-11-13
Self-Service Agent Tools

Self-Service Agent Tools

Each Self-Service Agent skill is made up of different actions a user can take, called tools. Tools are an abstraction layer over Workday APIs that the agent calls to perform tasks.
This topic contains Self-Service Agent tool names, descriptions, and limitations, grouped by the skill they're associated. You can also access the
View Security for Agent Skill
report to view this information, along with security requirements for each tool.
Skill and tool configuration changes can take up to 10 minutes to take effect for Self-Service agent due to caching.

ESS - Financial Management - Base

Tool
Description
Limitations
find_projects
Enables users to search for projects they have security access to. Users can search by name, Project ID, tenant-configured lifecycle statuses, and project start or end date ranges. Users can also search for opportunity, billable, and non-billable projects. Results return only active projects unless otherwise specified. Results include basic project header information. When the search parameters match a large number of projects, the tool may return a partial list and request that the user refine their search criteria.
view_expenses
Retrieves and displays expense report line details for an employee, including expense items, amounts, dates, and line statuses. Enables self-service users to look up a specific expense report line directly by its Workday ID or to search for expense lines across all reports. When searching, users can filter by expense item, trip, expense group or line status.
view_orders
Retrieves and displays the comprehensive details of an employee's purchase requisition, including the status of any associated purchase orders and invoices. Enables self-service users to search for a specific requisition to track its downstream procurement progress.

ESS - Financial Management - Advanced

Tool
Description
Limitations
create_manual_expense
Enables workers to manually create expense report lines without uploading a receipt or referencing a credit card transaction by specifying details like expense items, dates, worktags, per diems, and amounts. Supports basic parameters such as expense item, date, quantity, unit cost, currency, and amount. Also supports these expense item attributes:
  • Memo
  • Paid by corporate card
  • Busines reason
  • Number of days
  • Departure date
  • Arrival date
  • Travel location
  • Travel country
  • Country region
Doesn't support complex configurations, mileage route tracking, travel journals or itemizations.
submit_expenses
Enables workers to submit unsubmitted expense lines that are in a ready to submit status, with options to review details or add a memo for the approver.

ESS - Help - Advanced

Tool
Description
Limitations
create_a_case
Enables users to initiate and submit formal support requests to ensure complex issues are documented and routed correctly for resolution.

ESS - Human Capital Management - Base

Tool
Description
Limitations
get_benefits_decision_support
Enables workers to request data that assists in the benefits decision-making process based on user input, Workday plan data, and plan eligibility data. Provides answers to questions about benefit plans, retrieves benefit plan definitions, creates comparisons between benefits plans, identifies plans best suited for workers, retrieves changes in plans from prior years, and defines complete benefit concepts.
The Self-Service Agent retrieves benefit plan information from these sources in your Workday tenant:
You must set up and configure Benefits in your tenant to use this tool. See: Steps: Set Up Benefits.
You must ensure that all necessary benefit plan details are accessible to employees through the listed sources. We recommend adding any supplemental benefit plan information that isn’t included in the
View Benefit Plan
task or benefit enrollment instructions, such as deductibles, copays, prescription costs, procedure coverage, and network details, into a policy document for the agent to reference.
get_my_support_roles
Retrieves workers assigned to organization support roles, such as HR Partner and Absence Partner, for organizations you're associated with. Each result includes the assignable role, assigned worker, and organization. You can filter by role type or organization name.
View-only. You can't assign or change support roles. Results include only workers with support roles explicitly assigned to your organizations; inherited roles aren't included. Results depend on your security access to workers and organizations. Security:
Worker Data: Support Roles
domain, in addition to access to the agent skill.
view_bonus_history
Retrieves historical data for bonuses and one-time payments, such as spot bonuses and gift cards, for the user. Provides payment amounts, currency, effective or scheduled dates, plan names, bonus percentages, and the formal reason for the payment. Supports queries for the most recent payment, a specific calendar year’s history, or a summary of the three most recent events. Automatically retrieves all records if multiple payments occur on the same date.
Doesn’t display clawbacks, non-bonus plan types, or future/projected payments.
view_coworker_info
Searches for a coworker by name and/or worker ID to retrieve professional information such as title, manager, location, and, where permitted by the user's security access, personal contact fields such as home email and home phone. Retrieves 1 profile for each call.
The fields that the agent returns depend on the session user's security access. For example,
Home Email
and
Home Phone
fields are returned only when the user has access to those fields.
Doesn't return sensitive personal fields, such as home addresses.
Ambiguous names with multiple matches requires user clarification.
Doesn't support bulk or list lookups.
view_dependents
Retrieves a list of all active dependents for the user, including the dependent's name, relationship type, date of birth, age, gender, and tobacco status.
view_my_tasks
Secured to
Core Navigation
domain in the Tenant Non-Configurable functional area. Enables users to ask questions about their tasks and returns a read-only list of tasks with a direct link to
My Tasks
. The Self-Service Agent can call tools in addition to
view_my_tasks
, such as
find_journeys
and
view_learning_assignments
, to answer time-based questions and provide a comprehensive view of a user's immediate priorities.
Doesn't support translations at this time.
view_my_team
Retrieves the list of users on the current session user's my-team list, including display names and headcount. This tool retrieves peers under the same manager, not the user's direct reports.
Detailed profile information such as title or contact details is not included; use
view_coworker_info
for individual details.
Displays an empty team list when the manager has no other direct reports.
Doesn't return direct reports; use
view_team_members
for a user's direct reports and peers.
.
view_org_info
Retrieves organization records for organizations the user belongs to or from a specific name search. Results include organization identifiers, status, and location fields.
Retrieves org-level metadata rather than a member roster; use
view_my_team
or
view_team_members
for people-level queries.
Location and address fields are retrieved as stored in Workday with no locale transformation applied.
view_personal_info
Retrieves personal information details from the session user's personal and employment profile. Not all profile fields are supported even if they exist. This tool retrieves data for the authenticated session user only; use view_coworker_info for other workers. It uses a read-only GraphQL API with no write capabilities.
Doesn't retrieve fields such as emergency contacts or custom profile.
Date formats and field labels are retrieved as stored in Workday with no locale-based transformation applied.
view_total_compensation
Retrieves the user's total base pay, total compensation, pay frequency, and compensation grade, pay range details, and a summary of all stock grants grouped by type and the associated vesting schedule.
Doesn't predict future stock vesting dates or format step progression details beyond the provided string.

ESS - Human Capital Management - Advanced

Tool
Description
Limitations
add_dependent
Enables workers to add a dependent with details including:
  • Effective Tracking:
    • Effective Date
    • Reason
  • Personal Details:
    • Legal Name
    • Gender
    • Date of Birth (DoB)
    • Relationship
    • Citizenship Status
    • Disability Status
  • Status & Coverage:
    • Tobacco Usage
    • Healthcare Covered Elsewhere
    • Use as Beneficiary
  • Education Tracking:
    • Full Time Student
    • Student Start Date
    • Student End Date
Initiates a dependent event.
You must also enable the
change_personal_info
tool in the ESS - Human Capital Management - Advanced skill.
Doesn’t support file uploads.
change_dependent
Enables workers to edit dependent details including:
  • Effective Tracking:
    • Effective Date
    • Reason
  • Personal Details:
    • Legal Name
    • Gender
    • Date of Birth (DoB)
    • Relationship
    • Citizenship Status
    • Disability Status
  • Status & Coverage:
    • Tobacco Usage
    • Healthcare Covered Elsewhere
    • Use as Beneficiary
  • Education Tracking:
    • Full Time Student
    • Student Start Date
    • Student End Date
Initiates a dependent event.
You must also enable the
change_personal_info
tool in the ESS - Human Capital Management - Advanced skill.
Doesn’t support file uploads.
change_home_contact_info
Enables users to update their home address and personal phone number(s) in Workday.
Supports custom validations.
Doesn't support file uploads.
Managers can't update home contact info on behalf of direct reports.
change_name
Enables a user to update their legal name and/or preferred name in Workday only.
Supports custom validations.
Other name components, such as social name and former name, aren't supported.
Doesn't support file uploads such as legal name change certificates.
Doesn't support the effective date of a legal name.
change_personal_info
Enables a user to update a combination of their citizenship status, date of birth, ethnicity, gender, gender identity, marital status, nationality, place of birth, pronoun, race, religion or sexual orientation. This tool initiates the
Change Personal Information
business process and enables users to upload attachments.
You must enable View All access and REST initiating action access on the business process security policy. Example: Access the
Change Home Contact Information
business process security policy and add
Employee as self
to both the View All and REST initiating action on the business process security policy to enable users to change home contact information using the agent.
delete_dependent
Enables workers to delete a dependent. Creates a new dependent deletion event. If the worker doesn't provide a date, the event defaults to today's date as the effective date.
Workers can only delete 1 dependent at a time.
Doesn’t support file uploads.
request_reference_letter
Initiates a request for a standard employment verification or reference letter for the current user based on data on file in Workday.
Managers can't initiate reference letter requests for direct reports.
Doesn't support custom language, non-standard fields, client-specific formatting, or custom validations.

ESS - Payroll - Base

Tool
Description
Limitations
get_my_bank_accounts
Enables employees to retrieve and view details across their saved bank accounts by entering natural language prompts to access current payment distribution and direct deposit details.
get_my_payment_elections
Enables employees to retrieve and view details across their payment elections by entering natural language prompts to access current payment distribution and direct deposit details.
get_my_payment_election_defaults
Enables employees to retrieve and view details across their default payment configurations by entering natural language prompts to access current payment distribution and direct deposit details.
get_my_payslips
Enables employees to retrieve and view details for their issued payslips, gross and net pay amounts, and pay period summaries by entering natural language prompts to access current paycheck and earnings information.
get_tax_elections
Retrieves the current worker's payroll tax withholding elections. Returns the election in effect for each supported tax authority, for each company where the worker is active as of the specified date. If effectiveDate in yyyy-mm-dd format is omitted, returns elections as of the current date. You can filter results to one or more companies using company.
Requires security permissions for the user or integration system under the
Self-Service: Payroll (My Withholding Elections) - USA
or
Self-Service: Payroll (My Withholding Elections) - Canada
domains.
Your API client or agent workflow must invoke the
payrollElectionsForESS
resource using the required worker parameter, with optional parameters for Effective Date and Company.
model_my_pay
Enables hourly workers to model and plan for possible pay change scenarios.
Example prompts:
  • What if I made x an hour?
  • What is my gross pay if I made x an hour?
  • What is my net pay if I made x an hour?
  • What are my taxes if I made x an hour?
  • What are my pre-tax deductions if I make x an hour?
Retrieves hourly payroll result lines if the pay component includes
rate
and
hour
pay component related calculations.
You must configure pay modeling in your tenant to use this tool. SeeSet Up Pay Modeling.
Workers must have at least 1 completed pay period with hourly pay to prompt the agent successfully.
view_direct_deposit
Retrieves user's bank accounts and direct deposit information used in payment elections, including the default country and currency.
Doesn't provide information about payment elections that aren't associated with a bank account.
view_next_paydate
Retrieves the next payroll payment date for on-cycle payments for a user’s primary pay group.
Available only for Australia, Canada, France, Ireland, UK, and USA.
Additional configuration is required for workers assigned to a Payroll Interface pay group.
view_tax_form_details
Enables workers to query specific box values and access details across U.S. W-2 Wage and Tax Statements (including original W-2 and corrected W-2c forms).
Example prompts:
  • What is on Box 1 of my W-2 for 2025?
  • What is reported in Box 12 on my W-2?
  • Show me my state and local tax breakdowns on my W-2.
  • What is listed under Box 14 on my W-2?
Workers must have at least 1 issued U.S tax form (W-2 or W-2c) to prompt the agent successfully.
Enables workers to access year-end tax document details across Canadian tax forms (T4, T4A, T4A-RCA, RL-1, RL-2, and NR4).
Example prompts:
  • What is on my T4 for 2025?
  • Show me my T4A tax form details.
  • What company is listed on my RL-1??
  • What payroll province is on my T4A-RCA?
Workers must have at least 1 issued Canadian tax form (T4, T4A, T4A-RCA, RL-1, RL-2, or NR4) to prompt the agent successfully.

ESS - Payroll - Advanced

Tool
Description
Limitations
add_bank_account
Enables employees to retrieve country-specific account field requirements and submit new bank account details by entering natural language prompts to configure their account information for payroll.
remove_bank_account
Enables employees to delete unused bank account details by entering natural language prompts, including built-in validation logic to prevent removing accounts currently in active use.
update_payment_elections
Enables employees to modify payment election distribution rules and account allocations by entering natural language prompts to update their direct deposit preferences.

ESS - Talent Management - Base

Tool
Description
Limitations
continue_journey
Enables the user to advance through a journey by marking the steps as complete or incomplete.
distribute_journey
Enables employees to distribute journeys themselves.
find_internal_jobs
Enables users to search approved internal job postings using job title keyword matching or structured filters such as company, time type, location, remote work type, hiring manager, spotlight job status, management level, job category, job family, job type, and supervisory organization.
Keyword matching is restricted to job titles.
Doesn't search full job description text or infer roles from coworker profiles.
find_journeys
Enables users to search, filter, and retrieve available journeys. This tool displays details for self-service and distributed journeys, and provides specific journeys details when prompted.
view_continue_learning
Enables learners to view active, incomplete learning records, including in-progress standalone lessons and active courses that are in progress or not yet started.
Only returns the learner's records and doesn't include completed learning or transcript history.
view_feedback
Displays feedback the user has received (both unsolicited anytime and requested) along with the status of pending requests. Includes the date, the provider, and the feedback content with options to filter by date or person. Managers can also view a summary count of feedback requests for their direct reports.
view_learning_assignments
Enables learners to view their open, incomplete, or currently in-progress assigned learning by due date. Learners must specify if they want required assignments.
view_learning_content
Enables learners to search and browse active learning content they can access by keyword, topics, skills, content type, language, location, or recent updates.
Doesn't filter results by certification, course offering assessors, course offering locations, rating, or unit type.
view_my_goals
Retrieves submitted individual goals for the user, including status, due date, category, and organization alignment.
Doesn't support date range filtering milestones, or cascaded goals.
Doesn't retrieve archived goals.
view_my_learning_transcript
Enables learners to view learning records from their transcript, including enrolled, in progress, and completed learning content with completion status, dates, scores, and grades.
Filters the results by content, completion status, record type, and expiration date.
Only returns learner's records and returns an empty list when no transcript records exist or when viewing the learning transcript is disabled for the learner.
Doesn't filter results by registration status, date enrolled, attendance status, grade, score and record type.
view_org_goals
Retrieves an organization's goals for a specified date range, defaulting to the current user's primary-job supervisory organization.
Provides goal names, descriptions, completion percentages (0–100), and parent goal references.
Limited to active supervisory organizations.
Doesn't support searching by name or description.
view_performance_review
Retrieves the user's completed or in-progress performance reviews. Only retrieves overall ratings for managers and employees for each section. Users can filter the list by status.
Doesn't display the manager or employee's overall comments. Only retrieves overall ratings for managers and employees for each section.
view_recommended_learning
Enables learners to view learning content, including courses and programs, ranked by how well each item matches the learner's profile and learning history. Returns up to 40 ranked items per request.
Returns no recommendations when the organization hasn't enabled the required ML data contributions for learning recommendations, or when no recommendable content is available.
view_talent_profile_details
Retrieves specific talent profile sections, such as job history, skills, and education for the current user or another worker by their name or ID.

ESS - Talent Management - Advanced

Tool
Description
Limitations
create_referral
Enables users to submit a referral for an external candidate to 1 or more job requisitions using job requisition IDs such as candidate's name, country, contact details, optional address, and notes. The specified job requisition ID must be for an active, non-confidential job requisition posted externally. This tool doesn't support resume or file uploads and doesn't display the referral status after submission. Additionally, the submission may fail if country-specific candidate consent is missing.
Doesn't support resume or file uploads.
Doesn't display referral status after submission.
Doesn't support custom validations.
Submission might fail when referral consent for certain candidate countries is missing.
manage_goals_for_self
Enables the user to create, delete, edit, submit, or archive their own individual goals through the
Manage Goals
business process. The user is shown a summary of the proposed changes to review and confirm before submitting.
Doesn't support saving goals or updating saved goals.
manage_job_history
Enables employees to add, edit, or delete entries in their job history through a conversational interface. When you:
  • Don’t opt into the Career Profile, employees can use the tool to initiate a
    Manage Job History
    business process event to change their job history.
  • Opt into the Career Profile, employees can use this tool to directly update their job history without initiating a
    Manage Job History
    business process event.
Employees can’t use the tool to:
  • Take action on in-progress
    Manage Job History
    events.
  • Update or remove job history entries with in-progress business process events.
If you opt into the Career Profile and inactivate the
Job History
section using the
Configure Career Profile
task, employees can still use this tool to update their job history without using the
Manage Job History
business process. In this case, Workday recommends disabling the tool to enforce approvals and custom validations on the business process.
request_feedback_self
Enables users to request feedback from other users by selecting specific feedback templates and determine whether the responses should be private to them or visible to others.
start_performance_review_self
Initiates a performance review request through the
Start Performance Review
business process security policy. Enables the user to start a performance review based on a review template and review period start and end dates. Once initiated, you must complete any further interactions through the Workday UI. This tool only supports starting performance reviews for the processing user and review types that allow employee self-initiation.
Doesn't support custom validations.

ESS - Workforce & Frontline Management - Base

Tool
Description
Limitations
absence_types
Users must have access to the
Request Leave for Self
or
Request Leave of Absence (REST Service)
initiating actions on the
Request Leave of Absence
business process, or the
Request Time Off for Self
or
Request Time Off (REST Service)
initiating actions on the
Request Time Off
business process for the Self-Service Agent to use this tool.
Enables workers to view the absence tables, leave types, and time offs they’re eligible for and secured to request.
Doesn’t support absences and time offs that can't be entered through the standard process, such as those enabled only for time tracking, forfeiture adjustments, or selling.
my_absences
Enables workers to view their past, present, and future time off requests and event details.
Doesn't retrieve cancelled or denied time off entries.
Doesn't return leave of absence requests or event details.
Doesn't support viewing time off for direct reports or other workers.
time_off_balance
Retrieves and displays the user's time off balances as of an effective date.
Doesn't return time off carryover, expiring accrual balances, or expiration details.
view_holiday_calendar
Retrieves the user’s company holiday calendar events for a specified date range.
While the tool identifies the holidays, it doesn't return the specific duration of the holiday calendar event.
view_my_shifts
Enables workers to view their shifts.
view_my_upcoming_shifts
Enables workers to view all scheduled shifts in the date range, filtering out shifts with existing absence requests or that were previously called out.
view_time_blocks
Displays all recorded time blocks for a specified date range for the user.
Results are limited to the first 20 time blocks per request.

ESS - Workforce & Frontline Management - Advanced

Tool
Description
Limitations
accept_shift_swap
Secured to the Accept Shift Swap (REST Service) initiating action on the Accept Shift Swap business process in the Scheduling functional area. Enables workers to review, accept, or reject a pending shift swap request proposed by a coworker. Strictly for responding to existing requests.
Doesn't initiate new swaps or display other pending items in the worker's My Tasks.
bid_to_cover_shift
Enables workers to submit a bid to cover an open scheduled shift for themselves. This action submits the bid for manager or scheduler approval and is restricted to eligible scheduled workers.
call_out
Initiates call out for a set of shifts. This submits a request for time off for those shifts, then contacts the shift managers and initiates the process to fill the shifts.
call_out_no_absence
Initiates call out for a set of shifts. This contacts the shift managers about those shifts and starts the fill shift process for each, but doesn't submit a request for time off. Used by workers without absence management or when a time off request has failed and the call out should proceed without trying to correct the issue.
cancel_absence
Users must have access to the
Correct Time Off Entry (REST Service)
initiating action on the
Correct Time Off
business process for the Self-Service Agent to use this tool.
Enables workers to cancel or delete an approved time off entry. Also supports the cancellation of in-progress time off request and correction events.
change_work_availability
Users must have access to the Change My Work Availability (REST Service) initiating action on the Change Work Availability business process for Self-Service Agent to use this tool. Enables workers to update their work availability by specifying available days of the week and distinct time slots.
This tool only updates availability and can’t be used to modify schedule preferences or currently published shifts.
Doesn't support overlapping time slots on the same day. Managers can't use this tool to update availability on behalf of workers.
cover_shift
Enables workers to request to cover an open scheduled shift for themselves. Restricted to eligible scheduled workers.
delete_time_blocks
Enables users to delete time blocks but doesn’t enable edits or other changes.
Limited to 50 time blocks and a 1-week date range.
edit_absence
Users must have access to the
Correct Time Off Entry (REST Service)
initiating action on the
Correct Time Off
business process, or the
Request Time Off (REST Service)
initiating action on the
Request Time Off
business process for the Self-Service Agent to use this tool.
Enables workers to edit an approved time off entry. Supports modifications to quantity, start and end times, time off type, position, and reasons for both standard time off and absence tables. Supports custom validations.
Doesn't support corrections to worktags. Doesn't display warnings.
enter_time_block
Enables a user to create time entries for 1 or more days using quantity-based entries (# of hours) or in/out time-based entries (specific times of day).
Doesn't support worktag entry or project-based time entry codes.
Doesn't support time blocks requiring worktag selection, such as cost center, location, or division.
my_shifts
Enables workers to view their scheduled shifts. Supports retrieving, summarizing, aggregating, sorting, and filtering past or upcoming shifts across custom date ranges, as well as answering targeted questions like "When is my next shift?"
open_shift
Enables workers to open their own published shift and place it on the Open Shift board.
request_absence
Users must have access to the
Request Time Off (REST Service)
initiating action on the
Request Time Off
business process for the Self-Service Agent to use this tool.
Enables workers to initiate a:
  • Leave of absence request. Supports leave of absence requests with additional fields, custom additional fields, and entitlement per event.
  • Time off request, such as vacation and sick leave.
Doesn't support time off requests with worktags configured, or leave of absence requests with position-based leaves.
Doesn't display warnings. Doesn’t account for the configured daily default quantity or the worker’s scheduled hours when proposing time off for hours-based absence types.
Doesn’t support adding attachments when requesting a leave of absence or time off.
The
request_time_off
tool treats 1 day as 8 hours.
request_shift_swap
Users must have access to the
Request Shift Swap (REST Service)
initiating action on the
Request Shift Swap
business process for the Self-Service Agent to use this tool. Enables scheduled workers to initiate a request to swap one of their published shifts with a qualified coworker. The selected coworker must share a matching schedule tag and belong to the same scheduling organization.
Doesn't post shifts to the Open Shift board or request coverage for open shifts. Restricted to coworkers with matching schedule tags.
shift_check_in
Enables a user to clock in at the beginning of their shift to start recording worked time. The tool automatically resolves available time entry codes and positions.
Doesn't support worktag entry or project-based time entry codes; users requiring worktags can't complete check-in through this tool.
shift_check_out
Enables a user to clock out of their shift, either for a break or for the end of their shift, to stop recording their worked time.
submit_time
Submits a user's timesheet for review and approval for a single date. Includes all time entries for the full time period the date falls within. For example, any date within a weekly pay period will submit the entire week.
Doesn't support custom validations.
update_time_block_comment
Adds or updates a comment associated with a specific time block.
Doesn't support editing any other fields on the time block, such as time type or quantity.

Global Search Answers

The Global Search Answers skill uses these tools, which are also available in other Self-Service Agent skills:
  • find_jobs
  • get_tax_elections
  • view_bonus_history
  • view_candidate_status
  • view_dependents
  • view_direct_depost
  • view_direct_reports
  • view_direct_reports_info
  • view_feedback
  • view_learning_assignments
  • view_learning_content
  • view_my_goals
  • view_my_learning_transcript
  • view_org_goals
  • view_performance_review
  • view_tax_form_details
  • view_team_goals
  • view_team_learning_status
  • view_team_performance_review
  • view_total_compensation

Guide

Tool
Description
Limitations
get_user_context
Retrieves the user's full name, business title, work location, hire date, and manager. This foundational context is utilized by the agent to deliver more personalized, tailored responses for individual self-service interactions.
get_page_context
Retrieves the contents of the page the user currently has open on the Workday desktop application. Enables users to ask the agent questions about the page they’re on without having to provide page details. This tool is used when the user has both a page open and the agent chat open on the Workday desktop application.
Doesn’t apply to mobile or Workday Everywhere.

MSS - Human Capital Management - Base

Tool
Description
Limitations
get_worker_support_roles
Retrieves workers assigned to organization support roles, such as HR Partner and Absence Partner, for a direct report you specify across organizations the worker is associated with. You can identify the worker by name. Each result includes the assignable role, assigned worker, and organization. You can filter results by role type or organization name.
View-only. You can't assign or change support roles. You can view results only for direct reports you have access to. Results include only workers with support roles explicitly assigned to organizations; inherited roles aren't included. Results depend on your security access to workers and organizations. Security:
Worker Data: Support Roles
domain, in addition to access to the agent skill.
view_direct_reports_info
Retrieves professional profile information, such as anniversary dates, birthdays, promotion history, and tenure, for a manager's direct reports or a specific worker.
Provides data for direct reports only, not skip-level reports.
Managers with large teams might experience higher response volume.
Depending on an individual's employment record, some fields might not populate.
view_team_members
Retrieves the names of people on the current user's team. If the user has no direct reports, or asks about peers or teammates, returns coworkers who share the same manager, plus the user's manager when available.
For managers, only provides data for direct reports, not skip-level reports. Returns names only.
For broader organization hierarchy context, use
view_org_info
instead or consider asking your question in another way.
For richer profile data on direct reports, use
view_direct_reports_info
or
view_coworker_info
instead.
view_worker_history
Retrieves employment-related details for events such as hire, job change, and compensation for the user or a named worker within a specified date range. Each invocation retrieves a single event category.
When a name is provided, the worker must be part of the manager's reporting structure.
When multiple or zero matches are found for a name, the tool returns an error rather than a list.

MSS - Human Capital Management - Advanced

Tool
Description
Limitations
initiate_change_ job
Enables the user to initiate a Change Job event using a change job template that includes the Workday Assistant / Rest API initiating action. Automatically chooses the appropriate change job template based on the information the user provides. Collects and submits change job data, or provides a link to a pre-populated Change Job event that users can complete themselves in Workday. Use when a manager wants to initiate a job change such as a change in location, business title, or job profile for a worker.
You must configure the
Workday Assistant / REST API
initiating action in the
Select Initiating Actions
field on the
Maintain Change Job Templates
task to use this tool. See Set Up Change Job Templates for more information.
Access the
View Security for Agent Skill
report (secured to the
Manage: Agents
domain in the Agent System of Record functional area and the
Security Administration
domain in the System functional area) to view all security requirements for this tool. These include:
  • Change Job (Rest Service) initiating action
  • Staffing Actions: Change Job Date and Reason
  • Staffing Organizations: Header
  • Worker Data: Historical Staffing Information
Doesn’t support file uploads, and federal or academic detail fields.
Provides a link to the Change Job events that require sub-business processes. Doesn’t allow you to complete the event in the chat. Example: You’re initiating a change job template with the
Change Organization Assignment
business process configured in the
Select Subprocesses for Template
field.

MSS - Payroll - Advanced

Tool
Description
Limitations
request_payroll_input
Enables managers to identify eligible workers, retrieve available pay components, and submit payroll input requests for eligible team members by entering natural language prompts to streamline payroll input management.
Doesn't support custom validations.

MSS - Talent Management - Base

Tool
Description
Limitations
find_job_requisitions
Enables hiring managers to view job requisition information they have access to. Displays open job requisitions that includes status, supervisory organization, location, and openings filterable by supervisory organization and requisition type (standard or evergreen).
Displays in-progress requisition creation events awaiting approval, showing their current approval stage, filterable by supervisory organization.
Access to in-progress events is secured to the
View All
and
View Completed Only
security policies of the
Job Requisition
business process.
Require proper access for evergreen requisitions.
Doesn't support searching or applying for jobs as a candidate.
find_my_candidates
Enables managers to retrieve candidate profiles, application stages, and qualification details for job requisitions where they are assigned as the hiring manager. Supports free-text search by candidate name or candidate ID, as well as filtering by application stage, type, skills, job profile, job family, job requisition, experience duration, do-not-hire status, withdrawn status, and closed or frozen job status.
view_team_goals
Retrieves up to 100 goals for a manager's direct reports, grouped by worker and completion status. Only supports retrieving submitted individual goals and filters for status, keywords, and due dates.
Doesn't support filters for milestones, categories, or specific target and actual currency fields.
view_team_learning_status
Retrieves learning records such as completion, grade, and expiration for a manager's direct team.
Only provides data on learning activities in which the team has already formally enrolled; assigned but not-yet-enrolled training is excluded.
Doesn't support filtering by due dates or individual learners.
view_team_performance_review
Retrieves high-level review metadata and overall ratings for the supervisory organization the manager leads.
When a manager leads multiple organizations, only the first supervisory organization is retrieved.
Doesn't support non-overall section ratings or comments.

MSS - Talent Management - Advanced

Tool
Description
Limitations
add_goal_to_employees
Managers must have access to the
Cascade Goal (REST)
initiating action on the
Cascade Goals
business process for the Self-Service Agent to use this tool. Enables managers to create 1 or more goals and assign them to multiple employees through the
Cascade Goals
business process for named workers, organization members, or talent pool members.
Doesn’t manage an individual worker's personal goals or view existing goals, and only supports managers with permission to cascade goals; available goal fields depend on tenant configuration.
create_job_requisition
Enables hiring managers and recruiters to create job requisitions for existing filled or unfilled positions, either by selecting an active worker or a worker terminated within 90 days for backfill, or by specifying a position ID. Also enables users to customize requisition details directly in the agent chat session. Completing the chat workflow generates a direct link to review and revise details before submission.
Doesn't support contingent workers.
create_organizational_goal
Enables a manager or authorized user to create a new organizational goal for a specific supervisory organization within a designated goal period. The tool supports defining an optional description, privacy configurations, supporting initiatives, alignment to higher-level organization goals, and metrics for completion tracking.
manage_goals_for_worker
Enables a user to create, edit, delete, submit, or archive individual goals for a worker the processing user has access to through the
Manage Goals
business process. The user is shown a summary of the proposed changes to review and confirm before submitting.
Doesn't support saving goals or updating saved goals.
start_performance_review_worker
Starts a new
Employee Review
business process for a manager's single direct report or for their entire team.
While you must select a template and period dates, you can only use 1 template when starting reviews for all direct reports simultaneously.
Doesn't support custom validations.
request_feedback_worker
Enables a manager to request feedback about a worker from other users. Users can select specific feedback templates and determine if the responses should be confidential or visible to others.
update_organization_goal
Enables a manager or authorized user to update the details of an existing organizational goal, including its name, description, privacy settings, higher-level organization alignments, and completion tracking metrics. This tool appends new supporting initiatives to the existing list and allows modifying alignments, but it does not support changing the goal's owning organization or its designated goal period.

MSS - Workforce & Frontline Management - Base

Tool
Description
Limitations
view_my_direct_reports_absences
Enables managers to view time off event details for their direct reports.
Doesn't reference your team absence configuration.
Doesn't retrieve cancelled or denied time off entries.
Doesn't support viewing time off for workers who aren't direct reports or matrix reports of the manager.
view_submitted_time_entries_workers
Retrieves submitted time entries for multiple workers.
Displays a maximum of 60 records, with 20 records per page.
view_time_blocks_workers
Retrieves time blocks for multiple workers.
Displays up to 100 time blocks for a maximum of 20 workers for a maximum date range of 1 month.
Doesn't display project time entry details.
view_time_clock_events
Enables managers to view time clock events for workers on their team or direct reports, including check-in, check-out, meal, break, and out-for-lunch punch history. Managers can ask who on their team is currently checked in or out, retrieve event history for a date or date range, and filter by event type or worker.
This tool retrieves time clock event data only and doesn't enable edits, additions, or deletions.
Limited to 20 workers, 100 time clock events, and a 31-day date range per request. When a query exceeds these limits, Workday returns a partial list and indicates that more records are available.

MSS - Workforce & Frontline Management - Advanced

Tool
Description
Limitations
approve_time_entries
Enables a user to approve time entries for multiple workers.
Displays a maximum of 60 records, with 20 records per page.
create_time_blocks_workers
Enables a user to create time blocks for multiple workers.
For a maximum of:
  • 20 workers.
  • 100 time blocks.
  • Date range of 1 week.
Doesn't support projects or worktags.
delete_time_blocks_workers
Enables a user to delete time blocks on behalf of workers in bulk. This tool doesn’t enable edits or other changes.
For a maximum of:
  • 20 workers.
  • 100 time blocks.
  • Date range of 1 week.
deny_time_entries
Enables a user to deny time entries for multiple workers.
Displays a maximum of 60 records, with 20 records per page.
edit_time_blocks_workers
Enables a user to edit time blocks on behalf of workers in bulk. They can edit in/out times, quantity, and comment fields. Example: A user can change 07:00-14:00 to 08:00-16:00 or can change a quantity block from 8 hours to 6 hours.
This tool can't edit other fields. Edits a maximum of 10 workers and 50 time blocks.
send_back_time_entries
Enables a user to send back time entries for multiple workers.
Displays a maximum of 60 records, with 20 records per page.
shift_check_in_workers
Enables managers to check in 1 or more workers on their team or direct reports at the current time, at a specified time in the future, or for a previous date. When you specify time entry codes, managers can apply different codes for different workers in the same request. Workday excludes workers who aren't eligible to check in, such as hours-only workers, and returns partial results when a bulk request includes ineligible workers. Workday requires manager confirmation before creating check-in time clock events.
Doesn't enable check-out, edits, deletions, or time transfers.
shift_check_out_workers
Enables managers to check out 1 or more workers on their team or direct reports for the day, for a meal, or for a break at the current time or at a specified time. Managers can check out their entire team or direct reports in a single request. Workday creates check-out time clock events for workers who are eligible for the requested out type, and returns partial results when a bulk request includes ineligible workers or out types a worker can't use. Workday requires manager confirmation before creating check-out time clock events.
Doesn't doesn't enable check-in, edits, deletions, or time transfers.

MSS - Workforce & Frontline Management - Premium

Tool
Description
Limitations
confirm_or_reject_shift
When a manager gets worker recommendations for a shift, this tool contacts a chosen worker to request that they pick up the shift. If a different worker was offered the same shift with this tool, it rescinds the offer from that worker to make it to the new replacement worker.
get_next_worker_recommendations
Gets recommended workers for an open shift. If the agent has already gotten workers for this shift, it will fetch recommendations again and move past the previously recommended workers.
post_open_board
Posts the shift to the Open Shift board and closes the fill shift process.

MSS - Workforce & Frontline Management - Utility

Tool
Description
Limitations
reassign_shift
Reassigns the shift to the worker who has agreed to cover a shift that the original worker has called out for and closes the fill shift process.

Policy Intelligence

Tool
Description
Limitations
search_policy_documents
Retrieves company policy and procedural information from Help Knowledge Base articles to ensure responses are accurate and based on official documentation.
We recommend that you opt in to the
People Experience
Help
service on the
Innovation Services And Data Selection Opt-In
report before you sign the UMSA or change your data hosting region. This prevents a 14 day waiting period for Self-Service Agent to ingest your policy documents.
Doesn't extract data from articles in Sandbox environments. We recommend using IMPL tenants instead for test cases related to this.
Doesn't read document attachments or linked documents in help articles. Only reads the text of the article itself.