> 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/installations/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://contentful.com/developers/docs/_mcp/server.

An installation copies items from a design library version into a target environment.

> **Info**
>
> Installation is asynchronous:
>
> * A `201` response creates the installation and queues processing.
> * Poll [Get a design library installation](/references/experience-management-api/design-libraries/installations/get-design-library-installation) until `sys.status` is `succeeded` or `failed`.

> **Warning**
>
> You cannot install a design library into its source space.

## Concurrent installation limit

A target organisation can have up to **100 concurrent design library installations** across all its spaces, environments and libraries. Installations with `sys.status` set to `created` or `in_progress` count towards this limit. Installations with status `succeeded` or `failed` do not count.

When the limit is reached, creating another installation returns `409 Conflict` with the message `Parallel installation limit reached` and `details.limit` set to `100`. No installation is created or queued. Retry after an active installation finishes and capacity becomes available.

## Installations

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

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

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


## API Docs

- Design library installations [List design library installations](https://contentful.com/developers/docs/references/experience-management-api/design-libraries/installations/list-design-library-installations.md)
- Design library installations [Create a design library installation](https://contentful.com/developers/docs/references/experience-management-api/design-libraries/installations/create-design-library-installation.md)
- Design library installations [Get a design library installation](https://contentful.com/developers/docs/references/experience-management-api/design-libraries/installations/get-design-library-installation.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)