List SQL AI training documents

GET 
/nl2sql/training-documents

Returns a paginated list of the SQL AI training documents the caller added. A Super Admin sees every user's documents instead.

Requires SQLAI to be present in the environment's enabled AI services; otherwise the request fails with AI-1004 before authorization is even evaluated.

Items carry only the seven projected summary attributes, not the full document record: fetch GET /nl2sql/training-documents/{id} for the association fields, uploaded files and download URL.

Pagination: read next_available in the response. While it is "yes", request the next page by advancing offset by limit. When it is "no" this was the last page and the client must stop.

Request

Responses

200

Page of training documents. Check next_available to decide whether to request a further page.

Response Headers

Access-Control-Allow-Origin
Access-Control-Allow-Methods
Access-Control-Allow-Headers

400

Input validation or authorization failure. Body is {"Message": " - "}. Codes: AI-1004 (SQLAI is not enabled in this environment), IPV-1050 (limit above 1000), AUTH-1001 (role_id header missing), AUTH-1030 (role lacks playground.view).

Response Headers

Access-Control-Allow-Origin
Access-Control-Allow-Methods
Access-Control-Allow-Headers

500

Backend failure. Also returned when sortby names an attribute that is absent from the projected records. Body is {"Message": " - "}.

Response Headers

Access-Control-Allow-Origin
Access-Control-Allow-Methods
Access-Control-Allow-Headers