{
  "id": "updates",
  "title": "CRDB updates requests",
  "url": "https://redis.io/docs/latest/operate/rs/7.8/references/rest-api/requests/crdbs/updates/",
  "summary": "Update Active-Active configuration requests",
  "content": "\n| Method | Path | Description |\n|--------|------|-------------|\n| [POST](#post-crdbs-updates) | `/v1/crdbs/{crdb_guid}/updates` | Modify Active-Active confgurarion |\n\n## Modify Active-Active configuration {#post-crdbs-updates}\n\n\tPOST /v1/crdbs/{crdb_guid}/updates\n\nModify Active-Active configuration.\n\n\nThis is a very powerful API request and can cause damage if used incorrectly.\n\n\nIn order to add or remove instances, you must use this API. For simple configuration updates, it is recommended to use PATCH on /crdbs/{crdb_guid} instead.\n\nUpdating default_db_config affects both existing and new instances that may be added.\n\nWhen you update db_config, it changes the configuration of the database that you specify. This field overrides corresponding fields (if any) in default_db_config.\n\n### Request {#post-request} \n\n#### Example HTTP request\n\n    POST /v1/crdbs/1/updates\n\n#### Request headers\n\n| Key | Value | Description |\n|-----|-------|-------------|\n| X-Task-ID | string | Specified task ID |\n| X-Result-TTL | integer | Time (in seconds) to keep task result |\n\n#### URL parameters\n\n| Field | Type | Description |\n|-------|------|-------------|\n| crdb_guid | string | Globally unique Active-Active database ID (GUID) |\n\n#### Query parameters\n\n| Field | Type | Description |\n|-------|------|-------------|\n| dry_run | boolean | Validate the request without applying changes (optional) |\n\n#### Request body\n\nInclude a [CRDB modify_request object]() with updated fields in the request body.\n\n### Response {#post-response} \n\nReturns a [CRDB task object]().\n\n### Status codes {#post-status-codes} \n\n| Code | Description |\n|------|-------------|\n| [200 OK](http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.2.1) | The request has been accepted. |\n| [400 Bad Request](http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.1) | The posted Active-Active database contains invalid parameters. |\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| [406\u0026nbsp;Not\u0026nbsp;Acceptable](http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.7) | The posted Active-Active database cannot be accepted. |\n",
  "tags": ["docs","operate","rs"],
  "last_updated": "2026-04-01T08:10:08-05:00"
}