Changelog

The Plextera Public API v1 is now available. This release covers document processing, workflow automation, and webhook notifications.

Files

• Upload documents up to 50 MB: PDF, JPEG, PNG, TIFF, WebP, DOCX, XLSX, PPTX, plain text, CSV, HTML, archives, audio, and video.
• Retrieve file metadata and download raw content by fileId.
• Uploaded files are stored in Plextera and can be referenced in Document Insights jobs and workflow runs.

Document Insights

• Submit documents for structured field extraction with POST /document-insights/jobs/extract.
• Route jobs to a specific hub using hubId, or let Plextera determine the hub automatically via metadata key-value pairs, smart classification, or the organization’s default hub.
• Each job follows a QUEUED → PROCESSING → COMPLETED lifecycle; FAILED and REJECTED are terminal error states.
• Retrieve job status and extraction output with GET /document-insights/jobs/{jobId} once outputAvailable: true.
• Submit field-level corrections with POST /document-insights/jobs/{jobId}/feedback to improve hub models.

Workflows

• Trigger workflows configured in Plextera Studio with POST /workflows/{workflowId}/runs.
• Workflows support Document Insights steps, data transformation, and custom processing logic.
• Inspect run state, per-step output, and nested sub-workflow runs with GET /workflow-runs/{runId}.

Event Subscriptions

• Configure HTTPS webhook endpoints to receive push notifications when jobs and runs reach terminal states.
• Subscribe to any combination of document-insights.job.* and workflow.run.* event types.
• Optionally filter subscriptions by workflowId or Document Insights operation.
• All deliveries are signed with HMAC-SHA256 — verify using the X-Plextera-Signature header.
• Pause and resume subscriptions without deleting them.