Submit documents for compliance processing

Upload and submit documents for compliance processing in one call.

Multi-file support: Upload parent document with optional appendices. First file = parent, remaining files = children.

Submission Modes (Mutually Exclusive): Provide EITHER businessEntityId (creates new compliance review) OR complianceReviewId (appends to existing review). Cannot provide both or neither.

Control (Optional for Mode B): When using businessEntityId, you can optionally provide controlId.

• If provided, the framework is looked up from the control automatically.
• If omitted, the partner’s default control and framework are used.
• Validated against the partner’s whitelist. These are ignored when using complianceReviewId (the existing review already has them).

Control Item Selection: Use selectedControlClusterIds, selectedControlItemIds, or both to narrow the analysis scope:

• Both provided → union of cluster items and individual items
• Clusters only → all non-obsolete items within those clusters
• Items only → only those specific items
• Neither → all non-obsolete items across the entire control (default)

Invalid cluster IDs (not belonging to the active control) return 422.

Fire-and-forget: Returns immediately after upload. Poll /status endpoint for processing progress.

Supported formats: PDF, DOCX, XLSX, PPTX (auto-converted to PDF)

Limits:

• Maximum 50MB per file

Form Fields:

• files - Required. One or more files to process
• businessEntityId - Required if no complianceReviewId. Business entity ID for new review
• complianceReviewId - Required if no businessEntityId. Existing review ID to append to
• controlId - Optional with businessEntityId. Uses partner’s default control if omitted
• selectedControlItemIds - Optional. JSON array of control item IDs
• selectedControlClusterIds - Optional. JSON array of cluster ULIDs. All non-obsolete items within those clusters are included. Unioned with selectedControlItemIds if both are provided.
• auditLanguageId - Optional. Language ID for audit output