---
title: "Update a Config"
method: POST
path: "/configs/{id}/update"
tags: ["Config"]
---

# Update a Config

`POST /configs/{id}/update`

## Path parameters

- `id` string, required

## Query parameters

- `version` integer, required

## Request body

- ConfigSpec
  - `Name` string — User-defined name of the config.
  - `Labels` object — User-defined key/value metadata.
  - `Data` string — Data is the data to store as a config, formatted as a Base64-url-safe-encoded ([RFC 4648](https://tools.ietf.org/html/rfc4648#section-5)) string. The maximum allowed size is 1000KB, as defined in [MaxConfigSize](https://pkg.go.dev/github.com/moby/swarmkit/v2@v2.0.0-20250103191802-8c1959736554/manager/controlapi#MaxConfigSize).
  - `Templating` Driver — Driver represents a driver (network, logging, secrets).
    - `Name` string, required — Name of the driver.
    - `Options` object — Key/value map of driver-specific options.

## Response `200`

no error

## Other responses

- `400` — bad parameter
- `404` — no such config
- `500` — server error
- `503` — node is not part of a swarm

---

[API](https://skmtc.net/docker/apis/docker-engine-api.md) · [All operations](https://skmtc.net/docker/apis/docker-engine-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/docker/docker-engine-api/revisions/a181425ed19e/schema)