Patch a deployment

Patches the SDL the console stored for this deployment, or renames the deployment, or both; the SDL is never accepted from the request. Only the services named are touched. A name on its own touches no definition, so it renames a deployment the console holds no SDL for and sends neither a deployment update nor a manifest. Such a rename also reports every lease status as null, because it asks no provider for one. A patched environment variable is re-appended to its service's env list, so the order shown by GET may differ afterwards. A replaced secret takes effect through the deployment update this patch sends, not in the workload already running. The definition is recorded before the deployment update is sent, so an update that fails leaves the console describing a manifest version the deployment was never updated to. Re-sending the identical request repairs that: it recomputes the same manifest version, is accepted rather than refused, and goes on to send the update and push the manifest. A seal bound to the SDL is the exception: the first attempt replaced the SDL it was sealed against, so the same sealedSecrets answer 403 until the same values are sealed against the SDL GET now returns.

patch/v1/deployments/{dseq}

Path parameters

dseqstring required

Deployment sequence number

Request body

Response

Deployment patched successfully

Changes

Changed in 10 of the 64 revisions of this API.7522

Sep 25, 202692586f3009d71See the full diff
- ○
  added the optional property /// to the response with the status
  response-optional-property-added
Sep 24, 2026008c0988c96a1See the full diff
- ○
  added the non-success response with the status
  response-non-success-status-added
Sep 24, 2026d2bfd4f0bc0b1See the full diff
- ○
  added the non-success response with the status
  response-non-success-status-added
Sep 23, 202626080d8348622See the full diff
- ○
  added the new optional request property /////
  new-optional-request-property
- ○
  added the new optional request property /////
  new-optional-request-property
Sep 23, 20264b7bb51509b31See the full diff
- ○
  added the optional property /// to the response with the status
  response-optional-property-added
Sep 17, 2026422c4e950cc81See the full diff
- ○
  added the optional property /// to the response with the status
  response-optional-property-added
Sep 15, 20262dc2f501f2a71See the full diff
- ○
  added the required property / to the response with the status
  response-required-property-added
Sep 11, 20263e9c8b18440512See the full diff
- ▲
  the response property / became optional for the status
  response-property-became-optional
- ○
  added the new optional request property /
  new-optional-request-property
- ○
  the request property / became optional
  request-property-became-optional
Sep 9, 2026ac1c2d5096c46511See the full diff
- ▲
  request property /////// was restricted to a list of enum values
  request-property-became-enum
- ▲
  the ////// request property's min was increased to 1.00
  request-property-min-increased
- ▲
  the ////// request property's min was increased to 1.00
  request-property-min-increased
- ▲
  the ////// request property's min was increased to 1.00
  request-property-min-increased
- ▲
  the ////// request property's minItems was increased to 1
  request-property-min-items-increased
- ▲
  the / request property's minLength was increased from 0 to 1
  request-property-min-length-increased
- ●
  the ////// request property's max was set to 104857600.00
  request-property-max-set
- ●
  the ////// request property's max was set to 4294967295.00
  request-property-max-set
- ●
  the ////// request property's max was set to 4294967295.00
  request-property-max-set
- ●
  the ////// request property's max was set to 4294967295.00
  request-property-max-set
- ●
  the ////// request property's max was set to 4294967295.00
  request-property-max-set
- ○
  added the new optional request property /
  new-optional-request-property
- ○
  added the new 403 enum value to the request property ///////
  request-property-enum-value-added
- ○
  added the new 404 enum value to the request property ///////
  request-property-enum-value-added
- ○
  added the new 429 enum value to the request property ///////
  request-property-enum-value-added
- ○
  added the new 500 enum value to the request property ///////
  request-property-enum-value-added
- ○
  added the new 502 enum value to the request property ///////
  request-property-enum-value-added
- ○
  added the new 503 enum value to the request property ///////
  request-property-enum-value-added
- ○
  added the new 504 enum value to the request property ///////
  request-property-enum-value-added
- ○
  added the new error enum value to the request property ///////
  request-property-enum-value-added
- ○
  added the new off enum value to the request property ///////
  request-property-enum-value-added
- ○
  added the new timeout enum value to the request property ///////
  request-property-enum-value-added
Sep 8, 20263802e5e5b9db1See the full diff
- ○
  endpoint added
  endpoint-added

Full history