API collection management FAQs
Get answers to frequently asked questions (FAQs) about API collection management.
What is an API collection, and why is it used in Workato?
View answer
An API collection is a grouping of API endpoints that share a common access pattern, allowing them to be managed together. API collections are used to organize and manage related endpoints efficiently.
How can I access the API collections page in Workato?
View answer
To access the API collections page:
Log in to Workato and navigate to the workspace you plan to access the API collections page for.
Click to Platform > API platform > API collections.
What are the three types of API collections available at Workato?
View answer
There are three types of API collections available at Workato:
- API proxy collections
- API recipe collections
- AI gateway collections
What is an API recipe collection, and how does it work?
View answer
An API recipe collection consists of endpoints created from individual API recipes, with one recipe corresponding to one endpoint. API recipe collections enable you to make powerful API endpoints accessible to both internal and external users, even those without a Workato account.
Before creating an API recipe collection, you must create a project, create a folder within the project, and add one or more API recipes to the folder.
What is an API proxy collection, and what is it's purpose?
View answer
An API proxy collection contains proxy endpoints that act as intermediaries between API clients and servers. It adds a layer of security and control to internal APIs. This makes it easier to manage and monitor access control features.
To create API proxy collections, you must create a project and set up an HTTP connection to forward requests to.
How do I choose between an API recipe collection and an API proxy collection?
View answer
Your choice depends on your use case. API recipe collections are suitable when you plan to build your own backend, allowing customization of data retrieval and processing. API proxy collections are ideal for forwarding requests to existing backend APIs with minimal latency.
What settings can be configured for API collections, and where can I find them?
View answer
To find and configure your API collections settings:
Log in to Workato and navigate to the workspace you plan to access the API collections page for.
Click to Platform > API platform > API collections > Settings.
Configuration settings include:
- Version tags
- Descriptions
- URL settings
- Sharing options
- Ability to sync the collection to Postman
How can I synchronize an API collection with Postman?
View answer
To sync an API collection with Postman:
Log in to Workato and navigate to the workspace you plan to access the API collections page for.
Click to Platform > API platform > API collections.
Select Settings > Sync to Postman.
Connect to your Postman instance and configure the location for the collection to complete the synchronization.
Is there machine-readable documentation available for API collections?
View answer
Yes, machine-readable documentation in the form of OpenAPI specifications is available for API collections. You can download the OpenAPI spec for an API collection from the upper-right corner of the API collection page.
Last updated: