---
title: "Update deploy request throttler configurations"
method: PATCH
path: "/organizations/{organization}/databases/{database}/deploy-requests/{number}/throttler"
tags: ["Deploy requests"]
---

# Update deploy request throttler configurations

`PATCH /organizations/{organization}/databases/{database}/deploy-requests/{number}/throttler`

### Authorization
A service token or OAuth token must have at least one of the following access or scopes in order to use this API endpoint:

**Service Token Accesses**
 `create_deploy_request`

**OAuth Scopes**

 | Resource | Scopes |
| :------- | :---------- |
| Organization | `deploy_deploy_requests` |
| Database | `deploy_deploy_requests` |

## Path parameters

- `organization` string, required
- `database` string, required
- `number` integer, required

## Request body

- object
  - `ratio` integer — A throttler ratio between 0 and 95 that will apply to all keyspaces affected by the deploy request. 0 effectively disables throttler, while 95 drastically slows down migrations in the deploy request
  - `configurations` string[] — If specifying throttler ratios per keyspace, an array of { "keyspace_name": "mykeyspace", "ratio": 10 }, one for each eligible keyspace

## Response `200`

Deploy request throttler configurations

- object
  - `keyspaces` string[], required — Keyspaces that are eligible for throttler configuration in the configurable resource (database or deploy request)
  - `configurable` object, required
    - `id` string, required — The ID for the resource
    - `name` string, required — The name for the resource
    - `created_at` string, required — When the resource was created
    - `updated_at` string, required — When the resource was last updated
    - `deleted_at` string, nullable, required — When the resource was deleted, if deleted
  - `configurations` object[], required
    - `keyspace_name` string, required — Name of keyspace this throttler ratio applies to
    - `ratio` number, required — A throttler ratio between 0 and 95 that applies to migrations in this specific keyspace

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `500` — Internal Server Error

## Changes

- **2026-06-01** `72506953f367` — 1 breaking
  - the response property `configurable/deleted_at` became nullable for the status `200`
- **2025-12-09** `d710019068fb` — 2 breaking
  - for the `path` request parameter `number`, the type/format was changed from `number`/`` to `integer`/``
  - the `ratio` request property type/format changed from `number`/`` to `integer`/``
- **2025-12-06** `477c6ebdabdf` — 1 breaking
  - for the `path` request parameter `number`, the type/format was changed from `string`/`` to `number`/``

[Change history](https://skmtc.dev/planetscale/apis/planetscale-api/changes/organizations/:organization/databases/:database/deploy-requests/:number/throttler/patch.md)

---

[API](https://skmtc.dev/planetscale/apis/planetscale-api.md) · [All operations](https://skmtc.dev/planetscale/apis/planetscale-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/planetscale/planetscale-api/revisions/6d28c038c4fd/schema)