This repository contains:
- The OpenAPI specification that we use to build our Management SDKs
- Directory dist/current/ has the current version of our OpenAPI v3 specs for the Okta Managment API
- Each historical Okta release in format
YYYY.MM.POINTis retained in the dist/ directory
Note: this is a snapshot of the OpenAPI spec generated directly from the Okta Management API. This repository is not intended to take pull requests from the community. Do report issues here in Github so others in the community may benefit from the feedback. However, we encourage opening a support ticket with Okta Support to get help directly.
The original Swagger specs developed by the Okta Developer Experience team live on the tree/legacy-v1-swagger branch. The last artifacts from that branch are persisted in the dist/legacy-v1-swagger directory for the sake of convenience.
A published NPM artifact would be available to the public as @okta/openapi.
All of our management SDKs must be built from this spec.
If you notice any issues with the spec files while working with any of our management SDKs, please open a Github issue in the corresponding management SDK repo, it would be triaged from there.