In case of an OAS spec, updating spec contents can lead to: 1. Creation, deletion and update of operations. 2. Creation, deletion and update of definitions. 3. Update of other info parsed out from the new spec.
In case of contents or source_uri being present in update mask, specType must also be present. Also, specType can not be present in update mask if contents or source_uri is not present.
The updateMask should be used to specify the fields being updated.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-01-16 UTC."],[[["This content describes how to update a `Spec`, which includes information about HTTP requests, path and query parameters, request and response bodies, and authorization."],["The `Spec` fields that can be updated are: `display_name`, `source_uri`, `lint_response`, `attributes`, `contents`, and `specType`."],["Updating the `contents` or `source_uri` of an OAS spec can result in the creation, deletion, and updating of operations and definitions, along with other info parsed from the spec."],["When updating, you must use the `updateMask` query parameter to specify the fields being modified, and if either `contents` or `source_uri` is in the update mask, `specType` must also be present."],["Updating the `Spec` requires the `apihub.specs.update` IAM permission and the `https://www.googleapis.com/auth/cloud-platform` OAuth scope."]]],[]]
