Method: projects.versions.create

  • A new immutable version of a script project is created using a POST request to a specific URL.

  • The request requires a scriptId as a path parameter to identify the project.

  • The request body is a JSON object containing optional fields like versionNumber, description, and createTime for the new version.

  • A successful response returns a newly created Version object.

  • Authorization requires the https://www.googleapis.com/auth/script.projects OAuth scope.

Creates a new immutable version using the current code, with a unique version number.

HTTP request

POST https://script.googleapis.com/v1/projects/{scriptId}/versions

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
scriptId

string

The script project's Drive ID.

Request body

The request body contains data with the following structure:

JSON representation 
{
  "versionNumber": integer,
  "description": string,
  "createTime": string
}
Fields
versionNumber

integer

The incremental ID that is created by Apps Script when a version is created. This is system assigned number and is immutable once created.
description

string

The description for this version.
createTime

string (Timestamp format)

When the version was created.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".

Response body

If successful, the response body contains a newly created instance of Version.

Authorization Scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/script.projects

For more information, see the OAuth 2.0 Overview.