---
title: "Create Scheduled Mission"
method: POST
path: "/v0/mission/schedule"
tags: ["Missions"]
---

# Create Scheduled Mission

`POST /v0/mission/schedule`

Create a new schedule for a specific mission template.

## Request body

- union — Arguments to the POST /mission/schedule endpoint
  - object
    - `battery_threshold` integer — The miminum battery percentage required for the vehicle to run the mission. If the battery percentage reaches this mid-flight, the vehicle will return to the dock.
    - `dock_id` string, required — Deprecated, use dock_serial instead
    - `dock_serial` string
    - `schedule_events` object[], required
      - `day_of_week` integer — Numerical representation of the day of the week, where 1 is Monday and 7 is Sunday
      - `time_of_day` string — Clock time conforming to the full-time spec in RFC3339.
    - `template_uuid` string, uuid, required
    - `vehicle_id` string — Deprecated, use vehicle_serial instead
    - `vehicle_serial` string
  - object
    - `battery_threshold` integer — The miminum battery percentage required for the vehicle to run the mission. If the battery percentage reaches this mid-flight, the vehicle will return to the dock.
    - `dock_id` string — Deprecated, use dock_serial instead
    - `dock_serial` string, required
    - `schedule_events` object[], required
      - `day_of_week` integer — Numerical representation of the day of the week, where 1 is Monday and 7 is Sunday
      - `time_of_day` string — Clock time conforming to the full-time spec in RFC3339.
    - `template_uuid` string, uuid, required
    - `vehicle_id` string — Deprecated, use vehicle_serial instead
    - `vehicle_serial` string
  - object
    - `battery_threshold` integer — The miminum battery percentage required for the vehicle to run the mission. If the battery percentage reaches this mid-flight, the vehicle will return to the dock.
    - `dock_id` string — Deprecated, use dock_serial instead
    - `dock_serial` string
    - `schedule_events` object[], required
      - `day_of_week` integer — Numerical representation of the day of the week, where 1 is Monday and 7 is Sunday
      - `time_of_day` string — Clock time conforming to the full-time spec in RFC3339.
    - `template_uuid` string, uuid, required
    - `vehicle_id` string, required — Deprecated, use vehicle_serial instead
    - `vehicle_serial` string
  - object
    - `battery_threshold` integer — The miminum battery percentage required for the vehicle to run the mission. If the battery percentage reaches this mid-flight, the vehicle will return to the dock.
    - `dock_id` string — Deprecated, use dock_serial instead
    - `dock_serial` string
    - `schedule_events` object[], required
      - `day_of_week` integer — Numerical representation of the day of the week, where 1 is Monday and 7 is Sunday
      - `time_of_day` string — Clock time conforming to the full-time spec in RFC3339.
    - `template_uuid` string, uuid, required
    - `vehicle_id` string — Deprecated, use vehicle_serial instead
    - `vehicle_serial` string, required

## Response `200`

Scheduled mission returned from PATCH or POST /mission/schedule endpoints

- object
  - `data` object, required — Scheduled mission returned from PATCH or POST /mission/schedule endpoints
    - `scheduled_mission` object, required
      - `active` boolean — The active status cannot be toggled while editing the other attributes of a scheduled mission.
      - `battery_threshold` integer — The miminum battery percentage required for the vehicle to run the mission. If the battery percentage reaches this mid-flight, the vehicle will return to the dock.
      - `dock_id` string — Deprecated, use dock_serial instead
      - `dock_serial` string
      - `schedule_events` object[], required
        - `day_of_week` integer — Numerical representation of the day of the week, where 1 is Monday and 7 is Sunday
        - `time_of_day` string — Clock time conforming to the full-time spec in RFC3339.
      - `template_uuid` string, uuid, required
      - `uuid` string, uuid, required
      - `vehicle_id` string — Deprecated, use vehicle_serial instead
      - `vehicle_serial` string
  - `error_message` string
  - `meta` object, required
    - `time` number
  - `skydio_error_code` integer, required
  - `status_code` integer, required

## Other responses

- `404` — Not Found

---

[API](https://skmtc.net/skydio/apis/skydio-cloud-api.md) · [All operations](https://skmtc.net/skydio/apis/skydio-cloud-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/skydio/skydio-cloud-api/revisions/0f746b116483/schema)