App and Solution
Solutions
Update Solution
10 min
overview developers can use the https //docs getos1 com/app and soln reference/update solution api to modify their registered solutions with a single call with this api, developers can easily add new attributes, update existing ones, or remove certain specifications with a single call additionally, there are two endpoints available to add or remove apps within a solution https //docs getos1 com/reference/delete list of applications from solution and https //docs getos1 com/reference/addupdate list of applications in solution these endpoints allow developers to update existing applications in a solution version or remove redundant apps update soln endpoint patch developer/solutions/versions/{solutionversionid} attributes the https //docs getos1 com/reference/update solution api utilizes the same attributes as the https //docs getos1 com/reference/register solution endpoint true 222left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type example request the following example request updates the displayname , shortdescription , supportedcountries { "displayname" "last mile delivery v2", "shortdescription" "an optimized last mile delivery solution to ensure on time deliveries and reduce costs " } this payload does the following update the displayname to "last mile delivery v2" update the shortdescription add "uk" to the supportedcountries list all other existing attributes would remain unchanged updating array values when updating a solution, it's important to note that you need to pass all existing array attributes along with any new values you want to add or modify this applies to all attributes that are stored as arrays, such as solution urls, categories, or any other relevant array fields example adding a new solution url let's say you have previously registered an app with two solution urls { "solnurls" \[ { "name" "solution 1", "url" "https //example com/solution1" }, { "name" "solution 2", "url" "https //example com/solution2" } ] } now, if you want to add a third solution url to your app, you need to include the existing solution urls in the update request along with the new url here's an example of how you would update your app using the api { "solnurls" \[ { "name" "solution 1", "url" "https //example com/solution1" }, { "name" "solution 2", "url" "https //example com/solution2" }, { "name" "solution 3", "url" "https //example com/solution3" } ] } in the above example, we include the existing solution urls ( https //example com/solution1 and https //example com/solution2 ) along with the new url ( https //example com/solution3 ) in the solnurls array the same principle applies to all array attributes when updating a solution if you want to add, remove, or modify any values in an array attribute, you need to provide the complete updated array in the api request add or update apps within a solution endpoint put /developer/solutions/versions/{solutionversionid}/apps to add or update apps in a solution, call https //docs getos1 com/reference/addupdate list of applications in solution and provide the following information the applications array listingid the unique human readable identifier of the application semver the https //semver org/ version of the application displayorder assigning a numerical value to the display order controls its listing sequence within a solution's left navigation set to '0' or leave blank to hide the app from the console's menu initsequence the sequence in which the permission file for a given app should be onboarded to a tenant ( ) indicates that listingid and semver are required example request the following request adds version 1 0 2 of the truck trackers app to the solution { "applications" \[ { "listingid" "truck trackers", "semver" "1 0 2", "displayorder" 2, "initsequence" 3 } ] } remove application from solution endpoint delete /developer/solutions/versions/{solutionversionid}/apps to remove an app from a soln, call https //docs getos1 com/reference/delete list of applications from solution and provide the listingid of the app to delete in the applications array the following request would delete the "last mile delivery" example request { "applications" \[ { "listingid" "last mile delivery" } ] }