---
title: "Add report scope"
method: POST
path: "/reports/{reportId}/scope"
tags: ["reports"]
---

# Add report scope

`POST /reports/{reportId}/scope`

Adds source sheets for inclusion in the specified report by specifying individual sheets or their parent workspaces.

Specifying a workspace creates a dynamic scope—-the report automatically includes all sheets in that workspace and updates whenever sheets are added or removed from it.

> **Note:** You can have up to 30,000 source sheets per report.

## Request body

- ReportScope[]
  - `assetType` 'sheet' | 'workspace', required — The asset's type.
  - `assetId` integer, required — The ID of the asset according to its `assetType`.

## Response `200`

The operation's success level.

- GenericResult
  - `message` 'PARTIAL_SUCCESS' | 'SUCCESS' — Message that indicates the outcome of the request. (One of `SUCCESS` or `PARTIAL_SUCCESS`.)
  - `resultCode` 0 | 3 — * '0' Success * '3' Partial Success of Bulk Operation

## Other responses

- `400` — This can be caused by the following situations: - Request body exceeds maximum of 100 items. Example response: ```json { "errorCode": 1008, "message": "Unable to parse request. The following error occurred: Maximum of 100 items allowed in property $.", "refId": "abcd1234" } ``` - Sheets per report limit exceeded (for pro plan users currently). Example response: ```json { "errorCode": 1368, "message": "You have reached the limit of {sheet_limit} sheets for the report.", "refId": "abcd1234" } ``` - A source workspace does not exist. Example response: ```json { "errorCode": 1008, "message": "Unable to parse request. The following error occurred: Source workspace {id} not found.", "refId": "abcd1234" } ```
- `403` — This can be caused by the following situations: - Caller does not have EDITOR or ADMIN permissions to the report. ```json { "errorCode": 1004, "message": "You are not authorized to perform this action.", "refId": "abcd1234" } ```
- `404` — This can be caused by the following situations: - Report does not exist. ```json { "errorCode": 1006, "message": "Not Found.", "refId": "abcd1234" } ```
- `default` — Generic error payload.

---

[API](https://skmtc.net/smartsheet/apis/smartsheet-openapi-reference.md) · [All operations](https://skmtc.net/smartsheet/apis/smartsheet-openapi-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/smartsheet/smartsheet-openapi-reference/versions/b4afda95fb51/schema)