Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Workato Recipes API

Recipes are automated workflows that connect applications and services. Manage recipe lifecycle including creation, activation, and versioning.

Workato Recipes API is one of 11 APIs that Workato publishes on the APIs.io network, described by a machine-readable OpenAPI specification and an AsyncAPI event-driven specification.

This API exposes 2 JSON Schema definitions.

Tagged areas include Recipes. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, authentication docs, an API reference, rate-limit docs, an AsyncAPI specification, and 2 JSON Schemas.

This API exposes 12 operations across 8 paths, and defines 5 schemas. It is described by OpenAPI 3.1.0, at version 1.0.

Requests are made against 5 base URLs: https://www.workato.com, https://app.eu.workato.com, https://app.jp.workato.com, https://app.sg.workato.com, https://app.au.workato.com.

12 operations 8 paths 5 schemas 1 DELETE5 GET3 POST3 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
1.0
Servers
https://www.workato.com
https://app.eu.workato.com
https://app.jp.workato.com
https://app.sg.workato.com
https://app.au.workato.com
Authentication
HTTP Bearer
Terms of Service
Resource Areas
1

Authentication & Security 1

Workato Recipes API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (bearerAuth). By default, every request must be authenticated.

  • bearerAuth — API client token obtained from the Workato platform. Include as Authorization: Bearer {token}.

Paths & Operations 12

Across 8 paths, the API surfaces 12 operations — 1 DELETE, 5 GET, 3 POST, 3 PUT. Each is listed below with its method, path, parameters, and response codes.

Recipes 12

Recipes are automated workflows that connect applications and services. Manage recipe lifecycle including creation, activation, and versioning.

GET
/api/recipes
Workato List Recipes
listRecipes 11 params → 200401
POST
/api/recipes
Workato Create a Recipe
createRecipe body → 200400401
GET
/api/recipes/{id}
Workato Get a Recipe
getRecipe 1 param → 200401404
PUT
/api/recipes/{id}
Workato Update a Recipe
updateRecipe 1 param body → 200400401404
DELETE
/api/recipes/{id}
Workato Delete a Recipe
deleteRecipe 1 param → 200401404
PUT
/api/recipes/{id}/start
Workato Start a Recipe
startRecipe 1 param → 200401404
PUT
/api/recipes/{id}/stop
Workato Stop a Recipe
stopRecipe 1 param → 200401404
POST
/api/recipes/{id}/copy
Workato Copy a Recipe
copyRecipe 1 param → 200401404
GET
/api/recipes/{recipe_id}/versions
Workato List Recipe Versions
listRecipeVersions 3 params → 200401404
GET
/api/recipes/{recipe_id}/versions/{id}
Workato Get a Recipe Version
getRecipeVersion 2 params → 200401404
GET
/api/recipes/{recipe_id}/health
Workato Get Recipe Health Report
getRecipeHealth 1 param → 200401404
POST
/api/recipes/{recipe_id}/health
Workato Queue Recipe Health Analysis
queueRecipeHealthAnalysis 1 param → 200401404

Schemas 5

The contract defines 5 schemas that model the data the API accepts and returns. The most detailed are Recipe (11 properties), RecipeVersion (4 properties), ErrorResponse (2 properties), RecipeInput (1 property). Each schema is shown below with its type and property counts.

RecipeVersion
object
A specific version snapshot of a recipe.
4 properties
SuccessResponse
object
Standard success response.
1 property
Recipe
object
A Workato recipe representing an automated workflow.
11 properties
RecipeInput
object
Input schema for creating or updating a recipe.
1 property
ErrorResponse
object
Standard error response.
2 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

workato-recipes-api-openapi.yml Raw ↑

Other APIs Workato publishes across the network.

Workato Embedded Partner API
Workato Data Tables API
Workato Genies API
Workato Knowledge Bases API
Workato MCP Servers API
Workato Messages API
Workato Policies API
Workato Skills API
Workato Tools API
Workato User Groups API