---
title: Importing OpenAPI / Swagger
slug: archbee-docs/importing-openapi-swagger
description: Learn how to leverage the power of OpenAPI import in Archbee for developer-centric product documentation. Discover the benefits, supported versions, authentication methods, pre-population of default parameters, and displaying example values. This comprehe
docTags: 
createdAt: 2021-10-29T07:42:12.000Z
---

## Why use OpenAPI import?

If your product is built for developers or your product has an API, you need great product documentation — otherwise, you can't cut through to developers.

Once you import your OpenAPI file, Archbee will read it and convert it to a beautiful UI and make it ready to be:

- **Shared publicly **(on a custom domain) 
- **Internally** with your colleagues and teams

Once imported, you can sync, update and test your OpenAPI. See more details in the sections below.

## Rules and default settings

:::hint{type="info"}
Imported OpenAPI files can not be manually modified in Archbee.

To update and maintain your OpenAPI, check our [sync options](docId\:mXxw7zmkEkQUkalmaG-aM)
:::

### Supported OpenAPI versions:

Archbee currently supports the following OpenAPI versions to be imported:

1. Version 2.0 and 2.0.XX
2. Version 3.0 and 3.0.XX
3. Version 3.1  and 3.1.XX

### Supported Auth methods

Archbee currently supports the following Auth methods:

1. [Basic Authentication](https://swagger.io/docs/specification/authentication/basic-authentication/)
2. [API Keys](https://swagger.io/docs/specification/authentication/api-keys/)
3. [Bearer Authentication](https://swagger.io/docs/specification/authentication/bearer-authentication/)

If you import OpenAPI files with other Auth methods, they will import correctly, and the Auth method will be ignored. 

This means that you will get the whole Archbee OpenAPI experience, **except **the Try It! feature, if your endpoint requires an Auth that is not in the list above.

### Others

1. If you define a "**default**" parameters in your OpenAPI and you give it a value, the code sample and the parameter box will be automatically pre-populated with that value.
   This makes it easy for your users or customers to test your API with [Try It!](docId\:tRLvi13QsaU4of_h-C_vy) without having to update all the required parameters.
2. If you define an "**example**" parameter in your OpenAPI, the example value will be displayed on the left side just below the API parameter.
   This makes it easy for your users to identify what type of input is needed for that specific parameter.

![](https://app.archbee.com/api/optimize/bNBm7nPJgXjbjLyfbHNh2/fCN8X5XLW-WFI9W1yvi3K_body-light.png)

## How does it work?

::::WorkflowBlock
:::WorkflowBlockItem
Import your OpenAPI file using the **Import Content**:

![](https://app.archbee.com/api/optimize/bNBm7nPJgXjbjLyfbHNh2/ZIM8Bq-VEqGvv_aHHjArO_import-content-light.png)

Or use **Import** option from each space:

![](https://app.archbee.com/api/optimize/bNBm7nPJgXjbjLyfbHNh2/0w0sHacVm8l8N_AFkF4yf_import-option-light.png)

Or sync your OpenAPI files directly from your [GitHub](././INTEGRATIONS/GitHub.md) repository.

With Archbee's [Github Integration](././INTEGRATIONS/GitHub.md) you can add\&sync your openAPI files directly from your repo.
:::

:::WorkflowBlockItem
Preview and [test](docId\:tRLvi13QsaU4of_h-C_vy) your imported OpenAPI

![](https://app.archbee.com/api/optimize/bNBm7nPJgXjbjLyfbHNh2/DsF_NDr8yoe62d13qJDP6_test-it-light.png)

Preview and test your newly imported OpenAPI with Archbee's [API TRY IT!](docId\:tRLvi13QsaU4of_h-C_vy) feature.
:::

:::WorkflowBlockItem
**Publish** or **share it** with your colleagues or customers!

Publish it to Preview or on a Custom Domain and make it available to your colleagues, teams, or users. 

If you would like to protect the content and only share it with a selected few, check out our [Public Access Controls](<././HOSTED SPACES/Public Access Controls.md>) options for published portals.
:::

:::WorkflowBlockItem
Maintain, sync and configure it:

1. [Sync it manually](docId\:mXxw7zmkEkQUkalmaG-aM)
2. [Sync automatically via API](docId\:mXxw7zmkEkQUkalmaG-aM)
3. [Change sample code language](docId\:mXxw7zmkEkQUkalmaG-aM)
:::
::::

## Here's a video of how it works

::embed[]{url="https://youtu.be/LQ3nEGCcdKg"}