---
title: "Get agent setup suggestions"
method: GET
path: "/api/apps/{app_id}/agent-configs/setup-suggestions"
---

# Get agent setup suggestions

`GET /api/apps/{app_id}/agent-configs/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>

## Path parameters

- `app_id` string, required — ID of the app whose agents to read.

## Query parameters

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

## Response `200`

Suggested agents for the app.

- AgentSetupSuggestionsResponse — Suggested agents for the app.
  - `suggestions` AgentSetupSuggestion[], required — Up to 3 suggested agents. The list is empty if none could be generated.
    - `title` string, required — Short name for the suggested agent, up to 40 characters.
    - `description` string, required — One sentence on what the agent does for the app's users, up to 110 characters.
    - `prompt` string, required — Message you can send to the app's AI chat to have it build the agent, up to 300 characters.

## Other responses

- `401` — Missing or invalid credentials.
- `403` — You don't have access to this app, your API key is read-only, or you used a workspace API key.
- `404` — App not found.
- `422` — `page` isn't `0` or `1`.
- `429` — Too many requests for this app in the last minute from personal API keys in your workspace.

## Changes

> 28 revisions in range; 1 not diffed.

- **2026-09-29** `d2b7ac8beb0c` — 1 info
  - endpoint added

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

---

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