Skip to Content
API DesignManage API Spec Files

Manage API Spec Files Under “API Document” Tab

Whether you are in edit mode or not, there is a file navigation sidebar on the left side. To manage API spec files:

  • Click the “Add” icon at the top of the navigation tree to create a new API spec file
  • Hover your mouse over any spec file in the tree and click the 3-dots icon to access a dropdown menu that lets you delete, rename, or duplicate the spec file

Manage API spec files

Specify File Path When Adding New Specs

Since our API repository is a native Git repository, it doesn’t allow creating empty folders. When adding a new spec whose parent folders don’t exist, you should specify the complete path name instead of just the file name.

We will automatically create all necessary parent folders if they don’t exist.

Specify file path name

Manage API Spec Files Under “All Files” Tab

Besides managing API specs from the “API Document” tab, you can also manage them in the “All Files” tab, where all files are treated as regular files. Here, you can add, delete, or rename any file.

Manage API spec files from All Files tab

Manage API Spec Files by Local Git Push

In some cases, you may already have multiple API Spec files locally and don’t want to add them one by one. You can git clone the repository to your local PC, add these API spec files to the git repository, and push back to the API Repository.

This approach is particularly useful when you have split API spec files already, as you can easily add all the split API files in this way.

Last updated on