Create a file
Changed onCreate a new file in Documents and return a URL to upload the file content to.
Request
- Base URLhttps://api.mitti.com
- AuthHTTP bearer
Request body
An array of folder names that defines the path where the file will be stored. The path is relative to the parent_id if it is provided. If not, it starts from the root folder. The API will automatically create any folders in the path that don’t exist. Each folder name must be 1-255 characters and exclude invalid characters.
The name of the file. Must be between 1-255 characters and exclude invalid characters.
- MEDIA_TYPE_IMAGE: An image file (GIF, JPG, PNG, WEBP).
- MEDIA_TYPE_VIDEO: A video file (MP4, MOV).
- MEDIA_TYPE_PDF: A PDF document.
- MEDIA_TYPE_DOCX: A Microsoft Word document (DOCX, DOC).
- MEDIA_TYPE_XLSX: A Microsoft Excel spreadsheet (XLSX, XLS).
- MEDIA_TYPE_PPTX: A Microsoft PowerPoint presentation (PPTX, PPT).
- MEDIA_TYPE_CSV: A CSV file.
The size of the file in bytes. Must not exceed 50MB. This field is required if file_type is provided.
The ID of the folder where the file should be stored. Any folders defined in the path will be created inside the parent folder. If you don’t provide a parent_id, the file will be stored in the root folder. To get the parent_id, open the folder in the SafetyCulture web app and copy the last part of the URL. For example, in this link https://app.safetyculture.com/documents/9dd76834-65ef-41d3-815c-964df32450e4, the parent ID is 9dd76834-65ef-41d3-815c-964df32450e4.
The file extension of the uploaded blob (e.g. "pdf", "jpg"), without the leading dot. Used to populate the file's extension when the extension cannot be derived from name or the underlying media metadata is unavailable.
Response
A successful response.
The ID of the file that was created.
The URL where you must upload the file’s binary content. It is valid for 20 minutes.
If provided, the full folder path where the file was stored.
The name of the created file.
Changes
- info
added the new optional request property
- info