---
title: "Export all reports in a dashboard tab"
method: POST
path: "/gdc/projects/{project_id}/export/dashboardTab"
tags: ["export-reports"]
---

# Export all reports in a dashboard tab

`POST /gdc/projects/{project_id}/export/dashboardTab`

## Request

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

This resource exports all computable reports in a dashboard tab to one file (XLSX or PDF). In the XLSX format, all reports are converted into tables.**Request body parameters**

* `dashboard` (string) specifies the dashboard that the tab to export belongs to.

* `format` (string) specifies the format that the tab reports will be exported to. Can be set to `xlsx` or `pdf`.

* `options` (JSON, optional) specifies advanced exporting options. For more information, See [Export a Report](#operation/exportReport).

* `tab` (string) specifies the dashboard tab to export.

* `context` (string, optional) applies a predefined set of filters (execution context) to the dashboard tab to export. If you do not have existing execution contexts in your project, first [create one](#operation/createFilterForDashboardInScheduledEmail).

## Path parameters

- `project_id` string, required

## Request body

- ExportDashboardTab
  - `exportDashboardTab` object, required
    - `dashboard` union, required
      - string, uri
      - string: Global identifier of a metadata object
    - `format` 'xlsx' | 'pdf', required
    - `options` ExportOptionsMergeHeaders
      - `mergeHeaders` string, required
    - `tab` string, required
    - `context` string, uri

## Response `201`

`201` returns the URI to poll on. Polling returns various HTTP codes depending on whether the export is still running or not.
When the export is finished, the response returns `200` and the exported file.

- AsyncTask: Deprecated taskman async task used in old API resources. It contains `link` element in singular which doesn't comply with our API rules.
  - `asyncTask` object, required
    - `link` AsyncTaskPollLink, required
      - `poll` string, uri, required: URI of the polling resource

---

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