{
  "id": "stop_traffic",
  "title": "Stop database traffic requests",
  "url": "https://redis.io/docs/latest/operate/rs/references/rest-api/requests/bdbs/actions/stop_traffic/",
  "summary": "REST API requests to stop traffic for a database",
  "tags": [
    "docs",
    "operate",
    "rs"
  ],
  "last_updated": "2026-04-08T12:21:52-07:00",
  "page_type": "content",
  "content_hash": "398beca1e2f713a5ceb77bb772e104133b663c2cde779d63168a320e367c8864",
  "sections": [
    {
      "id": "overview",
      "title": "Overview",
      "role": "overview",
      "text": "| Method | Path | Description |\n|--------|------|-------------|\n| [POST](#post-bdbs-actions-stop-traffic) | `/v1/bdbs/{uid}/actions/stop_traffic` | Stop database traffic |"
    },
    {
      "id": "stop-database-traffic-post-bdbs-actions-stop-traffic",
      "title": "Stop database traffic {#post-bdbs-actions-stop-traffic}",
      "role": "content",
      "text": "[code example]\n\nStop handling traffic for the database.\n\nUse this action to stop read and write traffic on a database. To resume traffic afterward, use the [`resume_traffic`]() action.\n\n#### Required permissions\n\n| Permission name | Roles |\n|-----------------|-------|\n| [update_bdb_with_action]() | admin<br />cluster_member<br />db_member |"
    },
    {
      "id": "request-post-request",
      "title": "Request {#post-request}",
      "role": "content",
      "text": "#### Example HTTP request\n\n[code example]\n\n#### URL parameters\n\n| Field | Type | Description |\n|-------|------|-------------|\n| uid | integer | The unique ID of the database. |"
    },
    {
      "id": "response-post-response",
      "title": "Response {#post-response}",
      "role": "returns",
      "text": "Returns a JSON object with an `action_uid`. You can track the action's progress with a [`GET /v1/actions/<action_uid>`]() request.\n\n#### Status codes {#post-status-codes}\n\n| Code | Description |\n|------|-------------|\n| [200 OK](https://www.rfc-editor.org/rfc/rfc9110.html#name-200-ok) | The request is accepted and is being processed. The database state will be `active-change-pending` until the request has been fully processed. |\n| [404 Not Found](https://www.rfc-editor.org/rfc/rfc9110.html#name-404-not-found) | Attempting to perform an action on a nonexistent database. |\n| [409 Conflict](https://www.rfc-editor.org/rfc/rfc9110.html#name-409-conflict) | Attempting to change a database while it is busy with another configuration change. This is a temporary condition, and the request should be reattempted later. |"
    }
  ],
  "examples": [
    {
      "id": "stop-database-traffic-post-bdbs-actions-stop-traffic-ex0",
      "language": "sh",
      "code": "POST /v1/bdbs/{int: uid}/actions/stop_traffic",
      "section_id": "stop-database-traffic-post-bdbs-actions-stop-traffic"
    },
    {
      "id": "request-post-request-ex0",
      "language": "sh",
      "code": "POST /v1/bdbs/1/actions/stop_traffic",
      "section_id": "request-post-request"
    }
  ]
}