Connectors

/

Postman

/

Tidy Postman workspace names and descriptions
Write

Tidy Postman workspace names and descriptions

For API team leads who want unclear, duplicate or undescribed Postman workspaces fixed, approving each change.

Try PopdockAI free
Get a live demo
Tidy Postman workspace names and descriptions
Tidy up the names and descriptions of our Postman workspaces.
14 workspaces reviewed; 9 changes proposed. - 1. Add a description to Payments, from its collections - 2. Rename test ws 2 to Checkout Testing, owner input needed - Public: 2 workspaces to confirm Which numbers should I apply?
Postman
Sample figures. Your results come from your own account.
postman-get-workspaces
postman-get-users
postman-update-workspace

On this page

The problem

The problem

The prompt

Who it's for

How it works

Tools used

Connector

Postman

Postman
Run it on your own Postman data.

Connect Postman, pick your AI tool and paste the prompt.

Try PopdockAI free

The problem

Workspaces nobody can recognise

Postman workspaces multiply into Test, New Workspace and near-identical names, many with no description, so nobody can tell what a workspace is for. Public workspaces hide among them, sometimes by accident.

Without PopdockAI

  • Scroll a long list of vague workspace names
  • Open each one to guess its purpose
  • Rename and describe them one by one
  • Miss a public workspace hiding in the list

With PopdockAI

  • Workspaces are read with who created each one
  • Missing descriptions, duplicates and unclear names are found
  • Public workspaces are listed for you to confirm
  • Only the changes you pick are applied

The prompt

Use this prompt

Copy it into any AI tool connected to PopdockAI. Swap the values in braces for your own.

Prompt
**Objective:** Review workspaces whose name contains `{workspace-name}` (default: all) for naming and description problems, propose fixes, and apply only the ones the user approves.

**Step 1: Load workspaces**

Call `postman-get-workspaces`, with `name.contains` = `{workspace-name}` when given. Keep workspace-id, name, type, visibility, about and created-by. Call `postman-get-users` to turn created-by into a name.

**Step 2: Find problems**

* No description: about is empty, especially on team and public workspaces where others need to know what it is for.
* Duplicate or near-duplicate names: the same name ignoring case, spacing and punctuation.
* Unclear names: names like Test, New Workspace, My Workspace, Untitled, or a single person's name on a team workspace.
* Public workspaces: list them so the user can confirm they are meant to be public. There is no tool here that changes visibility.

**Step 3: Propose**

A numbered table: workspace, problem, proposed new name and/or description. Base descriptions only on what is evident (the workspace name and its creator); do not invent the workspace's purpose, mark such suggestions as needing the owner's input.

**Step 4: Apply what is approved**

Ask which numbered items to apply. For each approved item only, call `postman-update-workspace` once with `workspace-id` and the approved `name` and/or `description`. Report each result.

**Rules & Guidelines:**

* Never apply anything without the user picking it by number. "Apply all" must be stated explicitly.
* `postman-update-workspace` is the only write. Do NOT call `postman-add-workspace` or any other write tool.
* Do not rename a personal workspace that belongs to someone other than the user without flagging it.

**Validation:**

* If no workspaces match, say so and stop.
* If nothing needs fixing, say so and make no calls to the write tool.

Who it's for

One answer, three teams that use it

Workspace admins

Clean up the workspace list

Get a numbered list of clearer names and descriptions, applied only where you agree.

Propose clearer names and descriptions for our Postman workspaces.

Security engineers

Check public workspaces

Public workspaces are listed for you to confirm, so nothing is exposed by accident.

Which of our Postman workspaces are public, and do any look like they should not be?

API developers

Find the right workspace faster

Duplicate and unclear names are fixed, so people pick the right workspace first time.

Find Postman workspaces with duplicate names or no description and suggest fixes.

How it works

What PopdockAI does when you ask

You can name the workspaces to review, and your AI assistant proposes clearer names and descriptions. Anything that needs the owner's input is marked, and only the numbers you pick change.

01

Ask

You optionally name the workspaces to review.

Your AI tool

02

Find

It reads them and finds missing descriptions, duplicates and unclear names.

postman-get-workspaces
postman-get-users

03

Propose

You get a numbered list, with owner input marked where needed.

No items found.

04

Apply

Only the numbers you pick are applied.

Your AI tool

What PopdockAI provides

The tools behind the answer

Ready made tools for Postman and one secure connection to your AI tool. No code, no exports.

get-data

postman-get-workspaces

Returns Postman workspaces with their name, type, visibility, description and creator. Filter by name or by the user who created them.
get-data

postman-get-users

Returns the members of a Postman team with their name, username, email and join date. Filter by name, username or email.
run-action

postman-update-workspace

Renames a Postman workspace or changes its description.
Read only.Nothing in Postman Changes

This report is built from Get data tools only. PopdockAI applies the row, field and parameter rules your admin sets, and every query is written to the audit trail.

How Popdock AI secures your data

The outcome

Workspaces people can recognise and trust

Try PopdockAI free
Get a live demo

Related use cases

More ways to put this data to work

All Ramp use cases

One prompt template with infinite possibilities.

‍

Your AI assistant adapts its approach, tone, and capabilities to match each unique context while you maintain a single, manageable workflow.

Join forward-thinking companies that are transforming their operations with intelligent, secure AI automation.

Try PopdockAI Free
See Documentation