Use this API to upload OpenAPI specifications ("Swaggers"):

1. Create your API specification. You can use a swagger editor (e.g. Swagger Editor).
2. Validate the specification, make sure it is well formatted and there are no errors.
3. Check the schema specification below. Make sure all the mandatory fields are present. Note: the mandatory parameter x-project-id should uniquely identify your API, so it is common to use your Apigarden API name as the ID.
4. Also, make sure the new version of the specification is different from the current (if present).
5. Put your contact information.
6. Use the POST request below to submit your specification. Note, make sure you select proper content type (application/json or application/yaml).
7. Upload your draft specifications to stage first. Upload to production when the API version is production ready.
8. Make sure a proper server is selected. For example, you should select https://developer.teliacompany.io when using the production portal, but https://stage.developer.teliacompany.io when in stage environment of the portal.
9. Also note, tokens are different for different environments, so your production token will not work in stage and vice verse.