---
title: "Lists all Recipes which are available in the specified Workspace Id"
method: GET
path: "/recipes"
tags: ["recipes"]
---

# Lists all Recipes which are available in the specified Workspace Id

`GET /recipes`

You need workspace memberships to access this resource

## Query parameters

- `page[size]` integer
- `page[number]` integer
- `workspace_id` string, required
- `include` 'recipe-deployments'
- `search` string

## Response `200`

OK

- object
  - `data` object[], required
    - `id` string, required
    - `type` 'recipe', required
    - `links` object, required
      - `self` string, required
    - `attributes` object, required
      - `allow_modification` boolean — When this attribute is set to true, the Recipe activator can change step configurations before activation. In this scenario, the created integration Flow is not linked to the original recipe, and users do not receive the Recipe's updates.The feature is activated only on Recipe creation and can't be changed.
      - `declarations` object
        - `variables` object[] — List of variables used by steps in a flow
          - `id` string, required
          - `title` string, required
          - `help` object
            - `description` string, required
            - `link` string
        - `credentials` object[] — List of credentials used by steps in a flow
          - `id` string, required
          - `help` object
            - `description` string, required
        - `topics` object[] — List of Topics data used by steps in a flow that will be created upon Recipe activation
          - `id` string, required
          - `schema` object, required — JSON schema describing the objects to be exchanged
      - `visibility` 'workspace' | 'contract' | 'tenant' | 'global', required
      - `info` object, required
        - `title` string, required — Recipe title
        - `author` string
        - `description` string, required — Recipe description. Markdown is supported
        - `short_description` string, required — Recipe short description
      - `flow_templates` object[], required
        - `title` string, required — Flow template title
        - `cron` string — Cron expression to schedule executions for polling flows
        - `type` 'ordinary' | 'long_running', required — Flow template type
        - `graph` object, required — Recipe graph representing component connections
          - `nodes` union[], required
            - union
              - …
          - `edges` object[], required
            - `config` object
              - …
      - `created_at` string, required
      - `updated_at` string, required
      - `version` number
    - `relationships` object, required
      - `user` object, required
        - `data` object, required
          - `id` string, required — User ID
          - `type` 'user', required
        - `links` object, required
          - `self` string, required
      - `workspace` object, required
        - `data` object, required
          - `id` string, required — Workspace ID
          - `type` 'workspace', required
        - `links` object, required
          - `self` string, required
      - `contract` object, required
        - `data` object, required
          - `id` string, required — Contract ID
          - `type` 'contract', required
        - `links` object, required
          - `self` string, required
  - `meta` object, required
    - `page` integer, required
    - `per_page` integer, required
    - `total` integer, required
    - `total_pages` integer, required
  - `included` object[]
    - `data` object, required
      - `id` string, required
      - `type` 'recipe_deployment', required
      - `links` object, required
        - `self` string, required
      - `attributes` object, required
        - `name` string, required — Recipe deployment name
        - `recipe_version` number, required
        - `flows` object[]
          - `id` string, required — Flow id
        - `created_at` string, required
        - `updated_at` string, required
      - `relationships` object, required
        - `recipe` object, required
          - `data` object, required
            - `id` string, required — Recipe ID
            - `type` 'recipe', required
          - `links` object, required
            - `self` string, required
        - `workspace` object, required
          - `data` object, required
            - `id` string, required — Workspace ID
            - `type` 'workspace', required
          - `links` object, required
            - `self` string, required

## Other responses

- `401` — Unauthorized

---

[API](https://skmtc.net/elastic/apis/elastic-io-rest-api-documentation-v2.md) · [All operations](https://skmtc.net/elastic/apis/elastic-io-rest-api-documentation-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/elastic/elastic-io-rest-api-documentation-v2/revisions/411f9f98c01e/schema)