---
title: "Update database throttler configurations"
method: PATCH
path: "/organizations/{organization}/databases/{database}/throttler"
tags: ["Databases"]
---

# Update database throttler configurations

`PATCH /organizations/{organization}/databases/{database}/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**
 `write_database`

**OAuth Scopes**

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

## Path parameters

- `organization` string, required
- `database` string, required

## Request body

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

## Response `200`

Database 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

---

[API](https://skmtc.net/planetscale/apis/planetscale-api.md) · [All operations](https://skmtc.net/planetscale/apis/planetscale-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/planetscale/planetscale-api/versions/fa19f3305241/schema)