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

# Replace a user's planning for a specific day

`PUT /users/{userId}/plannings/{day}`

Replaces a user's availability planning for a single day of the week. This is a more targeted alternative to `PUT /users/{userId}/plannings` — use it when you only need to modify one day without replacing the entire week. Planning must be enabled in the user's settings (`is_planning = true`). 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
- `day` 'monday' | 'tuesday' | 'wednesday' | 'thursday' | 'friday' | 'saturday' | 'sunday', required

## Request body

- TimeRangesShort[]
  - `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)