For larger files, the preferred method is send the data directly to cloud storage.
The response includes a signed url that will allow the client to upload directly to the cloud storage provider. The signed url is only valid for a short period of time.
Refreshing the inspection media object will return a new signed url.
Media objects are contained by a project or a checklist instance. The name of the media object is unique within the project or checklist instance.
If a duplicate name is found, the system will append a number to the end of the name to make it unique. After a few attempts to rename the system will return an error.
client_id is a unique identifier for the media object in the entire workspace. If a media object with the same client_id is found, the system will return an error.
client_id needs to be unique or null.
After file upload, the system will process the media to:
- extracting metadata (GPS, EXIF, etc.)
- generating thumbnails and preview images
- convert video to a streamable format
The state is set to UPLOADED after the file is uploaded and processed.
Required permissions:
- (IsAuthenticated AND HasRolePermissions) OR APIKeyRequired