DigitalOcean API (unofficial showcase)
PUT/v2/gen-ai/models/routers/{uuid}

Replace a model router configuration

Replaces the configuration of a model router identified by its UUID. Supply any settings you want to update, such as name, description, or policies. The deprecated regions field does not affect deployment; omit it or set it to ["all"].

1 parameter · 6 body fields
uuidstringrequired
The unique identifier of the model router to replace.

Model router settings to replace; the request body is optional.

descriptionstringoptional
Model router description
fallback_modelsarray<object>optional
Fallback model objects to use when the router's assigned models are unavailable.
namestringoptional
Model router name: lowercase, at most 255 characters, only a-z, 0-9, and hyphens
policiesarray<object>optional
Router policies
regionsarray<string>optional
DEPRECATED: this field does not affect deployment and model routers are always deployed to all regions. Must be omitted or set to ["all"].
uuidstringoptional
Model router id

6 status codes
200Returns the updated model router, including its configuration, identifier, description, name, regions, and creation and update timestamps.
model_routerobjectoptional
Model router
401Returned when authentication credentials are invalid.
idstringrequired
A short identifier corresponding to the HTTP status code returned. For example, the ID for a response returning a 404 status code would be "not_found."
messagestringrequired
A message providing additional information about the error, including details to help resolve it when possible.
request_idstringoptional
Optionally, some endpoints may include a request ID that should be provided when reporting bugs or opening support tickets to help identify the issue.
404Returned when the requested model router cannot be found.
idstringrequired
A short identifier corresponding to the HTTP status code returned. For example, the ID for a response returning a 404 status code would be "not_found."
messagestringrequired
A message providing additional information about the error, including details to help resolve it when possible.
request_idstringoptional
Optionally, some endpoints may include a request ID that should be provided when reporting bugs or opening support tickets to help identify the issue.
429Returned when the API rate limit has been exceeded.
idstringrequired
A short identifier corresponding to the HTTP status code returned. For example, the ID for a response returning a 404 status code would be "not_found."
messagestringrequired
A message providing additional information about the error, including details to help resolve it when possible.
request_idstringoptional
Optionally, some endpoints may include a request ID that should be provided when reporting bugs or opening support tickets to help identify the issue.
500Returned when a server error occurs.
idstringrequired
A short identifier corresponding to the HTTP status code returned. For example, the ID for a response returning a 404 status code would be "not_found."
messagestringrequired
A message providing additional information about the error, including details to help resolve it when possible.
request_idstringoptional
Optionally, some endpoints may include a request ID that should be provided when reporting bugs or opening support tickets to help identify the issue.
defaultReturned when an unexpected error occurs.
idstringrequired
A short identifier corresponding to the HTTP status code returned. For example, the ID for a response returning a 404 status code would be "not_found."
messagestringrequired
A message providing additional information about the error, including details to help resolve it when possible.
request_idstringoptional
Optionally, some endpoints may include a request ID that should be provided when reporting bugs or opening support tickets to help identify the issue.

Error handling

A 401 is returned when authentication credentials are invalid. A 404 is returned when the uuid path parameter does not identify a model router; a 429 is returned when the API rate limit is exceeded; a 500 is returned when a server error occurs. name must be lowercase, no more than 255 characters, and contain only letters a-z, digits, and hyphens; omit regions or set it to ["all"].