API Evangelist API Evangelist
API Learnings
Toolbox
API Evangelist LLC

Postman Workspace

A Postman Workspace provides a dedicated space to manage API contracts within a domain, complimenting other types of workspaces, allowing for private, partner, and public workspaces to exist for managing API operations.

Rules

APIs.json Apis Properties Postman Public Workspace Info

This property so that an API is associated with a Postman Workspace, giving a single location that API producers and/or API consumers can engage around an API

Strategies

APIs Operations Possess Dedicated Workspaces

Workspaces are the virtual factory floor where the real work happens. Every domain, line of business, and team needs a dedicated one. This is where collaboration and automation actually take place....

API Development Is Collaborative Across Teams

API development is not just an engineering exercise--it requires product, engineering, and operations all working together. Shared workspaces, design reviews, cross-functional feedback loops--these...

Experiences

Access

I keep seeing teams struggle with getting consumers proper access to their APIs. The sign-up, authentication, and authorization process is where you lose people before they ever make their first AP...

Automation

I keep shining a light on automation because it's the only way to scale API operations. When testing, validation, deployment, and governance are all manual, you're just adding human error and slowi...

Communication

I struggle with how little communication happens between the teams producing APIs and the people consuming them. Blogs, changelogs, roadmaps -- these are building blocks that most teams just skip, ...

Discovery

Discovery is the dark matter of the API landscape. Teams build APIs that already exist somewhere else, and consumers can't find the APIs they need. Without a catalog and proper metadata, you're jus...

Onboarding

I see teams dealing with massive friction during onboarding. If a consumer can't get from zero to their first successful API call in minutes, you've already lost them. Getting started guides, sandb...

Self-Service

Self-service is the goal I keep pushing teams toward. If a consumer can't find your API, sign up, get keys, and make their first call without emailing someone, you've created a bottleneck that will...