---
title: "Changes status(ON/OFF) of a scheduler by provided scheduler id"
method: PUT
path: "/scheduler/{schedulerId}/status"
tags: ["Scheduler"]
---

# Changes status(ON/OFF) of a scheduler by provided scheduler id

`PUT /scheduler/{schedulerId}/status`

## Request

- Base URL: `http://localhost:9090`
- URL: `http://localhost:9090/scheduler/{schedulerId}/status`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/opencelium/apis/opencelium-api/docs/scheduler/:schedulerId/status/put.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `schedulerId` integer, required

## Request body

- Scheduler
  - `id` integer
  - `title` string
  - `status` boolean
  - `debugMode` boolean
  - `cronExp` string
  - `createdBy` integer
  - `createdOn` string, date-time
  - `modifiedBy` integer
  - `modifiedOn` string, date-time
  - `connection` Connection
    - `id` integer
    - `snapshotId` string
    - `title` string
    - `description` string
    - `fromConnector` integer
    - `toConnector` integer
    - `createdBy` integer
    - `createdOn` string, date-time
    - `modifiedBy` integer
    - `modifiedOn` string, date-time
    - `icon` string
    - `schedulers` Scheduler[]
    - `categoryId` integer
    - `ocVersion` string
    - `revision` integer
  - `webhook` Webhook
    - `id` integer
    - `uuid` string
    - `token` string
    - `createdBy` integer
    - `createdOn` string, date-time
  - `executions` Execution[]
    - `id` integer
    - `reqType` string
    - `startTime` string, date-time
    - `endTime` string, date-time
    - `status` string
    - `executionArguments` ExecutionArgument[]
      - `execution` Execution (recursive)
      - `argument` Argument
        - `id` integer
        - `name` string
        - `description` string
        - `dataAggregator` DataAggregator
          - `id` integer
          - `name` string
          - `script` string
          - `active` boolean
          - `args` Argument[]
        - `executionArguments` ExecutionArgument[]
      - `value` string
  - `eventNotifications` EventNotification[]
    - `id` integer
    - `name` string
    - `eventType` string
    - `scheduler` Scheduler (recursive)
    - `eventMessage` EventMessage
      - `id` integer
      - `name` string
      - `type` string
      - `eventContents` EventContent[]
        - `id` integer
        - `subject` string
        - `body` string
        - `language` string
    - `eventRecipients` EventRecipient[]
      - `id` integer
      - `destination` string

## Response `200`

Scheduler status has been successfully changed

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `500`: Internal Error
- `502`: Bad Gateway

## Changes

> 3 revisions in range; 1 not diffed.

- **2026-07-30** `82ed767ffb65`: 1 warning, 4 info
  - removed the request property `connection/enhancements`
  - added the new optional request property `connection/revision`
  - added the new optional request property `connection/snapshotId`
  - added the non-success response with the status `400`
  - …1 more

[Operation history](https://skmtc.dev/opencelium/apis/opencelium-api/changes/scheduler/:schedulerId/status/put.md)

---

[API](https://skmtc.dev/opencelium/apis/opencelium-api.md) - [All operations](https://skmtc.dev/opencelium/apis/opencelium-api/llms.txt) - [OpenAPI document](https://skmtc.dev/opencelium/apis/opencelium-api/revisions/82ed767ffb65?raw)