---
title: "Update the task rate limit settings at runtime"
method: PUT
path: "/workflow_engine/workers/rate_limit"
tags: ["Workflow Engine"]
---

# Update the task rate limit settings at runtime

`PUT /workflow_engine/workers/rate_limit`

## Request

- Base URL: `https://example.itential.io`
- URL: `https://example.itential.io/workflow_engine/workers/rate_limit`
- Auth: none declared

Updates one or more rate limit properties for the task worker without requiring a restart.

## Request body

- object
  - `rateLimit` integer: The maximum number of tasks to run per period. The value 0 disables the rate limiter.
  - `rateLimitPeriod` integer: The time period in seconds for the task worker rate limit.

## Response `200`

The result of the operation.

- WorkflowEngineUpdateTaskRateLimitResponse200
  - `success` boolean
  - `newLimits` WorkflowEngineWorkersRateLimitPutResponsesContentApplicationJsonSchemaNewLimits

## Other responses

- `500`: Error response from API

## Changes

- **2026-10-31** `2095cc90e583`: 2 info
  - api tag `Workflow Engine` added
  - api tag `workflowEngine` removed

[Operation history](https://skmtc.dev/itential/apis/itential-2/changes/workflow_engine/workers/rate_limit/put.md)

---

[API](https://skmtc.dev/itential/apis/itential-2.md) - [All operations](https://skmtc.dev/itential/apis/itential-2/llms.txt) - [OpenAPI document](https://skmtc.dev/itential/apis/itential-2/revisions/2095cc90e583?raw)