---
availability: INSTALLABLE
description: A plugin that allows users to plan the scheduling of approved changes.
installation_asset_uuid: 4ddd763c-1c32-49fa-9ef5-3c2d52278291
name: Schedule a Change
purple_chat_link: https://marketplace.moveworks.com/purple-chat?conversation=%7B%22messages%22%3A%5B%7B%22parts%22%3A%5B%7B%22richText%22%3A%22I+need+to+schedule+an+approved+change+in+ServiceNow%22%7D%5D%2C%22role%22%3A%22user%22%7D%2C%7B%22parts%22%3A%5B%7B%22richText%22%3A%22%3Cp%3EOkay%2C+I+can+help+with+that.+What+is+the+Change+Request+number+or+can+you+give+me+some+keywords+to+search+for+it%3F%3C%2Fp%3E%22%7D%5D%2C%22role%22%3A%22assistant%22%7D%2C%7B%22parts%22%3A%5B%7B%22richText%22%3A%22CHG0040551%22%7D%5D%2C%22role%22%3A%22user%22%7D%2C%7B%22parts%22%3A%5B%7B%22reasoningSteps%22%3A%5B%7B%22richText%22%3A%22Searching+for+change+request+%3Cb%3ECHG0040551%3C%2Fb%3E+in+ServiceNow.%22%2C%22status%22%3A%22success%22%7D%5D%7D%2C%7B%22richText%22%3A%22%3Cp%3EI+found+this+change+request%3A%3C%2Fp%3E%3Cul%3E%3Cli%3E%3Cb%3ENumber%3A%3C%2Fb%3E+CHG0040551%3C%2Fli%3E%3Cli%3E%3Cb%3EState%3A%3C%2Fb%3E+Approved%3C%2Fli%3E%3Cli%3E%3Cb%3EShort+Description%3A%3C%2Fb%3E+Increase+the+size+of+the+TEMP+tablespace+for+the+production+database.%3C%2Fli%3E%3C%2Ful%3E%3Cp%3EIs+this+the+correct+one%3F%3C%2Fp%3E%22%7D%2C%7B%22buttons%22%3A%5B%7B%22buttonText%22%3A%22Yes%2C+that%27s+right%22%2C%22style%22%3A%22filled%22%7D%2C%7B%22buttonText%22%3A%22No%2C+search+again%22%2C%22style%22%3A%22outlined%22%7D%5D%7D%5D%2C%22role%22%3A%22assistant%22%7D%2C%7B%22parts%22%3A%5B%7B%22richText%22%3A%22Yes%2C+that%27s+right%22%7D%5D%2C%22role%22%3A%22user%22%7D%2C%7B%22parts%22%3A%5B%7B%22richText%22%3A%22%3Cp%3EGreat.+When+would+you+like+to+schedule+the+planned+start+and+end+for+this+change%3F%3C%2Fp%3E%22%7D%5D%2C%22role%22%3A%22assistant%22%7D%2C%7B%22parts%22%3A%5B%7B%22richText%22%3A%22Let%27s+schedule+it+for+tomorrow+from+10+PM+to+11+PM.%22%7D%5D%2C%22role%22%3A%22user%22%7D%2C%7B%22parts%22%3A%5B%7B%22richText%22%3A%22%3Cp%3EOkay%2C+I+will+schedule+the+change+request+%3Cb%3ECHG0040551%3C%2Fb%3E+with+the+following+details%3A%3C%2Fp%3E%3Cul%3E%3Cli%3E%3Cb%3EShort+Description%3A%3C%2Fb%3E+Increase+the+size+of+the+TEMP+tablespace+for+the+production+database.%3C%2Fli%3E%3Cli%3E%3Cb%3EPlanned+Start%3A%3C%2Fb%3E+2023-10-27+10%3A00+PM%3C%2Fli%3E%3Cli%3E%3Cb%3EPlanned+End%3A%3C%2Fb%3E+2023-10-27+11%3A00+PM%3C%2Fli%3E%3C%2Ful%3E%3Cp%3EDoes+this+look+correct%3F%3C%2Fp%3E%22%7D%2C%7B%22buttons%22%3A%5B%7B%22buttonText%22%3A%22Confirm+Schedule%22%2C%22style%22%3A%22filled%22%7D%2C%7B%22buttonText%22%3A%22Edit+Details%22%2C%22style%22%3A%22outlined%22%7D%2C%7B%22buttonText%22%3A%22Cancel%22%2C%22style%22%3A%22outlined%22%7D%5D%7D%5D%2C%22role%22%3A%22assistant%22%7D%2C%7B%22parts%22%3A%5B%7B%22richText%22%3A%22Confirm+Schedule%22%7D%5D%2C%22role%22%3A%22user%22%7D%2C%7B%22parts%22%3A%5B%7B%22reasoningSteps%22%3A%5B%7B%22richText%22%3A%22Connecting+to+ServiceNow...%22%2C%22status%22%3A%22success%22%7D%2C%7B%22richText%22%3A%22Updating+schedule+for+change+request+%3Cb%3ECHG0040551%3C%2Fb%3E.%22%2C%22status%22%3A%22success%22%7D%5D%7D%2C%7B%22richText%22%3A%22%3Cp%3EDone%21+I%27ve+scheduled+the+change+request.%3C%2Fp%3E%22%7D%2C%7B%22citations%22%3A%5B%7B%22citationTitle%22%3A%22CHG0040551%22%2C%22connectorName%22%3A%22servicenow%22%7D%5D%7D%5D%2C%22role%22%3A%22assistant%22%7D%5D%7D
solution_tags:
- IT
systems:
- servicenow
---
## Introduction
The **“Schedule a Change”** plugin enables IT teams to efficiently **schedule an approved Change Request** in **ServiceNow** using the Moveworks AI Assistant. This helps streamline the change implementation process by automating scheduling steps, reducing delays, and improving accuracy in change timelines.
This guide will walk you through installing and configuring the plugin in **Agent Studio** in just a few minutes. Let’s get started!
## **Prerequisites**
- Access to Agent Studio
### Agent Design
This [purple chat](https://developer.moveworks.com/creator-studio/developer-tools/purple-chat/?conversation=%7B%22messages%22%3A%5B%7B%22parts%22%3A%5B%7B%22richText%22%3A%22I+need+to+schedule+an+approved+change+in+ServiceNow%22%7D%5D%2C%22role%22%3A%22user%22%7D%2C%7B%22parts%22%3A%5B%7B%22richText%22%3A%22%3Cp%3EOkay%2C+I+can+help+with+that.+What+is+the+Change+Request+number+or+can+you+give+me+some+keywords+to+search+for+it%3F%3C%2Fp%3E%22%7D%5D%2C%22role%22%3A%22assistant%22%7D%2C%7B%22parts%22%3A%5B%7B%22richText%22%3A%22CHG0040551%22%7D%5D%2C%22role%22%3A%22user%22%7D%2C%7B%22parts%22%3A%5B%7B%22reasoningSteps%22%3A%5B%7B%22richText%22%3A%22Searching+for+change+request+%3Cb%3ECHG0040551%3C%2Fb%3E+in+ServiceNow.%22%2C%22status%22%3A%22success%22%7D%5D%7D%2C%7B%22richText%22%3A%22%3Cp%3EI+found+this+change+request%3A%3C%2Fp%3E%3Cul%3E%3Cli%3E%3Cb%3ENumber%3A%3C%2Fb%3E+CHG0040551%3C%2Fli%3E%3Cli%3E%3Cb%3EState%3A%3C%2Fb%3E+Approved%3C%2Fli%3E%3Cli%3E%3Cb%3EShort+Description%3A%3C%2Fb%3E+Increase+the+size+of+the+TEMP+tablespace+for+the+production+database.%3C%2Fli%3E%3C%2Ful%3E%3Cp%3EIs+this+the+correct+one%3F%3C%2Fp%3E%22%7D%2C%7B%22buttons%22%3A%5B%7B%22buttonText%22%3A%22Yes%2C+that%27s+right%22%2C%22style%22%3A%22filled%22%7D%2C%7B%22buttonText%22%3A%22No%2C+search+again%22%2C%22style%22%3A%22outlined%22%7D%5D%7D%5D%2C%22role%22%3A%22assistant%22%7D%2C%7B%22parts%22%3A%5B%7B%22richText%22%3A%22Yes%2C+that%27s+right%22%7D%5D%2C%22role%22%3A%22user%22%7D%2C%7B%22parts%22%3A%5B%7B%22richText%22%3A%22%3Cp%3EGreat.+When+would+you+like+to+schedule+the+planned+start+and+end+for+this+change%3F%3C%2Fp%3E%22%7D%5D%2C%22role%22%3A%22assistant%22%7D%2C%7B%22parts%22%3A%5B%7B%22richText%22%3A%22Let%27s+schedule+it+for+tomorrow+from+10+PM+to+11+PM.%22%7D%5D%2C%22role%22%3A%22user%22%7D%2C%7B%22parts%22%3A%5B%7B%22richText%22%3A%22%3Cp%3EOkay%2C+I+will+schedule+the+change+request+%3Cb%3ECHG0040551%3C%2Fb%3E+with+the+following+details%3A%3C%2Fp%3E%3Cul%3E%3Cli%3E%3Cb%3EShort+Description%3A%3C%2Fb%3E+Increase+the+size+of+the+TEMP+tablespace+for+the+production+database.%3C%2Fli%3E%3Cli%3E%3Cb%3EPlanned+Start%3A%3C%2Fb%3E+2023-10-27+10%3A00+PM%3C%2Fli%3E%3Cli%3E%3Cb%3EPlanned+End%3A%3C%2Fb%3E+2023-10-27+11%3A00+PM%3C%2Fli%3E%3C%2Ful%3E%3Cp%3EDoes+this+look+correct%3F%3C%2Fp%3E%22%7D%2C%7B%22buttons%22%3A%5B%7B%22buttonText%22%3A%22Confirm+Schedule%22%2C%22style%22%3A%22filled%22%7D%2C%7B%22buttonText%22%3A%22Edit+Details%22%2C%22style%22%3A%22outlined%22%7D%2C%7B%22buttonText%22%3A%22Cancel%22%2C%22style%22%3A%22outlined%22%7D%5D%7D%5D%2C%22role%22%3A%22assistant%22%7D%2C%7B%22parts%22%3A%5B%7B%22richText%22%3A%22Confirm+Schedule%22%7D%5D%2C%22role%22%3A%22user%22%7D%2C%7B%22parts%22%3A%5B%7B%22reasoningSteps%22%3A%5B%7B%22richText%22%3A%22Connecting+to+ServiceNow...%22%2C%22status%22%3A%22success%22%7D%2C%7B%22richText%22%3A%22Updating+schedule+for+change+request+%3Cb%3ECHG0040551%3C%2Fb%3E.%22%2C%22status%22%3A%22success%22%7D%5D%7D%2C%7B%22richText%22%3A%22%3Cp%3EDone%21+I%27ve+scheduled+the+change+request.%3C%2Fp%3E%22%7D%2C%7B%22citations%22%3A%5B%7B%22citationTitle%22%3A%22CHG0040551%22%2C%22connectorName%22%3A%22servicenow%22%7D%5D%7D%5D%2C%22role%22%3A%22assistant%22%7D%5D%7D) shows the experience we are going to build.
## **Installation Steps**
We recommend setting up **ServiceNow** before installing this plugin. Please follow the [ServiceNow Connector](https://developer.moveworks.com/marketplace/package/?id=servicenow&hist=home%2Cbrws#how-to-implement) guide to configure the connection.
Ensure the following permissions are granted:
- **Table Access**: `Read` and `Update` access to the `change_request` table
- **Field Access**: `Read` access to retrieve approved change requests, and `Write` access to update scheduling details
Once the connector is successfully configured, follow our [plugin installation documentation](https://help.moveworks.com/docs/ai-agent-marketplace-installation) for detailed steps on how to install and activate the plugin in **Agent Studio**
## **Appendix**
### API #1: **Get Approved Change Request by Number**
```bash
curl --location 'https://<YOUR_DOMAIN>/api/now/table/change_request?sysparm_query=numberLIKE{{change_number}}%5Eapproval%3Dapproved&sysparm_fields=sys_id%2Cnumber%2Capproval%2Cstate%2Cshort_description' \
--header 'Authorization: Bearer <ACCESS_TOKEN>' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json'
```
**Query Parameters:**
- `number` (string) – A specific Change Request number to search for in the `change_request` table
- `approval` (string) – Filters results to return only Change Requests with the specified approval status
- `sysparm_fields` (string) – Fields to include in the response
### **API #2: Get Approved Change Request by Description**
```bash
curl --location 'https://<YOUR_DOMAIN>/api/now/table/change_request?sysparm_query=short_descriptionLIKE{{short_desc}}^approval=approved&sysparm_fields=sys_id,number,approval,state,short_description' \
--header 'Authorization: Bearer <ACCESS_TOKEN>' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json'
```
---
**Query Parameters:**
- `short_description` (string) – A keyword or phrase to match against the **short description** field in the `change_request` table.
- `approval` (string) – Filters results to return only Change Requests with the specified **approval status**.
- `sysparm_fields` (string) – Fields to include in the response
### API #3: **Schedule a Change**
```bash
curl --location --request PATCH 'https://<YOUR_DOMAIN>/api/now/table/change_request/{{sys_id}}' \
--header 'Authorization: Bearer <ACCESS_TOKEN>' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{
"start_date": "{{start_date}}",
"end_date": "{{end_date}}"
}'
```
**Query Parameters:**
- `sys_id` (string) – The unique identifier of the Change Request to be updated
- `start_date` (string) – The scheduled start date and time for the change
- `end_date` (string) – The scheduled end date and time for the change