Create a report from a code representation (Deprecated)

Deprecation notice: This endpoint is deprecated. Instead, use POST /v2/reports with contents in the request body.

This endpoint creates a new report from a code representation. Use it to programmatically define and create reports that are then accessible from the Sigma UI.

Beta: This documentation describes a private beta feature and is subject to the Beta features disclaimer.

Usage notes

• To retrieve the representation of an existing report, use the /v2/reports/{reportId}/spec endpoint.
• To update an existing report from code, use the /v2/reports/{reportId}/spec endpoint.
• To get a list of folders, call the /v2/files endpoint and review the id field in the response for files with a type of folder.

Usage scenarios

• Agentic workflows: Agents can use these endpoints to directly manage report contents in code.
• Automation: If you want to create several reports across one or more organizations, you can use this endpoint to programmatically create the reports.
• Integration: Using this endpoint, you can create reports based on external data sources or integrate Sigma with other tools and platforms.
• Migration: You can use this endpoint to migrate reports from one organization to another.