# Improvado Automated Recipes API

**Canonical:** https://apis.io/apis/improvado/improvado-automated-recipes-api/  
**Provider:** Improvado — https://apis.io/providers/improvado/  
**Base URL:** https://embedded.improvado.io  
**Documentation:** https://developers.improvado.io/api

Improvado Automated Recipes API is one of 18 APIs that [Improvado](https://apis.io/providers/improvado/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Automated Recipes. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, authentication docs, and rate-limit docs.

Deploy and operate automated recipes through the v3.1 API. An automated recipe turns a template into a SQL view in your workspace destination, built from the extractions the template needs. **Deploying a recipe takes four calls, in this order:** 1. `GET /api/v3.1/automated-recipe-templates/` - pick a template. 2. `POST /api/v3.1/automated-recipes/` - create the recipe. It is created empty. 3. `PUT /api/v3.1/automated-recipes/{recipe_id}/` - supply data sources, connections and accounts. **This step is mandatory.** 4. `POST /api/v3.1/automated-recipes/{recipe_id}/build/` - start the build, then poll `GET /api/v3.1/automated-recipes/{recipe_id}/` until `state` is `ready_to_work` or `failed`. Every path ends with a slash; a `301` means the slash is missing from your URL. With a bearer token the workspace is the one the token was issued for; with cookie authentication, send the workspace id in the `X-IM-WORKSPACE-ID` header. All errors use one envelope - see [Errors](/errors). See the [Deploying recipes](/recipes) guide for the full flow.

## Operations (10)

| Method | Path | Summary |
|---|---|---|
| GET | `/api/v3.1/automated-recipe-templates/` | List recipe templates |
| GET | `/api/v3.1/automated-recipe-templates/{template_id}/` | Get a recipe template |
| GET | `/api/v3.1/automated-recipes/` | List recipes |
| POST | `/api/v3.1/automated-recipes/` | Create a recipe |
| GET | `/api/v3.1/automated-recipes/{recipe_id}/` | Get a recipe |
| PUT | `/api/v3.1/automated-recipes/{recipe_id}/` | Configure a recipe |
| DELETE | `/api/v3.1/automated-recipes/{recipe_id}/` | Delete a recipe |
| POST | `/api/v3.1/automated-recipes/{recipe_id}/build/` | Start a recipe build |
| POST | `/api/v3.1/automated-recipes/{recipe_id}/resetup/` | Recreate a recipe from its template |
| GET | `/api/v3.1/automated-recipes/{recipe_id}/extractions/` | Check recipe extraction tables |

## Machine-readable artifacts (6)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/improvado/refs/heads/main/openapi/improvado-automated-recipes-api-openapi.yml
- **Documentation** — https://improvado.io/llms.txt
- **LLMsTxt** — https://raw.githubusercontent.com/api-evangelist/improvado/refs/heads/main/llms/improvado-site-llms.txt
- **Authentication** — https://raw.githubusercontent.com/api-evangelist/improvado/refs/heads/main/authentication/improvado-authentication.yml
- **RateLimits** — https://raw.githubusercontent.com/api-evangelist/improvado/refs/heads/main/rate-limits/improvado-rate-limits.yml
- **ErrorCatalog** — https://raw.githubusercontent.com/api-evangelist/improvado/refs/heads/main/errors/improvado-error-codes.yml

## Other Improvado APIs (12)

- [Improvado Embedded API v3](https://apis.io/apis/improvado/improvado-embedded-api-v3/)
- [Improvado Customer MCP](https://apis.io/apis/improvado/improvado-customer-mcp/)
- [Improvado Accounts API](https://apis.io/apis/improvado/improvado-accounts-api/)
- [Improvado Authentication API](https://apis.io/apis/improvado/improvado-authentication-api/)
- [Improvado Data source connections API](https://apis.io/apis/improvado/improvado-data-source-connections-api/)
- [Improvado Data sources API](https://apis.io/apis/improvado/improvado-data-sources-api/)
- [Improvado Data tables API](https://apis.io/apis/improvado/improvado-data-tables-api/)
- [Improvado Destination connections API](https://apis.io/apis/improvado/improvado-destination-connections-api/)
- [Improvado Destinations API](https://apis.io/apis/improvado/improvado-destinations-api/)
- [Improvado Extraction templates API](https://apis.io/apis/improvado/improvado-extraction-templates-api/)
- [Improvado Extracts API](https://apis.io/apis/improvado/improvado-extracts-api/)
- [Improvado Iframe API](https://apis.io/apis/improvado/improvado-iframe-api/)

## Tags

Automated Recipes

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/improvado/improvado-automated-recipes-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/improvado/.