Beta feature

Collaborate in Postman using Live Sessions

Live Sessions is a beta feature available with Postman Free, Basic, and Professional plans.

With Live Sessions, you can collaborate with your teammates and external partners in an HTTP request in real time. Your team can collaborate throughout the API lifecycle during a live session, viewing each other's changes live from the same request. Your collaborators can interactively write API tests, debug a failed request, test and debug APIs running on a collaborator's local machine, and much more.

You can start a live session from an internal workspace. If you're on a Postman Professional plan, you can also start a live session from a Partner Workspace, enabling you to onboard external partners to your private APIs. Live Sessions doesn't support Partner Workspaces with multi-partner mode enabled.

To get started, each user who wants to collaborate in a live session must turn on Live Sessions. Then you can start a live session and collaborate from the same HTTP request.

Turn on Live Sessions

Turn on Live Sessions if you'd like to collaborate with your teammates and external partners from the same HTTP request.

To turn on Live Sessions at the user level, do the following:

Click Settings in the header and then select Settings.
Click Feature previews.
Turn on the toggle next to Live Sessions.

Start a live session

After you've turned on Live Sessions, start a live session from an internal workspace or Partner Workspace. You need at least Viewer permissions on the request to start a live session. Collaborators must have at least Viewer permissions on a request to participate in a live session. The user who starts the live session is the host for the duration of the session. Requests are sent from the host's local machine, regardless of which user sends the request.

Everyone who participates in a live session can view the API response on the host's local machine. Make sure to consider the sensitivity of data shown in a response when deciding who to include in a live session. Learn more about collaborating in a live session.

To start a live session, do the following:

Open an HTTP request and click Share in the upper right of the workbench. You can also click View more actions next to an HTTP request, then click Share.
Click Start next to Live Session. The link to the live session is automatically copied to your clipboard.
Share the link with teammates and partners who have at least Viewer permissions on the request.

When a teammate or partner opens the link, Live Sessions is automatically turned on for that user.
Collaborate with your teammates and partners. When you're finished, you can end the live session.

If you need the link to the live session again, copy the live session link then share it with your collaborators.

Collaborate during a live session

After the host starts the live session, your team can collaborate from the same HTTP request. You can view your collaborators' changes during a live session, enabling everyone to collaborate in real time. Collaborate on tasks you'd typically complete in a request, like changing the request method, adding request parameters, viewing the response, and more. The live session ends for all participants when the host closes the request or ends the live session.

Edits made to types in collections features aren't shared during a live session.

Requests send from the host's local machine, regardless of which user sends the request. This is helpful for distributed collaborators who want to test and debug APIs running locally on a collaborator's machine. Environment variables, global variables, and vault secrets resolve from the host's local machine when the request is sent. Collaborators can't view the values associated with the host's environment variables, global variables, and vault secrets.

During a live session, Postman displays a pulsing blue dot in the request's workbench. Click Live Session to view which collaborators are in the live session and take more actions, like share a link to the live session or leave the live session.

If you navigate elsewhere in the workspace during a live session, Postman displays a pulsing blue dot in the request's tab.

Each user's presence is represented by a color and their initials that display when they're actively making edits. A user's color outlines the area they're editing or their cursor in an editor. Their initials display next to the area they're editing. To view which color a user is associated with during the live session, click Live Session and view the color that outlines their avatar.

Collaborate during live session

During a live session, you can share a link to a live session with your collaborators who have at least Viewer permissions on the request. If your collaborators didn't turn on Live Sessions, it'll be automatically turned on when they open the link.

To share a link to a live session, do the following:

Click Live Session in an HTTP request with a live session.
Click Copy Live Link.

To share a link to a live session, you can also click Share in the upper right of the workbench, then click Copy Link next to Live Session.

Leave a live session

To leave a live session, do the following:

Click Live Session in an HTTP request with a live session.
Click Leave Session.

To leave a live session, you can also click Share in the upper right of the workbench, then click Leave.

Hosts can't leave a live session. They can only end a live session for all participants.

End a live session

If you're the host, you can end a live session for all participants. A live session automatically ends when the host closes the request or the Postman app. A live session also ends if all teammates and partners in the live session are inactive for a period of time.

To end a live session, do the following: