---
title: "Create bandwidth schedule"
method: POST
path: "/schedules"
tags: ["Schedules"]
---

# Create bandwidth schedule

`POST /schedules`

## Request

- Base URL: `https://localhost:8446/api/v2`
- URL: `https://localhost:8446/api/v2/schedules`
- Auth: API key in header `Authorization`

Create new bandwidth schedule.

## Request body

- object
  - `name` string, required: Bandwidth schedule name
  - `description` string, required: Bandwidth schedule description
  - `time_blocks` number, required: Bandwidth schedule's rules indexes. First level array contains arrays of indexes per day of week (starting from Monday). Second level array contains rule indexes for each hour (0-23). Scheduler runs in a local Agents time zone
  - `custom_rules` object: Bandwidth schedule's rules descriptions. Default rules "Full bandwidth" (index = 0) and "Pause synchronization" (index = 1) will be applied automatically. Custom rules indexes start from 2
  - `custom_rules.up_speed` number, required: Rule sending limit (KBps). Unlimited value is -1, min available limited value is 1
  - `custom_rules.down_speed` number, required: Rule receiving limit (KBps). Unlimited value is -1, min available limited value is 1

## Response `200`

Successful response

- object

## Other responses

- `default`: Error response. Depending on the error, either a 4xx or 5xx response status is returned.

---

[API](https://skmtc.dev/resilio/apis/resilio-api.md) - [All operations](https://skmtc.dev/resilio/apis/resilio-api/llms.txt) - [OpenAPI document](https://skmtc.dev/resilio/apis/resilio-api/revisions/ca39130a395e?raw)