Adds rich media objects (images, videos, etc.) to an existing entity.
Placeholder entities cannot be updated.
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.
Supported file types are: txt, pdf, video (mp4, mov, wmv, avi, mkv), images (png, jpg, tiff, gif, raw, eps). The max file size is 5 MB per file.
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.
--form 'document_front=@/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.png",
"media_type": "IMAGE_DRIVERS_LICENSE_FRONT",
"custom_data": {
"internal_notes": "Reviewed by Mitchell on 31 June 2019",
"reviewers": 3,
"login": 1638384860,
"timestamp": "2012-03-40 05:12:41.000Z",
"daily_email": true,
"employees": ["John", "Anna", "Peter"],
"socure_device_session_id": "12121212121212112"
}
}]
media
and name
are the only required fields for each media object. The name
must include the file extension such a File.pdf
. 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 |