Create a public API reference collection and overview collection for your API consumers. When you publish your public APIs, you can invite your API consumers to fork your public collections, and get them to their first 200 OK response fast.
An API reference collection contains your public API's endpoints and their HTTP methods. An overview collection compliments your API reference collection and serves as a starting point for your API consumers.
An API reference collection is a comprehensive list of your public API's endpoints and their HTTP methods, which define your API's operations. It's often based on an API specification, such an OpenAPI definition.
Postman recommends you import your OpenAPI definition to create your API reference collection. If you don't have an OpenAPI definition, you can manually create your API reference collection.
To import your OpenAPI definition to create your API reference collection, do the following:
Postman turns your OpenAPI definition into a Postman Collection. You can continue to edit your API reference collection as your public APIs evolve and you curate your public collections.
To learn more, see Import an API into Postman.
If you don't have an OpenAPI definition, you can manually create your API reference collection.
To manually create your API reference collection, do the following:
You can continue to edit your API reference collection as your public APIs evolve and you curate your public collections.
To learn more, see Create a new collection.
An overview collection compliments your API reference collection. It's a starting point for your API consumers. Use an overview collection to summarize your public APIs and get your API consumers to their first 200 OK response in the fewest steps as possible. You can also showcase your public APIs with common use cases and popular workflows.
To create your public overview collection, do the following:
You can continue to edit your overview collection as your public APIs evolve and you curate your public collections.
To learn more, see Create a new collection.
Last modified: 2025/03/26