Re-syncing Your OpenAPI Document
On re-sync of your OpenAPI file, pages are merged with existing pages if they are present. We use operationId
of the Operation Object to determine what pages are considered to be the same.
If on re-sync there is a new operationId
, then a new page is created. If on re-sync an operationId
is removed, then the page is removed.
If you do not have an operationId
, we create one for you using the following algorithm.
With an endpoint like this:
{
"/pet": {
"post": {
}
}
}
We take the path /pet
, remove any non-alphanumeric characters, lowercase it and concatenate it onto the end of the method. So the above would become post_pet
.
We recommend you always provide an
operationId
for each of your endpoints to reduce the risk of data loss associated with us creating a unique ID for you.
Updated 10 months ago