NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI, #1541 most downloaded on PyPI
Pulumi's Python SDK
Latest stable
3.274.1
Last release 11 days ago
10 Nov 2026
Ships on a steady schedule
a new release about every 8 days
Nearly every release is documented
notes for 59 of the last 60 stable releases
7 versions withdrawn
withdrawn after publishing
8 years old
5049 releases · first in 2018
Drag across the ruler to compare, or tap a release to open it.
[cli] Add a pulumi package for npx support
[cli] Add a pulumi package for npx support
[cli] Add the pulumi org member edit command
#23235
[cli] Add the pulumi org member remove command
#23237
[cli/cloud] Add pulumi deployment get to retrieve details for a specific deployment
#23238
[cli/cloud] Add pulumi insights account scan get <account> <scan-id> to show the full workflow run for a single Insights scan
#23255
[cli/cloud] Add pulumi insights account scan list <account> to discover recent scan IDs to feed into pulumi insights account scan log
#23255
[cli/deployment] Add dedicated flags for each deployment setting #23236
[cli/do] Add the start of pulumi do
#23176
[cli/neo] Add --print/-p to pulumi neo to run a single prompt non-interactively and print the agent's final response to stdout
#23245
[cli/cloud] Fix pulumi insights account scan log --all to follow the server's pagination cursor through the end of the log, and render --job/--step mode as structured lines instead of an empty raw-string blob
#23256
[sdk] Close gzip.Writer in archiveTarGZIP to produce valid tar.gz output #23240
[sdkgen/python] Fix usage of ArgsDict types in typed dictionaries #23253
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Nothing published for this version
Nothing published for this version
[cli] Add --output json to pulumi preview for a structured JSON summary of the operation result #22927
[cli] Add --output json to pulumi preview for a structured JSON summary of the operation result
#22927
[cli] Add --output json to pulumi refresh for a structured JSON summary of the operation result
#22928
[cli] Add --output json to pulumi destroy for a structured JSON summary of the operation result
#22875
[cli] Add pulumi stack schedule get to retrieve the configuration of a scheduled action
#23153
[cli] Add pulumi stack schedule list to list all scheduled actions configured for a stack
#23153
[cli] Add pulumi stack schedule new to create a raw, drift, or TTL deployment schedule for a stack
#23153
[cli] Add pulumi stack webhook delivery list to list recent deliveries for a stack webhook
#23116
[cli] Add pulumi stack webhook delivery redeliver to redeliver a webhook event
#23118
[cli] Add pulumi stack webhook edit to update an existing stack webhook
#23139
[cli] Add pulumi stack webhook new to create a new stack webhook
#23101
[cli] Add pulumi stack webhook remove to delete a stack webhook
#23102
[cli] Add pulumi org webhook delivery list to list recent deliveries for an organization webhook
#23179
[cli] Add pulumi org webhook edit to update an organization webhook
#23179
[cli] Add pulumi org webhook list to list all webhooks configured for an organization
#23174
[cli] Add pulumi org webhook new to create a new organization webhook
#23172
[cli] Add pulumi org webhook ping to send a test ping to an organization webhook
#23179
[cli] Add pulumi org webhook remove to delete an organization webhook
#23177
[cli] Add pulumi stack drift list to list drift detection runs for a stack
#23159
[cli] Add pulumi stack drift status to show the drift detection status for a stack
#23161
[cli] Add pulumi stack schedule edit to update an existing scheduled deployment action
#23153
[cli] Add pulumi stack schedule remove to delete a scheduled deployment action
#23153
[cli] Add pulumi audit-log export command
#23212
[cli] Add pulumi org audit-log list
#23211
[cli] Add pulumi policy compliance list to list compliance results grouped by entity
#23209
[cli] Add pulumi policy group new command to allow creating new policy groups
#23202
[cli] Add the pulumi policy issue get command
#23200
[cli/cloud] Add pulumi insights account list to list Insights accounts in an organization
#23091
[cli/cloud] Add pulumi insights account new to create a Pulumi Insights account
#23093
[cli/cloud] Add pulumi insights account scan log to fetch log output for a Pulumi Insights scan
#23092
[cli/cloud] Add pulumi insights account scan to trigger a resource discovery scan for an Insights account
#23094
[cli/cloud] Implement pulumi stack history events to retrieve engine events for a Pulumi Cloud update
#23109
[cli/cloud] Add pulumi deployment cancel to terminate an in-progress deployment
#23164
[cli/cloud] Add pulumi org member list to list the members of an organization
#23170
[cli/cloud] Add pulumi org usage get to fetch the resources-under-management summary for an organization
#23166
[cli/cloud] Add pulumi org role assign to assign a custom role to a team
#23117
[cli/cloud] Add pulumi org role edit to update a custom role's name, description, or permission tree
#23117
[cli/cloud] Add pulumi org role list to list custom roles for an organization
#23117
[cli/cloud] Add pulumi org role new to create a custom role from a permission descriptor JSON file
#23117
[cli/cloud] Add pulumi org role remove to delete a custom role from an organization
#23117
[cli/env] Update esc to v0.24.0 #23213
[cli/neo] Show tool call arguments and results in pulumi neo via a ctrl+o overlay
#23075
[cli/neo] Multi-line input in pulumi neo - Enter sends, Shift+Enter / Alt+Enter / Ctrl+J / trailing \ insert a newline
#23151
[cli/neo] Make pulumi neo visible by default; the PULUMI_EXPERIMENTAL gate has been removed
#23228
[cli/policy] Add pulumi policy group edit to edit policy groups
#23206
[cli/policy] Add pulumi policy group remove command to remove policies
#23208
[cli/policy] Add the pulumi policy group get command
#23203
[cli] Add pulumi policy issue list command
#23198
[cli] Fix pulumi org role list to send the uxPurpose query parameter the service requires
#23231
[engine] Fix pulumi import dropping map entries whose value matched the enum member of a Union<Input<Enum<T>>, ...> element type
#23190
[cli/cloud] Surface a clear error when pulumi api --all is used against an endpoint whose response is not paginatable, instead of silently emitting an empty array
#23191
#23128
[cli/cloud] pulumi deployment settings edit no longer clears fields that the patch does not mention
#23217
[cli/import] Generate PCL for asset and archive inputs when importing resources, instead of returning a "NYI" error #22938
[cli/import] Preserve asset/archive/resource-reference values inside map and array inputs, and HCL-escape map keys containing ${ or %{ template sequences
#23222
[cli/install] Hint at adding a .git / _git when VCS URL resolution fails
#22831
[cli/neo] Transparently reconnect the Neo event stream after a transient network drop, resuming from the last seen event ID #23134
[cli/neo] Show preparing in the live preview/up block until the first resource arrives
#23155
[cli/new] Support specific versions when using registry-backed templates with pulumi new
#22909
Nothing published for this version
Nothing published for this version
Nothing published for this version
[cli] Add --output json to pulumi import for a structured JSON summary of the operation result #22929
[cli] Add --output json to pulumi import for a structured JSON summary of the operation result
#22929
[cli] Add pulumi stack get to retrieve detailed information about a stack
#23106
[cli] Add pulumi stack webhook get to inspect a single stack webhook
#23088
[cli] Add pulumi stack webhook ping to send a test ping to a stack webhook
[cli/cloud] Add pulumi deployment list to list deployment executions for a stack
#23114
[sdkgen] Validate that schema names can't conflict with module paths #22956
Nothing published for this version
Nothing published for this version
Nothing published for this version
[cli] Add a --language flag to pulumi package add to run outside a Pulumi project or plugin #22791
[cli] Add a --language flag to pulumi package add to run outside a Pulumi project or plugin
#22791
[cli] Add --output json to pulumi up for a structured JSON summary of the operation result
#22870
[cli] Recommend pulumi cloud api describe in pulumi cloud api --help to verify operation parameters before calling
#22881
[cli] Add pulumi stack webhook list to list all webhooks configured for a stack
#23082
[cli/cloud] Rename pulumi cloud api to pulumi api
#22970
[cli/cloud] Add pulumi insights resource get to look up a single resource discovered by Pulumi Insights
#23077
[cli/cloud] Add pulumi template list to list registry-backed templates
#23074
[cli/cloud] Rename the --format flag to --output on pulumi api and its subcommands
#23072
[cli/cloud] Add pulumi insights resource search to search for resources discovered by Pulumi Insights
#23087
[cli/engine] Add --skip-plugin-pre-install to skip up-front plugin installation
[engine] Fail the deployment when an after hook fails #22935
[cli/neo] Render the agent's TODO list in the pulumi neo TUI
#22864
[cli/neo] Add --approval-mode and --permission-mode flags to pulumi neo, with Ctrl+A and Ctrl+R hotkeys to switch modes mid-session
#22950
[cli/package] When invoked by an AI coding agent, print pulumi api pointers after pulumi package add and pulumi package gen-sdk
#22904
[pkg/testing] Recognize the hcl and pcl runtimes in integration.ProgramTest
#23018
[pkg/testing] Add l1-config-types-optional conformance test for PCL's optional type constructor
#23108
[backend/diy] Minify JSON persisted by the DIY backend for checkpoints, history, and stack tags #22245
[cli/import] Ignore property values that do not conform to the schema in maps #23076
[cli/import] Stop dropping map values whose element type is a union of Input-wrapped types during HCL2 import
[cli/neo] Use the selected stack's organization when starting a pulumi neo task instead of the user's default organization
#22951
[cli/neo] Include the failure reason in pulumi_preview and pulumi_up tool results when they fail, so the agent can react instead of seeing a blank error
#22948
[cli/neo] Retry pulumi neo task creation without the attached stack when the backend rejects it with an "invalid entities" error
#22945
[cli/neo] Surface the failure reason when a filesystem tool call fails, instead of returning an empty result to the agent
#23019
[cli/package] Use --output=markdown (not the renamed-away --format=markdown) in the pulumi api pointers printed by pulumi package add and pulumi package gen-sdk
#23098
[programgen/pcl] Stop reporting spurious circular references when an ignoreChanges, hideDiffs, replaceOnChanges, or additionalSecretOutputs entry shares a name with a top-level node
#22931
[sdk/python] Speed up python program resolution by using a set instead of deque to track outputs #22946
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
[cli] Include the running command name and detected AI agent (when present) in the User-Agent header on Pulumi Cloud API requests #22908
[cli] Include the running command name and detected AI agent (when present) in the User-Agent header on Pulumi Cloud API requests #22908
[engine] Include result on the summary engine event
#22883
[sdkgen] Eagerly error on schemas with unconstructable types #22890
[cli/cloud] Auto-fill lang and os query parameters on pulumi cloud api GET/HEAD requests when the matched OpenAPI operation declares them and the caller hasn't supplied them
#22726
[cli/package] Add pulumi package new to bootstrap a Pulumi package from a template
#22837
[cli] Add blank-line gaps between pulumi neo TUI conversation blocks
#22846
[cli/import] Preserve __-prefixed keys when generating PCL for imported resource state, so provider-defined payloads round-trip correctly
#22856
[cli/neo] Render ux__ask_user clarifying questions as questions instead of approval prompts
#22862
[cli/neo] Fix a panic when cancelling a pulumi neo session
#22898
[cli/neo] Render every assistant message in the TUI scrollback so multi-turn commentary no longer disappears between tool calls
[cli/neo] Return the bare stack name and canonical project name from pulumi_preview and pulumi_up tool results instead of echoing the raw input
#22891
[codegen/pcl] Stop reporting spurious circular references when an ignoreChanges, hideDiffs, replaceOnChanges, or additionalSecretOutputs entry shares a name with a top-level node
#22916
[programgen/pcl] Fix PCL binder panic when a conditional mixes a Promise-typed branch with a try() branch #22907
[sdk/python] Support NotRequired, Required and total=False in TypedDicts for component resource arg types
#22858
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
[cli] Add pulumi logs decrypt command for viewing logs #22523
[cli] Add pulumi logs decrypt command for viewing logs
#22523
[cli] Bundle the hcl language host (from pulumi-labs/pulumi-hcl)
#22807
[cli] Automatically install the hcl converter from pulumi-labs/pulumi-hcl when running pulumi convert --from hcl
#22816
[pcl] Add read blocks to PCL to read resources via ID and query instead of registering them
#22641
[cli/cloud] Add pulumi cloud api <op-or-path> for calling any Pulumi Cloud API
endpoint, with --field/--header/--input/--body flag handling, path
template binding, content negotiation via --format, and --dry-run
[cli/cloud] Add --paginate to pulumi cloud api: follow continuation cursors,
accumulate items into a single JSON envelope, and surface progress
events to stderr with --emit-events (page, complete, truncated,
partial_failure, cancelled).
[cli] Fix the pulumi neo shell tool to honor the agent-supplied timeout and to terminate the whole process tree (and unblock cmd.Wait) when the deadline fires, so commands like kubectl logs -f no longer hang Neo indefinitely.
#22820
[cli] Surface the error and exit when pulumi neo fails to create the underlying task, instead of leaving the TUI stuck in Thinking…
#22825
[codegen/go] Correctly generate []pulumi.Asset & []pulumi.Archive
#22827
[cli/neo] Exit cleanly when the user presses Ctrl+C twice in pulumi neo instead of hanging until a third press
#22821
[engine] The engine now caches schemas at PULUMI_HOME/schemas, and will cache for parameterised packages as well
#22812
[sdk-python] Preserve __-prefixed keys (e.g. __type discriminators) across RPC deserialization, matching the behavior of the other language SDKs
#22834
[programgen/{nodejs,python}] Fix programgen to emit the right length check for string length
#22802
pulumi neo welcome banner with new Neo-branded ASCII art.
#22817Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
[cli/cloud] Add pulumi cloud api describe for inspecting the parameters, request body, and response schema of any Pulumi Cloud API operation, with tex
[cli/cloud] Add pulumi cloud api describe for inspecting the parameters, request
body, and response schema of any Pulumi Cloud API operation, with
text, markdown, and JSON output
[cli/cloud] Add pulumi cloud api list for browsing every endpoint exposed by the Pulumi
Cloud OpenAPI spec, with table and JSON output
Nothing published for this version
Nothing published for this version
[auto/python] Expose the auto-generated Pulumi CLI interface as workspace.cli_api #22638
[auto/python] Expose the auto-generated Pulumi CLI interface as workspace.cli_api
#22638
[cli] Add encrypted logging to ~/.pulumi/logs; use the PULUMI_ENABLE_AUTOMATIC_LOGGING feature flag to turn it on #22494
[cli] Implement the filesystem__grep and filesystem__content_replace local tools
for pulumi neo. grep runs a regex search across files in the project root
with an optional include glob filter and returns results in path:lineno: line
form. content_replace performs a literal multi-file search-and-replace with a
file_pattern glob and dry_run preview mode. Both tools skip binary files,
hidden directories, and node_modules, and reject paths outside the project
root. Their input schemas match the cloud-side tool definitions.
[cli] Add pulumi_preview and pulumi_up as local tools for the experimental pulumi neo
agent. The Neo TUI renders a persistent bordered block for each operation that
streams changed resources and diagnostics as the engine runs and finalizes with a
summary of the op counts. Hidden behind PULUMI_EXPERIMENTAL.
[engine] Add List to the provider protocol and schema
#22693
[engine] Return a clear error when two installed plugins claim the same default provider package name (for example, a native scaleway provider alongside a terraform-provider bridge parameterized as scaleway) instead of panicking with "Should not have seen an older plugin if sorting is correct!"
#22679
[programgen] Do not wrap a call(...) on a method whose return type is marked plain in an Output. Previously
PCL bound every method call's return type as Output<T>, which caused downstream program-gen
to emit broken .apply(...)/.ApplyT(...) traversals against plain struct returns (e.g.
methods with liftSingleValueMethodReturns=true or ReturnTypePlain=true).
[backend/diy] When using a backend url containing creds (e.g. PostgreSQL conn string), mask user:pass as in lock-related error messages #22701
[codegen/go] Generate unqualified Provider references for the package's own provider resource. Previously
the Go codegen always emitted <pkg>.Provider even when the reference appeared inside <pkg>
itself, producing identifiers that would not compile. Affects generated code for method return
types (and other schema positions) that reference pulumi:providers:<pkg>.
[codegen/nodejs] Generate unqualified Provider references for the package's own provider resource when emitting
TypeScript code inside that package. Previously the generator always qualified the name as
<pkg>.Provider, which does not resolve when no <pkg> namespace import is in scope.
[codegen/nodejs] Import the correct class name for a provider resource. Imports for pulumi:providers:<pkg> used
the title-cased package name instead of Provider, producing a phantom identifier that clashed
with the containing package's component/resource classes.
[programgen/nodejs] Emit await for call(...) invocations of methods whose return type is marked plain, and
force the generated program into an async export = async () => ... wrapper whenever such a
call is present. The Node SDK returns Promise<T> for plain methods; previously program-gen
used the result directly, which did not match its runtime type.
[codegen/python] Avoid a self-import (import pulumi_<pkg> inside pulumi_<pkg>/<module>.py) when referencing
the package's own provider resource. Python referenced the Provider as pulumi_<pkg>.Provider
even inside that package, which caused a circular import at runtime.
[sdk/python] Reduce internal Output[T] data to a single asyncio.Future
#22661
[sdkgen/{nodejs,python}] Generate optional input types that accept undefined/None values #22552
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
[cli] Add an experimental pulumi neo command that creates a Pulumi Neo agent task in CLI tool-execution mode and runs the local tool loop. Filesystem
[cli] Add an experimental pulumi neo command that creates a Pulumi Neo agent task in CLI
tool-execution mode and runs the local tool loop. Filesystem and shell tool calls
issued by the agent run on the user's machine in their working directory; the
interactive chat continues to happen in the Pulumi Console at the URL the command
prints. Hidden behind PULUMI_EXPERIMENTAL.
[cli] Add support for handling user approval requests in the pulumi neo terminal UI.
When the agent requests confirmation for a sensitive action, the TUI prompts the
user and forwards their response back to the Pulumi Console. Hidden behind
PULUMI_EXPERIMENTAL.
[cli] Add an interactive terminal UI for pulumi neo built with bubbletea, rendering
agent messages, tool calls, and streaming output in the terminal alongside the
Pulumi Console session. Hidden behind PULUMI_EXPERIMENTAL.
[cli] Switch logging library from glog to slog.
BREAKING: any if logging.V(x) { need to be changed to if logging.V(x).Enabled()
[cli] Add a plan-mode toggle to the pulumi neo TUI, bound to Shift+Tab. When
plan mode is on, Neo explores and asks questions without writing files,
running pulumi up, or opening PRs, and surfaces an approved plan via a
dedicated approval gate. The toggle must be set before the first message
(plan mode is task-level on the wire); approving the proposed plan exits
plan mode automatically.
[cli] The pulumi neo TUI now drives its "thinking" spinner off a single declarative
rule (the spinner stays on until a final event — final assistant message, approval
request, cancellation, or error — lands), so the indicator no longer flickers off
when the agent hands off tool calls to the CLI or when streaming text arrives
between tools. Press Esc during a turn to ask the agent to cancel; the label
switches to "Cancelling..." until the backend acknowledges.
[cli] pulumi neo now executes the edit filesystem tool locally, matching the schema
and response wording of the upstream mcp-claude-code tool so the agent sees
identical output whether the call ran on Cloud or CLI. edit performs exact-string
replacement with occurrence-count validation, and creates a new file when the
target is missing and old_string is empty.
[cli] Render user messages in the pulumi neo TUI as soon as they're submitted
instead of waiting for the Pulumi Cloud event stream to echo them back.
The initial prompt passed on the command line also appears in the
transcript at startup. Self-echoes from the server are de-duplicated;
user input that originated from another client (e.g. the web UI on the
same task) still renders.
[cli] Wrap warnings, errors, and user-message bubbles to the terminal width in the
pulumi neo TUI. Previously these blocks rendered as single long lines that
were clipped at the right edge of the viewport. On resize, all width-dependent
transcript blocks (user messages, warnings, errors, assistant messages) now
reflow to the new terminal width.
[cli/policy] Fix policy ls to use the default org name, not username
#22656
[engine] Fix provider registry race condition in parallel delete-before-replace #21487
[engine] Signal providers to cancel before closing them during replacement
[sdkgen] Error on 'id' in state inputs #22636
[programgen/python] Add necessary casts between types in generated programs #22567
[sdkgen/go] Fix caching of package references to be per-deployment not per-process #22170
[java] Upgrade java to v1.25.0 #22673
[auto/go] Generate command methods for the Go Automation API codegen #22612
[sdk] Clarify docs on the remote parameter of ComponentResource / Resource in the Node and Python SDKs
#22603
[sdk/dotnet] Upgrade dotnet to v3.103.1 #22676
[yaml] Upgrade yaml to v1.32.0 #22674
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
[cli] Auto-detect Mercurial repository metadata for pulumi up / pulumi preview updates, mirroring existing Git support #22618
[cli] Auto-detect Mercurial repository metadata for pulumi up / pulumi preview updates, mirroring existing Git support
#22618
[engine] Send Cancel RPC to plugins on host close for graceful shutdown #22569
[engine] Pass resource options to hooks through the engine #22582
[engine] Add GetDeploymentInfo to the resource monitor service
[auto/go] Add New command to Automation API
#22439
[auto/{go,nodejs,python}] Add --diff to automation api for destroy #22563
[auto/python] Add new command to Automation API
#22439
[pcl] Support for resource hooks in PCL #22365
[sdk-nodejs] Warn when a non-ComponentResource class is passed in the explicit components list to componentProviderHost
#22619
[sdk-python] Warn when a non-ComponentResource class is passed in the explicit components list to component_provider_host
#22619
[cli/import] Add support for providers to be defined in the same import file as their users #21671
[cli/policy] ESC environment support for local policy packs #22495
[sdk/nodejs] Support package.yaml when using pnpm #22491
[sdk/python] Add function decorator variants for resource and error hooks #22519
[auto/{nodejs,python}] Support --run-program for inline programs with preview_refresh/destroy
[backend/diy] Remove state lock for destroy and import with preview only for diy backend #22561
[engine] Fix snapshot integrity error with component/provider resources in refresh --run-program #21817
[pcl] Type list and tuple indices as integers not numbers #22592
[pcl] Builtin functions element and range take int parameters not numbers #22597
[programgen/{go,nodejs,python}] Fix some cases of name conflicts in program gen not being handled correctly #22556
[programgen/nodejs] Add necessary casts between types in generated programs #22557
[programgen/{nodejs,python}] Fix imports of camelCase modules #22536
[sdk/python] Support Input[Optional[T]] in Python runtime type unwrapping #22553
[sdkgen] Warn about modules nested under the index module which are not supported #22531
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
One column per quarter.