Manage your specifications

Apigee Edge provides you with a place to store your OpenAPI Specifications. Manage your OpenAPI Specifications, as described in the following sections.

Explore the specs list

To access the specs list:

  1. Sign in to apigee.com/edge.
  2. Select an organization or your personal space.
    Specifications stored in your personal space, are available only to you. Specifications stored at the organization level are available to other members of your organization.
  3. Select Develop > Specs in the side navigation menu.

The current list of specifications and folders is displayed.

Spec list

As highlighted in the previous figure, from the specifications list you can:

Create a new OpenAPI Specification

To create a new OpenAPI Specification:

  1. Click Develop > Specs in the side navigation bar.
  2. Click + Spec.
  3. Click New in the drop-down menu.
    The spec editor opens.
  4. Replace the sample specification with your own OpenAPI Specification details.
    See Create specifications using the spec editor.

Import an OpenAPI Specification

To import an OpenAPI Specification:

  1. Click Develop > Specs in the side navigation bar.
  2. Click + Spec.
  3. Click one of the following options from the drop-down menu:
    • Import URL to import the specification from a URL. Specify the name and URL when prompted.
    • Import file to browse your local directory for the specification.
      The specification is added to the list.
  4. Click the name of the specification to view and edit it in the spec editor.
    See Create specifications using the spec editor.

Edit an existing OpenAPI Specification

To open an existing OpenAPI Specification:

  1. Click Develop > Specs in the side navigation bar.
  2. Click the name in the spec list.
  3. Edit the specification in the spec editor.
    See Create specifications using the spec editor.

Create an API proxy from a specification in the spec list

With Apigee Edge, you can create your API proxies from the OpenAPI Specifications that you design and save in the spec editor. In just a few clicks, you'll have an API proxy in Apigee Edge with the paths, parameters, conditional flows, and target endpoints generated automatically. Then, you can add features such as OAuth security, rate limiting, and caching.

After you create an API proxy from an OpenAPI Specification, if the specification is modified, you will need to manually modify the API proxy to reflect the changes implemented. See What happens if I modify a specification?.

To create an API proxy from an OpenAPI Specification in the spec list:

  1. Select Develop > Specs in the side navigation menu.
  2. Navigate to the folder that contains the OpenAPI Specification, if required.
  3. Position your cursor on the OpenAPI Specification for which you want to create an API proxy.
  4. Click Expand icon to expand the actions menu.
  5. Click Generate API proxy.
    The Build a Proxy wizard is opened and the Details page is pre-populated using values from the OpenAPI Specification, as shown in the following figure.
    build a proxy wizard
  6. Click Next.
  7. Step through the remaining pages in the Build a Proxy wizard, as described in Creating an API proxy from an OpenAPI Specification. (Start from step 8.)

Rename a specification

To rename a specification:

  1. Select Develop > Specs in the side navigation menu.
  2. Navigate to the folder that contains the specification, if required.
  3. Position the cursor over the specification that you want to rename to display the actions menu.
  4. Click Expand icon to expand the actions menu.
  5. Click Rename.
  6. Edit the specification name.
  7. Click Rename to save the edits or Cancel to cancel.

Move a specification to a folder

You can organize your specifications into folders to facilitate management and security. To move a specification into a folder, see Organizing specifications using folders.

Delete a specification

You can delete a specification from the file store when it is no longer needed or becomes invalid.

To delete a specification:

  1. Select Develop > Specs in the side navigation menu.
  2. Position the cursor over the specification that you want to delete to display the actions menu.
  3. Click Delete icon.
  4. Click Delete to confirm the delete operation at the prompt.
  5. Delete related artifacts that are no longer needed.