--- name: codeengine-api-changelog title: API change log description: Find a summary of the latest changes, improvements, and updates for the IBM Cloud® Code Engine API plug-in. Changes to existing API versions are designed to be compatible with existing client applications. last-updated: 2026-07-08 --- > ## Documentation Index > The table of contents for this documentation set is at https://cloud.ibm.com/docs/codeengine?format=markdown > The index for all IBM Cloud docs is at: https://cloud.ibm.com/docs/llms.txt > Use these files to discover more information as needed. # API change log {: #api-changelog} Find a summary of the latest changes, improvements, and updates for the IBM Cloud® Code Engine API plug-in. Changes to existing API versions are designed to be compatible with existing client applications. {: shortdesc} ## API versioning {: #api-versioning} API requests require a version parameter that takes the date in the format `version=YYYY-MM-DD`. Send the version parameter with every API request. When the API is changed in a way that is not compatible with previous versions, a new minor version is released. To take advantage of the changes in a new version, change the value of the version parameter to the new date. If you're not ready to update to that version, don't change your version date. ### Active version dates {: #active-version-dates} The following table shows the service behavior changes for each version date. Switching to a later version date activates all changes that are introduced in earlier versions. | Version date | Version number | Summary of changes | |---|---|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| |`2025-07-10`| Version 2.2.0 | As part of the introduction of `persistent_data_stores` as a Volume Mount type for apps and jobs, the `name` property of entries in `run_volume_mounts` is no longer supported. |`2024-05-13`| Version 2.1.0 | Environment variables defined and set by Code Engine are now split out from user-defined environment variables and are exposed as part of the `computed_env_variables` field in the API. | |`2022-12-09`| Version 2.0.0 | | |`2021-03-31`| Version 1.0.0 | | {: caption="Changes in the IBM Cloud Code Engine API" caption-side="bottom"} ## 27 February 2026 {: #27-february-2026} Added support for fleets in the API. : - See [Create a fleet API](https://cloud.ibm.com/apidocs/codeengine/v2#create-fleet){: external}. : - See [List fleets API](https://cloud.ibm.com/apidocs/codeengine/v2#list-fleets){: external}. : - See [Get a fleet API](https://cloud.ibm.com/apidocs/codeengine/v2#get-fleet){: external}. : - See [Cancel a fleet API](https://cloud.ibm.com/apidocs/codeengine/v2#cancel-fleet){: external}. : - See [Delete a fleet API](https://cloud.ibm.com/apidocs/codeengine/v2#delete-fleet){: external}. : - See [List tasks API](https://cloud.ibm.com/apidocs/codeengine/v2#list-fleet-tasks){: external}. : - See [Get a task API](https://cloud.ibm.com/apidocs/codeengine/v2#get-fleet-task){: external}. : - See [List workers API](https://cloud.ibm.com/apidocs/codeengine/v2#list-fleet-workers){: external}. : - See [Get a worker API](https://cloud.ibm.com/apidocs/codeengine/v2#get-fleet-worker){: external}. Added support for subnet pools in the API. : - See [Create a subnet pool](https://cloud.ibm.com/apidocs/codeengine/v2#create-subnet-pool){: external}. : - See [List subnet pools](https://cloud.ibm.com/apidocs/codeengine/v2#list-subnet-pools){: external}. : - See [Get a subnet pool](https://cloud.ibm.com/apidocs/codeengine/v2#get-subnet-pool){: external}. : - See [Delete a subnet pool](https://cloud.ibm.com/apidocs/codeengine/v2#delete-subnet-pool){: external}. Added support for type `private_path_service_gateway` for allowed outbound destinations in the API. : - See [Create an allowed outbound destination API](https://cloud.ibm.com/apidocs/codeengine/v2#create-allowed-outbound-destination){: external}. : - See [Get an allowed outbound destination API](https://cloud.ibm.com/apidocs/codeengine/v2#get-allowed-outbound-destination){: external}. : - See [List allowed outbound destinations API](https://cloud.ibm.com/apidocs/codeengine/v2#list-allowed-outbound-destinations){: external}. : - See [Update an allowed outbound destination API](https://cloud.ibm.com/apidocs/codeengine/v2#update-allowed-outbound-destination){: external}. ## 17 September 2025 {: #17-september-2025} Added a new `run_volume_mounts` type of `persistent_data_stores` for apps, jobs, and jobruns. : - See [Create an app API](https://cloud.ibm.com/apidocs/codeengine/v2#create-app){: external}. : - See [Update an app API](https://cloud.ibm.com/apidocs/codeengine/v2#update-app){: external}. : - See [Create a job API](https://cloud.ibm.com/apidocs/codeengine/v2#create-job){: external}. : - See [Update a job API](https://cloud.ibm.com/apidocs/codeengine/v2#update-job){: external}. : - See [Create a job run API](https://cloud.ibm.com/apidocs/codeengine/v2#create-job-run){: external}. ## 03 April 2025 {: #03-april-2025} Added support for HMAC auth secrets. Specify to create HMAC auth secrets with the `format` field and specify the details of HMAC auth secrets with the `hmac_auth` field. : - See [Create a secret API](https://cloud.ibm.com/apidocs/codeengine/v2#create-secret){: external}. Added the `run_compute_resource_token_enabled` property for app create, app update, job create, job update, function create, and function update. Use this property to enable or disable Trusted Profiles support for the selected resource. : - See [Create an app API](https://cloud.ibm.com/apidocs/codeengine/v2#create-app){: external}. : - See [Update an app API](https://cloud.ibm.com/apidocs/codeengine/v2#update-app){: external}. : - See [Create a job API](https://cloud.ibm.com/apidocs/codeengine/v2#create-job){: external}. : - See [Update a job API](https://cloud.ibm.com/apidocs/codeengine/v2#update-job){: external}. : - See [Create a function API](https://cloud.ibm.com/apidocs/codeengine/v2#create-function){: external}. : - See [Update a function API](https://cloud.ibm.com/apidocs/codeengine/v2#update-function){: external}. Replaced nodejs-18 support with nodejs-20 : - See [List the function runtimes API](https://cloud.ibm.com/apidocs/codeengine/v2#list-function-runtimes){: external}. : - See [Create a function API](https://cloud.ibm.com/apidocs/codeengine/v2#create-function){: external}. : - See [Update a function API](https://cloud.ibm.com/apidocs/codeengine/v2#update-function){: external}. ## 21 February 2025 {: #21-february-2025} Added support for `run_build_params` property for build and buildrun. : - See [Create a build API](https://cloud.ibm.com/apidocs/codeengine/v2#create-build){: external}. : - See [Get a build API](https://cloud.ibm.com/apidocs/codeengine/v2#get-build){: external}. : - See [Update a build API](https://cloud.ibm.com/apidocs/codeengine/v2#update-build){: external}. : - See [Create a build run API](https://cloud.ibm.com/apidocs/codeengine/v2#create-build-run){: external}. : - See [Get a build run API](https://cloud.ibm.com/apidocs/codeengine/v2#get-build-run){: external}. ## 16 January 2025 {: #16-january-2025} Added jobrun `indices_details` property to the existing jobrun `status_details` property. : - See [Get a job run API](https://cloud.ibm.com/apidocs/codeengine/v2#get-job-run){: external}. ## 21 November 2024 {: #21-november-2024} Added support for allowed outbound destinations in the API. : - See [List allowed outbound destinations API](https://cloud.ibm.com/apidocs/codeengine/v2#list-allowed-outbound-destinations){: external}. : - See [Create an allowed outbound destination API](https://cloud.ibm.com/apidocs/codeengine/v2#create-allowed-outbound-destination){: external}. : - See [Get an allowed outbound destination API](https://cloud.ibm.com/apidocs/codeengine/v2#get-allowed-outbound-destination){: external}. : - See [Delete an allowed outbound destination API](https://cloud.ibm.com/apidocs/codeengine/v2#delete-allowed-outbound-destination){: external}. : - See [Update an allowed outbound destination API](https://cloud.ibm.com/apidocs/codeengine/v2#update-allowed-outbound-destination){: external}. ## 17 May 2024 {: #17-may-2024} Added support for functions in the API. : - See [List function runtimes API](https://cloud.ibm.com/apidocs/codeengine/v2#list-function-runtimes){: external}. : - See [List functions API](https://cloud.ibm.com/apidocs/codeengine/v2#list-functions){: external}. : - See [Create a function API](https://cloud.ibm.com/apidocs/codeengine/v2#create-function){: external}. : - See [Get a function API](https://cloud.ibm.com/apidocs/codeengine/v2#get-function){: external}. : - See [Delete a function API](https://cloud.ibm.com/apidocs/codeengine/v2#delete-function){: external}. : - See [Update a function API](https://cloud.ibm.com/apidocs/codeengine/v2#update-function){: external}. ## 30 January 2024 {: #30-jan-2024} Added support for the `build` and `buildrun` properties for jobs. : - See [Create a job API](https://cloud.ibm.com/apidocs/codeengine/v2#create-job){: external}. : - See [Get a job API](https://cloud.ibm.com/apidocs/codeengine/v2#get-job){: external}. : - See [Update a job API](https://cloud.ibm.com/apidocs/codeengine/v2#update-job){: external}. ## 04 January 2024 {: #04-jan-2024} Added support for the `scale_array_size_variable_override` property for job runs. : - See [Create a job run API](https://cloud.ibm.com/apidocs/codeengine/v2#create-job-run){: external}. ## 03 November 2023 {: #03-nov-2023} Added support for domain mappings in the API. : - See [List domain mappings API](https://cloud.ibm.com/apidocs/codeengine/v2#list-domain-mappings){: external}. : - See [Create a domain mapping API](https://cloud.ibm.com/apidocs/codeengine/v2#create-domain-mapping){: external}. : - See [Get a domain mapping API](https://cloud.ibm.com/apidocs/codeengine/v2#get-domain-mapping){: external}. : - See [Delete a domain mapping API](https://cloud.ibm.com/apidocs/codeengine/v2#delete-domain-mapping){: external}. : - See [Update a domain mapping API](https://cloud.ibm.com/apidocs/codeengine/v2#update-domain-mapping){: external}. ## 27 September 2023 {: #27-sep-2023} Added support for liveness and readiness probes for applications in the API. Set the probes and their properties when you create or update an application with the API. : - See [Create an application API](https://cloud.ibm.com/apidocs/codeengine/v2#create-app){: external}. : - See [Update an application API](https://cloud.ibm.com/apidocs/codeengine/v2#update-app){: external}. ## 22 June 2023 {: #22-june-2023} Added support for service binding operations in the API. : - See [List bindings API](https://cloud.ibm.com/apidocs/codeengine/v2#list-bindings){: external}. : - See [Create a binding API](https://cloud.ibm.com/apidocs/codeengine/v2#create-binding){: external}. : - See [Get a binding API](https://cloud.ibm.com/apidocs/codeengine/v2#get-binding){: external}. : - See [Delete a binding API](https://cloud.ibm.com/apidocs/codeengine/v2#delete-binding){: external}. Added support for service access secrets, which are required for service binding operations. Specify to create service access secrets with the `format` field and specify the details of service access secrets with the `service_access` field. : - See [Create a secret API](https://cloud.ibm.com/apidocs/codeengine/v2#create-secret){: external}. ## 30 May 2023 {: #30-may-2023} Added support to get status details for a project. : - See [Get the status details for a project API](https://cloud.ibm.com/apidocs/codeengine/v2#get-project-status-details){: external}. ## 27 March 2023 {: #27-mar-2023} Added support to provide private and public egress IP addresses for a project. : - See [List egress IP addresses for projects API](https://cloud.ibm.com/apidocs/codeengine/v2#get-project-egress-ips){: external}. : - See [Code Engine public and private IP addresses](https://cloud.ibm.com/docs/codeengine?topic=codeengine-network-addresses&format=markdown). Improved documentation for create and update of secrets to include the `One of` fields for specific secret formats as part of the `data` field. : - See [Create a secret API](https://cloud.ibm.com/apidocs/codeengine/v2#create-secret){: external}. : - See [Update secret API](https://cloud.ibm.com/apidocs/codeengine/v2#replace-secret){: external}. ## 9 December 2022 {: #9-dec-2022} IBM Cloud® Code Engine API Version 2.0.0 API Version 2.0.0 released : This version of the API is enhanced to support more Code Engine resources, and more regions. - The API supports the following Code Engine resources: `projects`, `reclamations`, `apps`, `revisions`, `job`, `job runs`, `builds`, `build runs`, `config maps`, and `secrets`. See [Code Engine API](https://cloud.ibm.com/apidocs/codeengine){: external}. - The API supports more regional endpoints. See [Regions for Code Engine](https://cloud.ibm.com/docs/codeengine?topic=codeengine-regions&format=markdown).