> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://contentful.com/developers/docs/references/experience-management-api/design-libraries/versions/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://contentful.com/developers/docs/_mcp/server.

A design library version is an immutable snapshot of the library's items.

> **Info**
>
> Version creation is asynchronous:
>
> * A `201` response creates the version and queues processing.
> * Poll [Get a design library version](/references/experience-management-api/design-libraries/versions/get-design-library-version) until `sys.status` is `succeeded` or `failed`.
> * A succeeded version's items can be [read](/references/experience-management-api/design-libraries/versions/items) or [installed](/references/experience-management-api/design-libraries/installations/create-design-library-installation).

* A version can contain at most [1,000 unique fetched items](/references/experience-management-api/design-libraries#limits), including derived content types and data assemblies.
* Create and delete versions in the library's source space.

## Versions collection

[List design library versions](/references/experience-management-api/design-libraries/versions/list-design-library-versions)

[Create a design library version](/references/experience-management-api/design-libraries/versions/create-design-library-version)

## Version

[Get a design library version](/references/experience-management-api/design-libraries/versions/get-design-library-version)

[Delete a design library version](/references/experience-management-api/design-libraries/versions/delete-design-library-version)

## Items

[Read the snapshot's items](/references/experience-management-api/design-libraries/versions/items)


## API Docs

- Design library versions [List design library versions](https://contentful.com/developers/docs/references/experience-management-api/design-libraries/versions/list-design-library-versions.md)
- Design library versions [Create a design library version](https://contentful.com/developers/docs/references/experience-management-api/design-libraries/versions/create-design-library-version.md)
- Design library versions [Get a design library version](https://contentful.com/developers/docs/references/experience-management-api/design-libraries/versions/get-design-library-version.md)
- Design library versions [Delete a design library version](https://contentful.com/developers/docs/references/experience-management-api/design-libraries/versions/delete-design-library-version.md)

## OpenAPI Specification

The raw OpenAPI 3.1 specification for this API is available at:
- [OpenAPI JSON](https://contentful.com/developers/docs/openapi.json)
- [OpenAPI YAML](https://contentful.com/developers/docs/openapi.yaml)