Trigger AI summarization for dataset files

POST 
/datasets/:id/files/summarize

Starts asynchronous AI summarization for one or more successfully loaded text/pdf files in an s3-target dataset. Caller must have editor or owner access. Datasets AI service must be enabled (else AI-1004). Sets SummaryGenerationStatus to summarizing and starts the AI operations step function. Success Message is "Successfully triggered AI operation: 'summarize' on the dataset." Not idempotent while files are already summarizing/summarized (IPV-1020).

Request

Responses

200

Summarization triggered. Message is "Successfully triggered AI operation: 'summarize' on the dataset."

Response Headers

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

400

Validation or authorization failure. Body is {"Message": " - "}. Codes: AI-1004 (Datasets AI disabled), DS-1040 (non-s3), IPV-1020 (bad/empty/already summarized Files), AUTH-* (not editor+).

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