Product: Smart Cyber

Supporting Documents

We offer the ability to upload supporting documents, such as a third-party application, for an existing quote request. This is a three step process (with all steps being required) - generating an authorized link for the upload, uploading the document to the returned URL, and then updating the status of the upload to complete. This complete process will make the document available for underwriter review.

The first step, retrieving the url to use to upload the document, looks like this:

MUTATION

underwritingDataCredentials(quoteRequestId: $quoteRequestId, name: $name, size: $size, label: $label)

Product: Smart Cyber
Method: POST
Endpoint: Sandbox: https://api-sandbox.corvusinsurance.com/q Production: https://crowbar.corvusinsurance.com/q
Authentication: Send the headers X-API-KEY, X-USER-EMAIL, X-USER-NAME with every request. See Authentication.

Arguments for underwritingDataCredentials

Required Required to submit Optional

Pass these as variables.

underwritingDataCredentials arguments
Name	Type	Required	Description
quoteRequestId	ID!	Required	Id of the quote request to upload the document for (see Create Quote Request).
name	String!	Required	Name of the document being uploaded.
size	Int	Optional	Size of the document in bytes. Defaults to 1 if omitted.
label	UnderwritingDatumLabel	Optional	Type of document being uploaded. Defaults to `NONE` if omitted. Possible values: `BIND_ORDER, COMPETITOR_APPLICATION, COMPLETED_APPLICATION, LOSS_RUNS, NONE, PREFILLED_RENEWAL_APPLICATION, QUOTE_REQUEST, RANSOMWARE_SUPPLEMENTAL`

mutation UnderwritingDataCredentials($quoteRequestId: ID!, $name: String!, $size: Int, $label: UnderwritingDatumLabel) {  underwritingDataCredentials(    quoteRequestId: $quoteRequestId    name: $name    size: $size    label: $label  ) {    url    upload {      id    }  }}

{  "quoteRequestId": "O-HOSc06SFSt-dZxI98xqg",  "name": "ThirdPartyApplication.pdf",  "size": 482133,  "label": "COMPETITOR_APPLICATION"}

{  "data": {    "underwritingDataCredentials": {      "upload": {        "id": "wrBnCzNsRNS3EPrNweXrTQ"      },      "url": "https://corvus-uploads.s3.amazonaws.com/..."    }  }}

The second step is to use the provided url to upload the document via a PUT request.

The third and final step is to mark the completion of the upload:

MUTATION

completeUpload(id: $id)

Product: Smart Cyber
Method: POST
Endpoint: Sandbox: https://api-sandbox.corvusinsurance.com/q Production: https://crowbar.corvusinsurance.com/q
Authentication: Send the headers X-API-KEY, X-USER-EMAIL, X-USER-NAME with every request. See Authentication.

Arguments for completeUpload

Required Required to submit Optional

Pass these as variables.

completeUpload arguments
Name	Type	Required	Description
id	ID!	Required	Id of the upload provided in the request for upload url (see Supporting Documents).

mutation CompleteUpload($id: ID!) {  completeUpload(id: $id) {    id  }}

{  "id": "wrBnCzNsRNS3EPrNweXrTQ"}

{  "data": {    "completeUpload": {      "id": "wrBnCzNsRNS3EPrNweXrTQ"    }  }}

You can confirm files have been uploaded and are available for underwriting by fetching the quote request (see Get Quote Request) and specifying the following fields:

query GetQuoteRequest($id: ID!) {  quoteRequest(id: $id) {    underwritingData(first: 10) {      edges {        node {          id          upload {            id            name          }        }      }    }  }}

{  "data": {    "quoteRequest": {      "underwritingData": {        "edges": [          {            "node": {              "id": "IgrOPwEERGqMtUkd-31H0A",              "upload": {                "id": "PScKJxViTxCNozPNtoFG2g",                "name": "Test File"              }            }          }        ]      }    }  }}