Improvado

Improvado Recipes API

Work with pre-built recipes that automate common data pipeline workflows. Recipes are templated workflows that combine multiple API operations into reusable patterns. They simplify common tasks like: - Setting up end-to-end data pipelines (source → extract → load → destination) - Configuring multiple related extracts at once - Applying best-practice configurations Recipes accelerate implementation by providing proven patterns for common use cases. **Automated recipes have moved to v3.1.** They are documented under [Automated Recipes](/api/automated-recipes), which is where new integrations should start. The `/api/v3/automated-recipe-templates/` and `/api/v3/automated-recipes/` operations in this tag are deprecated. They keep working until they are switched off, and we will announce the date in advance. See [Moving recipes to v3.1](/recipes-migration) for what changes between the two versions, and [Deploying recipes](/recipes) for the current flow. **Two operations in this tag are not automated recipes and are not deprecated:** `List agency recipes` (`GET /api/v3/recipes/`) and `Enable recipe in a workspace` (`POST /api/v3/workspaces/{id}/recipes`). They use Basic authentication, work with the recipes available to your agency rather than with automated recipes, and have no v3.1 replacement.

Documentation GitHub OpenAPI

Operations 12

POST /api/v3/workspaces/{id}/recipes Enable recipe in a workspace #

GET /api/v3/recipes/ List agency recipes #

GET /api/v3/automated-recipe-templates/ DEPRECATED List automated recipe templates #

GET /api/v3/automated-recipe-templates/{template_id}/ DEPRECATED Get automated recipe template detail #

GET /api/v3/automated-recipes/ DEPRECATED List automated recipes #

POST /api/v3/automated-recipes/ DEPRECATED Create automated recipe #

GET /api/v3/automated-recipes/{recipe_id}/ DEPRECATED Get automated recipe detail #

PUT /api/v3/automated-recipes/{recipe_id}/ DEPRECATED Update automated recipe configuration #

DELETE /api/v3/automated-recipes/{recipe_id}/ DEPRECATED Delete automated recipe #

POST /api/v3/automated-recipes/{recipe_id}/build/ DEPRECATED Build automated recipe #

GET /api/v3/automated-recipes/{recipe_id}/extractions/ DEPRECATED Check the extraction tables a recipe reads #

POST /api/v3/automated-recipes/{recipe_id}/resetup/ DEPRECATED Reset an automated recipe from its template #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/improvado:improvado-recipes-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: Improvado Embedded API v3 Recipes API
  version: 3.0.0
  description: 'Improvado Embedded API V3 provides programmatic access to data extraction, transformation, and loading capabilities.


    ## Authentication


    This API supports multiple authentication methods depending on the endpoint:


    ### Basic Authentication

    Used for workspace-agnostic operations such as:

    - Creating access tokens (`POST /api/v3/token`)

    - Listing workspaces (`GET /api/v3/workspaces`)

    - Managing workspaces (`POST /api/v3/workspaces`, `GET /api/v3/workspaces/{id}`, `PUT /api/v3/workspaces/{id}`)

    - Getting iframe URLs (`POST /api/v3/get_iframe_url`)

    - Listing available recipes (`GET /api/v3/recipes/`)

    etc.


    **Format**: `Authorization: Basic `


    ### Bearer Token Authentication

    Used for workspace-scoped operations after obtaining a token from `/api/v3/token`. The token is scoped to a specific workspace.


    **Format**: `Authorization: Bearer `


    ### Cookie Authentication

    Alternative to Bearer token for browser-based integrations. When using cookie authentication, you must include the workspace ID in the request header.


    **Cookie**: `dts_session_id=`


    **Required Header**: `X-IM-WORKSPACE-ID: `


    ## Workspace Scoping


    Most API operations are workspace-scoped. After authenticating with Basic Auth, obtain a workspace-specific token using `POST /api/v3/token` with the desired `workspace_id`. This token provides access only to resources within that workspace, ensuring isolation between different customers or projects.


    ## Errors


    The automated recipe operations under `/api/v3.1/automated-recipe*` and

    `GET /api/v3.1/connections/{connection_id}/accounts/` return errors as

    `{"code": "...", "message": "...", "details": {...}}`. Branch on `code`, never on the

    message text. See Errors for the catalogue of codes and the shape of `details`.


    All other operations return errors as `{"detail": "error description"}`.'
servers:
- url: https://embedded.improvado.io
tags:


# --- truncated at 32 KB (72 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/improvado/refs/heads/main/openapi/improvado-recipes-api-openapi.yml