---
title: "Update Backend"
method: POST
path: "/api/configs/backend/{name}"
tags: ["Config API"]
---

# Update Backend

`POST /api/configs/backend/{name}`

## Request

- The document declares no server URL.
- Auth: none declared

Override the config for a specific backend.

## Path parameters

- `name` string, required

## Headers

- `x-osmo-user` string, nullable

## Request body

- PostBackendRequest: Request body for creating a new backend with history tracking metadata.
  - `description` string, nullable
  - `tags` string[], nullable
  - `configs` BackendConfig, required: Similar to connectors.Backend, but with optional fields.
    - `description` string, nullable
    - `k8s_uid` string, nullable
    - `dashboard_url` string, nullable
    - `grafana_url` string, nullable
    - `tests` string[], nullable
    - `scheduler_settings` BackendSchedulerSettings: Settings that control the how pods are scheduled in a backend
      - `scheduler_type` 'kai': Defines the type of scheduler used by the backend
      - `scheduler_name` string
      - `scheduler_timeout` integer
    - `node_conditions` BackendNodeConditions: Settings for backend node conditions.
      - `rules` object, nullable
      - `prefix` string
    - `router_address` string, nullable
    - `router_client_address` string, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-14** `845585a71dbb`: 1 info
  - added the new optional request property `configs/router_client_address`
- **2026-08-03** `b9d312a13f5d`: 2 info
  - added the optional property `detail/items/ctx` to the response with the `422` status
  - added the optional property `detail/items/input` to the response with the `422` status
- **2026-04-08** `a8157dc3279d`: 2 breaking, 5 warning, 12 info
  - the `configs/node_conditions` request property type changed from `object` to no type
  - the `configs/scheduler_settings` request property type changed from `object` to no type
  - removed the request property `configs/node_conditions/prefix`
  - removed the request property `configs/node_conditions/rules`
  - …15 more

[Operation history](https://skmtc.dev/nvidia/apis/nvidia-corporation-osmo-api/changes/api/configs/backend/:name/post.md)

---

[API](https://skmtc.dev/nvidia/apis/nvidia-corporation-osmo-api.md) - [All operations](https://skmtc.dev/nvidia/apis/nvidia-corporation-osmo-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nvidia/apis/nvidia-corporation-osmo-api/revisions/845585a71dbb?raw)