Add a version to a scripted REST API
task australia Updated Sep 10, 2026 1 min read t_AddAVersion.md
Add a new version to a versioned scripted REST API to define new API behavior without impacting older versions.
Before you begin
There must be a scripted REST Service that has versioning enabled before you can add a new version.
Role required: web_service_admin
Procedure
-
Navigate to All > System Web Services > Scripted REST APIs.
-
Select a scripted REST API.
-
Under Related Links, click Add new version.
The Add new version pop up appears.
-
Select Make this version the default to configure the REST service to use the new version as the default version.
-
In the Copy existing resources from version choice list, select an existing version to copy all resources from that version to the new version.
-
Click OK.
Parent Topic:Enable versioning for a scripted REST API
44 lines · 1.6 KB
---
title: Add a version to a scripted REST API
description: Add a new version to a versioned scripted REST API to define new API behavior without impacting older versions.
locale: en-US
canonical_url: https://www.servicenow.com/docs/r/australia/api-reference/rest-api-explorer/t\_AddAVersion.html
release: australia
product: REST API Explorer
classification: rest-api-explorer
topic_type: task
last_updated: "2026-09-10"
reading_time_minutes: 1
breadcrumb: [Enable versioning for a scripted REST API, Create a scripted REST API, Scripted REST APIs, REST APIs, Web services, API implementation, API implementation and reference]
---
# Add a version to a scripted REST API
Add a new version to a versioned scripted REST API to define new API behavior without impacting older versions.
## Before you begin
There must be a scripted REST Service that has versioning enabled before you can add a new version.
Role required: web\_service\_admin
## Procedure
1. Navigate to **All** > **System Web Services** > **Scripted REST APIs**.
2. Select a scripted REST API.
3. Under **Related Links**, click **Add new version**.
The **Add new version** pop up appears.
4. Select **Make this version the default** to configure the REST service to use the new version as the default version.
5. In the **Copy existing resources from version** choice list, select an existing version to copy all resources from that version to the new version.
6. Click **OK**.
**Parent Topic:**[Enable versioning for a scripted REST API](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/t_EnableVersioning.md)
| title | Add a version to a scripted REST API |
| description | Add a new version to a versioned scripted REST API to define new API behavior without impacting older versions. |
| locale | en-US |
| canonical_url | https://www.servicenow.com/docs/r/australia/api-reference/rest-api-explorer/t\_AddAVersion.html |
| release | australia |
| product | REST API Explorer |
| classification | rest-api-explorer |
| topic_type | task |
| last_updated | 2026-09-10 |
| reading_time_minutes | 1 |
| breadcrumb | Enable versioning for a scripted REST APICreate a scripted REST APIScripted REST APIsREST APIsWeb servicesAPI implementationAPI implementation and reference |