# 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 --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////versions/latest/installation Endpoints (replace `{version}` with a pinned semver where possible, or `latest` for the most recent published version): /api/registry/packages?search={query} /api/registry/packages/{source}/{publisher}/{name}/versions /api/registry/packages/{source}/{publisher}/{name}/versions/{version} /api/registry/packages/{source}/{publisher}/{name}/versions/{version}/readme /api/registry/packages/{source}/{publisher}/{name}/versions/{version}/installation /api/registry/packages/{source}/{publisher}/{name}/versions/{version}/nav /api/registry/packages/{source}/{publisher}/{name}/versions/{version}/docs/{typeToken} /api/registry/packages/{source}/{publisher}/{name}/versions/{version}/examples Common parameters: `?lang=typescript|python|go|csharp|java|yaml`, `?os=linux|macos|windows`, `?depth=summary|full` and `?q=` on `nav`, `?limit=` (max 100) on `examples`. For prose: `--output=markdown` (CLI) or `Accept: text/markdown` (HTTP). Type tokens for `docs/{typeToken}` are URL-encoded — use `encodeURIComponent` (or equivalent), e.g. `random:index/RandomPassword` becomes `random%3Aindex%2FRandomPassword`. Discover them via `nav?depth=full`. - **Full docs index (JSON)** — hierarchical sitemap of every documentation page with titles and nesting. curl https://www.pulumi.com/docs/llm-sitemap.json - **Provider schemas** — full Pulumi schema for any provider, including resource types, input/output shapes, function signatures, and language-specific type mappings. The cloud registry API's `versions/{version}` response includes a `schemaURL` field — follow it for the version-pinned schema. `pulumi package get-schema` accepts `[@version]`, a plugin binary or folder path, or a local `.json` / `.yaml` schema file. The static URL is latest-only. # Versioned (via cloud registry API) pulumi api /api/registry/packages/pulumi/pulumi/aws/versions/6.0.0 \ | jq -r .schemaURL | xargs curl pulumi package get-schema aws pulumi package get-schema aws@6.0.0 # Latest only curl https://www.pulumi.com/registry/packages/aws/schema.json - **Markdown content (per page)** — every `/docs/` URL is available as clean markdown via two equivalent mechanisms. For the `.md` URL form, drop the trailing slash and append `.md` (e.g., `/docs/iac/concepts/resources/` → `/docs/iac/concepts/resources.md`). `/registry/` URLs support the same mechanisms (`/registry/packages/.md`), but only for the latest version. Exception: `/registry/packages//api-docs/*` is not served as markdown — use the cloud registry API instead. # Accept-header content negotiation curl -H "Accept: text/markdown" https://www.pulumi.com/docs/iac/concepts/resources/ curl -H "Accept: text/markdown" https://www.pulumi.com/registry/packages/aws/ # .md URL suffix (header-free; same content, same cache entry) curl https://www.pulumi.com/docs/iac/concepts/resources.md curl https://www.pulumi.com/registry/packages/aws.md curl https://www.pulumi.com/registry.md ## Site overview This llms.txt covers www.pulumi.com, which includes: - [Product](https://www.pulumi.com/product/): Pulumi Cloud platform overview and capabilities - [Pricing](https://www.pulumi.com/pricing/): Plans and pricing for Pulumi Cloud (Individual, Team, Enterprise, Business Critical) - [Pulumi Registry](https://www.pulumi.com/registry/): Documentation for 150+ cloud providers and components, available at `https://www.pulumi.com/registry/packages//` - [Pulumi Neo](https://www.pulumi.com/neo/): Pulumi's AI agent for building and managing cloud infrastructure - [Blog](https://www.pulumi.com/blog/): Product announcements, technical guides, and engineering posts - [Tutorials](https://www.pulumi.com/tutorials/): Hands-on tutorials for building cloud infrastructure with Pulumi - [What is...](https://www.pulumi.com/what-is/): Explainer pages for cloud infrastructure concepts (e.g., infrastructure as code, Kubernetes, serverless) - [Case Studies](https://www.pulumi.com/case-studies/): Customer stories and use cases - [Templates](https://www.pulumi.com/templates/): Ready-to-use project templates across clouds and languages - [Automation API](https://www.pulumi.com/automation/): Program-driven Pulumi for embedding infrastructure as code into applications and platforms - [Whitepapers](https://www.pulumi.com/whitepapers/): Long-form educational and technical content - [Community](https://www.pulumi.com/community/): Slack, Discord, GitHub, and other community resources - [Security](https://www.pulumi.com/security/): Security posture, compliance, and trust information - [Docs](https://www.pulumi.com/docs/): Technical documentation (detailed sections below) ## Docs sections ### Download & Install - [Download & Install Pulumi](https://www.pulumi.com/docs/install/): This page contains detailed instructions for downloading and installing Pulumi. ### Getting Started - [Get Started](https://www.pulumi.com/docs/get-started/): Step-by-step guides for creating, deploying, and managing infrastructure with Pulumi on the cloud using your favorite language. ### Infrastructure as Code - [Infrastructure as Code](https://www.pulumi.com/docs/iac/): Learn how to create, deploy, and manage infrastructure on any cloud using Pulumi's open source infrastructure as code SDK. ### Deployments & Workflows - [Deployments & Workflows](https://www.pulumi.com/docs/deployments/): Cloud-hosted deployment automation, drift detection, and workflow management for infrastructure as code. ### Secrets & Configuration (ESC) - [Secrets & Configuration](https://www.pulumi.com/docs/esc/): Learn how to tame secrets sprawl and configuration complexity securely across all your cloud infrastructure and applications. ### Insights & Governance - [Insights & Governance](https://www.pulumi.com/docs/insights/): Discover, secure, and govern cloud infrastructure with comprehensive visibility and policy enforcement across all your resources. ### Internal Developer Platform - [Internal Developer Platform](https://www.pulumi.com/docs/idp/): Build self-service infrastructure workflows with reusable components, templates, and golden paths—from Day 0 to Day 2. ### Infrastructure AI - [Infrastructure AI](https://www.pulumi.com/docs/ai/): Pulumi Neo enables conversational infrastructure management through natural language interactions with purpose-built automation agents. ### Administration - [Administration](https://www.pulumi.com/docs/administration/): Manage organizations, teams, access control, security, and self-hosted deployments. ### Integrations - [Integrations](https://www.pulumi.com/docs/integrations/): Integrations connect Pulumi with the clouds, version control systems, and tools you already use. ### Reference - [Reference](https://www.pulumi.com/docs/reference/): Complete reference documentation for Pulumi CLI, Cloud REST API, language SDKs, and configuration syntax. ### Support - [Support & Troubleshooting](https://www.pulumi.com/docs/support/): Get help with Pulumi through FAQs, troubleshooting guides, community resources, and support options. ## Optional ### Recent blog posts - [Build a Governed Databricks Workspace with Pulumi](https://www.pulumi.com/blog/end-to-end-databricks-with-pulumi/): Provision a governed Databricks workspace baseline with Pulumi, including cluster policies, notebooks, jobs, and promotion workflows. - [Cloudflare-First Networking as Code with Pulumi](https://www.pulumi.com/blog/cloudflare-first-networking-with-pulumi/): Build a Cloudflare-first edge baseline with Pulumi, including DNS, WAF rules, Workers, Zero Trust Access policies, and repeatable validation. - [Neo code reviews: AI code review built for infrastructure](https://www.pulumi.com/blog/neo-code-reviews/): Neo code reviews analyze pull requests against what Pulumi Cloud knows about your running infrastructure and leave feedback right in the PR. - [Six Live Kubernetes Recommendations: AKS, Cilium, Rate Limiting, and More](https://www.pulumi.com/blog/getting-started-aks-pulumi-csharp/): Deploy an AKS cluster with Pulumi C#. Six Kubernetes recommendations from a live workshop, including the Docker Hub rate limit that hit mid-demo. - [Stop Prompting. Design the Loop.](https://www.pulumi.com/blog/stop-prompting-design-the-loop/): The unit of work moved from the prompt to the loop. The five pieces of loop engineering, the memory that makes it compound, and what it won't do for you. - [Trigger Deployments on Git Tags](https://www.pulumi.com/blog/trigger-deployments-on-git-tags/): Tie infrastructure deployments to your release tags. Push a version tag like v1.2.0 and let Pulumi Deployments run pulumi up automatically. - [Use Your Mac for AI Agents: Self-Host Gemma 4 12 B with Pulumi and Tailscale](https://www.pulumi.com/blog/self-host-gemma4-llama-cpp-k8s-tailscale-pulumi/): Self-host multimodal Gemma 4 on a Mac with Pulumi, llama.cpp, and Tailscale, using Unsloth's Gemma 4 12 B Q8 GGUF with a 128K context window. - [Build an EKS Environment Factory with Pulumi and vCluster](https://www.pulumi.com/blog/eks-vcluster-ephemeral-environments-with-pulumi/): Build EKS-hosted vCluster test environments with Pulumi, EKS Auto Mode, Helm, RBAC, quotas, and safe cleanup workflows. - [Why Choose Pulumi Over Terraform?](https://www.pulumi.com/blog/why-choose-pulumi-over-terraform/): See why teams choose Pulumi over Terraform for modern infrastructure as code, with examples for refactoring, secrets, testing, and safer changes. - [Five Stacks Before Lunch: The Parallel Coding Playbook for Pulumi](https://www.pulumi.com/blog/parallel-coding-playbook-for-pulumi/): AI coding has two shapes: 2x is mostly prompting, 10x is mostly plumbing. The parallel coding playbook, translated to Pulumi.