v4

latestOpenAPI 3.1.02026-08-01207318738.7 KB

AI Model Suggestions

List model suggestions

Lists AI-generated model suggestions for a shared model, filtered by dismissal status. Requires organization admin permissions.

get/api/v1/models/{modelId}/suggestions

Path parameters

modelIdstring uuid required

UUID of the shared model the suggestions belong to

Example:a1b2c3d4-e5f6-7890-abcd-ef1234567890

UUID of the shared model the suggestions belong to

Query parameters

cursorstring uuid

Cursor for pagination: the nextCursor from the previous response (the last suggestion id).

pageSizeinteger

Number of results per page (1-100, integer)

Example:20

Number of results per page (1-100, integer)

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

Which suggestions to return: active (default, not dismissed), ignored (dismissed only), or all.

Example:active

Which suggestions to return: active (default, not dismissed), ignored (dismissed only), or all.

Response

Paginated list of suggestions

Example response

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