# Manage and Automate Postman with the API **URL:** \ **Category:** Learning Lab\ **Tags:** tutorial, postman-api\ **Created:** [June 11, 2025, 2:02pm UTC](https://community.postman.com/t/manage-and-automate-postman-with-the-api/80977 "2025-06-11T14:02:00Z")\ **Posts on this page:** 5\ **Page:** 1
**Author:** ![david-espi-hernandez](https://sea2.discourse-cdn.com/getpostman/user_avatar/community.postman.com/david-espi-hernandez/32/25537_2.png) [@david-espi-hernandez](https://community.postman.com/u/david-espi-hernandez)\ **Post date:** [June 11, 2025, 2:02pm UTC](https://community.postman.com/t/manage-and-automate-postman-with-the-api/80977/1 "2025-06-11T14:02:00Z")
The Postman API Platform lets you create a variety of resources to support every stage of your API development workflow, including: - [Workspaces](https://www.postman.com/product/workspaces/) — Contain assets you can share with your internal and external teams. - [Collections](https://www.postman.com/collection/) — Organize your requests that share a common purpose. - [Environments](https://learning.postman.com/docs/sending-requests/managing-environments/) — Use sets of scoped variables in your requests. - [APIs](https://www.postman.com/api-design/) — Define different API standards, such as[OpenAPI](https://www.openapis.org/),[GraphQL](https://graphql.org/), or[gRPC](https://grpc.io/). - [Mock servers](https://learning.postman.com/docs/designing-and-developing-your-api/mocking-data/setting-up-mock/) — Simulate the behavior of real API servers. - [Monitors](https://learning.postman.com/docs/monitoring-your-api/intro-monitors/) — Run requests from the Postman cloud on a defined schedule. You can manage these resources—along with users, permissions, and Flows—directly in the Postman [desktop](https://www.postman.com/downloads/) or [web](https://www.postman.com/) app. But if you’re looking to automate your workflow, the Postman API makes it easy to programmatically manage these resources, helping you save time and reduce manual effort. In this post, we’ll take a closer look at what the Postman API can do and how it can boost your productivity. ---
**Author:** ![david-espi-hernandez](https://sea2.discourse-cdn.com/getpostman/user_avatar/community.postman.com/david-espi-hernandez/32/25537_2.png) [@david-espi-hernandez](https://community.postman.com/u/david-espi-hernandez)\ **Post date:** [June 11, 2025, 2:02pm UTC](https://community.postman.com/t/manage-and-automate-postman-with-the-api/80977/2 "2025-06-11T14:02:01Z")
## Endpoints available to all plans The following endpoints are available to all users, regardless of Postman[plan](https://www.postman.com/pricing/): ### Workspaces Use the [Workspaces](https://www.postman.com/postman/workspace/postman-public-workspace/folder/12959542-2581bf7a-36b8-4f09-8d2d-dbbaeb0c25bb) API to efficiently manage your Postman workspaces. Create temporary workspaces for testing and remove them when no longer needed to keep your account organized. Back up entire workspaces or specific resources—such as collections or APIs—using the Postman API. ### Collections Use the [Collections](https://www.postman.com/postman/workspace/postman-public-workspace/folder/12959542-c705956d-1005-4fbc-803c-b6b985242a85) endpoints to manage your Postman Collections with greater control and flexibility. These endpoints support standard CRUD operations and streamline collection-related workflows, including: - [Partial updates](https://www.postman.com/postman/postman-public-workspace/request/augwzgq/update-part-of-a-collection) — Modify part of a collection—such as its name, description, authentication, variables, or scripts—without needing to replace the entire object. - [Item-level operations](https://www.postman.com/postman/postman-public-workspace/folder/u1d0iuh/items) — These endpoints let you create, update, or delete individual Postman requests, folders, and responses. This is especially useful for large collections where updates with PUT can be error-prone. - [Transfers](https://www.postman.com/postman/postman-public-workspace/folder/e3lo7i5/transfers) — Move items between collections or folders, and reorder folders within a collection programmatically. - [Forks](https://www.postman.com/postman/postman-public-workspace/folder/yrtfwkg/forks) — Programmatically create and merge collection forks to support collaborative workflows or versioning. Additionally, you can: - [Transform collections](https://www.postman.com/postman/postman-public-workspace/request/vyyh2ga/transform-collection-to-openapi) — Convert a collection to an OpenAPI definition. - [Import definitions](https://www.postman.com/postman/postman-public-workspace/request/bugnazm/import-an-openapi-definition) — Generate a collection from an OpenAPI definition. These capabilities enable automation between your API definitions and Postman. When collections are kept in sync, dependent resources—like monitors, mock servers, and tests—stay up to date with minimal manual intervention. ### Forks and pull requests The Postman API allows you to fork [collections](https://www.postman.com/postman/postman-public-workspace/folder/yrtfwkg/forks) and [environments](https://www.postman.com/postman/postman-public-workspace/folder/c4xsfxv/forks) to support collaborative workflows. You can pull source changes from the original, create new forks, merge existing ones, and get a list of all forks associated with your [collections](https://www.postman.com/postman/postman-public-workspace/request/pydminp/get-a-collection-s-forks) and [environments](https://www.postman.com/postman/postman-public-workspace/request/h7jr1y9/get-an-environment-s-forks). Additionally, you can manage your collections’ [pull requests](https://www.postman.com/postman/postman-public-workspace/folder/0t3u8hc/pull-requests) programmatically. This includes [creating](https://www.postman.com/postman/postman-public-workspace/request/9wzo1v1/create-a-pull-request) new pull requests to propose changes, retrieving details of existing pull requests, and using the [Pull Requests](https://www.postman.com/postman/postman-public-workspace/folder/yu3y5jy/pull-requests) endpoints to review, update, or merge them. These capabilities enable smooth collaboration and version control directly within your Postman workflows. ### Variables and environments Postman supports three types of variables—global, environment, and collection—and you can update all of them programmatically using the Postman API. - Global variables are accessible across an entire workspace. Manage them using the [Global Variables](https://www.postman.com/postman/postman-public-workspace/folder/pfngjbr/global-variables) endpoints. - Environment variables let you scope requests to specific environments like dev, test, or prod. These are managed with the [Environments](https://www.postman.com/postman/postman-public-workspace/folder/t1fblas/environments) endpoints. - Collection variables are available to all requests within a collection and can be updated through the [Update part of a collection](https://www.postman.com/postman/postman-public-workspace/request/augwzgq/update-part-of-a-collection) endpoint. This simplifies maintaining consistent configurations across environments and supports automation within your existing workflows. ### API Builder and Specs The [API](https://www.postman.com/postman/postman-public-workspace/folder/j34rt1l/api) and [Specs](https://www.postman.com/postman/postman-public-workspace/folder/4qpsuuz/specs) endpoints offer straightforward CRUD operations to manage your APIs in Postman. The API Builder endpoints support: - Modifying API definitions using [schemas](https://www.postman.com/postman/workspace/postman-public-workspace/folder/12959542-878e91ec-37f0-4bc1-8dc0-c4add5a8556b). - Programmatically creating and publishing [versions](https://www.postman.com/postman/postman-public-workspace/folder/s0rz529/api-version) of your API for your consumers. - Managing and automatically syncing [collections](https://www.postman.com/postman/postman-public-workspace/folder/m3y646l/collections) linked to an API. Spec Hub endpoints allow you to: - [Create](https://www.postman.com/postman/postman-public-workspace/request/plumr6m/create-a-spec) or [retrieve](https://www.postman.com/postman/postman-public-workspace/request/3da633u/get-a-spec-s-definitionhttps://www.postman.com/postman/postman-public-workspace/request/3da633u/get-a-spec-s-definition) API specifications. - [Generate specs](https://www.postman.com/postman/postman-public-workspace/request/pufbovy/generate-spec-from-collection) from existing Postman Collections, or [collections](https://www.postman.com/postman/postman-public-workspace/request/p6gr7lk/generate-a-collection-from-spec) from specs. - [Fetch](https://www.postman.com/postman/postman-public-workspace/request/46gt147/get-a-spec-s-generated-collections) all collections generated from a specific spec. - [Update](https://www.postman.com/postman/postman-public-workspace/request/ll73cdt/create-or-update-a-spec-file) the contents of an existing specification. These endpoints provide the tools you’ll need to manage your API lifecycle and ensuring consistency across definitions and collections. ### Mock servers Postman mock servers are based on collections, so modifying a collection with [Collections](https://www.postman.com/postman/postman-public-workspace/folder/b7pojjp/collections) endpoints directly affects the behavior of any associated mock server. In addition, the [Mocks](https://www.postman.com/postman/postman-public-workspace/folder/zueaxnn/mocks) endpoints allow you to manage mock servers independently, with support for standard CRUD operations. Key features include: - Access control. Set a mock server to be [public](https://www.postman.com/postman/postman-public-workspace/request/7mglglo/publish-a-mock-server) or [private](https://www.postman.com/postman/postman-public-workspace/request/902qjpm/unpublish-a-mock-server). - [Call logs](https://www.postman.com/postman/postman-public-workspace/request/5a1zzxz/get-a-mock-server-s-call-logs). Get a list of requests received by a mock server. - Error handling. Configure [custom responses](https://www.postman.com/postman/postman-public-workspace/folder/za15xaf/server-responses) for 5XX server errors. This level of control enables more flexible testing and simulation workflows, especially when working with evolving APIs or isolated environments. ### Monitors The [Monitors](https://www.postman.com/postman/workspace/postman-public-workspace/folder/12959542-e8688124-26f9-4dbe-9226-0c453fedf8a9) endpoints allow you to automate collection runs on a schedule or in response to events within your CI/CD workflows. With these endpoints, you can: - [Run](https://www.postman.com/postman/workspace/postman-public-workspace/request/12959542-688c4c2a-58b6-4f26-b06b-1f45508ee1d4) a monitor synchronously or [asynchronously](https://www.postman.com/postman/postman-public-workspace/example/12959542-0c17682c-55c5-4903-b0e1-469d159775bb). Trigger a monitor and wait for the results in real time or pull the job execution status. - Create and run a [webhook](https://learning.postman.com/docs/collections/running-collections/collection-webhooks/)—special monitors that run collections based on external events. ### Users and groups Use the [Groups](https://www.postman.com/postman/postman-public-workspace/folder/y69vws8/groups) endpoints to retrieve information about Postman user groups, or the [Users](https://www.postman.com/postman/postman-public-workspace/folder/gpu5rwc/users) endpoints to access details about members of your Postman team. For insights into your API usage and limits, refer to the [authenticated user](https://www.postman.com/postman/postman-public-workspace/request/ay0ymqy/get-authenticated-user) endpoint (`/me`). ---
**Author:** ![david-espi-hernandez](https://sea2.discourse-cdn.com/getpostman/user_avatar/community.postman.com/david-espi-hernandez/32/25537_2.png) [@david-espi-hernandez](https://community.postman.com/u/david-espi-hernandez)\ **Post date:** [June 11, 2025, 2:02pm UTC](https://community.postman.com/t/manage-and-automate-postman-with-the-api/80977/3 "2025-06-11T14:02:01Z")
## Enterprise or Professional plans If you’re a Postman [Enterprise or Professional plan](https://www.postman.com/pricing/) user, you can use the following endpoints: ### Private API Network The [Postman Private API Network](https://learning.postman.com/docs/collaborating-in-postman/private-api-network/overview/) provides a centralized directory for your team’s internal workspaces, collections, and APIs. With the API, you can [manage network elements](https://www.postman.com/postman/postman-public-workspace/folder/2guzk9z/private-api-network) and [approve or reject](https://www.postman.com/postman/workspace/postman-public-workspace/folder/12959542-f426d433-3a4b-4d8d-ba79-38409585f308) contributions. This functionality enables you to automate internal documentation management, integrate with your CI/CD pipelines, and ensure that your team’s documentation remains current and reliable. ### Tags Postman’s API includes [Tags](https://www.postman.com/postman/workspace/postman-public-workspace/folder/12959542-7121c1c4-f792-484c-b3bd-c133d58dbbeb) endpoints that let you manage tags across your collections, APIs, and workspaces. You can add, update, or delete tags to keep your Postman elements organized at scale. Need to filter by a specific tag? The [Get elements by tag](https://www.postman.com/postman/postman-public-workspace/request/0o5vgfj/get-elements-by-tag) endpoint lets you fetch all elements associated with a specific tag so you can take action on them programmatically. ### Secret Scanner The[Secret Scanner](https://www.postman.com/postman/workspace/postman-public-workspace/folder/12959542-129b53d2-77f7-4593-89d5-a5a600e9d80f) endpoints, which programmatically provide the same functionality as the [Secret Scanner dashboard](https://learning.postman.com/docs/administration/managing-your-team/secret-scanner/#secret-scanner-dashboard), allow Enterprise Ultimate customers to manage their secrets detected by the Postman Secret Scanner. You can: - [Search](https://www.postman.com/postman/workspace/postman-public-workspace/request/12959542-d48e6590-8084-4964-adcc-62a597d338a7) detected secrets in a paginated response format. - [Find](https://www.postman.com/postman/workspace/postman-public-workspace/request/12959542-1a41e732-273f-41a0-bbde-5ce0e79f935d) the location of a detected secret. - [Update](https://www.postman.com/postman/workspace/postman-public-workspace/request/12959542-712b0936-0fc0-4b18-95bd-318e1be14809) the resolution status of a detected secret. These endpoints enable you to build automatic notification systems, or to programmatically[resolve](https://www.postman.com/postman/workspace/postman-public-workspace/request/12959542-712b0936-0fc0-4b18-95bd-318e1be14809) detected secrets. ### SCIM Postman supports [SCIM](https://www.postman.com/postman/workspace/postman-public-workspace/folder/12959542-842bb61b-7d6f-4ed0-832b-921e1d08fb43) (System for Cross-domain Identity Management) endpoints, allowing you to automate how users and groups are provisioned in your organization. By integrating with your identity provider, you can manage access to Postman at scale—ideal for larger teams and enterprise environments. The Postman API includes SCIM-specific endpoints that let you provision and deprovision users, manage user groups, and maintain centralized control over access through your IdP. This makes it easier to streamline onboarding and ensure the right people have the right access without the hassle of manual updates. ### API security and governance The [API Security](https://www.postman.com/postman/postman-public-workspace/folder/31xluzv/api-security) endpoints enable you to manage your API’s [security](https://learning.postman.com/docs/api-governance/api-definition/api-definition-warnings/) by performing security checks and validating [governance](https://www.postman.com/product/governance/) rules. For example, the API definition [security validation](https://www.postman.com/postman/postman-public-workspace/request/1kl63um/api-definition-security-validation) endpoint allows you to validate an OpenAPI definition before you publish it. If it passes validation, you can proceed to publish a new version of your API with confidence. ### Audit logs The [Audit Logs](https://www.postman.com/postman/postman-public-workspace/folder/tl4rymv/audit-logs) endpoints enable team admins to monitor and analyze activity within Professional or Enterprise Postman teams. You can review audit logs filtered by specific criteria to track: - When users were added, removed, or invited to the team. - Which user performed an action and the exact time it occurred. These capabilities provide transparency and help maintain security and compliance across your team. ---
**Author:** ![david-espi-hernandez](https://sea2.discourse-cdn.com/getpostman/user_avatar/community.postman.com/david-espi-hernandez/32/25537_2.png) [@david-espi-hernandez](https://community.postman.com/u/david-espi-hernandez)\ **Post date:** [June 11, 2025, 2:02pm UTC](https://community.postman.com/t/manage-and-automate-postman-with-the-api/80977/4 "2025-06-11T14:02:01Z")
The Postman API provides a comprehensive set of endpoints to programmatically manage your Postman resources and streamline organizational workflows. How have you used the Postman API to automate your development processes? Share your use cases and tips with us! ---
**Author:** ![scastrianni-gs](https://avatars.discourse-cdn.com/v4/letter/s/aca169/32.png) [@scastrianni-gs](https://community.postman.com/u/scastrianni-gs)\ **Post date:** [June 12, 2025, 10:40pm UTC](https://community.postman.com/t/manage-and-automate-postman-with-the-api/80977/5 "2025-06-12T22:40:27Z")
My usage of this is Terraform. I am the author of the [postman Terraform provider](https://registry.terraform.io/providers/scastria/postman/latest) which I use for all of my postman admin automation.