Create Auto Scaling Group Schedule

POST

/notebooks/autoscale-groups/{group_id}/scheduled-policies/

curl --request POST \
  --url 'https://api.e2enetworks.com/myaccount/api/v1/gpu/notebooks/autoscale-groups/{group_id}/scheduled-policies/?project_id=<PROJECT_ID>&location=<LOCATION>&apikey=<API_KEY>' \
  --header 'Authorization: Bearer <API_TOKEN>' \
  --header 'Content-Type: application/json' \
  --data '{
  "cron_expression": "0 8 * * 1-5",
  "target_min_replicas": 3,
  "target_max_replicas": 10,
  "name": "Morning",
  "enabled": true,
  "timezone_name": "Asia/Kolkata",
  "duration_seconds": 28800
}'

Adds a schedule to an Auto Scaling Group. The schedule starts running at once, unless enabled is false. A cron expression that cannot be read is refused and nothing is kept. Needs the permission to create.

Parameters

Path Parameters

group_id

required

integer

Auto Scaling Group ID

Query Parameters

project_id

required

integer

Project ID

active_iam

integer

Active IAM ID (To access contact person account) Find your Active IAM ID here

location

required

string

Allowed values: Delhi Chennai

Location

Request Body^required

Media typeapplication/json

object

cron_expression

required

When the schedule runs, as a cron expression read in timezone_name. At most 64 characters. Required.

string

<= 64 characters

Example

0 8 * * 1-5

target_min_replicas

required

Minimum number of VMs the schedule sets. Required, a whole number of at least 1.

integer

Example

3

target_max_replicas

required

Maximum number of VMs the schedule sets. Required, more than target_min_replicas and at most 60.

integer

Example

10

name

A label for the schedule. At most 128 characters. Default: empty.

string

<= 128 characters

Example

Morning

enabled

false creates the schedule paused: it does not run and holds no capacity. Default: true.

boolean

Example

true

timezone_name

Any time zone name, such as UTC or Asia/Kolkata. At most 64 characters. Default: UTC.

string

<= 64 characters

Example

Asia/Kolkata

duration_seconds

How long, in seconds, the schedule holds its range before the group goes back to its own. From 60 to 2,592,000 (30 days). Leave it out or send null for a permanent change. Default: null.

integer

nullable

Example

28800

Responses

201

Schedule created

Media typeapplication/json

object

code

integer

message

string

data

object

id

integer

group_id

ID of the Auto Scaling Group.

integer

name

The schedule’s name. Empty when none was sent.

string

<= 128 characters

cron_expression

When the schedule runs, as a cron expression.

string

<= 64 characters

timezone_name

The time zone cron_expression is read in.

string

<= 64 characters

target_min_replicas

Minimum number of VMs the schedule sets.

integer

target_max_replicas

Maximum number of VMs the schedule sets.

integer

enabled

false when the schedule is paused and does not run.

boolean

duration_seconds

How long, in seconds, the schedule holds its range before the group goes back to its own. null when the change is permanent.

integer

nullable

window_ends_at

When the hold that is on now ends. null when the schedule is not holding.

string

nullable

next_run_at

When the schedule runs next. null when it is paused.

string

nullable

last_run_at

When the schedule last ran. null until it has.

string

nullable

created_at

string

nullable

errors

object

Example

{
  "code": 201,
  "message": "Created Successfully",
  "data": {
    "id": 12,
    "group_id": 41,
    "name": "Morning",
    "cron_expression": "0 8 * * 1-5",
    "timezone_name": "Asia/Kolkata",
    "target_min_replicas": 3,
    "target_max_replicas": 10,
    "enabled": true,
    "duration_seconds": 28800,
    "window_ends_at": null,
    "next_run_at": "2026-10-22T08:00:00+05:30",
    "last_run_at": null,
    "created_at": "2026-10-21T10:02:11+00:00"
  },
  "errors": {}
}

400

A field is missing or out of range. errors names the first one found. errors is “Project ID is missing or invalid” when project_id is missing or not a number.

Media typeapplication/json

object

code

integer

message

string

data

object

errors

One of: “cron_expression is required.”, “target_min_replicas must be a positive integer.”, “target_max_replicas must be a positive integer.”, “target_max_replicas must be greater than target_min_replicas.”, “target_max_replicas cannot exceed the platform limit of 60 replicas per group.”, “duration_seconds must be between 60 and 2592000 seconds, or null for a permanent change.”, “duration_seconds must be an integer number of seconds, or null for a permanent change.”, “timezone_name ‘X’ is not a recognized IANA timezone (e.g. ‘UTC’, ‘Asia/Kolkata’).”

string

Example

{
  "code": 400,
  "message": "Bad Request",
  "data": {},
  "errors": "target_max_replicas must be greater than target_min_replicas."
}

404

No Auto Scaling Group with that ID in the project and region.

Media typeapplication/json

object

code

integer

message

string

data

object

errors

string

Example

{
  "code": 404,
  "message": "Bad Request",
  "data": {},
  "errors": "Autoscale Group not found"
}

500

The cron expression could not be read. The schedule is not kept.

Media typeapplication/json

object

code

integer

message

string

data

string

errors

object

Example

{
  "code": 500,
  "message": "Internal Server Error",
  "data": "Failed to create schedule: could not parse cron_expression '0 8 * *'.",
  "errors": {}
}