---
title: "POST /prompt-routers"
method: POST
path: "/prompt-routers"
---

# POST /prompt-routers

`POST /prompt-routers`

Creates a prompt router that manages the routing of requests between multiple foundation models based on the routing criteria.

## Request body

- object
  - `clientRequestToken` string — A unique, case-sensitive identifier that you provide to ensure idempotency of your requests. If not specified, the Amazon Web Services SDK automatically generates one for you.
  - `promptRouterName` string, required — The name of the prompt router. The name must be unique within your Amazon Web Services account in the current region.
  - `models` PromptRouterTargetModel[], required — A list of foundation models that the prompt router can route requests to. At least one model must be specified.
    - `modelArn` string, required — The target model's ARN.
  - `description` string, password — An optional description of the prompt router to help identify its purpose.
  - `routingCriteria` object, required — Routing criteria for a prompt router.
    - `responseQualityDifference` number, double — The criteria's response quality difference.
  - `fallbackModel` object, required — The target model for a prompt router.
    - `modelArn` string — The target model's ARN.
  - `tags` Tag[] — An array of key-value pairs to apply to this resource as tags. You can use tags to categorize and manage your Amazon Web Services resources.
    - `key` string, required — Key for the tag.
    - `value` string, required — Value for the tag.

## Response `200`

Success

- CreatePromptRouterResponse
  - `promptRouterArn` string — The Amazon Resource Name (ARN) that uniquely identifies the prompt router.

## Other responses

- `480` — ResourceNotFoundException
- `481` — AccessDeniedException
- `482` — ValidationException
- `483` — ConflictException
- `484` — InternalServerException
- `485` — TooManyTagsException
- `486` — ServiceQuotaExceededException
- `487` — ThrottlingException

---

[API](https://skmtc.net/aws/apis/bedrock.md) · [All operations](https://skmtc.net/aws/apis/bedrock/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/bedrock/versions/3bc874e43ecd/schema)