Skip to content

Allow stack description update - #5596

Merged
kathap merged 4 commits into
mainfrom
allow-stack-description-update
Nov 4, 2026
Merged

kathap merged 4 commits into
mainfrom
allow-stack-description-update

Conversation

@kathap

@kathap kathap commented Oct 29, 2026 •

Copy link
Copy Markdown
Contributor

Allow updating stack description via PATCH /v3/stacks/:guid

  • A short explanation of the proposed change:
    Adds an optional description parameter to PATCH /v3/stacks/:guid, making a stack's description editable after creation. When provided, description must be at most 250 characters (same length description was given in create in commit 50e9b79).
  • An explanation of the use cases your change solves
    Mark a newly introduced stack e.g. as "preview". When a new stack is rolled out, operators want to flag it as preview/experimental for a period. The description is prominent, it's shown by cf stacks, so updating it is a clear, visible signal to users. (state_reason could carry this too, but it's less visible and not shown by cf stacks.)
    Correct or clarify a stack description after the fact without recreating the stack, e.g. fixing a typo, updating the OS version note, or adding deprecation guidance, rather than being stuck with whatever was seeded from cf-deployment at creation time.

This change was developed with AI assistance; all code was reviewed and tested by me.

  • I have reviewed the contributing guide

  • I have viewed, signed, and submitted the Contributor License Agreement

  • I have made this pull request to the main branch

  • I have run all the unit tests using bundle exec rake

  • I have run CF Acceptance Tests

This adds an optional `description` parameter
to PATCH /v3/stacks/:guid so a stack's description can be changed after
creation — e.g. to mark a newly introduced stack as "preview".

Validation: when provided, description must be non-empty and <= 250
characters. The create message is tightened to match,
POST and PATCH now behave identically for description:
  - Omitted → allowed (comes from cf-deployment)
  - Non-empty, ≤250 → allowed
  - "", whitespace-only, or null → 422 rejected
  - >250 → rejected
@kathap
kathap marked this pull request as draft October 30, 2026 08:51
@kathap
kathap force-pushed the allow-stack-description-update branch from 5f58bfc to 8a79f29 Compare October 30, 2026 11:21
@kathap
kathap marked this pull request as ready for review October 30, 2026 15:26
@kathap
kathap merged commit 8bc68e6 into main Nov 4, 2026
14 checks passed
ari-wg-gitbot added a commit to cloudfoundry/capi-release that referenced this pull request Nov 4, 2026
Changes in cloud_controller_ng:

- Allow stack description update
    PR: cloudfoundry/cloud_controller_ng#5596
    Author: Katharina Przybill <30441792+kathap@users.noreply.github.com>
@moleske
moleske deleted the allow-stack-description-update branch November 5, 2026 02:57
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants