Updating OpenAPI file assigns new Stoplight stable IDs

markg (OP) [05/16/2023 - 14:42 ET]

Hi Skinghar, thank you for looking into this! My confusion is that "manually re-assign all the IDs" conflicts with what the documentation says:

If you delete a file from Stoplight, and later re-import it, the imported file is assigned a new stable ID if one isn't found in its contents. You may do this if you are managing an OpenAPI file in another tool, for example. To ensure your stable IDs stay in sync, add the Stoplight stable ID to the file in your external system, so that when it's re-imported, it won't be assigned a new stable ID.

https://docs.stoplight.io/docs/platform/hosted-docs/stoplight-urls#stable-id-guidelines I followed the first part of your instructions and:

1. Went to the Files tab and deleted our existing OpenAPI file.
2. Imported the updated OpenAPI file.

However, when we do this, it is assigning new IDs instead of the stable IDs in the OpenAPI file, even though we have added the stable ID into the file in our external system as directed by the documentation. Assigning all the IDs manually is too much manual work – we will have about 50 objects that need to be updated multiple times a day. Is there another way to "replace" the OpenAPI file in the workflow that follows the workflow detailed in the documentation?