Skip to main content Skip to complementary content

Organizing repositories

By default, your existing APIs and folders are stored in the Default repository. You can reorganize them into any repository you create.

Creating a new repository

Create new repositories to better organize your APIs and folders.

Procedure

  1. In the left panel, click the Menu button next to the Default repository.
  2. Click Create repository.
  3. Enter a repository name and a description.
    Create New Repository window.
  4. Click Create.
    Your new repository appears in the selector at the top of the main area.
  5. Create a new folder or API by clicking New folder or New API.
    For more information, see Working with a new API and Organizing API folders.
    New folder and New API buttons.

Moving and copying an API or a folder to another repository

Quickly move or copy APIs, folders, or versions between repositories to keep your work organized.

Before you begin

  • You have at least two different repositories.
  • The content you want to move or copy does not exist in the target repository.

Procedure

  1. In the left panel, click the Menu button next to the folder or API you want to move.
  2. Click Move / Copy to repository.
  3. Choose between MOVE and COPY.
    Move a folder to another repository window.
  4. Select a target repository.
  5. Click MOVE or COPY.

Results

The selected content now appears in the target repository.

Moving and copying multiple APIs and folders to another repository

Copy or move multiple root-level APIs and folders to another repository in a single operation.

Before you begin

You have at least one repository in addition to the Default Repository.

Procedure

  1. In the left panel, click the Menu button next to the source repository and click Move / Copy to repository.
    Repository context menu with the Move / Copy to repository option.

    The Move or copy Folders/APIs to a repository dialog opens.

  2. Select MOVE or COPY.
    Information noteNote: The MOVE and COPY options are unavailable once items are staged. To switch, click Remove to clear staged items first.
  3. In the Target dropdown, select the target repository.
    Information noteRestriction: The Default Repository cannot be selected as the target.
  4. In the Source panel, select the check boxes next to the root-level APIs and folders you want to copy or move, or click Select all.
    Information noteNote: Only root-level folders and APIs can be selected. Selecting a folder includes all its contents, preserving the existing folder structure.
    Move or copy Folders/APIs to a repository dialog, showing Source and Target panels with Add and Remove buttons.
  5. Click Add.
  6. Click MOVE or COPY.

Results

The selected items appear in the target repository.

Information noteNote: If any item being copied or moved has the same name as an existing item in the target repository, it is renamed by appending _1, _2, and so on.
Information noteNote: If you move a shared item, it is automatically unshared in the target repository. Copied items are not shared, regardless of the sharing status of the original.

Hiding the Default repository

Hide the Default repository once your APIs and folders are organized elsewhere. The Default repository cannot be deleted.

Procedure

  1. Click API settings next to repository field.
    API settings button.
  2. Toggle on the option Hide Default Repository.
    • If the Default repository was selected in the left panel, it will be hidden and the next repository in the list is automatically selected.
    • If the Default repository is the only repository, an empty state page appears with a message prompting you to create a new repository.
    Hide Default Repository option.

Deleting a repository

Delete repositories you no longer need. This action permanently removes all APIs and data from the repository. Before deleting, make sure to move any content you want to keep.

Procedure

  1. In the left panel, select the repository you want to delete.
  2. Click the Menu button next to the repository and click Delete repository.
  3. Confirm by clicking Delete Repository.
    Delete Repository window.

Results

The repository and all its content have been permanently deleted and removed from the left panel.

Did this page help you?

If you find any issues with this page or its content – a typo, a missing step, or a technical error – please let us know!