---
title: "Create a throttle policy"
method: POST
path: "/throttle-policies"
tags: ["Throttle Policies"]
---

# Create a throttle policy

`POST /throttle-policies`

## Request body

- CreateThrottlePolicyCommand
  - `name` string, required
  - `settings` ThrottlePolicySettings
    - `ingestion` object
    - `cleanseAnalysis` object
      - `pumpBatchSize` integer
      - `pumpDelayMs` integer
      - `recordIssueDelayMs` integer
      - `progressUpdateInterval` integer
      - `rpmWindowSeconds` integer
    - `cleanseExport` object
      - `streamBatchSize` integer
      - `throttlingDelayMs` integer
      - `rpmWindowSeconds` integer
    - `issueDeactivation` object
      - `batchSize` integer
      - `throttleDelayMs` integer
      - `rpmWindowSeconds` integer
    - `issueQuery` object

## Response `201`

Policy created

- ThrottlePolicy
  - `name` string
  - `slug` string
  - `isActive` boolean
  - `isReadOnly` boolean
  - `settings` ThrottlePolicySettings
    - `ingestion` object
    - `cleanseAnalysis` object
      - `pumpBatchSize` integer
      - `pumpDelayMs` integer
      - `recordIssueDelayMs` integer
      - `progressUpdateInterval` integer
      - `rpmWindowSeconds` integer
    - `cleanseExport` object
      - `streamBatchSize` integer
      - `throttlingDelayMs` integer
      - `rpmWindowSeconds` integer
    - `issueDeactivation` object
      - `batchSize` integer
      - `throttleDelayMs` integer
      - `rpmWindowSeconds` integer
    - `issueQuery` object

## Other responses

- `400` — Validation error
- `409` — Duplicate slug

---

[API](https://skmtc.net/defra/apis/keeper-data-bridge-api.md) · [All operations](https://skmtc.net/defra/apis/keeper-data-bridge-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/defra/keeper-data-bridge-api/versions/0ab7d7a7a24f/schema)
