---
title: "Snooze Catalog Entry"
method: POST
path: "/catalog/{api_id}:snooze"
tags: ["Catalog"]
---

# Snooze Catalog Entry

`POST /catalog/{api_id}:snooze`

Snooze the outstanding update notification for a catalog entry (C1, #925).

Operator action (``events:write``): quiet the "update available" badge for a
known-and-accepted upstream change without adopting it. Body is optional — omit or send
``{"snoozed_until": null}`` to mute until a newer upstream digest lands (the primary
per-API affordance); send an ISO-8601 ``snoozed_until`` for a time-boxed snooze. A
genuinely newer upstream change re-lights the badge automatically.

## Path parameters

- `api_id` string, required

## Request body

- CatalogSnoozeRequest — Body for ``POST /catalog/{api_id}:snooze`` (C1, #925). ``snoozed_until`` is optional: omit or send ``null`` to mute-until-newer (the primary per-API affordance — the badge re-lights only when a *newer* upstream digest lands); provide an ISO-8601 timestamp for a time-boxed snooze that lapses at that instant.
  - `snoozed_until` string, date-time, nullable — Optional expiry for the snooze (ISO-8601). Null = mute until a newer upstream digest is observed.

## Response `204`

Successful Response

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `409` — The catalog entry has no outstanding update to snooze.
- `422` — Unprocessable Entity
- `500` — Internal Server Error
- `503` — Service Unavailable

---

[API](https://skmtc.net/jentic/apis/jentic-control-plane-api.md) · [All operations](https://skmtc.net/jentic/apis/jentic-control-plane-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/jentic/jentic-control-plane-api/versions/ff371f19960a/schema)