Creates a new file in Documents and returns a URL to upload the file.
Documents is currently in Early Access and may not be available for your organization. If you're interested, please contact our customer support team or your customer success manager to check if your organization is eligible.
Use this endpoint to upload PDFs, Word documents, spreadsheets, or images to Documents. Files are stored in a centralized location, helping teams work from the most up-to-date version across the web and mobile apps.
You can automatically create folders by specifying the path in your request. The response includes a temporary upload_url (valid for 20 minutes), which you must use to upload the file’s binary content and complete the process.
This endpoint is commonly used to migrate business documents from platforms like SharePoint into SafetyCulture.
Requirements
- SafetyCulture Premium Plan or Enterprise Plan
- "Documents: Administration" permission
- Full seat
- "Edit" document access to create files in a folder
Limitations
- You can upload files up to 50MB in DOCX, DOC, JPEG, JPG, PNG, PDF, XLS, and XLSX formats.
- You can add up to 10,000 files in total. Each folder can contain up to 200 items, which includes both files and subfolders.
Although you can specify each file's name and and description, the endpoint does not support storing external or third-party IDs as metadata. We recommend maintaining your own mapping between SafetyCulture file IDs and your external system IDs.