Upload document (Synchronous)
Uploads a document to the DMS for a specific policy. Supports file uploads to designated locations within the policy’s DMS folder structure.
Response timing
Expected API response time is two minutes or less, subject to XFI availability and performance.
Query Parameters
Unique identifier of the policy
Example:20740
Folder location within the DMS structure where the document should be uploaded. Spaces and special characters (%20 for space, %26 for &) are URL-encoded and will be decoded.
Example:Supporting Documents
Reference identifier for the policy (e.g., quote reference)
Example:F0022390
Headers
Identifies the calling system or channel that originated this request. Used for traceability and auditing across the platform.
Example:S01x
Identifier of the end user on whose behalf this request is made, recorded for audit trail purposes.
Example:jsmith
Body
multipart/form-data
Body
File to be uploaded to the DMS
File to be uploaded
Response
text/plain
Response
Document uploaded successfully
Authentication
Query Parameters
Headers
Body
CyberSubmissionRequest
objectShell submission payload — Step 1 of the submission lifecycle (Base → Full → Quote). Reference fields are restricted per field: producer, directAssumed, typeOfBilling, division, producingCompany, marketSource, and insured.insureContacts accept id only; policy.currency, policy.territory, and class accept code only; sectionIdentifier and referenceType accept id only from their fixed value sets. office, mop, and typeOfPlacementBespoke are NOT part of the contract — they are derived/defaulted server-side from division (and, for office, also policy.product and class).
Required. Insured details; insureContacts.id identifies an existing insured contact, otherwise supply companyName + domicile country/state.
Show Child Parameters
Required. Producer (broker) reference. Supply id (producer id only). Optionally include a contactliaison block to attach, create, or update the broker contact liaison recorded on the policy (see ContactLiaisonSubmission).
Show Child Parameters
Required. Policy node (dates, currency, product, territory).
Show Child Parameters
Required. Business type — id only (Direct or Assumed).
Show Child Parameters
Required. id only.
Show Child Parameters
Required. id only.
Show Child Parameters
Required. Written line percentage (e.g. 100).
>= 1
Example:100
Optional. Free-text policy description. Defaulted/derived server-side when omitted.
Example:Cyber primary 2026 renewal
Optional at this step (becomes required at Step 2 — Full). Section identifier — id only (1 = C&C, 2 = Non C&C). Supply here to pre-derive the underwriting template.
Show Child Parameters
Optional. Reference type — id only (1 = EEA, 2 = Non-EEA, 3 = Both). Conditional requirement applies at Step 2 (Full) when the producing entity (derived from division) is MSSL or MEEA.
Show Child Parameters
Optional. Risk class — code only (e.g. { "code": "CY" }).
Show Child Parameters
Optional. Producing company — id only. Required when division is Mosaic Asta Europe.
Show Child Parameters
Optional. Market source — id only.
Show Child Parameters
FullCyberSubmissionRequest
objectFull submission payload — Step 2 of the submission lifecycle (Base → Full → Quote). Extends the Step 1 fields (all optional here, required only when calling this endpoint standalone without a prior /policies/submission/base call) with underwriting data. Required: underWriter, mosaicOccupation, sectionIdentifier. Conditional: referenceType (required when the producing entity, derived from division, is MSSL or MEEA). office, mop, and typeOfPlacementBespoke are NOT part of the contract — derived server-side.
Optional. Already on the DRAFT from Step 1; supply only when calling Full standalone.
Show Child Parameters
Optional. Already on the DRAFT from Step 1. id only.
Show Child Parameters
Optional. Already on the DRAFT from Step 1. Use the top-level policyDescription field for a free-text description.
Show Child Parameters
Optional. id only.
Show Child Parameters
Optional. id only.
Show Child Parameters
Optional. id only.
Show Child Parameters
Optional. Written line percentage (e.g. 100).
>= 1
Example:100
Optional. Free-text policy description. Defaulted/derived server-side when omitted.
Example:Cyber primary 2026 renewal
Optional. Risk class — code only (e.g. { "code": "CY" }).
Show Child Parameters
Optional. Producing company — id only. Required when division is Mosaic Asta Europe.
Show Child Parameters
Optional. Market source — id only.
Show Child Parameters
Required. Section identifier — id only (1 = C&C, 2 = Non C&C).
Show Child Parameters
Conditional. Reference type — id only (1 = EEA, 2 = Non-EEA, 3 = Both). Required when the producing entity (derived from division) is MSSL or MEEA.
Show Child Parameters
Required. Underwriter — id only (e.g. { "id": "8842" }).
Show Child Parameters
Required. Mosaic occupation — id only (e.g. { "id": "198" }).
Show Child Parameters
Optional. Unique Market Reference.
Example:B1234567890
Optional. Insured’s annual revenue or turnover amount.
>= 0
Optional. Producing underwriter — id only. Defaults to the submission underwriter when omitted.
Show Child Parameters
Optional. Lloyd’s industrial sector — id only. When supplied, takes precedence over the server’s automatic derivation.
Show Child Parameters
Optional. sBFClass — id only.
Show Child Parameters
CyberSubmissionResponse
objectResponse object containing cyber submission details including policy information, status, and reference keys
Current status of the policy
Allowed values:Quote PreparationPolicy UpdatedBoundDeclinedReferredQuote NTU
Example:Quote Preparation
Policy number assigned to the submission. Starts with ‘Q’ for quotes, ‘P’ for policies
Match pattern:^[QP]\d{7}$
Example:Q0038456
Business reference number for tracking purposes
Example:CYB-2026-001
Internal policy key identifier used for database references
Example:20894
Internal policy activity key identifier for tracking specific policy activities
Example:45632
Status of the current policy activity
Allowed values:ActiveCompletedPendingCancelledQuote NTU
Example:Active
Quote number assigned when the submission reaches quote stage.
Example:Q0021748