Updating skills from OpenAPI specifications

Changes to the API happen over time, whether to add new features, improve security, fix bugs, among others. Skills that are imported from OpenAPI specifications (OAS) must be updated manually when these changes happen. See how to update skills from OAS.

You can use the same OAS that you created to import the skills to IBM watsonx Orchestrate as the base. If you don't have your previous imported OAS, you can download it directly from IBM watsonx Orchestrate. To download OAS from IBM watsonx Orchestrate, see Exporting skills.

To update an app, you must keep the same title and x-ibm-application-id used in the previous imported OAS. If you don't know this information, download the previous imported OAS from IBM watsonx Orchestrate.

Note:Changing the URL will create a new app with a new set of skills. If you need to change the endpoint you can do it in the **Apps** page. For more information on changing prebuilt apps endpoint, see Configuring prebuilt apps endpoint . For more information on changing the endpoint of an imported app, see Configuring an imported app endpoint.

It is also recommended to update the version of the app to one version higher than the previous version.

The following image shows an example of an app update.

Updating skills
Figure 1: OpenAPI file with updates of an app, such as title, application ID, and version.

Then you can update the skills of your app according with your API, the process to update the skills is the same to create. See Creating OpenAPI Specification

Updating skills in other app

There are cases when you want to update skills but keep the previous version, for example to have the same pack of skills that point to different servers, or that uses different credentials to do some activity. To do so, you need to create a new app when you update the skill.

To create a new app with the same skills, change the title and x-ibm-application-id used in the previous imported OAS.

It is also recommended to change the x-ibm-application-name property too otherwise the new app has the same name that of the previous imported app.

The following image shows an example of an update that creates a new app.

Creating other app
Figure 2: OpenAPI file with updates of an app, such as title, name, and ID of the application.' property updated.