---
title: "Schedule"
method: POST
path: "/v0/schedule/"
tags: ["schedule"]
---

# Schedule

`POST /v0/schedule/`

## Request body

- ScheduleRequest
  - `windows` TimeRange[], required — List of time windows to schedule (start and end must be in the future)
    - `start` string, date-time, required
    - `end` string, date-time, required
  - `duration` string, duration, required
  - `zones` CloudZone[], required
    - `provider` 'aws' | 'gcp' | 'azure' | 'ovh', required
    - `region` union, required
      - 'af-south-1' | 'ap-east-1' | 'ap-northeast-1' | 'ap-northeast-2' | 'ap-northeast-3' | 'ap-south-1' | 'ap-south-2' | 'ap-southeast-2' | 'ap-southeast-3' | 'ap-southeast-4' | 'ap-southeast-5' | 'ap-southeast-7' | 'ca-central-1' | 'ca-west-1' | 'eu-central-1' | 'eu-central-2' | 'eu-north-1' | 'eu-south-1' | 'eu-south-2' | 'eu-west-1' | 'eu-west-2' | 'eu-west-3' | 'il-central-1' | 'me-central-1' | 'mx-central-1' | 'sa-east-1' | 'us-east-1' | 'us-east-2' | 'us-west-1' | 'us-west-2'
      - 'asia-east1' | 'asia-northeast1' | 'asia-southeast1' | 'europe-north1' | 'europe-west1' | 'europe-west3' | 'europe-west4' | 'northamerica-northeast2' | 'southamerica-west1' | 'us-central1' | 'us-east1' | 'us-east4' | 'us-west1' | 'us-west2'
      - 'australiacentral' | 'australiaeast' | 'australiasoutheast' | 'brazilsouth' | 'canadacentral' | 'canadaeast' | 'centralindia' | 'centralus' | 'chinaeast2' | 'chinanorth' | 'chinanorth2' | 'chinanorth3' | 'eastasia' | 'eastus' | 'eastus2' | 'francecentral' | 'germanywestcentral' | 'indonesiacentral' | 'israelcentral' | 'italynorth' | 'japaneast' | 'japanwest' | 'koreacentral' | 'mexicocentral' | 'newzealandnorth' | 'northcentralus' | 'northeurope' | 'norwayeast' | 'polandcentral' | 'southafricanorth' | 'southcentralus' | 'southindia' | 'spaincentral' | 'swedencentral' | 'switzerlandnorth' | 'uaenorth' | 'uksouth' | 'ukwest' | 'westcentralus' | 'westeurope' | 'westus' | 'westus2' | 'westus3'
      - 'fr-strasbourg' | 'pl-warsaw'
  - `num_options` integer, nullable

## Response `200`

Successful Response

- ScheduleResponse
  - `ideal` ScheduleOption, required
    - `time` string, date-time, required
    - `zone` CloudZone, required
      - `provider` 'aws' | 'gcp' | 'azure' | 'ovh', required
      - `region` union, required
        - 'af-south-1' | 'ap-east-1' | 'ap-northeast-1' | 'ap-northeast-2' | 'ap-northeast-3' | 'ap-south-1' | 'ap-south-2' | 'ap-southeast-2' | 'ap-southeast-3' | 'ap-southeast-4' | 'ap-southeast-5' | 'ap-southeast-7' | 'ca-central-1' | 'ca-west-1' | 'eu-central-1' | 'eu-central-2' | 'eu-north-1' | 'eu-south-1' | 'eu-south-2' | 'eu-west-1' | 'eu-west-2' | 'eu-west-3' | 'il-central-1' | 'me-central-1' | 'mx-central-1' | 'sa-east-1' | 'us-east-1' | 'us-east-2' | 'us-west-1' | 'us-west-2'
        - 'asia-east1' | 'asia-northeast1' | 'asia-southeast1' | 'europe-north1' | 'europe-west1' | 'europe-west3' | 'europe-west4' | 'northamerica-northeast2' | 'southamerica-west1' | 'us-central1' | 'us-east1' | 'us-east4' | 'us-west1' | 'us-west2'
        - 'australiacentral' | 'australiaeast' | 'australiasoutheast' | 'brazilsouth' | 'canadacentral' | 'canadaeast' | 'centralindia' | 'centralus' | 'chinaeast2' | 'chinanorth' | 'chinanorth2' | 'chinanorth3' | 'eastasia' | 'eastus' | 'eastus2' | 'francecentral' | 'germanywestcentral' | 'indonesiacentral' | 'israelcentral' | 'italynorth' | 'japaneast' | 'japanwest' | 'koreacentral' | 'mexicocentral' | 'newzealandnorth' | 'northcentralus' | 'northeurope' | 'norwayeast' | 'polandcentral' | 'southafricanorth' | 'southcentralus' | 'southindia' | 'spaincentral' | 'swedencentral' | 'switzerlandnorth' | 'uaenorth' | 'uksouth' | 'ukwest' | 'westcentralus' | 'westeurope' | 'westus' | 'westus2' | 'westus3'
        - 'fr-strasbourg' | 'pl-warsaw'
    - `co2_intensity` number, required
  - `options` ScheduleOption[], required
    - `time` string, date-time, required
    - `zone` CloudZone, required
      - `provider` 'aws' | 'gcp' | 'azure' | 'ovh', required
      - `region` union, required
        - 'af-south-1' | 'ap-east-1' | 'ap-northeast-1' | 'ap-northeast-2' | 'ap-northeast-3' | 'ap-south-1' | 'ap-south-2' | 'ap-southeast-2' | 'ap-southeast-3' | 'ap-southeast-4' | 'ap-southeast-5' | 'ap-southeast-7' | 'ca-central-1' | 'ca-west-1' | 'eu-central-1' | 'eu-central-2' | 'eu-north-1' | 'eu-south-1' | 'eu-south-2' | 'eu-west-1' | 'eu-west-2' | 'eu-west-3' | 'il-central-1' | 'me-central-1' | 'mx-central-1' | 'sa-east-1' | 'us-east-1' | 'us-east-2' | 'us-west-1' | 'us-west-2'
        - 'asia-east1' | 'asia-northeast1' | 'asia-southeast1' | 'europe-north1' | 'europe-west1' | 'europe-west3' | 'europe-west4' | 'northamerica-northeast2' | 'southamerica-west1' | 'us-central1' | 'us-east1' | 'us-east4' | 'us-west1' | 'us-west2'
        - 'australiacentral' | 'australiaeast' | 'australiasoutheast' | 'brazilsouth' | 'canadacentral' | 'canadaeast' | 'centralindia' | 'centralus' | 'chinaeast2' | 'chinanorth' | 'chinanorth2' | 'chinanorth3' | 'eastasia' | 'eastus' | 'eastus2' | 'francecentral' | 'germanywestcentral' | 'indonesiacentral' | 'israelcentral' | 'italynorth' | 'japaneast' | 'japanwest' | 'koreacentral' | 'mexicocentral' | 'newzealandnorth' | 'northcentralus' | 'northeurope' | 'norwayeast' | 'polandcentral' | 'southafricanorth' | 'southcentralus' | 'southindia' | 'spaincentral' | 'swedencentral' | 'switzerlandnorth' | 'uaenorth' | 'uksouth' | 'ukwest' | 'westcentralus' | 'westeurope' | 'westus' | 'westus2' | 'westus3'
        - 'fr-strasbourg' | 'pl-warsaw'
    - `co2_intensity` number, required
  - `worst_case` ScheduleOption, required
    - `time` string, date-time, required
    - `zone` CloudZone, required
      - `provider` 'aws' | 'gcp' | 'azure' | 'ovh', required
      - `region` union, required
        - 'af-south-1' | 'ap-east-1' | 'ap-northeast-1' | 'ap-northeast-2' | 'ap-northeast-3' | 'ap-south-1' | 'ap-south-2' | 'ap-southeast-2' | 'ap-southeast-3' | 'ap-southeast-4' | 'ap-southeast-5' | 'ap-southeast-7' | 'ca-central-1' | 'ca-west-1' | 'eu-central-1' | 'eu-central-2' | 'eu-north-1' | 'eu-south-1' | 'eu-south-2' | 'eu-west-1' | 'eu-west-2' | 'eu-west-3' | 'il-central-1' | 'me-central-1' | 'mx-central-1' | 'sa-east-1' | 'us-east-1' | 'us-east-2' | 'us-west-1' | 'us-west-2'
        - 'asia-east1' | 'asia-northeast1' | 'asia-southeast1' | 'europe-north1' | 'europe-west1' | 'europe-west3' | 'europe-west4' | 'northamerica-northeast2' | 'southamerica-west1' | 'us-central1' | 'us-east1' | 'us-east4' | 'us-west1' | 'us-west2'
        - 'australiacentral' | 'australiaeast' | 'australiasoutheast' | 'brazilsouth' | 'canadacentral' | 'canadaeast' | 'centralindia' | 'centralus' | 'chinaeast2' | 'chinanorth' | 'chinanorth2' | 'chinanorth3' | 'eastasia' | 'eastus' | 'eastus2' | 'francecentral' | 'germanywestcentral' | 'indonesiacentral' | 'israelcentral' | 'italynorth' | 'japaneast' | 'japanwest' | 'koreacentral' | 'mexicocentral' | 'newzealandnorth' | 'northcentralus' | 'northeurope' | 'norwayeast' | 'polandcentral' | 'southafricanorth' | 'southcentralus' | 'southindia' | 'spaincentral' | 'swedencentral' | 'switzerlandnorth' | 'uaenorth' | 'uksouth' | 'ukwest' | 'westcentralus' | 'westeurope' | 'westus' | 'westus2' | 'westus3'
        - 'fr-strasbourg' | 'pl-warsaw'
    - `co2_intensity` number, required
  - `naive_case` ScheduleOption, required
    - `time` string, date-time, required
    - `zone` CloudZone, required
      - `provider` 'aws' | 'gcp' | 'azure' | 'ovh', required
      - `region` union, required
        - 'af-south-1' | 'ap-east-1' | 'ap-northeast-1' | 'ap-northeast-2' | 'ap-northeast-3' | 'ap-south-1' | 'ap-south-2' | 'ap-southeast-2' | 'ap-southeast-3' | 'ap-southeast-4' | 'ap-southeast-5' | 'ap-southeast-7' | 'ca-central-1' | 'ca-west-1' | 'eu-central-1' | 'eu-central-2' | 'eu-north-1' | 'eu-south-1' | 'eu-south-2' | 'eu-west-1' | 'eu-west-2' | 'eu-west-3' | 'il-central-1' | 'me-central-1' | 'mx-central-1' | 'sa-east-1' | 'us-east-1' | 'us-east-2' | 'us-west-1' | 'us-west-2'
        - 'asia-east1' | 'asia-northeast1' | 'asia-southeast1' | 'europe-north1' | 'europe-west1' | 'europe-west3' | 'europe-west4' | 'northamerica-northeast2' | 'southamerica-west1' | 'us-central1' | 'us-east1' | 'us-east4' | 'us-west1' | 'us-west2'
        - 'australiacentral' | 'australiaeast' | 'australiasoutheast' | 'brazilsouth' | 'canadacentral' | 'canadaeast' | 'centralindia' | 'centralus' | 'chinaeast2' | 'chinanorth' | 'chinanorth2' | 'chinanorth3' | 'eastasia' | 'eastus' | 'eastus2' | 'francecentral' | 'germanywestcentral' | 'indonesiacentral' | 'israelcentral' | 'italynorth' | 'japaneast' | 'japanwest' | 'koreacentral' | 'mexicocentral' | 'newzealandnorth' | 'northcentralus' | 'northeurope' | 'norwayeast' | 'polandcentral' | 'southafricanorth' | 'southcentralus' | 'southindia' | 'spaincentral' | 'swedencentral' | 'switzerlandnorth' | 'uaenorth' | 'uksouth' | 'ukwest' | 'westcentralus' | 'westeurope' | 'westus' | 'westus2' | 'westus3'
        - 'fr-strasbourg' | 'pl-warsaw'
    - `co2_intensity` number, required
  - `median_case` ScheduleOption, required
    - `time` string, date-time, required
    - `zone` CloudZone, required
      - `provider` 'aws' | 'gcp' | 'azure' | 'ovh', required
      - `region` union, required
        - 'af-south-1' | 'ap-east-1' | 'ap-northeast-1' | 'ap-northeast-2' | 'ap-northeast-3' | 'ap-south-1' | 'ap-south-2' | 'ap-southeast-2' | 'ap-southeast-3' | 'ap-southeast-4' | 'ap-southeast-5' | 'ap-southeast-7' | 'ca-central-1' | 'ca-west-1' | 'eu-central-1' | 'eu-central-2' | 'eu-north-1' | 'eu-south-1' | 'eu-south-2' | 'eu-west-1' | 'eu-west-2' | 'eu-west-3' | 'il-central-1' | 'me-central-1' | 'mx-central-1' | 'sa-east-1' | 'us-east-1' | 'us-east-2' | 'us-west-1' | 'us-west-2'
        - 'asia-east1' | 'asia-northeast1' | 'asia-southeast1' | 'europe-north1' | 'europe-west1' | 'europe-west3' | 'europe-west4' | 'northamerica-northeast2' | 'southamerica-west1' | 'us-central1' | 'us-east1' | 'us-east4' | 'us-west1' | 'us-west2'
        - 'australiacentral' | 'australiaeast' | 'australiasoutheast' | 'brazilsouth' | 'canadacentral' | 'canadaeast' | 'centralindia' | 'centralus' | 'chinaeast2' | 'chinanorth' | 'chinanorth2' | 'chinanorth3' | 'eastasia' | 'eastus' | 'eastus2' | 'francecentral' | 'germanywestcentral' | 'indonesiacentral' | 'israelcentral' | 'italynorth' | 'japaneast' | 'japanwest' | 'koreacentral' | 'mexicocentral' | 'newzealandnorth' | 'northcentralus' | 'northeurope' | 'norwayeast' | 'polandcentral' | 'southafricanorth' | 'southcentralus' | 'southindia' | 'spaincentral' | 'swedencentral' | 'switzerlandnorth' | 'uaenorth' | 'uksouth' | 'ukwest' | 'westcentralus' | 'westeurope' | 'westus' | 'westus2' | 'westus3'
        - 'fr-strasbourg' | 'pl-warsaw'
    - `co2_intensity` number, required
  - `carbon_savings` CarbonSavings, required
    - `vs_worst_case` number, required
    - `vs_naive_case` number, required
    - `vs_median_case` number, required

## Other responses

- `404` — Not found
- `422` — Validation Error

---

[API](https://skmtc.net/carbon-aware/apis/carbon-aware-scheduler.md) · [All operations](https://skmtc.net/carbon-aware/apis/carbon-aware-scheduler/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/carbon-aware/carbon-aware-scheduler/versions/2dbf4d087175/schema)