---
title: "Versions list"
method: GET
path: "/v2/storage/components/{componentId}/configs/{configurationId}/versions"
tags: ["Components and Configurations"]
---

# Versions list

`GET /v2/storage/components/{componentId}/configs/{configurationId}/versions`

## Request

- Base URL: `https://connection.keboola.com`
- URL: `https://connection.keboola.com/v2/storage/components/{componentId}/configs/{configurationId}/versions`
- Auth: one of:
  - API key in header `X-StorageApi-Token`
  - API key in header `X-KBC-ManageApiToken`
  - HTTP bearer
- TypeScript: <https://skmtc.dev/keboola/apis/keboola-storage-api/docs/v2/storage/components/:componentId/configs/:configurationId/versions/get.ts> (a function with typed inputs; its response is checked against the schema)

Lists all versions of a component configuration for [Development Branch](#tag/Development-Branches).

The variant without `branch/{branchId}` in the URL is deprecated, use the branch endpoint and set `branch/default`.

## Path parameters

- `componentId` string, required
- `configurationId` string, required

## Query parameters

- `include` string, nullable: Comma-separated list of information to be retrieved; possible fields are `name`, `description` and `configuration`.
- `limit` integer, nullable: Pagination limit.
- `offset` integer, nullable: Pagination offset.

## Response `200`

List of configuration versions, newest first.

- ConfigurationVersionListItemResponse[]
  - `version` integer, required: Version number.
  - `created` string, required: When the version was created, ISO 8601 with a `+hhmm` offset; `""` when none was recorded.
  - `versionIdentifier` string, nullable, required: ULID uniquely identifying the version across branches.
  - `creatorToken` ConfigurationCreatorTokenResponse, required
    - `id` integer, required: Id of the token that created the object or version.
    - `description` string, nullable, required: Description of the token (typically the user e-mail).
  - `actor` ActorResponse, required: Who performed the action and through which credential.
    - `type` 'token' | 'session' | 'pat' | 'system', required: Credential the action came through: a Storage token, a programmatic session, a personal access token, or system work.
    - `id` string, required: Token id as a string, session or personal access token UUID, or the system subject.
    - `name` string, required: Token description, the admin email for a session or personal access token, or the system label, as it was when the action happened.
    - `adminId` integer, nullable, required: Admin behind the credential; null for a token without an admin, for system work, and when the admin was not recorded (an object whose creator is known only from its token columns, including rows backfilled from them).
  - `changeDescription` string, nullable, required: Change description of the version.
  - `isDisabled` boolean, required: Disabled flag at this version.
  - `isDeleted` boolean, required: Whether this version is a deletion tombstone.
  - `name` string: Configuration name at this version.
  - `description` string, nullable: Configuration description at this version.
  - `configuration` object: Configuration data at this version.

## Other responses

- `400`: Invalid `limit` or `offset` query parameter.
- `404`: Component (`storage.component.notFound`) or configuration (`storage.configuration.notFound`) not found.

---

[API](https://skmtc.dev/keboola/apis/keboola-storage-api.md) - [All operations](https://skmtc.dev/keboola/apis/keboola-storage-api/llms.txt) - [OpenAPI document](https://skmtc.dev/keboola/apis/keboola-storage-api/revisions/34b5ceac0317?raw)