Finalize a file upload and trigger analysis
Confirms that the bytes were uploaded and starts background content extraction (status becomes analyzing). Only call this after the PUT to the presigned URL has completed: the API checks that the stored object exists and has exactly sizeBytes bytes, and returns 412 PRECONDITION_FAILED until it does.
Safe to call multiple times: if the file is already analyzing or analyzed, the call does nothing and still returns ok: true. If the file is failed, calling it again retries extraction. Extraction runs after the response: Excel, CSV, plain-text and Word files are converted locally; PDFs go through OCR and images are described by an AI model. Poll GET .../uploaded-files for the result.
Request
- Base URLhttps://vetnio.com/api/v2
- URLhttps://vetnio.com/api/v2/workspaces/{workspaceId}/consultations/{consultationId}/uploaded-files/{fileName}/finalize
- AuthHTTP bearer
Path parameters
Opaque identifier of the Vetnio workspace (veterinary clinic) that owns the resource. Scopes every request — callers can only access files under workspaces they are a member of.
Identifier of the consultation (a single veterinary visit) the file is attached to. The consultation must belong to the same workspace as the authenticated caller.
Stable internal identifier for the file — a server-generated UUID returned by initUpload. Used in every subsequent endpoint (finalize, download, delete). Not intended for display; use originalFileName for that.
Response
Extraction scheduled (or already in progress / completed).
Example response
{
"ok": true
}Changes
No recorded changes to this operation across all 1 revision of this API.