---
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.

`page` 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.

`suggestions` can come back empty when the model returns nothing usable, under a 200.

This endpoint is limited to 5 requests per minute.

## 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; anything higher returns the last set.

## Response `200`

Workflow ideas for this app.

- WorkflowSuggestions — Workflow ideas for an app.
  - `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

## Changes

- **2026-08-26** `f2727732ced1` — 1 info
  - endpoint added

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

---

[API](https://skmtc.dev/idealspot/apis/base44-app-management-api.md) · [All operations](https://skmtc.dev/idealspot/apis/base44-app-management-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/idealspot/base44-app-management-api/revisions/31ef75eb64ab/schema)
