---
title: "Replace a user's entire weekly planning"
method: PUT
path: "/users/{userId}/plannings"
tags: ["users"]
---

# Replace a user's entire weekly planning

`PUT /users/{userId}/plannings`

Replaces a user's entire weekly availability planning with a new one. The request body must contain an array of time ranges for each day of the week (Monday through Sunday). Planning must be enabled in the user's settings (check `is_planning` via `GET /users/{userId}/plannings` first). If planning is disabled, the request returns `406`.

**Permission:** `Users Write` required.

**Monitoring:** **Required.** Modifying another user's planning is a supervisory operation. Returns `401 Unauthorized` if Monitoring is OFF on your API key.

## Path parameters

- `userId` integer, required

## Request body

- TimeRanges[]
  - `day` integer — Day of the week (0 => Monday, 6 => Sunday)
  - `start` integer — Start time in minutes (0 => 0:00)
  - `end` integer — End time in minutes (1440 => 24:00)

## Response `200`

Successful operation

## Other responses

- `401` — Authentication token is missing, invalid, expired, Users Write permission is missing, or monitoring is not enabled
- `406` — Planning is not enabled for this user, or the submitted planning data is invalid
- `500` — Internal server error

---

[API](https://skmtc.net/ringover/apis/ringover-public-api.md) · [All operations](https://skmtc.net/ringover/apis/ringover-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ringover/ringover-public-api/revisions/9da73dd2f99e/schema)