Workato docs Return to Workato
Edit this page
GitHub (opens new window)
  • Introduction
  • Getting started
  • Product Updates (opens new window)
  • Concepts
  • Connecting apps
  • Building recipes

  • Running recipes

  • Troubleshooting

  • Data types and formulas

  • Tools
  • Files and attachments

  • Batch processing

  • Teams and collaboration
  • People Task by Workato
  • Recipe lifecycle management
  • On-prem connectivity
  • Key features
  • Workbot for Slack
  • Workbot for MS Teams
  • Workbot for Workplace
  • API Platform
  • Connectors

  • Universal connectors
  • Community connectors
  • Connector SDK
  • Custom OAuth profiles
  • Workato API
  • Security
  • Training & Certification
  • Contact us

# API Collections Management

The API collections tab displays all API collections under this account (individual or team account). Navigate to this page by clicking on the API Collections tab. You will see something like this:

API Collection Tab API Collections Tab

The next step is to organize these recipes into one or more API Collections. Generally, an API Collection should contain endpoints whose access pattern has some common features, so that you can manage them together. For example, a set of Salesforce endpoints that are intended to be called by recipes used with the Sales team might be put together in an API Collection.

API Collections are versioned, using a unique 1-10 character version identifier. Collections with the same name but different versions are distinct objects.

In this guide, we will go through API collection configurations:

  • How to create an API collection
  • How to edit an API collection
  • How to activate an API endpoint
  • How to customize URL path for API collection
  • How to obtain machine-readable documentation (OpenAPI)

In a separate guide, we will go through API endpoint configuration.

# Creating an API Collection

Click on Add new API Collection to create a new collection.

Step Description
1. Provide information about the Collection name, Version, and Description. Also, select a Recipe folder from which the endpoints will be retrieved from.
Select API Source dialogSelect API Source dialog

It may be helpful to place recipes whose endpoints belong to the same API Collection within the same folder. An API Collection can be associated with a folder so that any new callable recipes added to the folder will be included in the collection automatically (they are not, however, automatically enabled for external calling).
2. This screen shows a list of the endpoints that will be initially placed into your collection from the folder you have selected. Don't worry if more endpoints are included than you actually intend to use. You can edit the list later.
Review endpointsReview endpoints

Click on Create API Collection to create the collection. This returns you to the API Collections list, where you will see the new collection listed.

# Editing an API Collection

Once you have created an API collection, click on an API collection open up the collection overview page. From this page, you can add, remove, or edit endpoints that are available within this collection.

API collection overview API collection overview

# Activating or Deactivating an Endpoint

Control the recipes that are callable from this API collection page. When first created as part of creating an API Collection, or when first added to an existing collection, an endpoint is set to the Inactive state.

State Description
Active Active endpoints are callable from API requests. To set an endpoint to the Active state, the recipe associated with the endpoint must first be running.
Inactive Inactive endpoints cannot be called remotely. Using this slider to toggle to Inactive does not, however, stop the associated recipe.

# Customize URL path for API collection

API collection URL paths are sub-directory paths that you can use to define your API collection. For example, you can use the path prefix to differentiate collections for sales, marketing, or HR.

Navigate to this page by selecting your desired API collection > click on the Settings tab, and selecting URL settings on the left menu.

Customize endpoint URL Customize endpoint URL

You can edit the URL path for this collection. Workato recommends using a meaningful name and standardizing the name across development teams. Having standardized collection names across your company will simplify the recipe export process during versioning changes and updates between development, testing, and production-ready endpoint.

WARNING

oauth2 is a reserved namespace. A collection path that begins with oauth2/* is not allowed.

TIP

New Workato collections are automatically configured with a custom path prefix. For more information on path prefixes, see here.

# Machine-readable documentation (OpenAPI)

The API Collection page has a link in the upper-right corner, labeled Download OpenAPI spec. This gives you access to a downloadable file that contains documentation for all the endpoints within the collection, in a format that can be used by tools like Postman. This format is called OpenAPI, also known as Swagger. Currently, Workato supports version 2.0 (opens new window) of the specification.

# More information

Read our walkthrough for API endpoint configuration:

  • How to activate an API endpoint
  • How to view individual endpoint
  • How to test individual endpoints

← Dashboard API Endpoints →

Didn’t find what you are looking for?
Search our resource library View getting started guides, tutorials, training videos, webinars and FAQ Ask our community View questions and answers from other users and Workato experts. File a support ticket File a support ticket for critical issues that require a higher level of support.
Privacy Terms (844) 469-6752 Workato 2021