{
  "schema_version": 2,
  "id": "operate/iris/intent-router/manage-router",
  "title": "View and manage an Intent Router",
  "url": "https://redis.io/docs/latest/operate/iris/intent-router/manage-router/",
  "summary": "View and manage an Intent Router and its intents in Redis Cloud.",
  "tags": [
    "docs",
    "operate",
    "iris"
  ],
  "last_updated": "2026-11-03T13:56:50-08:00",
  "page_type": "content",
  "content_hash": "9f4a6cdeb0c8b7e7b0589dcaa53e1dd579dd6ddac482de8e438811cceb597a80",
  "sections": [
    {
      "id": "overview",
      "title": "Overview",
      "role": "overview",
      "text": "After you [create an Intent Router](https://redis.io/docs/latest/operate/iris/intent-router/create-router), select **Intent Router** under **Iris** in the Redis Cloud console menu to see the list of your Routers.\n\nThe list shows each Router's **Status**, **Name**, **Router ID**, **Embedding model**, **Minimum score**, **Related Database**, and **Configuration updated date**. Select a Router to open it.\n\n\n\n| Status | Meaning |\n|:-------|:--------|\n| **Provisioning** | Intent Router is building the Router's search index. The Router can't serve requests yet. |\n| **Ready** | The Router serves requests. |\n| **Suspended** | The Router keeps its intents but doesn't serve requests. |\n| **Failed** | The Router couldn't be provisioned. Its **Configuration** tab shows why. |\n| **Deleting** | Intent Router is removing the Router. |\n\nA failed Router can't be resumed. Delete it and create it again after you fix the cause.\n\nThe Router's page has the **Configuration** and **Intents** tabs, and opens on the **Configuration** tab. Select **Connect** on the Router's page to [connect an application](https://redis.io/docs/latest/operate/iris/intent-router/create-router#connect-an-application)."
    },
    {
      "id": "configuration-tab",
      "title": "Configuration tab",
      "role": "configuration",
      "text": "The **General settings** section shows the Router's **Router ID**, its **Embedding model**, its **Redis Cloud database**, its **Status**, its **Template**, its **Created date**, and its **Configuration updated date**. To change a setting, select **Edit**, make your changes, and select **Save changes**.\n\n| Setting | Description |\n|:--------|:------------|\n| **Router name** | The Router's name, up to 128 characters. |\n| **Description** | An optional description. |\n| **Minimum score** | How similar a request must be to an intent's examples to match, from 0.01 to 1. |\n\nYou can't change a Router's embedding model or database after you create it.\n\nIf someone else changed the Router while you were editing, the console asks you to reload it and apply your changes again."
    },
    {
      "id": "suspend-or-resume-a-router",
      "title": "Suspend or resume a Router",
      "role": "content",
      "text": "Suspend a Router to stop it serving requests without deleting its intents. Requests to a suspended Router fail until you resume it.\n\n1. On the Router's **Configuration** tab, find the **Availability** section.\n1. Turn the switch off to suspend the Router, or on to resume it.\n\nYou can suspend or resume a Router only when it's **Ready** or **Suspended**."
    },
    {
      "id": "delete-a-router",
      "title": "Delete a Router",
      "role": "content",
      "text": "Deleting a Router permanently removes it with its intents and examples, and applications that use it lose access right away.\n\n1. On the Router's **Configuration** tab, select **Delete** in the **Danger zone** section.\n1. Select the **Yes, I want to delete this resource** checkbox.\n1. Select **Delete**.\n\nThis action can't be undone."
    },
    {
      "id": "intents-tab",
      "title": "Intents tab",
      "role": "content",
      "text": "The **Intents** tab lists the Router's intents, with each one's name, **When it should win** description, **Target**, and number of **Examples**. You can view intents only while the Router is **Ready**.\n\nFrom this tab, you can:\n\n- [Add an intent](https://redis.io/docs/latest/operate/iris/intent-router/create-router#add-intents) with **New intent**.\n- Expand an intent to see its example commands, add examples, or remove them.\n- Use an intent's actions menu to edit or delete it.\n- Test how the Router classifies a request under **Try a query**.\n\nThe console doesn't set an intent's target or its own minimum score. To set them, use the [data-plane API or a client](https://redis.io/docs/latest/develop/ai/context-engine/intent-router/manage-intents)."
    },
    {
      "id": "manage-examples",
      "title": "Manage examples",
      "role": "content",
      "text": "Expand an intent to see its **Example commands**.\n\n- To add an example, enter it under **New example command** and press Enter. To add several at once, paste one per line.\n- To remove an example, select **Remove**. The console removes it right away, without asking you to confirm.\n\nAn intent holds up to 256 examples, each up to 2,048 characters. You can't edit an example. Remove it and add the new wording instead."
    },
    {
      "id": "edit-an-intent",
      "title": "Edit an intent",
      "role": "content",
      "text": "1. Select **Edit** in the intent's actions menu.\n1. Change **When it should win**.\n1. Select **Save changes**.\n\nYou can't rename an intent. To use a new name, create an intent with that name and delete the old one."
    },
    {
      "id": "delete-an-intent",
      "title": "Delete an intent",
      "role": "content",
      "text": "Deleting an intent removes it with its examples.\n\n1. Select **Delete** in the intent's actions menu.\n1. Select the **Yes, I want to delete this resource** checkbox.\n1. Select **Delete**.\n\nThis action can't be undone."
    },
    {
      "id": "try-a-query",
      "title": "Try a query",
      "role": "content",
      "text": "Under **Try a query**, enter a request such as `Where is my order?` and select **Match**. The console lists the intents that match, best first, with each one's score. If no intent scores at least the Router's minimum score, the console shows **No intent matched**."
    }
  ],
  "examples": []
}