# Where to get AWX openapi spec file

**URL:** <https://forum.ansible.com/t/where-to-get-awx-openapi-spec-file/1200>\
**Category:** Get Help\
**Tags:** documentation, awx\
**Created:** [September 29, 2023, 4:23pm UTC](https://forum.ansible.com/t/where-to-get-awx-openapi-spec-file/1200 "2023-09-29T16:23:57Z")\
**Posts on this page:** 6\
**Page:** 1

<div class="post-metadata">

**Author:** ![ivansla](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/ivansla/32/889_2.png) [@ivansla](https://forum.ansible.com/u/ivansla)\
**Post date:** [September 29, 2023, 4:23pm UTC](https://forum.ansible.com/t/where-to-get-awx-openapi-spec-file/1200/1 "2023-09-29T16:23:57Z")

</div>

Hi community,

on my current project we want to call AWX REST Api, however the requirement is to use Azure API Management as proxy. Is there somewhere AWX openapi yaml file that I can download and import into Azure APIM?

Currently, AWX REST Api has over 100 resources, I don’t want to write yaml if I don’t have to.  
Why is it so difficult to find AWX openapi spec to download?

Thanks

---

<div class="post-metadata">

**Author:** ![fosterseth](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/fosterseth/32/101_2.png) [@fosterseth](https://forum.ansible.com/u/fosterseth)\
**Post date:** [September 29, 2023, 5:18pm UTC](https://forum.ansible.com/t/where-to-get-awx-openapi-spec-file/1200/2 "2023-09-29T17:18:05Z")

</div>

You can grab a copy of our API in json format from

`curl https://s3.amazonaws.com/awx-public-ci-files/devel/schema.json -o reference-schema.json`

this was generated via `make swagger`

It _should_ be compatible with openapi spec, let us know if you run into issues

We are going to update [https://ansible.readthedocs.io/projects/awx/en/latest/](https://ansible.readthedocs.io/projects/awx/en/latest/) with a browsable version of our API

AWX Team

---

<div class="post-metadata">

**Author:** ![sean\_sullivan](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/sean_sullivan/32/274_2.png) [@sean\_sullivan](https://forum.ansible.com/u/sean_sullivan)\
**Post date:** [September 30, 2023, 5:57pm UTC](https://forum.ansible.com/t/where-to-get-awx-openapi-spec-file/1200/3 "2023-09-30T17:57:53Z")

</div>

Fosterseth has pointed at the api in json format, But wanted to point to a few resources depending on what you are doing

If using in a playbook, use awx.awx/ansible.controller modules, as they interact with the API and you don’t have to write for it. If you are doing python or other coding to interact with the API, I’d check out the code as it is a good resource for how to interact efficiently.

If you are configuring many things in a playbook, I’d look at the infra.controller\_configuration collection as well, as it wraps around the above modules.

---

<div class="post-metadata">

**Author:** ![ivansla](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/ivansla/32/889_2.png) [@ivansla](https://forum.ansible.com/u/ivansla)\
**Post date:** [September 30, 2023, 9:11pm UTC](https://forum.ansible.com/t/where-to-get-awx-openapi-spec-file/1200/4 "2023-09-30T21:11:16Z")

</div>

Marvelous Seth,

thank you so much for this. I needed to do some cleanup, but I managed to import into Azure API Management.

---

<div class="post-metadata">

**Author:** ![jmack](https://avatars.discourse-cdn.com/v4/letter/j/57b2e6/32.png) [@jmack](https://forum.ansible.com/u/jmack)\
**Post date:** [October 11, 2023, 7:13pm UTC](https://forum.ansible.com/t/where-to-get-awx-openapi-spec-file/1200/5 "2023-10-11T19:13:18Z")

</div>

Hi @ivansla ! It looks like the post @fosterseth submitted might have solved your issue.

If so, it would be _super_ helpful if you could click the ✔ on their post to accept the solution - it recognises the input of others, helps our volunteers find new issues to answer, and keeps the forum nice and tidy.

Thanks!

---

<div class="post-metadata">

**Author:** ![system](https://us1.discourse-cdn.com/ansible/original/1X/1882d9a01da5d8996a862359b0913cc568a39b84.svg) [@system](https://forum.ansible.com/u/system)\
**Post date:** [March 27, 2024, 3:52pm UTC](https://forum.ansible.com/t/where-to-get-awx-openapi-spec-file/1200/6 "2024-03-27T15:52:05Z")

</div>

This topic was automatically closed 30 days after the last reply. New replies are no longer allowed.
