- Release notes
- Getting started
- For administrators
- RPA workflow projects
- Creating an RPA workflow from an idea
- Creating a project
- How to start an RPA workflow
- Managing project files and folders
- Connecting RPA workflows to your accounts
- Configuring activities
- Managing the activities in a project
- Passing values between activities
- Iterating through items
- Managing the data in a project
- Configuring a project to use your data
- Using file and folder resources
- App projects
- Agentic processes
- Agents
- Solutions - Preview
- API workflows - Preview
- User interface
- Managing API workflows
- Consuming API workflows

Studio Web User Guide
Extend the capability of your UiPath Agents by integrating API workflows as tools. Agents automatically query these workflows to gather relevant context, enabling precise control over the data available to your agents and AI models.
The following scenario demonstrates how an API workflow can transform data retrieved from Workday, limiting the information exposed to agents to names and email addresses only. In the Workday sandbox, Betty Liu is configured as a manager with assigned direct reports and peers. Example queries for the agent include:
- "Who reports to Betty Liu?"
- "Provide all peers for Betty Liu."
- "Do any of Betty Liu's peers have reports?"
Before you begin, ensure the following prerequisites are met:
- You published your Workday API workflow to Orchestrator. Confirm that the workflow runs successfully when executed from Orchestrator.
- Platform units are assigned to your tenant.
- To follow the provided Workday integration example, ensure your workflow includes:
- An input schema with fields for first name and last name.
- An output schema containing arrays for Peers and Direct Reports.
Congratulations!
Now you can create variations of your agent user prompt. Depending on the query, the agent may trigger multiple calls to your API workflow before providing a complete response.
API workflows as tasks in Maestro encapsulate detailed API chaining and data transformations. This keeps the primary Maestro process clear, concise, and easy to follow. By isolating specific API interactions within API workflows, you maintain readability and promote reusability across multiple processes.
The following scenario demonstrates how Maestro calls Workday APIs and then sends a Slack team notification whenever an employee was terminated.
Before you begin, ensure the following prerequisites are met:
-
You published your Workday API workflow to Orchestrator. Confirm that the workflow runs successfully when executed from Orchestrator.
Ensure your API workflow includes:
- An input schema with fields for First Name and Last Name.
- An output schema containing arrays for Peers and Direct Reports.
Step 1: Creating an Agentic Process
- Create an agentic process.
- Add a Start event element. Name it "Employee Hired".
- For the Action property of the Start event, select Wait for connector event.
- For the Connector property, select Workday REST - Worker Created. This is the event that triggers the process.
- Add a Task element and connect the Start event to it. Name it "Find Employee Relationships".
- Add another Task element, name it "Send Notifications", and connect the Find Employee Relationships element to it.
- Add an End event. Name it "Notification Sent".
Step 2: Configuring the Find Employee Relationship task
The API workflow required by the agentic process resides in the Find Employee Relationships task. Here is how to configure it:- Select the Find Employee Relationships task.
- For the Action property , select Start and wait for API workflow.
- For the API workflow property, select the published Workday API workflow. The properties panel displays inputs and outputs for the selected workflow.
For this example:
- Inputs include Last Name and First Name.
- Outputs include details for Manager, Peers, and Reports.
- Configure inputs as follows:
- First Name as a variable from the Start event response object. Open the Expression editor, select Insert variable and navigate to Employee Hired > response > Worker > Worker full name. Then add
Split(' ')[0]
to the expression. It should look like the following:Wherevars.response_1.worker.descriptor.Split(' ')[0]
vars.response_1.worker.descriptor.Split(' ')[0]worker
is the response object from the Start event response, and.Split(' ')[0]
splits the full name by the space character and fetches the first part of the full name. - Last Name as a variable from the Start event response object. Open the Expression editor, select Insert variable and navigate to Employee Hired > response > Worker > Worker full name. Then add
Split(' ')[1]
to the expression. It should look like the following:Wherevars.response_1.worker.descriptor.Split(' ')[1]
vars.response_1.worker.descriptor.Split(' ')[1]worker
is the response object from the Start event response, and.Split(' ')[1]
splits the full name by the space character and fetches the second part of the full name.
- First Name as a variable from the Start event response object. Open the Expression editor, select Insert variable and navigate to Employee Hired > response > Worker > Worker full name. Then add
Step 3: Customizing the Send Notification task
In this step, you configure the Send Notification task to use data returned from the API workflow executed at Step 2.- Select the Send Notification task.
- For the Action property, select Execute connector event.
- For the Connector property, select Slack, and configure it to use your Connection.
- For the Activity property, select Send Message to Channel.
- For the Channel name/ID, write the ID of the Slack channel where the notification should be sent.
- For the Message property, select the output variables from Step 2: Manager, Peers, and Reports.
- For the Send as property, select bot.
Step 4: Testing your agentic process
To successfully test this agentic process, ensure you have access to your Workday sandbox environment.
Select Test to validate your workflow. Maestro prompts you to provide two essential connections:
- Slack Connection—Required by the Send Notification task.
- Workday Connection—Required by the Start event.
- Consuming API workflows
- Consuming API workflows from Orchestrator
- Invoking API workflows in an Agent
- Using API workflows as tasks in Maestro
- Step 1: Creating an Agentic Process
- Step 2: Configuring the Find Employee Relationship task
- Step 3: Customizing the Send Notification task
- Step 4: Testing your agentic process