{
  "id": "purge",
  "title": "CRDB purge requests",
  "url": "https://redis.io/docs/latest/operate/rs/7.8/references/rest-api/requests/crdbs/purge/",
  "summary": "Purge removed Active-Active database requests",
  "content": "\n| Method | Path | Description |\n|--------|------|-------------|\n| [PUT](#put-crdbs-purge) | `/v1/crdbs/{crdb_guid}/purge` | Purge data from an instance that was forcibly removed from the Active-Active database |\n\n## Purge data from removed instance {#put-crdbs-purge}\n\n\tPUT /v1/crdbs/{crdb_guid}/purge\n\nPurge the data from an instance that was removed from the\nActive-Active database by force.\n\nWhen you force the removal of an instance from an Active-Active\ndatabase, the removed instance keeps the data and configuration\naccording to the last successful synchronization.\n\nTo delete the data and configuration from the forcefully removed\ninstance you must use this API (Must be executed locally on the\nremoved instance).\n\n### Request {#put-request} \n\n#### Example HTTP request\n\n    PUT /v1/crdbs/1/purge\n\n#### URL parameters\n\n| Field | Type | Description |\n|-------|------|-------------|\n| crdb_guid | string | Globally unique Active-Active database ID (GUID) |\n\n#### Request body\n\n| Field | Type | Description |\n|-------|------|-------------|\n| instances | array of integers | Array of unique instance IDs |\n\n### Response {#put-response} \n\nReturns a [CRDB task object]().\n\n### Status codes {#put-status-codes} \n\n| Code | Description |\n|------|-------------|\n| [200 OK](http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.2.1) | Action was successful. |\n| [400 Bad Request](http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.1) | The request is invalid or malformed. |\n| [401 Unauthorized](http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.2) | Unauthorized request. Invalid credentials |\n| [404 Not Found](http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.5) | Configuration, instance, or Active-Active database not found. |\n",
  "tags": ["docs","operate","rs"],
  "last_updated": "2026-04-01T08:10:08-05:00"
}