# Create a model route

> Creates a project-scoped model route: a named, ordered list of provider+model targets tried in array order. Every target must reference an AI provider in the same project (400 otherwise), and the total attempt budget — the sum of `1 + max_retries` over all targets — may not exceed 10 (400 naming the computed total). A duplicate `name` in the project is rejected with 409.

<Heading
  as={"h1"}
  className={"openapi__heading"}
  children={"Create a model route"}
>
</Heading>

<MethodEndpoint
  method={"post"}
  path={"/api/v1/model-routes"}
  context={"endpoint"}
>
  
</MethodEndpoint>

Creates a project-scoped model route: a named, ordered list of provider+model targets tried in array order. Every target must reference an AI provider in the same project (400 otherwise), and the total attempt budget — the sum of `1 + max_retries` over all targets — may not exceed 10 (400 naming the computed total). A duplicate `name` in the project is rejected with 409.

<Heading
  id={"request"}
  as={"h2"}
  className={"openapi-tabs__heading"}
>
  <Translate id="theme.openapi.request.title">Request</Translate>
</Heading>

<ParamsDetails>
  
</ParamsDetails>

<RequestSchema
  {...require("./create-model-route.RequestSchema.json")}
>
  
</RequestSchema>

<StatusCodes
  {...require("./create-model-route.StatusCodes.json")}
>
  
</StatusCodes>