---
title: "Set Release Timer"
method: PUT
path: "/api/v1/admin/release-timer"
tags: ["Admin APIs", "release-timer"]
---

# Set Release Timer

`PUT /api/v1/admin/release-timer`

Start or stop the release timer. Idempotent in both directions.

## Request body

- ReleaseTimerUpdate — Start (``running=true``) or stop (``running=false``) the release timer. ``label`` is an optional free-text tag applied when starting; ignored on stop.
  - `running` boolean, required
  - `label` string, nullable

## Response `200`

Successful Response

- ReleaseTimerRead — Current release timer state — the single open timing, if any.
  - `running` boolean, required
  - `id` string, nullable
  - `label` string, nullable
  - `started_at` string, date-time, nullable
  - `started_by` string, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/carbonarc/apis/carbon-arc-client-admin-api.md) · [All operations](https://skmtc.net/carbonarc/apis/carbon-arc-client-admin-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/carbonarc/carbon-arc-client-admin-api/revisions/a8ca30023371/schema)