---
title: "List your saved recipes and workflows"
method: GET
path: "/api/v1/recipes"
tags: ["Recipes"]
---

# List your saved recipes and workflows

`GET /api/v1/recipes`

## Request

- Base URL: `https://api.popnow.ai`
- URL: `https://api.popnow.ai/api/v1/recipes`
- Auth: HTTP bearer

Your own recipes and workflows first, then the ones shared with a team you belong to (`mine: false`, with `teamId`).
Each item lists the inputs a run takes, in order. Prompts are never listed; the server assembles them at run time.
`estimatedCredits` is `null` here; read one item to get its current price.

## Query parameters

- `kind` 'recipe' | 'workflow'

## Response `200`

Your recipes and workflows.

- object
  - `code` 200, required
  - `msg` string, required
  - `data` object, required
    - `items` SavedRecipe[], required
      - `id` string, required
      - `kind` 'recipe' | 'workflow', required
      - `name` string, required
      - `mine` boolean, required
      - `teamId` string: The team that shared it (only on items that aren't yours).
      - `media` 'image' | 'video' | 'audio', required
      - `inputs` object[], required
        - `id` string, required
        - `label` string
        - `media` 'image' | 'video' | 'audio' | 'text', required
        - `multiple` boolean, required
        - `required` boolean, required: No material was saved for it, so a run must give one.
      - `steps` integer, required
      - `estimatedCredits` integer, nullable, required
      - `prompt` string: Only for your own recipes.
      - `updatedAt` string, date-time, required

## Other responses

- `400`: Invalid JSON, query, callback URL, model input, or media declaration. Invalid callBackUrl values return code 400 and msg "Invalid callback URL" with request_id. Submitted hosts, IP addresses, and DNS diagnostics are not echoed.
- `401`: Missing, malformed, expired, revoked, or otherwise invalid API key.
- `429`: Account-level request limit exceeded.
- `500`: Internal failure. Details are not exposed; report `request_id` to support.

## Changes

- **2026-10-20** `fede911a6e9b`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/popnow/apis/popnow-api/changes/api/v1/recipes/get.md)

---

[API](https://skmtc.dev/popnow/apis/popnow-api.md) · [All operations](https://skmtc.dev/popnow/apis/popnow-api/llms.txt) · [OpenAPI document](https://skmtc.dev/popnow/apis/popnow-api/revisions/fede911a6e9b?raw)