{
  "schema_version": 2,
  "id": "develop/ai/context-engine/intent-router/limits",
  "title": "Service limits and errors",
  "url": "https://redis.io/docs/latest/develop/ai/context-engine/intent-router/limits/",
  "summary": "Find Router, content, and match limits, error types, and retry guidance.",
  "tags": [
    "docs",
    "develop",
    "ai"
  ],
  "last_updated": "2026-10-30T10:17:15-04:00",
  "page_type": "content",
  "content_hash": "12dee3636e1f7a2240f84e0be4037d9391d82d40ffe46a97af8901c5632650fa",
  "sections": [
    {
      "id": "overview",
      "title": "Overview",
      "role": "overview",
      "text": "Intent Router limits how many Routers, intents, and examples you can create, how long text can be, and how many results a match or list returns. This page lists those limits and the errors each API returns, with what each error means and how to recover. Use it when you plan how many intents and examples to write, or when a request fails.\n\nThe values shown are defaults. An administrator can change some of them for a self-managed deployment, so confirm any overrides with them.\n\nThe [API reference](https://redis.io/docs/latest/develop/ai/context-engine/intent-router/api-reference) defines field formats and operation-specific schemas."
    },
    {
      "id": "router-limits",
      "title": "Router limits",
      "role": "content",
      "text": "| Limit | Default |\n|:------|:--------|\n| Routers per tenant | 128 |\n| Embedding models per deployment | 1 |\n| Time for a new Router to become `READY` before it fails | 10 minutes |"
    },
    {
      "id": "content-limits",
      "title": "Content limits",
      "role": "content",
      "text": "A deployment can change the intents per Router and the bulk-request ceilings. The 256-example ceilings are fixed.\n\n| Content | Default ceiling |\n|:--------|:----------------|\n| Intents per Router | 1,000 |\n| Examples per intent | 256 |\n| Intents per bulk add request | 100 |\n| Examples across one bulk add request | 5,000 |\n| Examples per add-examples request | 256 |\n| Intent name | 128 characters: letters, digits, `.`, `_`, `-`, starting with a letter or digit |\n| Example text or query | 2,048 characters |\n| Description | 1,024 characters |\n| `target.type` | 32 characters, no whitespace |\n| `target.ref` | 512 characters |\n| `target.args` | 32 top-level keys |\n| `metadata` | 32 keys of up to 64 characters, each value up to 512 characters |"
    },
    {
      "id": "match-and-list-limits",
      "title": "Match and list limits",
      "role": "content",
      "text": "| Setting | Default | Notes |\n|:--------|:--------|:------|\n| Intents returned by a match | 5 | Set with `limit`. |\n| Maximum `limit` on a match | 50 | A larger value is rejected with `400`, not clamped. |\n| Minimum score | 0.7 | The Router's `minScore` unless you set another. |\n| Page size of a list | 50 | Set with `limit`, from 1 to 200. Pass `nextCursor` back as `cursor`. |"
    },
    {
      "id": "handle-request-errors",
      "title": "Handle request errors",
      "role": "content",
      "text": "The API reports failures as [RFC 9457](https://www.rfc-editor.org/rfc/rfc9457) problem documents. Match on the `type` value rather than the message."
    },
    {
      "id": "data-plane",
      "title": "Data plane",
      "role": "content",
      "text": "| Status | Type | Meaning and recovery |\n|:-------|:-----|:---------------------|\n| `400` | `/errors/invalid-data` | A field is invalid, `limit` exceeds the cap, or `If-Match` and `expectedRevision` disagree. The `fields` list names each field and the rule it broke. Fix the request. |\n| `400` | `/errors/invalid-cursor` | The `cursor` can't be read. Start again without a cursor. |\n| `401` | `/errors/authentication-failed` | The agent key is missing, invalid, expired, or revoked. |\n| `403` | `/errors/insufficient-permissions` | The key has no grant on this Router, or lacks the action the operation needs, such as `write` for authoring. |\n| `404` | `/errors/resource-not-found` | The Router, intent, or example doesn't exist, or the Router is being deleted. Deleting a missing intent succeeds instead, and so does deleting an example the intent doesn't hold. |\n| `408` | `/errors/timeout` | The request timed out. Retry with backoff. |\n| `409` | `/errors/router-not-serving` | The Router is provisioning, has failed, or the data plane hasn't applied its latest configuration yet. Retry after a short wait, and check the Router's state if it persists. |\n| `409` | `/errors/intent-limit-exceeded` | The Router already holds the maximum number of intents. Delete an intent or ask your administrator to raise the limit. |\n| `412` | `/errors/revision-conflict` | The intent changed since the revision you sent. Read the intent, reapply your change, and retry. |\n| `423` | `/errors/router-suspended` | An administrator suspended the Router. Retrying doesn't help until it resumes. |\n| `424` | `/errors/dependency-unavailable` | The embedding provider is unavailable. Retry with backoff. |\n| `424` | `/errors/database-out-of-memory` | The Router's database is out of memory. Ask your administrator to add memory. |\n| `500` | `/errors/unexpected-error` | An unexpected internal error. Retry once, then contact support with the request details. |\n| `503` | `/errors/service-unavailable` | The Router's search index is rebuilding, or its database isn't answering. Wait for the `Retry-After` interval, then retry. |"
    },
    {
      "id": "control-plane",
      "title": "Control plane",
      "role": "content",
      "text": "| Status | Type | Meaning and recovery |\n|:-------|:-----|:---------------------|\n| `400` | `/errors/invalid-data` | A field is invalid, the `vectorSpace` or `databaseId` isn't one the deployment offers, the deployment requires a `databaseId`, the `Idempotency-Key` is malformed, the requested state isn't `READY` or `SUSPENDED`, or an update is empty. |\n| `401` | `/errors/authentication-failed` | The admin token is missing or wrong. Agent keys are refused here. |\n| `404` | `/errors/resource-not-found` | The Router doesn't exist. Deleting a Router that is already gone succeeds instead. |\n| `409` | `/errors/conflict` | The tenant has reached its Router limit, the Router isn't `READY` or `SUSPENDED` for an update, or a request with the same `Idempotency-Key` is still running. |\n| `412` | `/errors/revision-conflict` | The Router changed since the revision you sent. Read it and retry. |\n| `422` | `/errors/idempotency-key-reused` | The `Idempotency-Key` was already used with a different request body. Use a new key. |\n| `503` | `/errors/service-unavailable` | The control plane's storage isn't answering. Retry with backoff. |"
    },
    {
      "id": "retry-uncertain-operations",
      "title": "Retry uncertain operations",
      "role": "content",
      "text": "Most writes are safe to retry:\n\n- Upserting an intent produces the same intent, although each write returns a new `revision`. A retried conditional write that already succeeded fails with `412`, so read the intent before you retry it.\n- Adding a phrasing that exists doesn't duplicate it, and deleting a missing intent or example succeeds.\n- Bulk add replaces intents of the same name, so repeating it produces the same intents.\n- Creating a Router with an `Idempotency-Key` returns the first successful response on a retry for 24 hours. Without one, list the Routers before you retry, or you may create a second Router."
    }
  ],
  "examples": []
}