---
title: "Execute a report definition"
method: POST
path: "/gdc/projects/{project_id}/execute"
tags: ["dashboard-view"]
---

# Execute a report definition

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

## Request

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

## Path parameters

- `project_id` string, required

## Request body

- WebbappReportRequest
  - `report_req` union, required
    - ExecuteContent
      - `definitionContent` object, required
        - `content` union, required
          - ReportDefinition
            - `reportDefinition` object, required
              - …
          - ReportDefinitionWithInlinedMetrics
            - `meta` MetaRequest, required
              - …
            - `content` ReportDefinitionContentWithInlinedMetrics, required
              - …
            - `links` ReportDefinitionLinks
              - …
        - `projectMetadata` string, uri, required
        - `context` ExecContext
          - `filters` ExecutionFilter[], required
            - `uri` string, uri, required: filtered attribute display form URI
            - `constraint` union
              - …
            - `promptUri` string, uri: prompt uri, only when the filter originates from a prompt
          - `drillInto` DrillInto
            - `target` string, uri, required: report or attribute display form
            - `locators` DrillLocator[], required
              - …
            - `targetType` 'report' | 'attributeDisplayForm', required
          - `report` string, uri, required
          - `dashboard` string, uri, required
        - `executionHints` ExecutionHints
          - `adHocFilters` union, required
            - union: Legacy boolean allowing boolean values represented by booleans or numbers
              - …
            - 'all'
        - `format` 'pdf' | 'xls' | 'xlsx' | 'png' | 'csv'
        - `prompts` object
        - `timestamp` integer
        - `timeout` string, date-iso
    - ExecuteReport
      - `report` string, uri, required
      - `executionHints` ExecutionHints
        - `adHocFilters` union, required
          - union: Legacy boolean allowing boolean values represented by booleans or numbers
            - '0' | '1'
            - 0 | 1
            - boolean
          - 'all'
      - `context` ExecContext
        - `filters` ExecutionFilter[], required
          - `uri` string, uri, required: filtered attribute display form URI
          - `constraint` union
            - object: filter constraints definition, when is missing "no constraint" is applied (= all elements)
              - …
            - object: filter constraints definition, when is missing "no constraint" is applied (= all elements)
              - …
            - object: filter constraints definition, when is missing "no constraint" is applied (= all elements)
              - …
          - `promptUri` string, uri: prompt uri, only when the filter originates from a prompt
        - `drillInto` DrillInto
          - `target` string, uri, required: report or attribute display form
          - `locators` DrillLocator[], required
            - union
              - …
          - `targetType` 'report' | 'attributeDisplayForm', required
        - `report` string, uri, required
        - `dashboard` string, uri, required
      - `format` 'pdf' | 'xls' | 'xlsx' | 'png' | 'csv'
      - `prompts` object
      - `timestamp` integer
      - `timeout` string, date-iso
    - ExecuteDefinition
      - `reportDefinition` string, required
      - `executionHints` ExecutionHints
        - `adHocFilters` union, required
          - union: Legacy boolean allowing boolean values represented by booleans or numbers
            - '0' | '1'
            - 0 | 1
            - boolean
          - 'all'
      - `context` ExecContext
        - `filters` ExecutionFilter[], required
          - `uri` string, uri, required: filtered attribute display form URI
          - `constraint` union
            - object: filter constraints definition, when is missing "no constraint" is applied (= all elements)
              - …
            - object: filter constraints definition, when is missing "no constraint" is applied (= all elements)
              - …
            - object: filter constraints definition, when is missing "no constraint" is applied (= all elements)
              - …
          - `promptUri` string, uri: prompt uri, only when the filter originates from a prompt
        - `drillInto` DrillInto
          - `target` string, uri, required: report or attribute display form
          - `locators` DrillLocator[], required
            - union
              - …
          - `targetType` 'report' | 'attributeDisplayForm', required
        - `report` string, uri, required
        - `dashboard` string, uri, required
      - `format` 'pdf' | 'xls' | 'xlsx' | 'png' | 'csv'

## Response `201`

_

- ExecResult
  - `execResult` object, required
    - `reportView` ReportView, required
      - `chart` ChartContent
        - `styles` object
        - `buckets` object, required
          - `x` ChartBucketItem[], required
            - `id` string
            - `uri` union, required
              - …
          - `y` ChartBucketItem[], required
            - `id` string
            - `uri` union, required
              - …
          - `color` ChartBucketItem[]
            - `id` string
            - `uri` union, required
              - …
          - `angle` ChartBucketItem[]
            - `id` string
            - `uri` union, required
              - …
          - `size` ChartBucketItem[]
            - `id` string
            - `uri` union, required
              - …
          - `detail` ChartBucketItem[]
            - `id` string
            - `uri` union, required
              - …
          - `marker` ChartBucketItem[]
            - `id` string
            - `uri` union, required
              - …
        - `axes` ChartAxisItem[]
          - `locators` union, required
            - AttributeLocator
              - …
            - AttributeLocator2
              - …
            - MetricLocator
              - …
            - TotalLocator
              - …
            - AttributeHeaderLocator
              - …
            - EmptyLocator
              - …
            - ValuesLocator
              - …
          - `id` string, required
        - `sort` object
          - `x` ChartSortRule[]
            - union
              - …
          - `y` ChartSortRule[]
            - union
              - …
          - `color` AttributeChartSortRule[]
            - `attributeChartSort` object, required
              - …
      - `reportName` string, required
      - `columnWidths` ColumnWidth[], required
        - `locator` Locators[], required
          - union
            - AttributeLocator
              - …
            - AttributeLocator2
              - …
            - MetricLocator
              - …
            - TotalLocator
              - …
            - AttributeHeaderLocator
              - …
            - EmptyLocator
              - …
            - ValuesLocator
              - …
        - `width` integer, required
      - `defaultColumnWidt` integer: configurable default grid column width transfered from reportDefinition
      - `filters` ReportFilter, required
        - `expression` string, required
        - `tree` MAQLTree1
          - `type` string, required
          - `value` string
          - `position` object, required
            - `line` integer
            - `column` integer
          - `content` MAQLTree
            - `type` string, required
            - `value` string
            - `position` object, required
              - …
            - `content` MAQLTree (recursive)
      - `having` ReportFilter[]
        - `expression` string, required
        - `tree` MAQLTree1
          - `type` string, required
          - `value` string
          - `position` object, required
            - `line` integer
            - `column` integer
          - `content` MAQLTree
            - `type` string, required
            - `value` string
            - `position` object, required
              - …
            - `content` MAQLTree (recursive)
      - `rows` GridElement[], required
        - union
          - string
          - GridAttributeInfo
            - `drillDownStepAttributeDF` string, uri
            - `sort` 'pk' | 'byUsedDF' | 'SortDF'
            - `displayFormId` string, uri, required
            - `attributeTitle` string, required
            - `baseElementURI` string, uri, required
            - `title` string, required
            - `attributeId` string, uri, required
            - `totals` array[], required
              - …
            - `type` string
            - `summary` string
            - `linkAttributeDF` string, uri
      - `columns` GridElement[], required
        - union
          - string
          - GridAttributeInfo
            - `drillDownStepAttributeDF` string, uri
            - `sort` 'pk' | 'byUsedDF' | 'SortDF'
            - `displayFormId` string, uri, required
            - `attributeTitle` string, required
            - `baseElementURI` string, uri, required
            - `title` string, required
            - `attributeId` string, uri, required
            - `totals` array[], required
              - …
            - `type` string
            - `summary` string
            - `linkAttributeDF` string, uri
      - `sort` Sort, required
        - `columns` string[], required
        - `rows` string[], required
      - `oneNumber` OneNumberVisualization
        - `labels` object, required
      - `format` 'grid' | 'chart' | 'oneNumber', required
      - `metrics` MetricInfo[], required
        - `format` string, required
        - `title` string, required
        - `metricId` string, required
      - `sortedLookups` AttributeSortRule[]
        - `attributeSort` object, required
          - `uri` string, uri, required: URI of attributeDisplayForm (or metricGroup)
          - `direction` 'asc' | 'desc', required: sort order ascending (asc) or descending (desc)
          - `aggregation` string: aggregation function - how to put values from area together
      - `summary` string
      - `promptFilters` PromptFilter[]
        - `promptUri` string, uri, required
        - `expression` string, required
      - `locked` union
        - '0' | '1': transfered lock state from report if available, for reportDefinition or repDef. content is not filled
        - 0 | 1: transfered lock state from report if available, for reportDefinition or repDef. content is not filled
        - boolean: transfered lock state from report if available, for reportDefinition or repDef. content is not filled
      - `unlisted` union: Legacy boolean allowing boolean values represented by booleans or numbers
        - '0' | '1'
        - 0 | 1
        - boolean
    - `reportDefinition` string, uri: points to report definition, until executed by content only
    - `dataResult` string, uri, required: points to data
    - `geoResult` string, uri: link to the geo representation of the result

---

[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)