> 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.

# List design library installations

GET https://api.contentful.com/spaces/{spaceId}/environments/{environmentId}/design_library_installations

Lists design library installation history for the target environment using cursor pagination.

Filter results by:

- `designLibraryId`: Design library ID.
- `versionId`: Version ID.

Reference: https://contentful.com/developers/docs/references/experience-management-api/design-libraries/installations/list-design-library-installations

## Authentication

- `Authorization` header (bearer token, required) — Contentful Management API token

## Request

### Path parameters

- `spaceId` (string, required)
- `environmentId` (string, required)

### Query parameters

- `pageNext` (string, optional) — Opaque cursor for the next page. Use the cursor returned by the API; do not supply it together with `pagePrev`.
- `pagePrev` (string, optional) — Opaque cursor for the previous page. Use the cursor returned by the API; do not supply it together with `pageNext`.
- `limit` (integer, optional) — Maximum number of items to return per page, from 1 to 100.
- `designLibraryId` (string, optional) — Filters installation history by design library ID.
- `versionId` (string, optional) — Filters installation history by version ID.

## Response

### 200

200

- `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsGetResponsesContentApplicationJsonSchemaSys, required)
- `limit` (double, required)
- `items` (list of SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsGetResponsesContentApplicationJsonSchemaItemsItems, required)
- `pages` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsGetResponsesContentApplicationJsonSchemaPages, required)

## Errors

### 400 Bad Request Error

400

- `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsGetResponsesContentApplicationJsonSchemaSys, required)
- `message` (string, optional)
- `requestId` (string, optional)
- `details` (any, optional)

### 401 Unauthorized Error

401

- `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsGetResponsesContentApplicationJsonSchemaSys, required)
- `message` (string, optional)
- `requestId` (string, optional)
- `details` (any, optional)

### 403 Forbidden Error

403

- `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsGetResponsesContentApplicationJsonSchemaSys, required)
- `message` (string, optional)
- `requestId` (string, optional)
- `details` (any, optional)

### 404 Not Found Error

404

- `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsGetResponsesContentApplicationJsonSchemaSys, required)
- `message` (string, optional)
- `requestId` (string, optional)
- `details` (any, optional)

### 409 Conflict Error

409

- `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsGetResponsesContentApplicationJsonSchemaSys, required)
- `message` (string, optional)
- `requestId` (string, optional)
- `details` (any, optional)

### 422 Unprocessable Entity Error

422

- `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsGetResponsesContentApplicationJsonSchemaSys, required)
- `message` (string, optional)
- `requestId` (string, optional)
- `details` (any, optional)

### 500 Internal Server Error

500

- `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsGetResponsesContentApplicationJsonSchemaSys, required)
- `message` (string, optional)
- `requestId` (string, optional)
- `details` (any, optional)

## Types

### SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsGetResponsesContentApplicationJsonSchemaSys

- `id` (string, required)
- `type` ("Error", required)

### SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsGetResponsesContentApplicationJsonSchemaItemsItems

- SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsGetResponsesContentApplicationJsonSchemaItemsItems0
- SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsGetResponsesContentApplicationJsonSchemaItemsItems1
- SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsGetResponsesContentApplicationJsonSchemaItemsItems2

### SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsGetResponsesContentApplicationJsonSchemaPages

- `next` (string, optional) — URL for the next page. Request this URL to continue; its absence means there are no further results.
- `prev` (string, optional) — URL for the previous page, when available. Request this URL to page backwards.

### SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsGetResponsesContentApplicationJsonSchemaItemsItems0

- `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsGetResponsesContentApplicationJsonSchemaItemsItemsOneOf0Sys, required)

### SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsGetResponsesContentApplicationJsonSchemaItemsItems1

- `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsGetResponsesContentApplicationJsonSchemaItemsItemsOneOf1Sys, required)

### SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsGetResponsesContentApplicationJsonSchemaItemsItems2

- `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsGetResponsesContentApplicationJsonSchemaItemsItemsOneOf2Sys, required)
- `errors` (list of SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsGetResponsesContentApplicationJsonSchemaItemsItemsOneOf2ErrorsItems, optional)

### SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsGetResponsesContentApplicationJsonSchemaItemsItemsOneOf0Sys

- `id` (string, required)
- `type` ("DesignLibraryInstallation", required)
- `createdAt` (string, required)
- `status` (enum, required)
  - Allowed values: `created`, `in_progress`
- `createdBy` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsGetResponsesContentApplicationJsonSchemaItemsItemsOneOf0SysCreatedBy, required)
- `space` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsGetResponsesContentApplicationJsonSchemaItemsItemsOneOf0SysSpace, required)
- `environment` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsGetResponsesContentApplicationJsonSchemaItemsItemsOneOf0SysEnvironment, required)
- `designLibrary` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsGetResponsesContentApplicationJsonSchemaItemsItemsOneOf0SysDesignLibrary, required)
- `version` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsGetResponsesContentApplicationJsonSchemaItemsItemsOneOf0SysVersion, required)
- `completedAt` (string, optional)

### SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsGetResponsesContentApplicationJsonSchemaItemsItemsOneOf1Sys

- `id` (string, required)
- `type` ("DesignLibraryInstallation", required)
- `createdAt` (string, required)
- `status` ("succeeded", required)
- `createdBy` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsGetResponsesContentApplicationJsonSchemaItemsItemsOneOf1SysCreatedBy, required)
- `space` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsGetResponsesContentApplicationJsonSchemaItemsItemsOneOf1SysSpace, required)
- `environment` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsGetResponsesContentApplicationJsonSchemaItemsItemsOneOf1SysEnvironment, required)
- `designLibrary` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsGetResponsesContentApplicationJsonSchemaItemsItemsOneOf1SysDesignLibrary, required)
- `version` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsGetResponsesContentApplicationJsonSchemaItemsItemsOneOf1SysVersion, required, nullable)
- `completedAt` (string, optional)

### SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsGetResponsesContentApplicationJsonSchemaItemsItemsOneOf2Sys

- `id` (string, required)
- `type` ("DesignLibraryInstallation", required)
- `createdAt` (string, required)
- `status` ("failed", required)
- `createdBy` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsGetResponsesContentApplicationJsonSchemaItemsItemsOneOf2SysCreatedBy, required)
- `space` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsGetResponsesContentApplicationJsonSchemaItemsItemsOneOf2SysSpace, required)
- `environment` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsGetResponsesContentApplicationJsonSchemaItemsItemsOneOf2SysEnvironment, required)
- `designLibrary` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsGetResponsesContentApplicationJsonSchemaItemsItemsOneOf2SysDesignLibrary, required)
- `version` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsGetResponsesContentApplicationJsonSchemaItemsItemsOneOf2SysVersion, required, nullable)
- `completedAt` (string, optional)

### SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsGetResponsesContentApplicationJsonSchemaItemsItemsOneOf2ErrorsItems

- `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsGetResponsesContentApplicationJsonSchemaItemsItemsOneOf2ErrorsItemsSys, required)
- `message` (string, required)
- `details` (string, required)

### SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsGetResponsesContentApplicationJsonSchemaItemsItemsOneOf0SysCreatedBy

- `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsGetResponsesContentApplicationJsonSchemaItemsItemsOneOf0SysCreatedBySys, required)

### SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsGetResponsesContentApplicationJsonSchemaItemsItemsOneOf0SysSpace

- `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsGetResponsesContentApplicationJsonSchemaItemsItemsOneOf0SysSpaceSys, required)

### SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsGetResponsesContentApplicationJsonSchemaItemsItemsOneOf0SysEnvironment

- `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsGetResponsesContentApplicationJsonSchemaItemsItemsOneOf0SysEnvironmentSys, required)

### SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsGetResponsesContentApplicationJsonSchemaItemsItemsOneOf0SysDesignLibrary

- `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsGetResponsesContentApplicationJsonSchemaItemsItemsOneOf0SysDesignLibrarySys, required)

### SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsGetResponsesContentApplicationJsonSchemaItemsItemsOneOf0SysVersion

- `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsGetResponsesContentApplicationJsonSchemaItemsItemsOneOf0SysVersionSys, required)

### SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsGetResponsesContentApplicationJsonSchemaItemsItemsOneOf1SysCreatedBy

- `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsGetResponsesContentApplicationJsonSchemaItemsItemsOneOf1SysCreatedBySys, required)

### SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsGetResponsesContentApplicationJsonSchemaItemsItemsOneOf1SysSpace

- `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsGetResponsesContentApplicationJsonSchemaItemsItemsOneOf1SysSpaceSys, required)

### SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsGetResponsesContentApplicationJsonSchemaItemsItemsOneOf1SysEnvironment

- `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsGetResponsesContentApplicationJsonSchemaItemsItemsOneOf1SysEnvironmentSys, required)

### SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsGetResponsesContentApplicationJsonSchemaItemsItemsOneOf1SysDesignLibrary

- `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsGetResponsesContentApplicationJsonSchemaItemsItemsOneOf1SysDesignLibrarySys, required)

### SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsGetResponsesContentApplicationJsonSchemaItemsItemsOneOf1SysVersion

- `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsGetResponsesContentApplicationJsonSchemaItemsItemsOneOf1SysVersionSys, required)

### SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsGetResponsesContentApplicationJsonSchemaItemsItemsOneOf2SysCreatedBy

- `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsGetResponsesContentApplicationJsonSchemaItemsItemsOneOf2SysCreatedBySys, required)

### SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsGetResponsesContentApplicationJsonSchemaItemsItemsOneOf2SysSpace

- `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsGetResponsesContentApplicationJsonSchemaItemsItemsOneOf2SysSpaceSys, required)

### SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsGetResponsesContentApplicationJsonSchemaItemsItemsOneOf2SysEnvironment

- `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsGetResponsesContentApplicationJsonSchemaItemsItemsOneOf2SysEnvironmentSys, required)

### SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsGetResponsesContentApplicationJsonSchemaItemsItemsOneOf2SysDesignLibrary

- `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsGetResponsesContentApplicationJsonSchemaItemsItemsOneOf2SysDesignLibrarySys, required)

### SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsGetResponsesContentApplicationJsonSchemaItemsItemsOneOf2SysVersion

- `sys` (SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsGetResponsesContentApplicationJsonSchemaItemsItemsOneOf2SysVersionSys, required)

### SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsGetResponsesContentApplicationJsonSchemaItemsItemsOneOf2ErrorsItemsSys

- `type` ("Error", required)
- `name` (string, required)

### SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsGetResponsesContentApplicationJsonSchemaItemsItemsOneOf0SysCreatedBySys

- `type` ("Link", required)
- `linkType` ("User", required)
- `id` (string, required)

### SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsGetResponsesContentApplicationJsonSchemaItemsItemsOneOf0SysSpaceSys

- `type` ("Link", required)
- `linkType` ("Space", required)
- `id` (string, required)

### SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsGetResponsesContentApplicationJsonSchemaItemsItemsOneOf0SysEnvironmentSys

- `type` ("Link", required)
- `linkType` ("Environment", required)
- `id` (string, required)

### SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsGetResponsesContentApplicationJsonSchemaItemsItemsOneOf0SysDesignLibrarySys

- `type` ("Link", required)
- `linkType` ("DesignLibrary", required)
- `id` (string, required)

### SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsGetResponsesContentApplicationJsonSchemaItemsItemsOneOf0SysVersionSys

- `type` ("Link", required)
- `linkType` ("DesignLibraryVersion", required)
- `id` (string, required)

### SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsGetResponsesContentApplicationJsonSchemaItemsItemsOneOf1SysCreatedBySys

- `type` ("Link", required)
- `linkType` ("User", required)
- `id` (string, required)

### SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsGetResponsesContentApplicationJsonSchemaItemsItemsOneOf1SysSpaceSys

- `type` ("Link", required)
- `linkType` ("Space", required)
- `id` (string, required)

### SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsGetResponsesContentApplicationJsonSchemaItemsItemsOneOf1SysEnvironmentSys

- `type` ("Link", required)
- `linkType` ("Environment", required)
- `id` (string, required)

### SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsGetResponsesContentApplicationJsonSchemaItemsItemsOneOf1SysDesignLibrarySys

- `type` ("Link", required)
- `linkType` ("DesignLibrary", required)
- `id` (string, required)

### SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsGetResponsesContentApplicationJsonSchemaItemsItemsOneOf1SysVersionSys

- `type` ("Link", required)
- `linkType` ("DesignLibraryVersion", required)
- `id` (string, required)

### SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsGetResponsesContentApplicationJsonSchemaItemsItemsOneOf2SysCreatedBySys

- `type` ("Link", required)
- `linkType` ("User", required)
- `id` (string, required)

### SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsGetResponsesContentApplicationJsonSchemaItemsItemsOneOf2SysSpaceSys

- `type` ("Link", required)
- `linkType` ("Space", required)
- `id` (string, required)

### SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsGetResponsesContentApplicationJsonSchemaItemsItemsOneOf2SysEnvironmentSys

- `type` ("Link", required)
- `linkType` ("Environment", required)
- `id` (string, required)

### SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsGetResponsesContentApplicationJsonSchemaItemsItemsOneOf2SysDesignLibrarySys

- `type` ("Link", required)
- `linkType` ("DesignLibrary", required)
- `id` (string, required)

### SpacesSpaceIdEnvironmentsEnvironmentIdDesignLibraryInstallationsGetResponsesContentApplicationJsonSchemaItemsItemsOneOf2SysVersionSys

- `type` ("Link", required)
- `linkType` ("DesignLibraryVersion", required)
- `id` (string, required)

## Examples

**Response**

```json
{
  "sys": {
    "type": "string"
  },
  "limit": 1.1,
  "items": [
    {
      "sys": {
        "completedAt": "string",
        "createdAt": "string",
        "createdBy": {
          "sys": {
            "id": "string",
            "linkType": "string",
            "type": "string"
          }
        },
        "designLibrary": {
          "sys": {
            "id": "string",
            "linkType": "string",
            "type": "string"
          }
        },
        "environment": {
          "sys": {
            "id": "string",
            "linkType": "string",
            "type": "string"
          }
        },
        "id": "string",
        "space": {
          "sys": {
            "id": "string",
            "linkType": "string",
            "type": "string"
          }
        },
        "status": "created",
        "type": "string",
        "version": {
          "sys": {
            "id": "string",
            "linkType": "string",
            "type": "string"
          }
        }
      }
    }
  ],
  "pages": {
    "next": "string",
    "prev": "string"
  }
}
```