Get AI-generated summary for a dataset file

GET 
/datasets/:id/files/summarize

Returns SummaryGenerationStatus and SummaryMetadata for a single dataset file. Required query file-name (else IPV-1020). File must exist in the dataset files table (else IPV-1002). Datasets AI service must be enabled (else AI-1004). Safe to retry (read-only).

Request

Responses

200

Summary status and metadata returned (GetSummaryResponse). SummaryGenerationStatus may be pending, summarizing, completed, etc. SummaryMetadata includes Summary and ApprovalStatus when generated.

Response Headers

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

400

Validation or authorization failure. Body is {"Message": " - "}. Codes: IPV-1020 (missing file-name), IPV-1002 (unknown file), AI-1004, AUTH-*.

Response Headers

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

500

Something went wrong at backend. Input, permission and file-state errors - such as an unsupported file type, a file that is already processed, or a dataset you cannot access - are also reported here.

Response Headers

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