> ## Documentation Index
> Fetch the complete documentation index at: https://docs.base44.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Suggest workflows

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



## OpenAPI

````yaml /developers/references/app-management/app-management-openapi.json get /api/apps/{app_id}/workflows/suggestions
openapi: 3.1.0
info:
  title: Base44 App Management API
  version: 1.0.0
servers:
  - url: https://app.base44.com
security:
  - ApiKeyAuth: []
paths:
  /api/apps/{app_id}/workflows/suggestions:
    get:
      summary: Suggest workflows
      description: >-
        <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.
      operationId: get_workflow_suggestions_api_apps__app_id__workflows_suggestions_get
      parameters:
        - name: app_id
          in: path
          required: true
          schema:
            type: string
            description: ID of the app whose workflows you want to work with.
            title: App Id
          description: ID of the app whose workflows you want to work with.
          example: 6820f3a4e7b91d003c45a1f2
        - name: page
          in: query
          required: false
          schema:
            type: integer
            minimum: 0
            description: >-
              Which set of ideas to return. `0` and `1` give different sets;
              anything higher returns the last set.
            default: 0
            title: Page
          description: >-
            Which set of ideas to return. `0` and `1` give different sets;
            anything higher returns the last set.
          example: 0
      responses:
        '200':
          description: Workflow ideas for this app.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WorkflowSuggestions'
        '401':
          description: Missing or invalid credentials.
        '402':
          description: >-
            This workspace's plan does not include workflows. Upgrade to Builder
            or above.
        '403':
          description: >-
            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':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    WorkflowSuggestions:
      properties:
        suggestions:
          items:
            $ref: '#/components/schemas/WorkflowSuggestion'
          type: array
          title: Suggestions
          description: >-
            The generated ideas. Can be empty when the model returns nothing
            usable.
          example:
            - description: Send yourself an email whenever someone creates an account.
              prompt: >-
                Create a workflow that emails me whenever a new User record is
                created.
              title: Email me new signups
      type: object
      required:
        - suggestions
      title: WorkflowSuggestions
      description: Workflow ideas for an app.
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    WorkflowSuggestion:
      properties:
        title:
          type: string
          title: Title
          description: Short name for the suggested workflow.
          example: Email me new signups
        description:
          type: string
          title: Description
          description: One sentence explaining what the workflow would do.
          example: Send yourself an email whenever someone creates an account.
        prompt:
          type: string
          title: Prompt
          description: >-
            What to say to the builder to create this workflow. Send it as
            `content` to [Send chat message](/api-reference/send-chat-message).
          example: >-
            Create a workflow that emails me whenever a new User record is
            created.
      type: object
      required:
        - title
        - description
        - prompt
      title: WorkflowSuggestion
      description: One workflow idea generated for the app.
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: api_key
      description: Personal API key.

````