Design and build APIsDesign APIs with specifications

Create a new API specification

View as Markdown

Create a specification in Spec Hub to design and test your API’s structure. You can create specifications in OpenAPI, AsyncAPI, protobuf, GraphQL, and Smithy format, then collaborate with others on your specification.

You can also import a specification into Spec Hub.

Create a new specification

You can create OpenAPI, AsyncAPI, protobuf, and GraphQL specifications in Spec Hub. You can also import an existing specification into Postman.

  1. In the sidebar, click Add icon and select Spec.
  2. Select the type of specification you want to create. Postman creates a new specification with boilerplate content.
  3. To rename your specification, click Options icon More actions next to the specification in the sidebar and select Rename. Type a new name and press Return or Enter. Or, select the filename in the workbench, enter a new name, and press Return or Enter.
  4. Edit or replace the content in the specification as needed for your API. Learn more about editing your specification.

Your Postman plan gives you a limited number of specifications in your team’s internal workspaces. Learn more about resource usage in Postman.

You can’t change the specification’s type after creating a specification. Create a new specification instead.

Rename a specification

  1. Expand Specs in the sidebar.
  2. Next to your specification, select Options icon More actions > Rename.
  3. Enter a new name for your specification.
  4. Press Return or Enter.

Delete a specification

  1. Expand Specs in the sidebar.
  2. Next to your specification, select Options icon More actions > Delete.
  3. Click Delete to confirm.