---
title: "Control Plan"
method: PATCH
path: "/admin/recurring-jobs/{plan_id}"
tags: ["admin"]
---

# Control Plan

`PATCH /admin/recurring-jobs/{plan_id}`

## Request

- Base URL: `https://api.kolens.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.kolens.ai/admin/recurring-jobs/{plan_id}`
- Auth: none declared

Pause/resume (status), change cadence (interval_hours, floored by the
guardrail), or change volume (max_videos_per_run).

## Path parameters

- `plan_id` string, required

## Headers

- `x-admin-secret` string, nullable

## Request body

- PlanControl
  - `status` string, nullable
  - `interval_hours` integer, nullable
  - `max_videos_per_run` integer, nullable

## Response `200`

Successful Response

- object

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/kolens/apis/kolens-api.md) · [All operations](https://skmtc.dev/kolens/apis/kolens-api/llms.txt) · [OpenAPI document](https://skmtc.dev/kolens/apis/kolens-api/revisions/5d6865ab0a24?raw)
