---
title: "Update elimination bucket"
method: POST
path: "/elimination.EliminationAnalyser/UpdateEliminationBucket"
tags: ["Elimination"]
---

# Update elimination bucket

`POST /elimination.EliminationAnalyser/UpdateEliminationBucket`

Updates the failure records for specific processors, affecting future elimination decisions.

## Headers

- `x-tenant-id` string, required
- `x-profile-id` string, required
- `x-api-key` string, required

## Request body

- UpdateEliminationBucketRequest
  - `id` string, required — Entity identifier
  - `params` string — Additional parameters
  - `labels_with_bucket_name` LabelWithBucketName[], required
    - `label` string, required — Processor identifier
    - `bucket_name` string, required — Bucket to update (failure type)
  - `config` EliminationBucketConfig, required
    - `bucket_size` integer, required — Maximum failures allowed before elimination
    - `bucket_leak_interval_in_secs` number, required — Time interval after which failures are "forgotten"

## Response `200`

Bucket updated successfully

- UpdateEliminationBucketResponse
  - `status` 'BUCKET_UPDATION_SUCCEEDED' | 'BUCKET_UPDATION_FAILED', required — Status of the update operation

## Other responses

- `400` — Invalid request parameters
- `500` — Internal server error

---

[API](https://skmtc.net/hyperswitch/apis/dynamic-routing-openapi-3-0.md) · [All operations](https://skmtc.net/hyperswitch/apis/dynamic-routing-openapi-3-0/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hyperswitch/dynamic-routing-openapi-3-0/revisions/8fbf69ab2597/schema)