---
title: "Read a Power BI file before importing it"
method: POST
path: "/dashboards/v3/pbix/assess"
tags: ["Dashboard v3 Surfaces"]
---

# Read a Power BI file before importing it

`POST /dashboards/v3/pbix/assess`

## Request

- Base URL: `https://app.mammoth.io/api/v2`
- URL: `https://app.mammoth.io/api/v2/dashboards/v3/pbix/assess`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-KEY` and API key in header `X-API-SECRET` and API key in header `X-WORKSPACE-ID`

One uploaded .pbix -> what it contains and what an import would produce: page and visual counts, the model's shape, the narrative arc, and TWO coverage numbers — the share of the report's questions that stay answerable on the imported data, and the share of its visuals that port as the same chart. Both are returned because quoting either alone misleads. Read-only: nothing is imported, no dataset is created, and no model is called.

## Response `201`

Document created, URL follows

- ObjectJobSchema
  - `status_code` integer, nullable
  - `job_id` integer, nullable: Created job id
  - `failure_reason` string, nullable: Failure reason if status is failure

## Other responses

- `202`: Workbook accepted; poll /jobs/{id} for the read or the import
- `400`: Bad request syntax or unsupported method
- `403`: Request forbidden -- authorization will not help

---

[API](https://skmtc.dev/mammoth/apis/mammoth-analytics.md) · [All operations](https://skmtc.dev/mammoth/apis/mammoth-analytics/llms.txt) · [OpenAPI document](https://skmtc.dev/mammoth/apis/mammoth-analytics/revisions/fe078afe239b?raw)