> For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://learning.postman.com/llms.txt.

# Create a new API specification

[Create a specification](#create-a-new-specification) in Spec Hub to design and test your API's structure. You can create specifications in OpenAPI, AsyncAPI, protobuf, GraphQL, and Smithy [format](/docs/design-apis/specifications/overview#supported-specification-formats), then [collaborate with others on your specification](/docs/design-apis/specifications/collaborate-with-specifications/).

You can also [import a specification](/docs/design-apis/specifications/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](/docs/design-apis/specifications/import-a-specification/) into Postman.

1. In the sidebar, click ![Add icon](https://assets.postman.com/postman-docs/aether-icons/v12/action-add-stroke.svg#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](https://assets.postman.com/postman-docs/aether-icons/v12/action-options-stroke.svg#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](/docs/design-apis/specifications/edit-a-specification/).

Your [Postman plan](https://www.postman.com/pricing/) gives you a limited number of specifications in your team's internal workspaces. Learn more about [resource usage in Postman](/docs/billing/resource-usage/#specifications).

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](https://assets.postman.com/postman-docs/aether-icons/v12/action-options-stroke.svg#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](https://assets.postman.com/postman-docs/aether-icons/v12/action-options-stroke.svg#icon) **More actions > Delete**.
3. Click **Delete** to confirm.