Skip to main content
Postman
Previewv0.2.0
153 actions · 1 event · 1 auth method
Developer ToolsIAM

Getting Started

1

Create or Select a Project

Set up a new project or select an existing one. See Organizations & Projects.
2

Configure the Connector

Enable the connector and create a Connector Profile in your project. See Setup Connector Profile.

API Key · Connector Profile

No app registration required. The key has no scopes, carries the permissions of the Postman user who creates it, and rea…
Optionally, configure receiving Events for Postman into StackOne.

Webhooks setup

3

Link an Account

Link an account from the dashboard (or via StackOne Hub).See the guide for the authentication type chosen in the Connector Profile:

API Key · Link Account

4

Use Actions

Connect an AI platform to the linked account’s actions. See AI Platforms.Other ways to call actions are listed in Protocols & SDKs.

Actions

153 actions
Action
Description
List Audit Log Event Actions
Gets a complete list of all available audit log event actions.
List Team Audit Logs
Gets a list of your team’s generated audit events. For a complete list of all audit events, see Audit logs.
Merge Or Pull Changes Into A Collection Fork
Merges a forked (source) collection and its parent (destination) collection asynchronously.
Create A Fork
Creates a fork from an existing collection into a workspace.
Create A Pull Request
Creates a pull request for a forked collection into its parent collection.
Create A Collection
Creates a collection using the Postman Collection v2.1.0 schema format.
Delete A Collection
Deletes a Postman collection by its ID, permanently removing its folders, requests and saved responses.
Duplicate A Collection
Creates a duplicate of the given collection in another workspace. Use the GET /collection-duplicate-tasks/{taskId} end…
List Collection’s Forks
Gets a collection’s forked collections. The response returns data for each fork, such as the fork’s ID, the user who for…
List Collection’s Pull Requests
Gets information about a collection’s pull requests, such as the source and destination IDs, status of the pull requests…
Get A Collection’s Roles
Gets information about all roles in a collection. The response returns the IDs of all users, teams, and groups with acce…
Get A Collection
Gets information about a collection. For a complete list of this endpoint’s possible values, refer to the Postman Collec…
List Forked Collections
Gets a list of all the authenticated user’s forked collections.
List Collections
Gets all of your collections. The response includes all of your subscribed collections.
Get Source Collection’s Status
Checks whether there is a change between the forked collection and its parent (source) collection.
Update Part Of A Collection
Updates specific collection information, such as its name, events, or its variables.
Publish Documentation
Publishes a collection’s documentation. This makes it publicly available to anyone with the link to the documentation.
Pull Source Changes
Pulls the changes from a parent (source) collection into the forked collection.
Replace A Collection’s Data
Replaces the contents of a collection using the Postman Collection v2.1.0 schema format.
Transfer Folders
Copies or moves folders into a collection or folder.
Transfer Requests
Copies or moves requests into a collection or folder.
Transfer Responses
Copies or moves responses into a request.
Unpublish Documentation
Unpublishes a collection’s documentation. On success, this returns an HTTP 204 No Content response.
Update A Collection’s Roles
Updates the roles of users, groups, or teams in a collection. On success, this returns an HTTP 204 No Content response…
Create A Folder Comment
Creates a comment on a folder. To create a reply on an existing comment, include the threadId property in the request…
Delete A Folder’s Comment
Deletes a comment from a folder. On success, this returns an HTTP 204 No Content response.
List Folder’s Comments
Gets all comments left by users in a folder in Postman, returning the Postman API response unchanged.
Update A Folder’s Comment
Updates a comment on a folder. Note: This endpoint accepts a max of 10,000 characters.
Create A Request Comment
Creates a comment on a request. To create a reply on an existing comment, include the threadId property in the request…
Delete A Request’s Comment
Deletes a comment from a request. On success, this returns an HTTP 204 No Content response.
List Request’s Comments
Gets all comments left by users in a request.
Update A Request’s Comment
Updates a comment on a request. Note: This endpoint accepts a max of 10,000 characters.
Create A Response Comment
Creates a comment on a response. To create a reply on an existing comment, include the threadId property in the reques…
Delete A Response’s Comment
Deletes a comment from a response. On success, this returns an HTTP 204 No Content response.
List Response’s Comments
Gets all comments left by users in a response.
Update A Response’s Comment
Updates a comment on a response. Note: This endpoint accepts a max of 10,000 characters.
Create A Collection Comment
Creates a comment on a collection. To create a reply on an existing comment, include the threadId property in the requ…
Delete A Collection’s Comment
Deletes a comment from a collection. On success, this returns an HTTP 204 No Content response.
List Collection’s Comments
Gets all comments left by users in a collection.
Update A Collection’s Comment
Updates a comment on a collection. Note: This endpoint accepts a max of 10,000 characters.
Resolve A Comment Thread
Resolves a comment and any associated replies. On success, this returns an HTTP 204 No Content response.
Create An Environment
Creates an environment. Note: - The request body size cannot exceed the maximum allowed size of 30MB.
Delete An Environment
Deletes an environment in Postman, returning the Postman API response unchanged.
Create A Fork
Creates a fork of an existing environment in Postman, returning the Postman API response unchanged.
List Environment’s Forks
Gets all of an environment’s forked environments.
Get An Environment
Gets information about an environment in Postman, returning the Postman API response unchanged.
List Environments
Gets information about all of your environments.
Merge A Fork
Merges a forked environment back into its parent environment.
Update An Environment
Updates specific environment properties, such as its name and variables.
Pull Source Changes
Pulls the changes from a parent (source) environment into the forked environment.
Replace An Environment’s Data
Replaces all the contents of an environment with the given information.
Create A Folder
Creates a folder in a collection. For a complete list of properties, refer to the Folder entry in the Postman Collection…
Delete A Folder
Deletes a folder in a collection in Postman, returning the Postman API response unchanged.
Get A Folder
Gets information about a folder in a collection.
Update A Folder
Updates a folder in a collection. For a complete list of properties, refer to the Folder entry in the Postman Collection…
List Groups
List the groups of the Postman team.
Get Group
Get one Postman group by ID.
Get Unified Credentials
Get the current Postman connection’s unified credentials and identity.
List Unified Groups
List unified groups in the Postman team.
Get Unified Group
Get a unified Postman group by ID.
List Unified Users
List unified users in the Postman team.
Get Unified User
Get a unified Postman team user by ID.
Create A Mock Server
Creates a mock server in a collection. Note: - You cannot create mocks for collections added to an API definition.
Delete A Mock Server
Deletes a mock server in Postman, returning the Postman API response unchanged.
List Mock Server’s Call Logs
Gets a mock server’s call logs. You can get a maximum of 6.5MB of call logs or a total of 100 call logs, whichever limit…
Get A Mock Server
Gets information about a mock server in Postman, returning the Postman API response unchanged.
List Mock Servers
Gets all active mock servers. By default, this endpoint returns only mock servers you created across all workspaces.
Publish A Mock Server
Publishes a mock server. Publishing a mock server sets its Access Control configuration setting to public.
Unpublish A Mock Server
Unpublishes a mock server. Unpublishing a mock server sets its Access Control configuration setting to private.
Update A Mock Server
Updates a mock server’s properties, such as its name or collection.
Create A Monitor
Creates a monitor. Note: - You cannot create monitors for collections added to an API definition.
Delete A Monitor
Deletes a monitor in Postman, returning the Postman API response unchanged.
Get A Monitor
Gets information about a monitor in Postman, returning the Postman API response unchanged.
List Monitors
Gets all monitors in Postman, returning the Postman API response unchanged.
Run A Monitor
Runs a monitor and returns its run results. Note: * If you pass the async=true query parameter, the response does not…
Update A Monitor
Updates a monitor’s configurations in Postman, returning the Postman API response unchanged.
Create A Request
Creates a request in a collection. For a complete list of properties, refer to the Request entry in the Postman Collecti…
Delete A Request
Deletes a request in a collection in Postman, returning the Postman API response unchanged.
Get A Request
Gets information about a request in a collection.
Update A Request
Updates a request in a collection. For a complete list of properties, refer to the Request entry in the Postman Collecti…
Create A Response
Creates a request response in a collection. For a complete list of request body properties, refer to the Response entry…
Delete A Response
Deletes a response in a collection in Postman, returning the Postman API response unchanged.
Get A Response
Gets information about a response in a collection.
Update A Response
Updates a response in a collection. For a complete list of properties, see the Postman Collection Format documentation.
Create A Server Response
Creates a server response. Server responses let you simulate 5xx server-level responses, such as 500 or 503.
Delete A Server Response
Deletes a mock server’s server response in Postman, returning the Postman API response unchanged.
Get A Server Response
Gets information about a server response in Postman, returning the Postman API response unchanged.
List Server Responses
Gets all of a mock server’s server responses.
Update A Server Response
Updates a server response in Postman, returning the Postman API response unchanged.
Create A Spec File
Creates a file for an OpenAPI or a protobuf 2 or 3 specification. Note: - If the file path contains a / (forward slash…
Create A Version Tag
Creates a version tag for a specification. Version tags are snapshots of a specification at a point in time that let you…
Create A Spec
Creates an API specification in Postman’s Spec Hub. Specifications can be single or multi-file.
Delete A Spec File
Deletes a file in an API specification. On success, this returns an HTTP 204 No Content response.
Delete A Spec
Deletes an API specification. On success, this returns an HTTP 204 No Content response.
Generate A Collection From Spec
Creates a collection from the given OpenAPI 2.0, 3.0, or 3.1 specification or Smithy specification.
Generate Spec From Collection
Generates an OpenAPI 2.0, 3.0, or 3.1 specification for the given collection.
List Specs
Gets all API specifications in a workspace in Postman, returning the Postman API response unchanged.
Get Generated Spec
Gets the API specification generated for the given collection.
Get A Spec’s Generated Collections
Gets all of an API specification’s generated collections.
Get A Spec’s Definition
Gets the complete contents of an OpenAPI or AsyncAPI specification’s definition.
Get A Spec File
Gets the contents of an API specification’s file.
List Spec’s Files
Gets all the files in an API specification in Postman, returning the Postman API response unchanged.
Get A Version Tag
Gets information about a specification’s version tag. The response returns a snapshot of a specification at a point in t…
List Specification’s Version Tags
Gets a list of a specification’s version tags.
Get A Spec
Gets information about an API specification in Postman, returning the Postman API response unchanged.
Sync Collection With Spec
Syncs a collection generated from an API specification. This is an asynchronous endpoint that returns an HTTP `202 Accep…
Sync Spec With Collection
Syncs an API specification linked to a collection. This is an asynchronous endpoint that returns an HTTP 202 Accepted…
Update A Spec File
Updates a file for an OpenAPI or protobuf 2 or 3 specification. Note: - This endpoint does not accept an empty request b…
Update A Spec’s Properties
Updates an API specification’s properties, such as its name.
Update Spec Sync Options
Updates the sync options for a specification’s generated collection.
Get A Collection’s Tags
Gets all the tags associated with a collection.
List Elements By Tag
Gets Postman elements (entities) by a given tag. Tags enable you to organize and search workspaces, APIs, and collection…
Get A Workspace’s Tags
Gets all the tags associated with a workspace.
Update A Collection’s Tags
Updates a collection’s associated tags. This endpoint replaces all existing tags with those you pass in the request body…
Update A Workspace’s Tags
Updates a workspace’s associated tags. This endpoint replaces all existing tags with those you pass in the request body.
Get Merge Or Pull Task Status
Gets the status of a collection’s merge or a pull changes task. Note: After a merge’s success or failure, the task’s sta…
Get Async Collection Update Status
Gets the status of an asynchronous collection update task.
Get Duplication Task Status
Gets the status of a collection duplication task.
Get Status Of An Async Spec Task
Gets the status of an asynchronous API specification creation task.
List Teams
List the Postman teams in the organization.
Get Team
Get one Postman team by ID.
Get Team Access Requests
List the pending access requests of a Postman team.
Approve Or Deny An Access Request
Approve or deny a team’s access request in Postman, returning the Postman API response unchanged.
Create An Access Request
Creates an access request for a team. Access requests include actions such as request to join a team, upgrading a user’s…
Create A Team
Creates a Postman team in your organization in Postman, returning the Postman API response unchanged.
Get A Team’s Settings
Gets a team’s settings in Postman, returning the Postman API response unchanged.
Manage Team Member Roles
Adds or removes member roles in groups, teams, organizations, as well as individual users’ roles.
Remove Team Members
Removes entities, such as users or organizations, from your Postman team.
Update Team Settings
Updates a team’s settings in Postman, returning the Postman API response unchanged.
Update A Team
Updates a Postman team’s name in your organization. Note: You can only update the team’s name.
Create A Workspace Update
Creates a workspace update in the given workspace. Workspace updates keep workspace watchers informed about changes, suc…
Delete A Workspace Update
Deletes a workspace update. On success, this returns an HTTP 204 No Content response.
Get A Workspace Update
Gets information about a workspace update in Postman, returning the Postman API response unchanged.
List Workspace Updates
Gets a list of workspace updates for the given workspace.
Update A Workspace Update
Updates a workspace update. Note: This endpoint requires the application/merge-patch+json Content-Type header.
Get Authenticated User
Get the Postman user that owns the API key.
List Team Users
List the users of the Postman team.
Get Team User
Get one user of the Postman team by ID.
Create A Webhook
Creates a webhook that triggers a collection with a custom payload. You can get the webhook’s URL from the webhookUrl…
Create A Workspace
Creates a new workspace. Note: - This endpoint returns a 403 Forbidden response if the user does not have permission t…
Delete A Workspace
Deletes an existing workspace in Postman, returning the Postman API response unchanged.
List Roles
Gets information about all roles in a workspace, based on the team’s plan.
List Workspace’s Activity Feed
Gets a workspace’s activity feed. Activity feeds return information about who added or removed collections, environments…
Get Global Variables
Gets a workspace’s global variables. Global variables enable you to access data between collections, requests, scripts,…
Get A Workspace’s Roles
Gets the roles of users, user groups, and partners in a workspace. Note: Partner roles don’t support SCIM IDs.
Get A Workspace
Gets information about a workspace. Note: This endpoint’s response contains the visibility field.
List Workspaces
Gets all workspaces. The response includes your workspaces and any workspaces that you have access to.
Manage Partner Workspace Invites
Manages invitations and access to your team’s Partner Workspaces. You can use this endpoint to: - Send Partner Workspace…
Transfer Element To A Workspace
Transfers a Postman element from one workspace to another workspace. Supported elements include collections, environment…
Transfer Workspace To A Team
Transfers a workspace from one team (source) to another team (destination).
Update Global Variables
Updates and replaces a workspace’s global variables. This endpoint replaces all existing global variables with the varia…
Update Workspace Roles
Updates the roles of users, user groups, or partners in a workspace. To get a list of roles, use the GET `/workspace-rol…
Update A Workspace
Updates a workspace’s property, such as its name or visibility.

Events

|
1 event
Event
Description
Tags
Monitor Run Completed
Processes monitor run results sent by a Postman Post monitoring results webhook integration.
WebhooksMonitors