v1

latestOpenAPI 3.1.02026-07-2618690613.4 KB

AI Model Suggestions

List AI-generated suggestions

<Note> This endpoint requires **Organization Admin** permissions. </Note>

Lists AI-generated suggestions for a shared model. Suggestions can be filtered by status and are returned with keyset-based pagination.

Suggestions are sorted by priority, creation date, and ID for stable pagination.

get/v1/models/{modelId}/suggestions

Path parameters

modelIdstring uuid required

The ID of the shared model to list suggestions for.

Query parameters

status'active' | 'ignored' | 'all'

Filter suggestions by status:

active - Only active suggestions (default)
ignored - Only ignored suggestions
all - All suggestions regardless of status

cursorstring

Cursor for keyset-based pagination. Use the id from the last suggestion in the previous page.

pageSizeinteger

Number of suggestions to return per page. Defaults to 25, maximum 100.

Response

List of suggestions for the model

Example response

{
  "records": [
    {
      "category": "missing_context",
      "priority": 1,
      "proposedChanges": {
        "edits": [
          {
            "field": "ai_context",
            "target": "views.orders"
          }
        ]
      }
    }
  ]
}