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

# Get agent setup suggestions

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

Returns up to 3 agents worth adding to the app, based on its name, description, data entities, and the agents it already has. They're the suggestions the builder shows on the app's Agents page.

Each suggestion carries a `prompt` you can send to the app's AI chat to build that agent. Nothing is created by this call.

Suggestions are generated by AI and kept for 24 hours for each app and `page`, so changes to the app show up in them after that. Generating them doesn't use the workspace's credits.

This is limited to 10 requests a minute per app for each workspace's personal API keys, so every key in a workspace shares one allowance. Some workspaces have a different limit.

<Note>This endpoint accepts a full-access personal API key from anyone with access to the app, viewers included. Read-only keys and workspace API keys are not authorized for it, because a call can start AI generation.</Note>



## OpenAPI

````yaml /developers/references/app-management/app-management-openapi.json get /api/apps/{app_id}/agent-configs/setup-suggestions
openapi: 3.1.0
info:
  title: Base44 App Management API
  version: 1.0.0
servers:
  - url: https://app.base44.com
security:
  - PersonalAccessTokenAuth: []
paths:
  /api/apps/{app_id}/agent-configs/setup-suggestions:
    get:
      summary: Get agent setup suggestions
      description: >-
        <Info>This API is in beta. Endpoints, fields, and behavior may still
        change, so avoid depending on it in production.</Info>


        Returns up to 3 agents worth adding to the app, based on its name,
        description, data entities, and the agents it already has. They're the
        suggestions the builder shows on the app's Agents page.


        Each suggestion carries a `prompt` you can send to the app's AI chat to
        build that agent. Nothing is created by this call.


        Suggestions are generated by AI and kept for 24 hours for each app and
        `page`, so changes to the app show up in them after that. Generating
        them doesn't use the workspace's credits.


        This is limited to 10 requests a minute per app for each workspace's
        personal API keys, so every key in a workspace shares one allowance.
        Some workspaces have a different limit.


        <Note>This endpoint accepts a full-access personal API key from anyone
        with access to the app, viewers included. Read-only keys and workspace
        API keys are not authorized for it, because a call can start AI
        generation.</Note>
      operationId: >-
        get_setup_suggestions_api_apps__app_id__agent_configs_setup_suggestions_get
      parameters:
        - name: app_id
          in: path
          required: true
          schema:
            type: string
            description: ID of the app whose agents to read.
            title: App Id
          description: ID of the app whose agents to read.
          example: 6820f3a4e7b91d003c45a1f2
        - name: page
          in: query
          required: false
          schema:
            type: integer
            maximum: 1
            minimum: 0
            description: >-
              Which set of suggestions to return. `0` covers the assistants
              users expect right away, and `1` covers agents that keep users
              engaged and follow up with them. Defaults to `0`.
            default: 0
            title: Page
          description: >-
            Which set of suggestions to return. `0` covers the assistants users
            expect right away, and `1` covers agents that keep users engaged and
            follow up with them. Defaults to `0`.
          example: 1
      responses:
        '200':
          description: Suggested agents for the app.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgentSetupSuggestionsResponse'
        '401':
          description: Missing or invalid credentials.
        '403':
          description: >-
            You don't have access to this app, your API key is read-only, or you
            used a workspace API key.
        '404':
          description: App not found.
        '422':
          description: '`page` isn''t `0` or `1`.'
        '429':
          description: >-
            Too many requests for this app in the last minute from personal API
            keys in your workspace.
components:
  schemas:
    AgentSetupSuggestionsResponse:
      properties:
        suggestions:
          items:
            $ref: '#/components/schemas/AgentSetupSuggestion'
          type: array
          title: Suggestions
          description: >-
            Up to 3 suggested agents. The list is empty if none could be
            generated.
      type: object
      required:
        - suggestions
      title: AgentSetupSuggestionsResponse
      description: Suggested agents for the app.
    AgentSetupSuggestion:
      properties:
        title:
          type: string
          title: Title
          description: Short name for the suggested agent, up to 40 characters.
          example: Order Tracker
        description:
          type: string
          title: Description
          description: >-
            One sentence on what the agent does for the app's users, up to 110
            characters.
          example: Tells customers where their order is and when it should arrive.
        prompt:
          type: string
          title: Prompt
          description: >-
            Message you can send to the app's AI chat to have it build the
            agent, up to 300 characters.
          example: >-
            Create an agent that answers customers' questions about their Order
            status and delivery date.
      type: object
      required:
        - title
        - description
        - prompt
      title: AgentSetupSuggestion
      description: One suggested agent.
  securitySchemes:
    PersonalAccessTokenAuth:
      type: http
      scheme: bearer
      description: 'Personal access token, sent as `Authorization: Bearer <token>`.'

````