{
  "id": "bdb",
  "title": "Database actions requests",
  "url": "https://redis.io/docs/latest/operate/rs/7.8/references/rest-api/requests/actions/bdb/",
  "summary": "Database actions requests",
  "content": "\n| Method | Path | Description |\n|--------|------|-------------|\n| [GET](#get-db-actions) | `/v1/actions/bdb/{bdb_uid}` | Get the status of a specific database's actions |\n\n## Get database actions {#get-db-actions}\n\n```\nGET /v1/actions/bdb/{bdb_uid}\n```\n\nGet the status of all currently executing, pending, or completed state-machine-related actions for a specific database. This API tracks short-lived API requests that return `action_uid`.\n\n#### Required permissions\n\n| Permission name |\n|-----------------|\n| [view_status_of_cluster_action]() |\n\n### Request {#get-request}\n\n#### Example HTTP request\n\n```\nGET /v1/actions/bdb/1\n```\n\n#### URL parameters\n\n| Field | Type | Description |\n|-------|------|-------------|\n| bdb_uid | string | Unique database ID |\n\n### Response {#get-response}\n\nReturns an array of JSON objects with attributes from [actions]() and [state machines]().\n\nEach action contains the following attributes: `name`, `action_uid`, `status`, and `progress`.\n\n#### Example JSON body\n\n```json\n[\n    {\n        \"action_uid\": \"8afc7f70-f3ae-4244-a5e9-5133e78b2e97\",\n        \"heartbeat\": 1703067908,\n        \"name\": \"SMUpdateBDB\",\n        \"object_name\": \"bdb:1\",\n        \"pending_ops\": {},\n        \"progress\": 50.0,\n        \"state\": \"proxy_policy\",\n        \"status\": \"active\"\n    }\n]\n```\n\n### Status codes {#get-status-codes}\n\n| Code | Description |\n|------|-------------|\n| [200 OK](http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.2.1) | No error, response provides info about state-machine actions |\n| [404 Not Found](http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.5) | bdb not found |\n",
  "tags": ["docs","operate","rs"],
  "last_updated": "2026-04-01T08:10:08-05:00"
}

