Collaborate in Postman with Live Sessions

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

With Live Sessions, you can collaborate with your teammates and external partners in all HTTP collections in your workspace in real time. Your team can collaborate throughout the API lifecycle during a live session, viewing each other’s changes live from the same collection, folder, and 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 or Enterprise 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.

Start a live session

You can start a live session from an internal workspace or Partner Workspace. You need at least Viewer permissions on the collection to start a live session. Collaborators must have at least Viewer permissions on a collection 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 it.

Important: 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:

1. Open your workspace.

2. From the Postman header, next to Invite, click the workspace members.

3. Click Start Live Session. Postman copies a link to your live session to your clipboard.

4. Share the link with your teammates or partners. To collaborate, the person you share the link with must have at least Viewer permissions.

Tip: You can also start a live session from a collection, folder, or request. To start a live session, open an HTTP collection, folder, or request and, in the upper right, click Share. Then, next to Live Session, click Start.

Postman adds a Live indicator to the Postman header. You’re ready to collaborate in real time. When you’re done, end the session.

If you need the live session link again, copy the live session link and share it with your team and partners.

Collaborate during a live session

After the host starts the live session, your team can collaborate from the same HTTP collections, folders, and requests in your workspace. 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 collection, 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 workspace or ends the live session.

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

Postman sends requests from the host’s local machine. If you’re the host and a participant wants to send a request, keep that request open on your local machine. This is helpful for distributed collaborators who want to test and debug APIs running locally on a collaborator’s machine. 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 variables and vault secrets.

During a live session, Postman displays a pulsing blue dot in the Postman header. Click Live 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. Postman displays a blue underline at the bottom of open tabs that are shared during a live session, such as a folder in an HTTP collection.

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 and view the color that outlines their avatar.

Share a link to a live session

During a live session, you can share a link to the session with your collaborators who have at least Viewer permissions.

To share a link to a live session, from the Postman header, click Live. Then, click Copy Live Link.

End or leave a session

A live session host can end a session. A participant can leave.

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 workspace or the Postman app.

To end a live session, from the Postman header, click Live. Then, click End Session.

Leave a live session

If you’re a participant, you can leave the session.

To leave a live session, from the Postman header, click Live. Then, click Leave Session.