---
title: "Put Service Configs"
method: PUT
path: "/api/configs/service"
tags: ["Config API"]
---

# Put Service Configs

`PUT /api/configs/service`

## Request

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

Put service configurations

## Headers

- `x-osmo-user` string, nullable

## Request body

- PutServiceRequest: Request body for updating service configurations with history tracking metadata.
  - `description` string, nullable
  - `tags` string[], nullable
  - `configs` ServiceConfigInput, required: Stores any configs OSMO Admins control
    - `service_base_url` string
    - `service_auth` AuthenticationConfig: Store info needed to generate and validate idtokens
      - `keys` object, required
      - `active_key` string, required
      - `issuer` string, required
      - `audience` string, required
      - `user_roles` string[]
      - `ctrl_roles` string[]
      - `login_info` LoginInfo: Store info needed to login
        - `device_endpoint` string, nullable
        - `device_client_id` string, nullable
        - `browser_endpoint` string, nullable
        - `browser_client_id` string, nullable
        - `token_endpoint` string, nullable
        - `logout_endpoint` string, nullable
      - `max_token_duration` string
    - `cli_config` CliConfig: Config for storing information regarding CLI storage.
      - `latest_version` string, nullable
      - `min_supported_version` string, nullable
      - `client_install_url` string, nullable
    - `max_pod_restart_limit` string
    - `agent_queue_size` integer

## Response `200`

Successful Response

- object

## Other responses

- `422`: Validation Error

## Changes

- **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, 2 warning, 13 info
  - the `configs/cli_config` request property type changed from no type to `object`
  - the `configs/service_auth/login_info` request property type changed from no type to `object`
  - removed `#/components/schemas/CliConfig` from the `configs/cli_config` request property `allOf` list
  - removed `#/components/schemas/LoginInfo` from the `configs/service_auth/login_info` request property `allOf` list
  - …13 more
- **2026-02-27** `3b4b243276b5`: 5 breaking, 1 warning, 6 info
  - added the new required request property `configs/service_auth/active_key`
  - added the new required request property `configs/service_auth/audience`
  - added the new required request property `configs/service_auth/issuer`
  - added the new required request property `configs/service_auth/keys`
  - …8 more

[Operation history](https://skmtc.dev/nvidia/apis/nvidia-corporation-osmo-api/changes/api/configs/service/put.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)