---
title: "Set or clear a user's snooze status"
method: PUT
path: "/users/{userId}/snooze"
tags: ["users"]
---

# Set or clear a user's snooze status

`PUT /users/{userId}/snooze`

Activates or deactivates snooze mode for a user. When snooze is active, the user is marked as unavailable and incoming calls are not routed to them (calls go to voicemail or are forwarded according to the user's call routing rules). The `name` field selects a predefined snooze label (e.g., "meeting", "lunch", "break") — use `GET /snoozes` to retrieve available labels. The optional `duration` field sets an auto-expiry in seconds; if `null` or omitted, snooze remains active until explicitly cleared. To clear snooze, send `name` as an empty string.

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

**Monitoring:** Not needed. This route works regardless of the Monitoring flag.

## Path parameters

- `userId` integer, required

## Request body

- object
  - `name` string
  - `duration` integer, nullable — Duration of snooze in seconds

## Response `200`

Successful operation

## Other responses

- `400` — The provided user ID is invalid
- `401` — Authentication token is missing, invalid, expired, or Users Write permission is missing
- `406` — The snooze data is invalid (e.g. unrecognized label or invalid duration)
- `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)