> This page is for API Reference.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://contentful.com/developers/docs/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](/developers/docs/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](/developers/docs/references/experience-management-api/design-libraries/versions/items) or [installed](/developers/docs/references/experience-management-api/design-libraries/installations/create-design-library-installation).

* A version can contain at most [1,000 unique fetched items](/developers/docs/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](/developers/docs/references/experience-management-api/design-libraries/versions/list-design-library-versions)

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

## Version

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

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

## Items

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