Collaborate in Postman using Live Sessions

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

With Live Sessions, you can collaborate with your teammates 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 team can interactively write API tests, debug a failed request, test and debug APIs running on your teammate's local machine, and much more.

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 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, you can start a live session from an internal workspace everyone in your team can access. You need at least Viewer permissions on the request to start a live session. Share a link to the HTTP request with teammates you want to include in the 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 team members who have at least Viewer permissions on the request.

When a team member opens the link, Live Sessions will be automatically turned on for that user.
Collaborate with your teammates. 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 teammates.

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 teammates' 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 will end 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 team members who want to test and debug APIs running locally on a teammate's machine. Environment variables, global variables, and vault secrets resolve from the host's local machine when the request is sent. Note that teammates 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 teammates are in the live session and take additional actions, like share a link to the live session or leave the live session.

Each user who's included in a live session is associated with a specific color that displays where they're actively making edits. A user's color may outline the area they're editing or show a cursor in their color. To view which color a user is associated with during the live session, click Live Session and view the color that outlines the user's avatar.

During a live session, you can share a link to a live session with your teammates who have at least Viewer permissions on the request. If your teammates 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 will automatically end when the host closes the request or the Postman app. A live session will also end if all team members in the live session are inactive for a period of time.

To end a live session, do the following: