> For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://learning.postman.com/llms.txt. For full content including API reference and SDK examples, see https://learning.postman.com/llms-full.txt.

# Collaborate with specifications in Postman

When you design an API in Postman, you can work on the specification with your team. Share your specifications and leave comments to discuss your design in context. Use the changelog to track edits, see who made changes, and tag specific revisions. You can also fork a specification to create a copy and work on it in your own workspace without impacting the original.

## Share a specification

You can share a specification with collaborators. Expand **Specs** in the sidebar and select a specification. Then click <img alt="Link icon" src="https://assets.postman.com/postman-docs/aether-icons/v12/action-link-stroke.svg#icon" width="20px" /> **Copy link** in the workbench.

![Copy a link to a specification](https://assets.postman.com/postman-docs/v12/specs-copy-link-v12-03.png)

For more details about sharing elements, see [Share your work in Postman](/docs/collaborating-in-postman/sharing/).

## Version control for specifications

[Version control](/docs/collaborating-in-postman/using-version-control/version-control-overview/) for specifications enables you to fork a specification and make changes to the forked specification. This lets you collaborate with your team on specifications without affecting the original. Changes made in a fork can then be reviewed and merged back into the parent specification.

For information about forking elements, see [Fork elements in Postman](/docs/collaborating-in-postman/using-version-control/forking-elements/).

Pull requests aren't currently available for specifications.

## View specification changes with the changelog

The changelog provides a complete list of changes and revisions to a specification in chronological order. You can use it to view the time and date at which changes occurred, the users who made changes, and where the edits were made in the specification. To view the changelog, click <img alt="History icon" src="https://assets.postman.com/postman-docs/aether-icons/v12/icon-descriptive-history-stroke.svg#icon" width="20px" /> **Changelog** in the right sidebar.

Postman groups changes made within several minutes of each other into sessions for readability. You can click a session in the changelog to review its changes. If a diff is too large to view in the changelog, you can hover over the diff and click it to open the complete diff in a new window.

You can also [add a version tag](#add-a-version-tag-to-the-changelog) to the latest changes and revisions in the changelog.

To refresh the changelog, click <img alt="Refresh icon" src="https://assets.postman.com/postman-docs/aether-icons/v12/icon-action-refresh-stroke.svg#icon" width="20px" /> **Refresh changelog**.

### Add a version tag to the changelog

You can add a version tag to the latest changes and revisions in the changelog to identify a specific version of your API specification.

To add a version tag, do the following:

1. Click <img alt="History icon" src="https://assets.postman.com/postman-docs/aether-icons/v12/icon-descriptive-history-stroke.svg#icon" width="20px" /> **Changelog** in the right sidebar.
2. In the changelog, click **Add Version Tag**. You can't add a version tag if the latest changes already have a version tag, or if there are no changes to tag.
3. Enter your version tag.
4. Click **Add Version Tag**.

A version tag displays in the changelog next to the changes it applies to. Click a version tag to view the changes included in that version in read-only mode. You can also click <img alt="Link icon" src="https://assets.postman.com/postman-docs/aether-icons/v12/icon-action-link-stroke.svg#icon" width="20px" /> **Copy version link** to copy a link to the version that you can share with your teammates.

## Comment on a specification

You can add one or more [comments](/docs/collaborating-in-postman/comments/) to a specification in Spec Hub. Use comments to discuss your specifications with collaborators in Postman, keeping the conversation in context and available to other stakeholders.

To add a comment to a specification, do the following:

1. Click **Specs** in the sidebar, then select the specification that you want to comment on.
2. Click <img alt="Comments icon" src="https://assets.postman.com/postman-docs/aether-icons/v12/action-comments-stroke.svg#icon" width="20px" /> **Comments** in the right sidebar.
3. Enter your comment and click **Comment**.

You can also add comments to collections you've added to your API and to requests and folders in that collection. Learn more about [commenting on a collection](/docs/collaborating-in-postman/comments/#global-comments).