Your AI team, working in Postman

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

Start your company

What your team can do in Postman

135 tools to work with, connected with an API key.

Create a Collection

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.

Create a Collection Comment

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.

Create a Folder

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.

Create a Folder Comment

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

Create a Mock Server

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.

Create a Monitor

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.

Create a Pull Request

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.

Create a Request Comment

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.

Create a Response

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.

Create a Response Comment

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.

Create a Spec

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.

Create a Webhook

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.

Create a Workspace

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.

Create an API

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.

Create an Environment

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.

Create API Schema

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.

Create API Version Relations

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.

Create Collection from Schema

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.

Create Environment Fork

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

Create Mock Server Response

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.

Create or Update a Schema File

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.

Create Request in Collection

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.

Create Spec File

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.

Delete a Collection

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

Delete a collection's comment

Delete a specific comment from an API's collection. A 204 response from the API is returned as a success result with a message.

Delete a Folder

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.

Delete a Folder's Comment

Delete a specific comment from a folder in a Postman collection. Returns a success indicator after a successful request.

Delete a Request's Comment

Delete a specific comment from a request in a Postman collection. Returns a success indicator after a successful request.

Delete a Response

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

Delete a Response's Comment

Delete a specific comment from a collection response. Returns a success indicator for successful requests and also when the API returns HTTP 404.

Delete a Schema File

Delete a specific file from an API schema. Returns a success indicator after a successful request.

Delete a Spec

Delete an API specification from Postman by ID. Returns a success flag when the request succeeds.

Delete a Workspace

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.

Delete an API

Delete an API from Postman by ID. Returns a success flag when the request succeeds.

Delete an API's Comment

Delete a specific comment from an API. Returns a success indicator after a successful request.

Delete an environment

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

Delete Mock Server Response

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

Delete Monitor

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.

Delete Spec File

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

Duplicate a Collection

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.

Fork Collection

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

Generate Collection from Spec

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.

Generate Spec from Collection

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.

Get All API ReleasesReads only

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.

Get All API SpecificationsReads only

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.

Get All API VersionsReads only

List published versions of a specific Postman API, returning version IDs and names. Results are paginated; use the returned cursor to fetch subsequent pages.

Get All APIsReads only

List accessible Postman APIs, optionally filtered by workspace. Returns a page of API metadata and a cursor for fetching further results.

Get All CollectionsReads only

List collections accessible to the authenticated user, including subscribed collections, optionally filtered by workspace. Returns a page of collection details and a cursor for fetching further results.

Get All EnvironmentsReads only

List environments accessible to the authenticated user, optionally filtered by workspace. Returns a page of environment objects and pagination metadata; use the cursor to request another page.

Get All Forked CollectionsReads only

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.

Get All GroupsReads only

List user groups in a Postman team, including group details such as member counts and timestamps. Results are paginated; use the cursor to request another page.

Get All Linked RelationsReads only

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.

Get All Mock ServersReads only

List active Postman mock servers, optionally filtered by workspace; by default, the list covers mock servers you created across workspaces. Results are paginated; use the cursor to request another page.

Get All MonitorsReads only

List monitors accessible to the authenticated user, optionally filtered by workspace. Returns a page of monitor objects and pagination metadata; use the cursor to request another page.

Get All Team UsersReads only

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.

Get All Test RelationsReads only

Retrieve test relations for a specific API version. This endpoint is deprecated in Postman v10 and higher; an HTTP 404 is returned as an empty test list.

Get All WorkspacesReads only

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.

Get an EnvironmentReads only

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.

Get API CommentsReads only

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

Get API InformationReads only

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

Get API SchemaReads only

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.

Get API SpecificationReads only

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

Get API VersionReads only

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.

Get Async Collection Update StatusReads only

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.

Get Authenticated UserReads only

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.

Get Billing Account DetailsReads only

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.

Get Collection Access KeysReads only

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.

Get Collection CommentsReads only

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.

Get Collection Pull RequestsReads only

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.

Get Collection RolesReads only

Retrieve user and team role information for a Postman collection, including IDs and roles.

Get Collection's ForksReads only

Retrieve a page of forks of a Postman collection, including fork IDs, owners, and creation dates. The response may include pagination metadata.

Get Contract Test RelationsReads only

Retrieve contract test relations for a specific API version. This endpoint is deprecated and may return limited or no data; a 404 response is returned as an empty relations list.

Get documentation relationsReads only

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

Get Duplication Task StatusReads only

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.

Get Environment ForksReads only

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.

Get Environment RelationsReads only

Get environment relations for a specific API version. This endpoint is deprecated in Postman v10 and higher; an HTTP 404 is returned as an empty environment list.

Get Folder CommentsReads only

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.

Get Folder InformationReads only

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.

Get Generated SpecificationReads only

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.

Get Integration Test RelationsReads only

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

Get Monitor InformationReads only

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.

Get Request CommentsReads only

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.

Get Request InformationReads only

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.

Get Resource TypesReads only

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.

Get Response CommentsReads only

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.

Get Response InformationReads only

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.

Get Schema File ContentsReads only

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.

Get Schema FilesReads only

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.

Get Service Provider ConfigurationReads only

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.

Get Source Collection StatusReads only

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.

Get Spec DefinitionReads only

Retrieve an API specification's definition as a string. JSON object responses are formatted as JSON; other responses are returned as text.

Get Spec File ContentsReads only

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.

Get Spec's Generated CollectionsReads only

Retrieve a page of collections generated from a Postman API specification, with response metadata.

Get Specification FilesReads only

List a page of files in a Postman API specification, returning file metadata such as IDs, names, paths, types, and timestamps.

Get Team UserReads only

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.

Get Test Suite RelationsReads only

Retrieve test suite relations for a specific API version. This endpoint is deprecated; 404 responses and certain 400 errors are returned as an empty list with a deprecation message.

Get Unclassified RelationsReads only

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.

Get Workspace Activity FeedReads only

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.

Get Workspace DetailsReads only

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.

Get Workspace Global VariablesReads only

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.

Get Workspace RolesReads only

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.

Import OpenAPI Specification

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.

List Account InvoicesReads only

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.

Merge a Fork

Merge a forked collection into its parent using the deprecated endpoint. An optional strategy can delete the fork after merging or update both collections.

Merge a forked environment

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.

Publish a Mock Server

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.

Pull Source Changes into Fork

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.

Replace an Environment's Data

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.

Replace Collection Data Asynchronously

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.

Resolve a Comment Thread

Resolve a comment thread and its associated replies in Postman. On a 204 response, the tool returns a success indicator.

Review a Pull Request

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.

Run a Monitor

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.

Sync Collection with API Schema

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.

Sync Collection with Specification

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.

Sync Spec with Collection

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.

Transfer Folders

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.

Transform Collection to OpenAPIReads only

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.

Update a Folder

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.

Update a Folder's Comment

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.

Update a Mock Server

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.

Update a Monitor

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.

Update a Pull Request

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.

Update a Request's Comment

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.

Update a Response

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.

Update a Response's Comment

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.

Update a Server Response

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.

Update a Workspace

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.

Update an API

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

Update an API's Comment

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.

Update an Environment

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.

Update Collection Properties

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.

Update Request in Collection

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.

Update Spec File

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

Update Spec Properties

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

Update Workspace Global Variables

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.

More in Developer tools

See them all β†’

Your company, run by an AI team

Start your company

BRAINER

Continue to B.R.A.I.N.E.R.

Continue with Google or your email.

or