Create a report

This endpoint lets you create an empty report in Sigma, enabling you to build presentation-ready documents for sharing insights with stakeholders.

Usage notes

• The name parameter is required to provide a name for the new report.
• Use the folderId to specify the folder in which to save the report. Retrieve the folderId by calling the /v2/files endpoint and reviewing the id field in the response for files with a type of folder.

Usage scenarios

• Reliable export formatting: Users can quickly generate a new blank report to create predictable, paginated exports.

Best practices

• Naming conventions: Establish and follow consistent naming conventions for reports to make it easier to manage and identify them within larger projects.
• Folder organization: Use the folderId to organize reports into relevant folders, which helps in maintaining a tidy workspace, especially in environments with multiple users or teams.
• Access control: Regularly review and manage access permissions for new reports, ensuring that only the appropriate personnel can view or edit sensitive data.