---
title: "Replace Schedule"
method: PUT
path: "/v4/accounts/{voip_id}/schedules/{id}"
tags: ["Schedules"]
---

# Replace Schedule

`PUT /v4/accounts/{voip_id}/schedules/{id}`

## Request

- Base URL: `https://api.phone.com`
- URL: `https://api.phone.com/v4/accounts/{voip_id}/schedules/{id}`
- Auth: HTTP bearer

Replace a schedule

## Path parameters

- `voip_id` integer, required
- `id` integer, required

## Request body

- Schedule
  - `voip_id` integer, nullable: Account ID
  - `name` string, required: Schedule Name
  - `timezone` unknown
  - `items` object[], required: Schedule Items
    - `holiday_id` integer, nullable: Schedule holiday ID
    - `days_before` integer, nullable: Number of days before the holiday
    - `days_after` integer, nullable: Number of days after the holiday
    - `start_date` integer, nullable: The Scheduled Start Date
    - `end_date` integer, nullable: The Scheduled End Date
    - `start_hour` integer, nullable: Start hour of schedule
    - `start_minute` integer, nullable: Start minute of schedule
    - `end_hour` integer, nullable: End hour of schedule
    - `end_minute` integer, nullable: End minute of schedule
    - `day` 'M' | 'T' | 'W' | 'Th' | 'F' | 'S' | 'Su', nullable: Schedule day
    - `use_once` boolean, nullable: Check schedule if use once
    - `expiration_date` integer, nullable: Schedule expiration date

## Response `200`

OK

- object

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `402`: Payment Required
- `403`: Forbidden
- `404`: Not Found
- `409`: Conflict
- `422`: Validation failed
- `429`: Too Many Requests
- `500`: Internal Server Error

---

[API](https://skmtc.dev/phone/apis/phoenix-api-by-phone-com.md) · [All operations](https://skmtc.dev/phone/apis/phoenix-api-by-phone-com/llms.txt) · [OpenAPI document](https://skmtc.dev/phone/apis/phoenix-api-by-phone-com/revisions/a6274ad4319c?raw)