# Swagger specification for Dremio Rest API **URL:** \ **Category:** Uncategorized\ **Created:** [July 19, 2018, 7:58am UTC](https://community.dremio.com/t/swagger-specification-for-dremio-rest-api/1490 "2018-07-19T07:58:08Z")\ **Posts on this page:** 9\ **Page:** 1
**Author:** ![ashitabh\_kumar](https://avatars.discourse-cdn.com/v4/letter/a/35a633/32.png) [@ashitabh\_kumar](https://community.dremio.com/u/ashitabh_kumar)\ **Post date:** [July 19, 2018, 7:58am UTC](https://community.dremio.com/t/swagger-specification-for-dremio-rest-api/1490/1 "2018-07-19T07:58:08Z")
Could you please share Swagger specification for Dremio Rest API ---
**Author:** ![cottreld](https://avatars.discourse-cdn.com/v4/letter/c/6de8d8/32.png) [@cottreld](https://community.dremio.com/u/cottreld)\ **Post date:** [July 19, 2018, 3:24pm UTC](https://community.dremio.com/t/swagger-specification-for-dremio-rest-api/1490/2 "2018-07-19T15:24:07Z")
Yes, we would to gen a python client for the api. ---
**Author:** ![cottreld](https://avatars.discourse-cdn.com/v4/letter/c/6de8d8/32.png) [@cottreld](https://community.dremio.com/u/cottreld)\ **Post date:** [July 19, 2018, 3:25pm UTC](https://community.dremio.com/t/swagger-specification-for-dremio-rest-api/1490/3 "2018-07-19T15:25:53Z")
Interestingly there seems to be a api/swagger but when I hit it I get errors. ---
**Author:** ![laurent](https://sea2.discourse-cdn.com/flex020/user_avatar/community.dremio.com/laurent/32/16_2.png) [@laurent](https://community.dremio.com/u/laurent)\ **Post date:** [July 19, 2018, 3:46pm UTC](https://community.dremio.com/t/swagger-specification-for-dremio-rest-api/1490/4 "2018-07-19T15:46:02Z")
Dremio has a catch-all mechanism, so that’s why it is responding to `api/swagger` but it doesn’t return the expected document as we don’t support Swagger at that time. ---
**Author:** ![cottreld](https://avatars.discourse-cdn.com/v4/letter/c/6de8d8/32.png) [@cottreld](https://community.dremio.com/u/cottreld)\ **Post date:** [July 19, 2018, 3:50pm UTC](https://community.dremio.com/t/swagger-specification-for-dremio-rest-api/1490/5 "2018-07-19T15:50:42Z")
Ah ok. Is there some other API spec that you are using behind the scenes? Often you can just clip on something to produce the swagger spec automatically. I am reluctant to spend time manually mapping the API if it is subject to change. If I can scrape it from the open sourced code that could be good too. ---
**Author:** ![laurent](https://sea2.discourse-cdn.com/flex020/user_avatar/community.dremio.com/laurent/32/16_2.png) [@laurent](https://community.dremio.com/u/laurent)\ **Post date:** [July 19, 2018, 4:06pm UTC](https://community.dremio.com/t/swagger-specification-for-dremio-rest-api/1490/6 "2018-07-19T16:06:16Z")
Internally our Rest API is based on the Jersey framework ([https://jersey.github.io/](https://jersey.github.io/)), and it is in theory possible to integrate Swagger to automatically generate the API schema. This would need to be added to our roadmap, so I cannot tell you when this will be delivered. At the same time, we try to make our public API stable over versions (only extending it), so you can assume that anything documented at [https://docs.dremio.com/rest-api/](https://docs.dremio.com/rest-api/) will remain (or you would be given advance notice in case we plan to deprecate/retire an API). ---
**Author:** ![datocrats-org](https://sea2.discourse-cdn.com/flex020/user_avatar/community.dremio.com/datocrats-org/32/2565_2.png) [@datocrats-org](https://community.dremio.com/u/datocrats-org)\ **Post date:** [September 1, 2020, 3:48pm UTC](https://community.dremio.com/t/swagger-specification-for-dremio-rest-api/1490/7 "2020-09-01T15:48:51Z")
Has anyone documented the Dremio REST API using Swagger or another Postman compatible format? ---
**Author:** ![ben](https://sea2.discourse-cdn.com/flex020/user_avatar/community.dremio.com/ben/32/1367_2.png) [@ben](https://community.dremio.com/u/ben)\ **Post date:** [September 1, 2020, 4:22pm UTC](https://community.dremio.com/t/swagger-specification-for-dremio-rest-api/1490/8 "2020-09-01T16:22:35Z")
Hi @datocrats-org, this remains and unfinished task at Dremio, but we would make Swagger documentation publicly available if it ever is completed. ---
**Author:** ![datocrats-org](https://sea2.discourse-cdn.com/flex020/user_avatar/community.dremio.com/datocrats-org/32/2565_2.png) [@datocrats-org](https://community.dremio.com/u/datocrats-org)\ **Post date:** [January 24, 2021, 11:47pm UTC](https://community.dremio.com/t/swagger-specification-for-dremio-rest-api/1490/9 "2021-01-24T23:47:16Z")
Here is my work on the Postman collection, I think it should be useful! I haven’t finished documenting examples for the enterprise edition. I also need to figure out exactly what the body must contain for the PUT endpoints. I linked all the official dremio documentation links into the description for each endpoint. I think if you run it and have Postman account, you should be able to provide a pull request. I’d be really happy if @ben can fold the format for Postman into the official documentation somehow. [![Run in Postman](https://run.pstmn.io/button.svg)](https://god.postman.co/run-collection/bf1c56b0496c59ea19a5)