---
title: "Save an insight as a report definition"
method: POST
path: "/gdc/projects/{project_id}/convertVisualizationObject"
tags: ["vizualization-object"]
---

# Save an insight as a report definition

`POST /gdc/projects/{project_id}/convertVisualizationObject`

## Request

- Base URL: `https://secure.gooddata.com`
- URL: `https://secure.gooddata.com/gdc/projects/{project_id}/convertVisualizationObject`
- Auth: none declared

Use this method to save an insight as a report definition.
This is equivalent to clicking the **Open as Report** button from Analytical Designer.

The report definition is saved in the same project as the insight, under **Reports**. The report definition is saved as a hidden `Untitled report`. You can then rename it and make it visible for everybody.

## Path parameters

- `project_id` string, required

## Request body

- VisualizationObject
  - `visualizationObject` object, required
    - `meta` MetaRequest, required
      - `title` string, required: Title of this metadata object. Mustn't contain only whitespace characters
      - `category` string: Category of this metadata object
      - `tags` string: List of tags for this metadata object separated by spaces
      - `author` string, uri: URI of the user's profile
      - `created` string: Date and time string in the format `YYYY-MM-DD hh:mm:ss`
      - `contributor` string, uri: URI of the user's profile
      - `updated` string: Date and time string in the format `YYYY-MM-DD hh:mm:ss`
      - `identifier` string: Global identifier of a metadata object
      - `flags` string[]: List of flags specified for this metadata object
      - `summary` string, nullable: A short description of this metadata object
      - `projectTemplate` string, uri
      - `uri` string, uri: Link to this metadata object
      - `deprecated` union: Legacy boolean allowing boolean values represented by booleans or numbers
        - '0' | '1'
        - 0 | 1
        - boolean
      - `locked` union: Legacy boolean allowing boolean values represented by booleans or numbers
        - '0' | '1'
        - 0 | 1
        - boolean
      - `unlisted` union: Legacy boolean allowing boolean values represented by booleans or numbers
        - '0' | '1'
        - 0 | 1
        - boolean
      - `isProduction` union: Legacy boolean allowing boolean values represented by booleans or numbers
        - '0' | '1'
        - 0 | 1
        - boolean
      - `sharedWithSomeone` union: Legacy boolean allowing boolean values represented by booleans or numbers
        - '0' | '1'
        - 0 | 1
        - boolean
    - `content` object, required
      - `visualizationClass` Uri, required: URI containing mandatory root key
        - `uri` string, uri, required
      - `buckets` Bucket[], required
        - `localIdentifier` string: Global identifier of a metadata object
        - `items` union[], required
          - union
            - VisualizationObjectAttribute
              - …
            - VisualizationObjectMeasure
              - …
        - `totals` object
          - `measureIdentifier` string, required: Global identifier of a metadata object
          - `type` unknown, required
          - `attributeIdentifier` string, required: Global identifier of a metadata object
      - `filters` union[]
        - union
          - PositiveAttributeFilter
            - `positiveAttributeFilter` object, required
              - …
          - NegativeAttributeFilter
            - `negativeAttributeFilter` object, required
              - …
          - AbsoluteDateFilter
            - `absoluteDateFilter` object, required
              - …
          - RelativeDateFilter
            - `relativeDateFilter` object, required
              - …
          - VisualizationObjectMeasureValueFilter
            - `measureValueFilter` object, required
              - …
          - VisualizationRankingFilter
            - `rankingFilter` object, required
              - …
      - `properties` string: contains user part of configuration for current visualizationObject. ( content depend on user, not validated )
      - `references` string[]: map identifiers to URIs from properties

## Response `201`

_

- Uri: URI containing mandatory root key
  - `uri` string, uri, required

---

[API](https://skmtc.dev/gooddata/apis/gooddata-api-documentation.md) - [All operations](https://skmtc.dev/gooddata/apis/gooddata-api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/gooddata/apis/gooddata-api-documentation/revisions/e5dc0ee6ab00?raw)