Databricks Community

j_al · ‎03-15-2023

Jobs API 2.1 OpenAPI specification seems broken.

The swagger file seems to be invalid.

https://docs.databricks.com/_extras/api-refs/jobs-2.1-aws.yaml

Debayan · ‎03-15-2023

Hi, What do you mean by broken? Was there an issue running the API? If yes, any screenshot for reference?

please tag @Debayan with your next response which will notify me, Thank you!

j_al · ‎03-16-2023

You can try to open above file in swagger editor to view the errors.

@Debayan Mukherjee

Debayan · ‎03-20-2023

Hi, Could you please try with openapi: 3.0.3 and let us know whats the outcome?

Anonymous · ‎03-17-2023

Hi @Julius Almeida

Hope all is well! Just wanted to check in if you were able to resolve your issue and would you be happy to share the solution or mark an answer as best? Else please let us know if you need more help.

We'd love to hear from you.

Thanks!

JeffShutt_ · ‎05-03-2023

@Debayan Mukherjee , are you suggesting to revert the openapi version specified in https://docs.databricks.com/_extras/api-refs/jobs-2.1-aws.yaml from 3.1.0 to 3.0.3?

Debayan · ‎05-04-2023

Hi @Jeff Shutt , lets try to revert to 3.0.3 in a dev environment and try again?

JeffShutt_ · ‎05-05-2023

It's unclear to me what you are asking, so let me spell out what I am seeing so we are on the same page.

If you go to https://editor.swagger.io/ and input this document, https://docs.databricks.com/_extras/api-refs/jobs-2.1-aws.yaml, it tells you "Unable to render this definition"

If you go to https://editor-next.swagger.io/ and input the same document, it does seem to open there albeit with a few warnings.

If you go to https://apitools.dev/swagger-parser/online/ and input the same document, it does validate successfully as far as I can tell.

I am guessing this means that the old swagger editor doesn't support OpenAPI 3.1.0?

JeffShutt_ · ‎05-17-2023

@Debayan Mukherjee , now it appears that https://docs.databricks.com/_extras/api-refs/jobs-2.1-aws.yaml has been taken down and is replaced by the new API page. As a user of this API, are we not able to access this Open API spec for code generation anymore?