llms.txt Content
# Pulumi
> Infrastructure as code in real programming languages. Define, deploy, and manage cloud infrastructure on AWS, Azure, Google Cloud, Kubernetes, and 150+ providers using TypeScript, Python, Go, C#, Java, or YAML.
Pulumi is an open source infrastructure as code platform that lets you use familiar programming languages and tools to build, deploy, and manage cloud infrastructure. Pulumi Cloud provides state management, secrets, deployments, and governance for teams.
## For agents
If you are an AI agent or programmatic consumer, start with these endpoints. Each has a copy-pasteable example.
- **Pulumi Cloud REST API (via the CLI)** — call any [Pulumi Cloud REST API](https://www.pulumi.com/docs/reference/cloud-rest-api/) endpoint with [`pulumi api`](https://www.pulumi.com/docs/iac/cli/api/). The command emits a stable JSON error envelope and stable [exit codes](https://www.pulumi.com/docs/iac/cli/exit-codes/) for agent consumers, and `pulumi api list --output=json` returns the full endpoint catalog. Authentication reuses the existing Pulumi CLI credentials.
pulumi api list --output=json
pulumi api describe <path-or-operation-id> --output=json
pulumi api /api/user
- **Cloud registry API** — every published package, version-by-version. Public packages need no auth; set `Authorization: token $PULUMI_ACCESS_TOKEN` for private. Works without the CLI.
# CLI (auto-fills lang/os from project runtime + host OS)
pulumi api ls | grep registry
pulumi api describe ListPackageVersions
pulumi api /api/registry/packages/pulumi/pulumi/aws/versions/latest/readme
# Direct HTTP (markdown variant via Accept header)
curl -H "Accept: text/markdown" \
https://api.pulumi.com/api/registry/packages/pulumi/pulumi/aws/versions/latest/readme
curl -H "Authorization: token $PULUMI_ACCESS_TOKEN" \
https://api.pulumi.com/api/registry/packages/<source>/<publisher>/<private-pkg>/versions/latest/installation