Collection sharing in Postman - Test Execution Trace

Test Overview

This test verifies that a Postman collection can be shared successfully with a team member and that the shared collection is accessible to them.

Test Code - Postman

Postman

pm.test("Share collection with team member", async function () {
    // Step 1: Authenticate as collection owner
    const ownerToken = pm.environment.get("owner_token");

    // Step 2: Share collection via API
    const collectionId = pm.environment.get("collection_id");
    const shareWithUserId = pm.environment.get("team_member_id");

    const shareResponse = await pm.sendRequest({
        url: `https://api.getpostman.com/collections/${collectionId}/share`,
        method: 'POST',
        header: {
            'X-Api-Key': ownerToken,
            'Content-Type': 'application/json'
        },
        body: {
            mode: 'raw',
            raw: JSON.stringify({
                userId: shareWithUserId,
                permission: 'edit'
            })
        }
    });

    pm.expect(shareResponse.code).to.eql(200);

    // Step 3: Authenticate as team member and verify access
    const memberToken = pm.environment.get("team_member_token");

    const accessResponse = await pm.sendRequest({
        url: `https://api.getpostman.com/collections/${collectionId}`,
        method: 'GET',
        header: {
            'X-Api-Key': memberToken
        }
    });

    pm.expect(accessResponse.code).to.eql(200);
    pm.expect(accessResponse.json().collection.id).to.eql(collectionId);
});

Execution Trace - 4 Steps

Step	Action	System State	Assertion	Result
1	Authenticate as collection owner using API key from environment	Owner token is loaded from environment variables	—	PASS
2	Send POST request to share collection with team member using owner token	API receives share request with userId and permission	Response code is 200 indicating successful share	PASS
3	Authenticate as team member using their API key	Team member token is loaded from environment variables	—	PASS
4	Send GET request to retrieve shared collection using team member token	API returns collection details to team member	Response code is 200 and collection id matches shared collection	PASS

Failure Scenario

Failing Condition: Sharing fails due to invalid owner token or incorrect userId

Execution Trace Quiz - 3 Questions

What indicates that the collection was shared successfully?

A The share API response code is 200

B The team member token is loaded

C The collection id is retrieved

D The POST request is sent

Key Result

Always verify both the action (sharing) and the effect (access by shared user) to ensure sharing works end-to-end.

Practice

1.

What is the main purpose of Collection sharing in Postman?

easy

A. To allow team members to access and work on the same API requests easily

B. To create new APIs from scratch

C. To delete collections permanently

D. To run automated tests only on local machines

Solution

1. Step 1: Understand the concept of collection sharing

   Collection sharing is designed to help teams collaborate by giving access to the same set of API requests.

2. Step 2: Identify the main purpose

   The main goal is to let team members work together easily on the same collection.

3. Final Answer:

   To allow team members to access and work on the same API requests easily -> Option A

4. Quick Check:

   Collection sharing = team collaboration [OK]

Hint: Sharing means working together on the same collection [OK]

Common Mistakes:

• Thinking sharing creates new APIs
• Confusing sharing with deleting collections
• Believing sharing only runs tests locally

2.

Which of the following is a valid way to share a Postman collection?

easy

A. Only export and send the file

B. All of the above methods are valid

C. Only share using a public link

D. Only share via workspace

Solution

1. Step 1: Review sharing methods in Postman

   Postman allows sharing collections by exporting files, sharing in workspaces, or using public links.

2. Step 2: Confirm all methods are valid

   Each method suits different collaboration needs, so all are valid ways.

3. Final Answer:

   All of the above methods are valid -> Option B

4. Quick Check:

   Export + workspace + link = all valid [OK]

Hint: Remember: export, workspace, and link all share collections [OK]

Common Mistakes:

• Choosing only one sharing method
• Ignoring public link sharing
• Confusing export with import

3.

What will happen if you share a collection via a workspace in Postman?

medium

A. Team members in the workspace can access and edit the collection

B. Only you can access the collection

C. The collection is deleted from your account

D. The collection becomes read-only for everyone

Solution

1. Step 1: Understand workspace sharing in Postman

   Sharing a collection in a workspace allows all workspace members to access and collaborate on it.

2. Step 2: Identify access rights

   Members can view and edit the collection, enabling teamwork.

3. Final Answer:

   Team members in the workspace can access and edit the collection -> Option A

4. Quick Check:

   Workspace sharing = team access and edit [OK]

Hint: Workspace sharing means team can edit collection [OK]

Common Mistakes:

• Thinking only owner can access
• Believing collection is deleted after sharing
• Assuming collection is read-only

4.

You tried to share a collection via a public link, but your teammates cannot access it. What is the most likely reason?

medium

A. Public link sharing is not supported in Postman

B. The collection was shared in a workspace instead

C. The link was not generated or copied correctly

D. The collection was deleted before sharing

Solution

1. Step 1: Check the sharing method used

   If teammates cannot access via public link, the link might be wrong or missing.

2. Step 2: Rule out other causes

   Public link sharing is supported, and workspace sharing is different. Deletion would prevent all access.

3. Final Answer:

   The link was not generated or copied correctly -> Option C

4. Quick Check:

   Wrong or missing link = access denied [OK]

Hint: Verify link correctness if access fails [OK]

Common Mistakes:

• Assuming public link sharing is unsupported
• Confusing workspace sharing with link sharing
• Ignoring link copy errors

5.

You want to share a collection with a team that has mixed access needs: some should edit, others only view. Which sharing method best fits this requirement?

hard

A. Share via a public link with edit permissions

B. Share the collection by copying requests manually

C. Export the collection and email it to everyone

D. Share the collection in a workspace with role-based access

Solution

1. Step 1: Analyze sharing needs

   Mixed access means some users can edit, others only view.

2. Step 2: Identify sharing method supporting roles

   Workspaces in Postman support role-based access control, allowing this setup.

3. Step 3: Rule out other methods

   Public links usually have uniform access; exporting or manual copying lacks access control.

4. Final Answer:

   Share the collection in a workspace with role-based access -> Option D

5. Quick Check:

   Workspace + roles = mixed access control [OK]

Hint: Use workspace roles for mixed edit/view access [OK]

Common Mistakes:

• Using public links without access control
• Emailing exports causes version mismatch
• Copying requests manually is inefficient