---
id: aws-cdk-cloud-assembly-schema
version: "54.18.0"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# aws-cdk.cloud-assembly-schema — Schema for the protocol between CDK framework and CDK CLI

License: permissive · Maintenance: active · Downloads: 6.7M/mo

## What it is and what it does

This package provides the canonical schema definition for AWS CDK Cloud Assembly manifest files—the structured output produced by the CDK synthesis operation that instructs deployment tooling how to deploy infrastructure. It contains the TypeScript structs and generated JSON schema that define the versioned protocol between the CDK framework and consumers like the CDK CLI.

The package is part of the AWS CDK project and defines how the assembly communicates deployment instructions. Since the schema version follows semantic versioning with every schema change treated as a major version bump, consumers must verify that a manifest's schema version matches their expectations before deployment to ensure all instructions are understood.

Use it for:

- Validate manifest.json files from CDK synthesis output against the canonical schema.
- Parse Cloud Assembly manifests programmatically to extract deployment instructions.
- Ensure compatibility between CDK versions and deployment tooling by checking manifest schema versions.
- Integrate CDK-generated artifacts into custom deployment pipelines.
- Develop tooling that consumes Cloud Assembly output independently of the CDK CLI.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Provides the schema and structures for AWS CDK Cloud Assembly manifest files, enabling validation and interpretation of synthesis output.

Yes, if you are building tooling that consumes AWS CDK Cloud Assemblies or need to validate manifest files programmatically. The package is actively maintained, has no known vulnerabilities, and provides essential infrastructure for non-CLI-based CDK workflows. Not needed if you only use standard CDK CLI deployment.

## Install

pip install aws-cdk-cloud-assembly-schema
uv add aws-cdk-cloud-assembly-schema
poetry add aws-cdk-cloud-assembly-schema

## Installing aws-cdk.cloud-assembly-schema

Before you install: Active maintenance with a recent release (2 days old) and low install friction. Depends on jsii and publication.

License in practice: Licensed under Apache-2.0 (permissive), allowing commercial and private use with minimal restrictions.

Quickstart:

pip install aws-cdk-cloud-assembly-schema

import aws_cdk.cloud_assembly_schema

Requires Python 3.10 or later.

Verify before relying:

- Whether the package provides a JSON schema file for use with external validators.
- Specific validation methods or utilities available in the package API.
- How to programmatically load and validate manifest.json files using this package.

## Package facts

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 6.7M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

cdk cloud assembly schema, aws cdk manifest validation, cloud assembly protocol, cdk synthesis output schema, manifest.json schema, cdk deployment instructions, cloud assembly versioning, aws-cdk, infrastructure-as-code, schema-validation

[View on SkillFed](https://skillfed.io/packages/aws-cdk-cloud-assembly-schema) · [View on PyPI](https://pypi.org/project/aws-cdk-cloud-assembly-schema/)