---
title: "List configs"
method: GET
path: "/configs"
tags: ["Config"]
---

# List configs

`GET /configs`

## Query parameters

- `filters` string

## Response `200`

no error

- Config[]
  - `ID` string
  - `Version` ObjectVersion — The version number of the object such as node, service, etc. This is needed to avoid conflicting writes. The client must send the version number along with the modified specification when updating these objects. This approach ensures safe concurrency and determinism in that the change on the object may not be applied if the version number has changed from the last read. In other words, if two update requests specify the same base version, only one of the requests can succeed. As a result, two separate update requests that happen at the same time will not unintentionally overwrite each other.
    - `Index` integer
  - `CreatedAt` string, dateTime
  - `UpdatedAt` string, dateTime
  - `Spec` 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 standard base64-encoded ([RFC 4648](https://tools.ietf.org/html/rfc4648#section-4)) 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.

## Other responses

- `500` — server error
- `503` — node is not part of a swarm

---

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