Sign in

v3

latestOpenAPI 3.0.32026-07-21354289.5 KB
File

createFileSummaryJob

Create or return the current AI summary job for a file entity.

post/v1/files/{id}/summary-jobs

Path parameters

string required

Empty string (used when file ID not yet assigned)

OR
string uuid required

Valid UUID v4

The UUID of the file entity

Response

Summary job accepted

job_idstring uuid required

File summary job ID.

status'queued' | 'waiting_for_extraction' | 'processing' | 'completed' | 'failed' | 'unsupported' | 'stale' required

Current state of a file summary job.

errorstring

Human-readable failure or unsupported reason when available.

created_atstring date-time required
updated_atstring date-time required
completed_atstring date-time