Postman

Learn how to use Postman with Composio

Overview

SLUG: POSTMAN

Description

Postman is an API platform for building, testing, and managing APIs with powerful collaboration features.

Authentication Details

generic_api_key
stringRequired

Connecting to Postman

Create an auth config

Use the dashboard to create an auth config for the Postman toolkit. This allows you to connect multiple Postman accounts to Composio for agents to use.

1

Select App

Navigate to Postman.

2

Configure Auth Config Settings

Select among the supported auth schemes of and configure them here.

3

Create and Get auth config ID

Click “Create Postman Auth Config”. After creation, copy the displayed ID starting with ac_. This is your auth config ID. This is not a sensitive ID — you can save it in environment variables or a database. This ID will be used to create connections to the toolkit for a given user.

Connect Your Account

Using API Key

1from composio import Composio
2
3# Replace these with your actual values
4postman_auth_config_id = "ac_YOUR_POSTMAN_CONFIG_ID" # Auth config ID created above
5user_id = "0000-0000-0000" # UUID from database/app
6
7composio = Composio()
8
9def authenticate_toolkit(user_id: str, auth_config_id: str):
10 # Replace this with a method to retrieve an API key from the user.
11 # Or supply your own.
12 user_api_key = input("[!] Enter API key")
13
14 connection_request = composio.connected_accounts.initiate(
15 user_id=user_id,
16 auth_config_id=auth_config_id,
17 config={"auth_scheme": "API_KEY", "val": {"generic_api_key": user_api_key}}
18 )
19
20 # API Key authentication is immediate - no redirect needed
21 print(f"Successfully connected Postman for user {user_id}")
22 print(f"Connection status: {connection_request.status}")
23
24 return connection_request.id
25
26
27connection_id = authenticate_toolkit(user_id, postman_auth_config_id)
28
29# You can verify the connection using:
30connected_account = composio.connected_accounts.get(connection_id)
31print(f"Connected account: {connected_account}")

Tools

Executing tools

To prototype you can execute some tools to see the responses and working on the Postman toolkit’s playground

For code examples, see the Tool calling guide and Provider examples.

Tool List

Tool Name: Create a Collection

Description

Tool to create a new Postman collection in a specific workspace or the default workspace. Use when you need to create a collection with workspace specification. For complete collection format details, refer to the Postman Collection Format documentation.

Action Parameters

collection
objectRequired
workspace

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Create a Collection Comment

Description

Tool to create a comment on an API's collection. Use when you need to add a comment to a specific collection within an API. To create a reply on an existing comment, include the thread_id in the request.

Action Parameters

api_id
stringRequired
body
stringRequired
collection_id
stringRequired
thread_id

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Create Collection from Schema

Description

Tool to create a collection from a schema and link it to an API with specified relations. Note: This endpoint is deprecated in Postman v10 and higher. Use when you need to generate a collection from an API schema and establish relations like contract tests or documentation.

Action Parameters

api_id
stringRequired
api_version_id
stringRequired
name
stringRequired
relations
arrayRequired
schema_id
stringRequired
workspace

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Create a Folder

Description

Tool to create a folder in a Postman collection. Use when you need to organize requests by creating a new folder within a collection. For complete details, see the Postman Collection Format documentation.

Action Parameters

collection_id
stringRequired
description
name
stringRequired

Action Response

data
error
meta
model_id
successful
booleanRequired

Tool Name: Create a Folder Comment

Description

Tool to create a comment on a folder. Use when you need to add a comment to a specific folder in a collection.

Action Parameters

body
stringRequired
collection_uid
stringRequired
folder_uid
stringRequired

Action Response

data
error
successful
booleanRequired

Tool Name: Create a Fork

Description

Tool to create a fork from an existing collection into a workspace. Use when you need to fork a collection to create an independent copy in a specific workspace.

Action Parameters

collection_id
stringRequired
label
stringRequired
workspace
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Create Environment Fork

Description

Tool to create a fork from an existing environment into a workspace. Use when you need to fork an environment to a specified workspace.

Action Parameters

environment_uid
stringRequired
fork_name
stringRequired
workspace
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Create a Mock Server

Description

Tool to create a new mock server in a Postman collection. Use when you need to create a mock server to simulate API endpoints for testing or development. Returns the created mock server's details including the mockUrl which can be used to make requests.

Action Parameters

mock
objectRequired
workspace

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Create a Monitor

Description

Tool to create a new monitor in a specific workspace to run a collection on a schedule. Use when you need to set up automated collection runs at specified intervals using cron expressions within a workspace.

Action Parameters

monitor
objectRequired
workspace
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Create an API

Description

Tool to create a new API in Postman. Use when you need to create an API with a name, summary, and description in your Postman workspace.

Action Parameters

api
objectRequired
workspace_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Create an API

Description

Tool to create a new API in a Postman workspace. Use when you need to create an API with a name and optional summary and description.

Action Parameters

api
objectRequired
workspace_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Create an Environment

Description

Tool to create a new environment in a Postman workspace. Use when you need to create a new environment with variables for different settings (development, production, testing, etc.). Returns the created environment's ID, name, and UID upon successful creation.

Action Parameters

environment
objectRequired
workspace_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Create a Pull Request

Description

Tool to create a pull request for a forked collection into its parent collection. Use when you need to propose changes from a forked collection to be merged into the parent collection. The forked collection must exist before creating a pull request.

Action Parameters

collection_uid
stringRequired
description
destination_id
stringRequired
reviewers
array
title
stringRequired

Action Response

data
error
successful
booleanRequired

Tool Name: Create Request in Collection

Description

Tool to create a new request in a Postman collection. Use when you need to add a request to an existing collection with specified method, URL, headers, and body.

Action Parameters

collection_id
stringRequired
name
stringRequired
request
objectRequired

Action Response

data
error
successful
booleanRequired

Tool Name: Create a Request Comment

Description

Tool to create a comment on a request. Use when you need to add a comment to a specific request within a collection or reply to an existing comment thread.

Action Parameters

body
stringRequired
collection_uid
stringRequired
request_uid
stringRequired
thread_id

Action Response

data
error
successful
booleanRequired

Tool Name: Create a Response

Description

Tool to create a request response in a Postman collection. Use when you need to add a saved response example to a specific request in a collection.

Action Parameters

_postman_previewlanguage
body
code
collection_id
stringRequired
header
name
stringRequired
original_request
parent_request_id
stringRequired
status

Action Response

data
error
meta
model_id
revision
successful
booleanRequired

Tool Name: Create a Response Comment

Description

Tool to create a comment on a response. Use when you need to add a comment to a specific response within a collection or reply to an existing comment thread.

Action Parameters

body
stringRequired
collection_uid
stringRequired
response_uid
stringRequired
thread_id

Action Response

data
error
successful
booleanRequired

Tool Name: Create API Schema

Description

Tool to create a schema for an API in Postman. Use when you need to add a schema definition (such as OpenAPI, GraphQL, or Protocol Buffers) to an existing API. The schema can consist of single or multiple files. Returns the created schema's ID and metadata upon successful creation.

Action Parameters

api_id
stringRequired
files
arrayRequired
type
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Create Mock Server Response

Description

Tool to create a server response on a Postman mock server. Use when you need to simulate 5xx server-level responses (500, 503, etc.) for testing error conditions.

Action Parameters

mock_id
stringRequired
serverResponse
objectRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Create a Spec

Description

Tool to create an API specification in Postman's Spec Hub. Use when you need to create single or multi-file specifications in a workspace. Supports various spec types including OpenAPI 3.0, OpenAPI 3.1, and AsyncAPI 2.0.

Action Parameters

files
arrayRequired
name
stringRequired
type
stringRequired
workspace_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Create Spec File

Description

Tool to create a new file in an API specification. Use when you need to add a new file (such as schema definitions, path configurations, or components) to an existing spec.

Action Parameters

content
stringRequired
path
stringRequired
spec_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Create a Webhook

Description

Tool to create a webhook that triggers a collection with a custom payload. Use when you need to set up a webhook endpoint that can trigger a Postman collection run. The webhook URL is available in the webhookUrl property of the response.

Action Parameters

webhook
objectRequired
workspace
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Create a Workspace

Description

Tool to create a new workspace in Postman. Use when you need to create a workspace with a specified name, type (personal, team, private, or public), and optional description. Returns the created workspace's ID, name, and type upon successful creation.

Action Parameters

workspace
objectRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Create Collection

Description

Tool to create a new Postman collection with specified name and configuration. Use when you need to create a new collection in Postman workspace. Returns the created collection's ID, name, and UID upon successful creation.

Action Parameters

collection
objectRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Create Environment

Description

Tool to create a new Postman environment with specified name and variables. Use when you need to create a new environment in Postman workspace. Returns the created environment's ID, name, and UID upon successful creation.

Action Parameters

environment
objectRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Create Mock Server

Description

Tool to create a new mock server for a Postman collection. Use when you need to set up a mock server that simulates API responses based on saved examples in a collection.

Action Parameters

mock
objectRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Create Monitor

Description

Tool to create a new monitor to run a collection on a schedule. Use when you need to set up automated collection runs at specified intervals using cron expressions.

Action Parameters

monitor
objectRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Create or Update a Schema File

Description

Tool to create or update an API schema file in Postman. Use when you need to add a new schema file or modify an existing one within an API schema. Requires API ID, schema ID, file path, and stringified JSON content.

Action Parameters

api_id
stringRequired
content
stringRequired
file_path
stringRequired
schema_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Create API Version Relations

Description

Tool to create new relations for an API version. Use when you need to link collections or mock servers to an API version as contract tests, test suites, documentation, or mocks.

Action Parameters

api_id
stringRequired
api_version_id
stringRequired
contracttest
documentation
mock
testsuite

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Create Webhook

Description

Tool to create a new webhook for a Postman collection. Use when you need to create a webhook that triggers a collection when called. Returns the created webhook's ID and name upon successful creation.

Action Parameters

webhook
objectRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Delete a Collection

Description

Tool to permanently delete a collection from Postman. Use when you need to remove a collection that is no longer needed.

Action Parameters

collection_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Delete a collection’s comment

Description

Tool to delete a comment from an API's collection. Use when you need to remove a specific comment from a collection. On success, returns HTTP 204 No Content.

Action Parameters

api_id
stringRequired
collection_id
stringRequired
comment_id
integerRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Delete a Folder

Description

Tool to delete a folder in a Postman collection. Use when you need to remove a folder and all its contents from a collection. The folder ID should not contain spaces to avoid 404 errors.

Action Parameters

collection_id
stringRequired
folder_id
stringRequired

Action Response

data
error
meta
model_id
revision
successful
booleanRequired

Tool Name: Delete a Folder’s Comment

Description

Tool to delete a comment from a folder. Use when you need to remove a specific comment from a folder. Returns HTTP 204 No Content on successful deletion.

Action Parameters

collection_uid
stringRequired
comment_id
integerRequired
folder_uid
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Delete an API

Description

Tool to delete an API from Postman. Use when you need to permanently remove an API. On success, returns HTTP 204 No Content response.

Action Parameters

api_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Delete an API’s Comment

Description

Tool to delete a comment from an API. Use when you need to remove a comment from a specific API. On success, this returns an HTTP 204 No Content response indicating the comment was successfully deleted.

Action Parameters

api_id
stringRequired
comment_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Delete an environment

Description

Tool to delete an environment permanently in Postman. Use when you need to remove an environment that is no longer needed.

Action Parameters

environment_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Delete a Request’s Comment

Description

Tool to delete a comment from a request. Use when you need to remove a specific comment from a request. On success, this returns an HTTP 204 No Content response.

Action Parameters

collection_uid
stringRequired
comment_id
integerRequired
request_uid
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Delete a Response

Description

Tool to delete a response in a Postman collection. Use when you need to remove a saved response from a collection.

Action Parameters

collection_id
stringRequired
response_id
stringRequired

Action Response

data
error
meta
model_id
revision
successful
booleanRequired

Tool Name: Delete a Response’s Comment

Description

Tool to delete a comment from a response. Use when you need to remove a specific comment from a collection response. On successful deletion, this returns HTTP 204 No Content.

Action Parameters

collection_uid
stringRequired
comment_id
integerRequired
response_uid
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Delete a Schema File

Description

Tool to delete a file in an API schema. Use when you need to remove a specific file from a schema. On success, returns HTTP 204 No Content response.

Action Parameters

api_id
stringRequired
file_path
stringRequired
schema_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Delete Mock Server Response

Description

Tool to delete a mock server's server response. Use when you need to remove a specific response from a Postman mock server.

Action Parameters

mock_id
stringRequired
server_response_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Delete a Spec

Description

Tool to delete an API specification from Postman. Use when you need to permanently remove a specification. On success, returns HTTP 204 No Content response.

Action Parameters

spec_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Delete Spec File

Description

Tool to delete a file from an API specification. Use when you need to remove a specific file from a multi-file specification.

Action Parameters

file_path
stringRequired
spec_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Delete a Workspace

Description

Tool to delete a Postman workspace permanently. Use when you need to remove a workspace and all its contents. Deletion is permanent and cannot be undone.

Action Parameters

workspace_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Delete Monitor

Description

Tool to delete a monitor by its ID. Use when you need to permanently remove a monitor from Postman. The monitor ID must be provided to identify which monitor to delete.

Action Parameters

monitor_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Duplicate a Collection

Description

Tool to create a duplicate of a collection in another workspace. Use when you need to copy an existing collection to a different workspace. Returns an asynchronous task that can be tracked using the duplication task status endpoint.

Action Parameters

collection_id
stringRequired
workspace
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Fork Collection

Description

Tool to create a fork of a collection in a specified workspace. Use when you need to fork an existing collection to a workspace.

Action Parameters

collection_id
stringRequired
label
workspace
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Generate Collection from Spec

Description

Tool to generate a Postman collection from an OpenAPI 2.0, 3.0, or 3.1 specification. Use when you need to create a collection from an existing API spec. The operation is asynchronous and returns a task ID and polling URL to check the generation status.

Action Parameters

element_type
stringDefaults to collection
name
stringRequired
options
spec_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Generate Spec from Collection

Description

Tool to generate an API specification from a Postman collection. Use when you need to create an OpenAPI 3.0 specification from an existing collection. The operation is asynchronous and returns a task ID and polling URL to check the generation status.

Action Parameters

collection_uid
stringRequired
element_type
stringDefaults to spec
format
stringRequired
name
stringRequired
type
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get Billing Account Details

Description

Tool to retrieve Postman billing account details for the authenticated team. Use when you need to access account information such as account ID, team ID, account state, billing slots, sales channel, or billing email.

Action Parameters

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get Collection Comments

Description

Tool to retrieve all comments left by users in an API's collection. Use when you need to fetch all comments associated with a specific collection within an API.

Action Parameters

api_id
stringRequired
collection_id
stringRequired

Action Response

data
array
error
successful
booleanRequired

Tool Name: Get Collection’s Forks

Description

Tool to get all forks of a specific collection. Use when you need to retrieve information about who has forked a collection, including fork IDs, users, and creation dates.

Action Parameters

collection_id
stringRequired

Action Response

data
error
meta
successful
booleanRequired

Tool Name: Get Collection Pull Requests

Description

Tool to get information about a collection's pull requests including source and destination IDs, status, and URLs. Use when you need to retrieve pull request details for a specific collection.

Action Parameters

collection_uid
stringRequired

Action Response

data
array
error
successful
booleanRequired

Tool Name: Get Collection Roles

Description

Tool to get information about all roles in a collection. Use when you need to retrieve the IDs of all users, teams, and groups with access to view or edit a collection.

Action Parameters

collection_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get Folder Information

Description

Tool to retrieve information about a folder in a Postman collection. Use when you need to fetch details about a specific folder including its name, description, owner, and timestamps.

Action Parameters

collection_id
stringRequired
folder_id
stringRequired

Action Response

data
error
meta
model_id
successful
booleanRequired

Tool Name: Get Folder Comments

Description

Tool to retrieve all comments left by users in a folder. Use when you need to fetch all comments associated with a specific folder within a collection.

Action Parameters

collection_uid
stringRequired
folder_uid
stringRequired

Action Response

data
array
error
successful
booleanRequired

Tool Name: Get All API Releases

Description

Tool to get all releases for a specific API version in Postman. Use when you need to list releases for an API version. Note: This endpoint is deprecated in Postman v10 and higher.

Action Parameters

api_id
stringRequired
api_version_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get All APIs

Description

Tool to get all APIs accessible to the authenticated user with optional workspace filtering. Use when you need to list or retrieve APIs from Postman. Returns an array of API objects with their IDs, names, summaries, and other metadata.

Action Parameters

workspace

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get All APIs in Workspace

Description

Tool to get all APIs in a specific Postman workspace. Use when you need to list or retrieve APIs from a workspace. Returns an array of API objects with their details.

Action Parameters

workspace_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get All Collections

Description

Tool to get all collections accessible to the authenticated user with optional workspace filtering. Use when you need to list or retrieve collections from Postman. Returns an array of collection objects with their IDs, names, and UIDs.

Action Parameters

workspace

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get All Collections

Description

Tool to get all collections accessible to the authenticated user. Use when you need to retrieve all your collections including subscribed collections. Returns detailed information for each collection including owner, creation/update timestamps, and visibility.

Action Parameters

workspace

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get All Environments

Description

Tool to get all environments accessible to the authenticated user with optional workspace filtering. Use when you need to list or retrieve environments from Postman. Returns an array of environment objects with their IDs, names, and UIDs.

Action Parameters

workspace

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get All Forked Collections

Description

Tool to retrieve all forked collections for the authenticated user. Use when you need to list or access all collections that the user has forked.

Action Parameters

Action Response

data
error
meta
successful
booleanRequired

Tool Name: Get All Groups

Description

Tool to get all user groups in a Postman team. Use when you need to list all groups and their details including member counts and timestamps. Returns an array of group objects with their IDs, names, team IDs, user counts, and creation/update timestamps.

Action Parameters

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get All Linked Relations

Description

Tool to retrieve all linked relations for a specific API version in Postman. Use when you need to discover what collections, documentation, mocks, or monitors are linked to an API version.

Action Parameters

api_id
stringRequired
api_version_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get All Mock Servers

Description

Tool to get all active mock servers accessible to the authenticated user. Use when you need to list or retrieve mock servers from Postman. By default, returns only mock servers you created across all workspaces. Can be filtered by workspace ID to get mock servers specific to a workspace.

Action Parameters

workspace

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get All Monitors

Description

Tool to get all monitors accessible to the authenticated user with optional workspace filtering. Use when you need to list or retrieve monitors from Postman. Returns an array of monitor objects with their IDs, names, and UIDs.

Action Parameters

workspace

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get All Workspace Roles

Description

Tool to get information about all roles in a workspace based on the team's plan. Use when you need to retrieve the IDs of all users with different roles (Editor, Admin, Viewer) in a workspace.

Action Parameters

workspace_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get All API Specifications

Description

Tool to get all API specifications in a workspace. Use when you need to list or retrieve API specs from a specific Postman workspace. Returns an array of spec objects with their IDs, names, types, and timestamps, along with pagination metadata.

Action Parameters

workspace_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get All Team Users

Description

Tool to get information about all users on the Postman team. Use when you need to list all team members and their details including roles and join dates. Returns an array of user objects with their IDs, names, usernames, emails, roles, and join timestamps.

Action Parameters

Action Response

data
error
successful
booleanRequired

Tool Name: Get All Test Relations

Description

Tool to retrieve all test relations for a specific API version. Use when you need to get test relations associated with an API version. Note: This endpoint is deprecated in Postman v10 and higher.

Action Parameters

api_id
stringRequired
api_version_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get All API Versions

Description

Tool to get all published versions of a specific API in Postman. Use when you need to list or retrieve version information for an API. Returns an array of version objects with their IDs and names.

Action Parameters

api_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get All Workspaces

Description

Tool to get all workspaces accessible to the authenticated user with optional type filtering. Use when you need to list or retrieve workspaces from Postman. Returns an array of workspace objects with their IDs, names, and types.

Action Parameters

type

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get Monitor Information

Description

Tool to retrieve information about a specific monitor in Postman. Use when you need to fetch monitor details including schedule, collection, environment, and run status.

Action Parameters

monitor_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get API Information

Description

Tool to retrieve information about a specific API in Postman. Use when you need to fetch API details including name, description, versions, and schemas.

Action Parameters

api_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get API Comments

Description

Tool to retrieve all comments left by users in an API. Use when you need to fetch all comments associated with a specific API.

Action Parameters

api_id
stringRequired

Action Response

data
array
error
successful
booleanRequired

Tool Name: Get API Version

Description

Tool to get information about a specific API version in Postman. Use when you need to retrieve details about a particular version of an API. Returns version details including ID, name, creation date, and associated schemas.

Action Parameters

api_id
stringRequired
api_version_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get an Environment

Description

Tool to retrieve detailed information about a specific environment in Postman. Use when you need to fetch environment details including name, ID, owner, and all environment variables.

Action Parameters

environment_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get Environment Forks

Description

Tool to retrieve all forked environments for a specific environment. Use when you need to list all environments that have been forked from a particular environment.

Action Parameters

environment_uid
stringRequired

Action Response

data
error
meta
successful
booleanRequired

Tool Name: Get Request Information

Description

Tool to retrieve information about a specific request in a Postman collection. Use when you need to fetch details about a request including its method, URL, headers, body, authentication, and associated scripts.

Action Parameters

collection_id
stringRequired
request_id
stringRequired

Action Response

data
error
meta
model_id
successful
booleanRequired

Tool Name: Get Request Comments

Description

Tool to retrieve all comments left by users in a request. Use when you need to fetch all comments associated with a specific request within a collection.

Action Parameters

collection_uid
stringRequired
request_uid
stringRequired

Action Response

data
array
error
successful
booleanRequired

Tool Name: Get Response Information

Description

Tool to retrieve information about a saved response in a Postman collection. Use when you need to fetch details about a specific response including status, headers, body, and metadata.

Action Parameters

collection_id
stringRequired
response_id
stringRequired

Action Response

data
error
meta
model_id
successful
booleanRequired

Tool Name: Get Response Comments

Description

Tool to retrieve all comments left by users in a response. Use when you need to fetch all comments associated with a specific response within a collection.

Action Parameters

collection_uid
stringRequired
response_uid
stringRequired

Action Response

data
array
error
successful
booleanRequired

Tool Name: Get API Schema

Description

Tool to retrieve information about an API schema from Postman. Use when you need to fetch schema details for a specific API. Optionally specify a version ID to get a schema published in a specific API version.

Action Parameters

api_id
stringRequired
schema_id
stringRequired
version_id

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get API Specification

Description

Tool to retrieve information about an API specification in Postman. Use when you need to fetch spec details including name, type, and timestamps.

Action Parameters

spec_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get Spec File Contents

Description

Tool to get the contents of an API specification's file. Use when you need to retrieve the actual content and metadata of a specific file within a spec.

Action Parameters

file_path
stringRequired
spec_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get Spec Definition

Description

Tool to get the complete contents of an API specification's definition. Use when you need to retrieve the full OpenAPI/Swagger specification content for a spec. Returns the raw definition content as a string.

Action Parameters

spec_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get Specification Files

Description

Tool to retrieve all files in an API specification from Postman. Use when you need to list or view specification files for a specific spec ID. Returns file metadata including IDs, names, paths, types, and timestamps.

Action Parameters

spec_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get Spec’s Generated Collections

Description

Tool to retrieve all collections generated from an API specification in Postman. Use when you need to fetch collections that have been auto-generated from a spec. Returns metadata and an array of generated collections.

Action Parameters

element_type
stringDefaults to collection
spec_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get Async Collection Update Status

Description

Tool to get the status of an asynchronous collection update task. Use when you need to check whether a previously initiated async collection update is still processing, has completed successfully, or has failed. The task ID is obtained from PUT /collections/{collectionId} endpoint when using the Prefer: respond-async header.

Action Parameters

task_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get Team User

Description

Tool to get information about a user on the Postman team. Use when you need to retrieve details about a specific team member including their ID, name, email, roles, and join date.

Action Parameters

user_id
integerRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get Authenticated User

Description

Tool to get information about the authenticated user. Use when you need to retrieve details about the current authenticated user, including their user ID, username, and email address.

Action Parameters

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get Workspace Details

Description

Tool to get detailed information about a specific workspace by its ID. Use when you need to retrieve the complete structure of a workspace including all collections, environments, APIs, mocks, and monitors.

Action Parameters

workspace_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get Workspace Activity Feed

Description

Tool to get a workspace's activity feed showing who added or removed collections, environments, or elements, and users joining or leaving. Use when you need to track workspace changes and user activity.

Action Parameters

cursor
limit
workspace_id
stringRequired

Action Response

data
error
meta
successful
booleanRequired

Tool Name: Get Workspace Roles

Description

Tool to get the roles of users, user groups, and partners in a workspace. Use when you need to retrieve role assignments and understand who has what level of access to a specific workspace.

Action Parameters

workspace_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get Collection Access Keys

Description

Tool to retrieve all personal and team collection access keys for the authenticated user. Use when you need to list or manage collection access keys. Returns an array of access key objects with their IDs, tokens, status, and associated collection information.

Action Parameters

Action Response

data
error
meta
successful
booleanRequired

Tool Name: Get Contract Test Relations

Description

Tool to retrieve contract test relations for a specific API version. Use when you need to check contract test associations. Note: This endpoint is deprecated and may return limited or no data.

Action Parameters

api_id
stringRequired
api_version_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get documentation relations

Description

Tool to get documentation relations for a specific API version. This endpoint is deprecated in Postman v10 and higher.

Action Parameters

api_id
stringRequired
api_version_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get Duplication Task Status

Description

Tool to get the status of a collection duplication task. Use when you need to check whether a previously initiated collection duplication is still processing or has completed. The task ID must first be obtained from the POST /collections/{collectionId}/duplicates endpoint.

Action Parameters

task_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get Environment Relations

Description

Tool to get environment relations for a specific API version. This endpoint is deprecated in Postman v10 and higher.

Action Parameters

api_id
stringRequired
api_version_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get Generated Specification

Description

Tool to retrieve the API specification generated for a Postman collection. Use when you need to fetch OpenAPI/Swagger specs that have been auto-generated from a collection. Returns metadata and an array of generated specifications.

Action Parameters

collection_uid
stringRequired
element_type
stringDefaults to spec

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get Workspace Global Variables

Description

Tool to get a workspace's global variables. Use when you need to retrieve global variables that are available throughout a workspace for access between collections, requests, scripts, and environments. Note that this endpoint only works with personal or team workspaces, not public workspaces.

Action Parameters

workspace_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get Integration Test Relations

Description

Tool to get integration test relations for a specific API version. This endpoint is deprecated and may not return active data.

Action Parameters

api_id
stringRequired
api_version_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get Resource Types

Description

Tool to get all resource types supported by Postman's SCIM API. Use when you need to discover what resource types (e.g., User, Group) are available in the SCIM API and their corresponding endpoints and schemas.

Action Parameters

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get Schema File Contents

Description

Tool to get the contents of an API schema file at a specified path. Use when you need to retrieve the actual content of a schema file. Optionally specify a version ID to get file contents from a specific API version.

Action Parameters

api_id
stringRequired
file_path
stringRequired
schema_id
stringRequired
version_id

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get Schema Files

Description

Tool to retrieve files in an API schema from Postman. Use when you need to list or view schema files for a specific API and schema ID. Optionally filter by version ID to get files from a particular API version.

Action Parameters

api_id
stringRequired
schema_id
stringRequired
version_id

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get Service Provider Configuration

Description

Tool to get Postman's SCIM API service provider configuration information. Use when you need to discover supported SCIM operations, capabilities, and authentication schemes. This endpoint returns configuration details including support for PATCH, bulk operations, filtering, sorting, and ETag handling.

Action Parameters

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get Source Collection Status

Description

Tool to check whether there is a change between a forked collection and its parent (source) collection. Use when you need to determine if the source collection has updates that are not yet in the forked collection. This endpoint only works with forked collections; attempting to use it with regular collections will result in an error.

Action Parameters

collection_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get Test Suite Relations

Description

Tool to get test suite relations for a specific API version. Use when you need to retrieve the test suites associated with an API version. Note: This endpoint is deprecated and only works with legacy v9 APIs. For v10+ APIs, this returns an empty array.

Action Parameters

api_id
stringRequired
api_version_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get Unclassified Relations

Description

Tool to get unclassified relations for an API version in Postman. Use when you need to retrieve unclassified relations for a specific API version. This endpoint is for Postman v10 and higher.

Action Parameters

api_id
stringRequired
api_version_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Import OpenAPI Definition

Description

Tool to import an OpenAPI definition into Postman as a new collection. Use when you need to convert an OpenAPI specification into a Postman collection within a specific workspace.

Action Parameters

input
stringRequired
type
stringRequired
workspace_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Import OpenAPI Specification

Description

Tool to import an OpenAPI specification into Postman as a new collection. Use when you need to convert an OpenAPI 3.0+ specification into a Postman collection within a specific workspace. The imported specification will be automatically converted to a Postman collection with all endpoints, request parameters, and documentation.

Action Parameters

input
stringRequired
type
stringRequired
workspace
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: List Account Invoices

Description

Tool to get all invoices for a Postman billing account filtered by status. Use when you need to retrieve invoice history for an account. The account ID must first be obtained from the GET /accounts endpoint.

Action Parameters

account_id
stringRequired
status

Action Response

data
error
successful
booleanRequired

Tool Name: Merge a Fork

Description

Tool to merge a forked collection back into its parent collection. This endpoint is deprecated. Use when you need to merge changes from a forked collection into the parent collection.

Action Parameters

destination
stringRequired
source
stringRequired
strategy

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Merge a forked environment

Description

Tool to merge a forked environment back into its parent environment. Use when you need to merge changes from a forked environment into the parent.

Action Parameters

environment_uid
stringRequired
source
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Publish a Mock Server

Description

Tool to publish a mock server in Postman. Use when you need to make a mock server publicly accessible. Publishing sets the mock server's Access Control configuration to public.

Action Parameters

mock_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Pull Source Changes into Fork

Description

Tool to pull changes from a parent (source) collection into a forked collection. Use when you need to sync a forked collection with its parent.

Action Parameters

collection_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Replace an Environment’s Data

Description

Tool to completely replace an environment's data with new variables and values. Use when you need to update an entire environment by replacing all its contents. This operation replaces ALL existing variables with the ones provided in the request.

Action Parameters

environment
objectRequired
environment_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Replace Collection Data Asynchronously

Description

Tool to replace the entire contents of a collection asynchronously. Use when you need to completely replace a collection with new data. IMPORTANT: Include the collection's ID values in item, variable, and other nested objects to preserve them. If you do not include IDs, existing items will be removed and new items will be created.

Action Parameters

collection
objectRequired
collection_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Resolve a Comment Thread

Description

Tool to resolve a comment thread and any associated replies. Use when you need to mark a comment thread as resolved. On success, this returns an HTTP 204 No Content response.

Action Parameters

thread_id
integerRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Review a Pull Request

Description

Tool to update the review status of a pull request by approving, declining, or unapproving it. Use when you need to perform a review action on a Postman pull request.

Action Parameters

action
stringRequired
pull_request_id
stringRequired

Action Response

data
error
message
successful
booleanRequired

Tool Name: Run a Monitor

Description

Tool to trigger an immediate run of a monitor and retrieve its execution results. Use when you need to manually execute a monitor outside of its scheduled runs.

Action Parameters

monitor_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Sync Collection with API Schema

Description

Tool to sync a collection attached to an API with the API schema. This is an asynchronous endpoint that returns HTTP 202 Accepted. Use when you need to synchronize a collection with changes made to the API schema. The collection must already be attached to the API. Returns a task ID that can be used to check the status of the sync operation.

Action Parameters

api_id
stringRequired
collection_uid
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Sync Collection with Specification

Description

Tool to sync a collection generated from an API specification. This is an asynchronous operation that returns HTTP 202 Accepted. Use when you need to update a collection to match the latest version of its source API specification. The collection must have been generated from a spec.

Action Parameters

collection_uid
stringRequired
spec_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Sync Spec with Collection

Description

Tool to sync an API specification with a linked collection. This is an asynchronous operation that returns HTTP 202 Accepted with task tracking information. Use when you need to synchronize changes from a spec to its generated collection. Prerequisites: the collection must be generated from the spec, and the spec must be single-file.

Action Parameters

collection_uid
stringRequired
spec_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Transfer Folders

Description

Tool to copy or move folders into a collection or folder. Use when you need to reorganize collections by transferring folders between collections or into other folders.

Action Parameters

ids
arrayRequired
location
objectRequired
mode
stringRequired
target
objectRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Transform Collection to OpenAPI

Description

Tool to transform an existing Postman Collection into a stringified OpenAPI 3.0.3 definition. Use when you need to convert a collection to OpenAPI format for API documentation or interoperability with other tools.

Action Parameters

collection_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Update a Folder

Description

Tool to update a folder in a Postman collection. Use when you need to modify the name or description of an existing folder. For complete properties and information, see the Postman Collection Format documentation.

Action Parameters

collection_id
stringRequired
description
folder_id
stringRequired
name

Action Response

data
error
meta
model_id
successful
booleanRequired

Tool Name: Update a Folder’s Comment

Description

Tool to update a comment on a folder. Use when you need to modify the text content of an existing comment on a specific folder in a collection.

Action Parameters

body
stringRequired
collection_uid
stringRequired
comment_id
stringRequired
folder_uid
stringRequired

Action Response

data
error
successful
booleanRequired

Tool Name: Update a Mock Server

Description

Tool to update an existing mock server. Use when you need to change a mock server's name, collection, environment, or privacy settings. The collection UID is required for all updates.

Action Parameters

mock
objectRequired
mock_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Update a Monitor

Description

Tool to update an existing monitor in Postman. Use when you need to modify monitor properties like name, active status, collection, environment, options, notifications, or distribution settings.

Action Parameters

monitor
objectRequired
monitor_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Update an API

Description

Tool to update an existing API in Postman. Use when you need to modify the name, summary, or description of an API.

Action Parameters

api
objectRequired
api_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Update an API’s Comment

Description

Tool to update a comment on an API. Use when you need to modify the text content of an existing comment on a specific API.

Action Parameters

api_id
stringRequired
body
stringRequired
comment_id
integerRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Update an Environment

Description

Tool to update specific environment properties using JSON Patch operations (RFC 6902). Use when you need to modify environment name or variables without replacing the entire environment.

Action Parameters

environment_id
stringRequired
operations
arrayRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Update a Pull Request

Description

Tool to update an open pull request in Postman. Use when you need to modify the title, description, source, destination, or reviewers of an existing pull request. All fields must be provided in the request.

Action Parameters

description
stringRequired
destination_id
stringRequired
pull_request_id
stringRequired
reviewers
arrayRequired
source_id
stringRequired
title
stringRequired

Action Response

data
error
successful
booleanRequired

Tool Name: Update Request in Collection

Description

Tool to update a request in a Postman collection. Use when you need to modify an existing request's name, method, URL, headers, or body following the Postman Collection Format.

Action Parameters

collection_id
stringRequired
name
request
request_id
stringRequired

Action Response

data
error
successful
booleanRequired

Tool Name: Update a Request’s Comment

Description

Tool to update a comment on a request. Use when you need to modify the text content of an existing comment on a specific request within a collection.

Action Parameters

body
stringRequired
collection_uid
stringRequired
comment_id
integerRequired
request_uid
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Update a Response

Description

Tool to update a response in a Postman collection. Use when you need to modify properties of an existing saved response example such as name, status, code, headers, cookies, or body.

Action Parameters

collection_id
stringRequired
response
objectRequired
response_id
stringRequired

Action Response

data
error
meta
model_id
revision
successful
booleanRequired

Tool Name: Update a Response’s Comment

Description

Tool to update a comment on a response. Use when you need to modify the text content of an existing comment on a specific response within a collection.

Action Parameters

body
stringRequired
collection_uid
stringRequired
comment_id
stringRequired
response_uid
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Update a Server Response

Description

Tool to update a mock server's server response. Use when you need to modify properties of an existing server response such as name, status code, language, body, or headers. At least one property must be included in the update request.

Action Parameters

mock_id
stringRequired
server_response
objectRequired
server_response_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Update Spec File

Description

Tool to update an API specification file's content. Use when you need to modify the contents of a specific file within a spec.

Action Parameters

content
stringRequired
file_path
stringRequired
spec_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Update Spec Properties

Description

Tool to update an API specification's properties such as its name. Use when you need to modify metadata of an existing spec.

Action Parameters

name
spec_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Update a Workspace

Description

Tool to update an existing workspace in Postman. Use when you need to modify the name, type, or description of a workspace. The 'type' field is required for all updates.

Action Parameters

workspace
objectRequired
workspace_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Update Workspace Global Variables

Description

Tool to update and replace a workspace's global variables. Use when you need to set or replace all global variables in a workspace. Note: This endpoint replaces all existing global variables with the provided list.

Action Parameters

values
arrayRequired
workspace_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Update Collection Properties

Description

Tool to update specific collection properties like name, description, authentication, variables, or events. Use when you need to partially update a collection without replacing the entire collection structure. Returns the updated collection information after the changes are applied.

Action Parameters

collection
objectRequired
collection_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired