Adds rich media objects (images, videos, etc.) to an existing alert.

This endpoint is useful for sending in rich media such as profile pictures, ID card scans, official documents etc. that you want available for investigative and verification purposes.

The payload to this endpoint can either be a form-data or a base64 encoded media file via the requests JSON body.

Form-data sent to this endpoint must use the key media_key and the value as the media file. If you wish to provide optional information, use the media_key and provide stringified JSON data as the value. There are no required fields in each media file's supplementary form data. However, if a recognized media_type value is provided, the Unit21 system will be able to use the media object for purposes such as document verification.

    --form '[email protected]/src/103031/images/document_front.jpg' \
    --form 'document_front={"media_type": "IMAGE_ID_CARD_FRONT", "source": "passport_app", "timestamp": 1572673229}'

Base64 encoded media objects must follow the format:

  {
    "media": "iVBORw0KGgoAAAANSUhEUgAAAQMAAADCCAYAAABNEqduAAAgAElEQVR4Aey9CbgmV1Xv...",
    "name": "Drivers License",
    "media_type": "IMAGE_DRIVERS_LICENSE_FRONT",
    "custom_data": {
      "internal_notes": "Reviewed by Mitchell on 31 June 2019"
    }
  }

media and name are the only required fields for each media object. Supplementary form data is sent through the optional custom_data object.

Recognized values of media_type are:

media_type
IMAGE_PROFILE_PICTURE
IMAGE_DRIVERS_LICENSE_FRONT
IMAGE_DRIVERS_LICENSE_BACK
IMAGE_PASSPORT_FRONT
IMAGE_ID_CARD_FRONT
IMAGE_ID_CARD_BACK
IMAGE_FACE_IMAGE
Language
Authentication
Header
URL
Click Try It! to start a request and see the response here!