---
title: "Suggest workflows"
method: GET
path: "/api/apps/{app_id}/workflows/suggestions"
---

# Suggest workflows

`GET /api/apps/{app_id}/workflows/suggestions`

<Info>This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.</Info>

Suggests workflows worth building for this app.

Each suggestion carries a `prompt` you can send straight to [Send chat message](/api-reference/send-chat-message) to have the builder create it. Nothing is saved by calling this.

The `page` param picks between two different sets, so `0` and `1` give you meaningfully different ideas. Anything higher is treated as the last page rather than rejected. Results are cached per app and page, so asking twice returns the same set.

The `suggestions` field can come back empty when the model returns nothing usable. That is still a successful call.

## Path parameters

- `app_id` string, required — ID of the app whose workflows you want to work with.

## Query parameters

- `page` integer — Which set of ideas to return: `0` and `1` give different sets, and anything higher returns the last set.

## Response `200`

Workflow ideas for this app.

- WorkflowSuggestions
  - `suggestions` WorkflowSuggestion[], required — The generated ideas. Can be empty when the model returns nothing usable.
    - `title` string, required — Short name for the suggested workflow.
    - `description` string, required — One sentence explaining what the workflow would do.
    - `prompt` string, required — What to say to the builder to create this workflow. Send it as `content` to [Send chat message](/api-reference/send-chat-message).

## Other responses

- `401` — Missing or invalid credentials.
- `402` — This workspace's plan does not include workflows. Upgrade to Builder or above.
- `403` — You don't have access to this app, the app does not exist, the app still runs the older automations engine instead of workflows, or you used a workspace API key. A missing app and an app you cannot reach are deliberately the same answer.
- `422` — Validation Error
- `429` — Rate limit exceeded. The base limit is 5 requests per minute. See [Rate limits](/developers/references/apps-api/get-started/rate-limits) for the multiplier your plan gets.

## Changes

- **2026-09-18** `f70e515893d2` — 1 info
  - added the non-success response with the status `429`

[Change history](https://skmtc.dev/base44/apis/base44-app-management-api/changes/api/apps/:app_id/workflows/suggestions/get.md)

---

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