Risk Item Asset Management

With the InsureHero Shield API you can upload assets in behave of your risk items. This creates a repository of assets for each risk item. Then users can request public URLs to these assets to attach them to: risk items, claims, events and more.

Good to know

Attaching assets to entities like claims & events is a 2 step process.

• First assets are uploaded to a private repository. A public URL is returned for each of the uploaded assets.

• Then you create/update an entity with the given URLs.

Upload assets

When needed allow users to upload assets to their private repositories.

Upload assets to a risk item

POST https://app.insurehero.io/api/shield/v1/risk-items/:riskItemId/assets

When you need to add documents, videos or any other type of asset to backup a claim or attach evidence to a risk item event, you will first need to upload those assets to a risk item.

Path Parameters

Name	Type	Description
riskItemId*	string	The id of a given risk item
name	string	Provides descriptive context for the file being uploaded. If you do not provide a name, the name of each loaded asset will be taken as the value

Headers

Name	Type	Description
Authorization*	string	Bearer access token
Content-Type*	string	multipart/form-data

Request Body

Name	Type	Description
files*	Blob[]	The list of files to be uploaded

200: OK Upload finished

Each file will be returned with a success or fail status and a public URL in the case of a success.

400: Bad Request Request contains malformed data

401: Unauthorized Invalid or expired access token

402: Payment Required Pending payment

422: Unprocessable Entity Internal validation failed

429: Too Many Requests API rate limit

Keep in mind

• The maximum file size is 4Mb per file.

• Only images, videos & PDF MIME types are supported.