---
title: "Get Configs History"
method: GET
path: "/api/configs/history"
tags: ["Config API"]
---

# Get Configs History

`GET /api/configs/history`

## Request

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

Reject the retired database-backed configuration history API.

## Query parameters

- `offset` integer, nullable: Number of records to skip
- `limit` integer, nullable: Maximum number of records to return
- `order` 'ASC' | 'DESC': Represents the list order for the database.
- `config_types` ConfigHistoryType[], nullable: Filter by config types
- `name` string, nullable: Filter by config name
- `revision` integer, nullable: Filter by revision
- `tags` string[], nullable: Filter by tags
- `created_before` string, date-time, nullable: Filter by creation time before
- `created_after` string, date-time, nullable: Filter by creation time after
- `at_timestamp` string, date-time, nullable: Get config state at specific timestamp
- `omit_data` boolean: Whether to omit data from the response

## Response `200`

Successful Response

- GetConfigsHistoryResponse: Response body for config history endpoint.
  - `configs` ConfigHistory[], required
    - `config_type` 'DATASET' | 'SERVICE' | 'WORKFLOW' | 'BACKEND' | 'POOL' | 'POD_TEMPLATE' | 'GROUP_TEMPLATE' | 'RESOURCE_VALIDATION' | 'BACKEND_TEST' | 'ROLE', required: Type of configs supported by config history
    - `name` string, required
    - `revision` integer, required
    - `username` string, required
    - `created_at` string, date-time, required
    - `description` string, required
    - `tags` string[], nullable
    - `data` unknown

## Other responses

- `422`: Validation Error

## Changes

- **2026-08-03** `b9d312a13f5d`: 1 warning, 3 info
  - added the new `DATASET` enum value to the `configs/items/config_type` response property for the response status `200`
  - added the enum value `DATASET` to the property `anyOf[subschema #1]/items/` of the `query` request parameter `config_types`
  - 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-06-24** `d3e1ce0d4036`: 1 breaking, 1 info
  - removed the enum value `DATASET` from the property `anyOf[subschema #1]/items/` of the `query` request parameter `config_types`
  - removed the `DATASET` enum value from the `configs/items/config_type` response property for the response status `200`
- **2026-04-08** `a8157dc3279d`: 3 breaking, 21 info
  - the `query` request parameter `order` was restricted to a list of enum values
  - response property `configs/items/tags` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - the `configs/items/config_type` response's property type changed from no type to `string` for status `200`
  - added the new enum value `ASC` to the `query` request parameter `order`
  - …20 more
- …earlier changes not shown

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