> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# BSC Designer

> BSC Designer helps organizations create balanced scorecards, manage KPIs, visualize strategy maps, and track strategic performance.

![BSC Designer logo](https://mintcdn.com/composio-preview/PudKL42NVsy5O-ND/images/toolkits/bsc_designer.svg?fit=max\&auto=format\&n=PudKL42NVsy5O-ND\&q=85\&s=fbb31e429c0e6f5bd1677b2bb8e3fc52)

* **Category:** business intelligence
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 10
* **Triggers:** 0
* **Slug:** `BSC_DESIGNER`
* **Version:** 20261101\_00

## Tools

> [accordion] Balance Scorecard Weights
>
> **Slug:** `BSC_DESIGNER_BALANCE_SCORECARD_WEIGHTS`
>
> Recalculate and persist balanced indicator weights across a scorecard. Returns old and new weights when the provider supplies change details; the change list may be empty.
>
> #### Input Parameters
>
> **document\_id\_or\_alias** `string` *required*
>
> Document numeric ID or alias whose indicator weights will be recalculated.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Download Excel Report
>
> **Slug:** `BSC_DESIGNER_DOWNLOAD_EXCEL_REPORT`
>
> Generate and download a scorecard's Excel report, optionally evaluated at a specified date.
>
> #### Input Parameters
>
> **date** `string`
>
> Optional report date in yyyy-MM-dd format. Omit it to use BSC Designer's default report date.
>
> **document\_id** `integer` *required*
>
> Numeric document ID returned by List Documents; aliases are not documented for this report route.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Document
>
> **Slug:** `BSC_DESIGNER_GET_DOCUMENT`
>
> Get metadata and sharing settings for one scorecard document by numeric ID or alias.
>
> #### Input Parameters
>
> **document\_id\_or\_alias** `string` *required*
>
> Numeric document ID or alias returned by List Documents.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Grouped Indicator Values
>
> **Slug:** `BSC_DESIGNER_GET_GROUPED_INDICATOR_VALUES`
>
> Get one indicator's values grouped by day, week, month, quarter, half-year, or year over an explicit date range.
>
> #### Input Parameters
>
> **period** `string ("DAY" | "WEEK" | "MONTH" | "QUARTER" | "HALF_YEAR" | "YEAR")` *required*
>
> Time bucket used to group indicator values.
>
> **end\_date** `string` *required*
>
> Inclusive range end in yyyy-MM-dd format. Must not precede start\_date.
>
> **start\_date** `string` *required*
>
> Inclusive range start in yyyy-MM-dd format.
>
> **indicator\_id** `string` *required*
>
> Exact identifier of a value-bearing indicator returned by List Scorecard Items. Preserve braces, capitalization, and spelling.
>
> **document\_id\_or\_alias** `string` *required*
>
> Document numeric ID or alias returned by List Documents.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Indicator Value
>
> **Slug:** `BSC_DESIGNER_GET_INDICATOR_VALUE`
>
> Get one indicator's value, baseline, target, minimum, and maximum for the requested as-of date under its update-interval and value-inheritance settings, including each metric's effective date. Future scheduled values are not returned before their effective date.
>
> #### Input Parameters
>
> **date** `string` *required*
>
> As-of lookup date in yyyy-MM-dd format. BSC Designer applies the indicator's update interval and value-inheritance settings, so metrics may resolve from an earlier effective date. A write normalized to a later scheduled date is not visible before that date.
>
> **indicator\_id** `string` *required*
>
> Exact identifier of a value-bearing indicator returned by List Scorecard Items. Preserve braces, capitalization, and spelling.
>
> **document\_id\_or\_alias** `string` *required*
>
> Document numeric ID or alias returned by List Documents.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Scorecard Item
>
> **Slug:** `BSC_DESIGNER_GET_SCORECARD_ITEM`
>
> Get detailed metadata for one scorecard item, such as an indicator, goal, or initiative, using its exact item identifier.
>
> #### Input Parameters
>
> **item\_id** `string` *required*
>
> Exact guid or symbolic item identifier returned by List Scorecard Items; preserve braces and spelling.
>
> **document\_id\_or\_alias** `string` *required*
>
> Document numeric ID or alias returned by List Documents.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Documents
>
> **Slug:** `BSC_DESIGNER_LIST_DOCUMENTS`
>
> List scorecard documents owned by or shared with the connected user, returning IDs and aliases for subsequent scorecard operations.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Scorecard Items
>
> **Slug:** `BSC_DESIGNER_LIST_SCORECARD_ITEMS`
>
> List scorecard items, including goals, perspectives, indicators, initiatives, risks, rationales, and expected outcomes. Filter the item list locally by category or whether items accept value data; the separately returned root remains unfiltered.
>
> #### Input Parameters
>
> **item\_type** `string ("AUTOMATIC" | "INITIATIVE" | "SUCCESS_FACTOR" | "EXPECTED_OUTCOME" | "RATIONALE" | "HYPOTHESIS" | "RISK" | "PERSPECTIVE" | "GOAL" | "INDICATOR")`
>
> Optional scorecard item category to retain from the complete response. Filtering occurs locally and is not sent upstream.
>
> **value\_data\_only** `boolean`
>
> When true, return only items whose acceptValueData field is true. Filtering occurs locally and is not sent upstream.
>
> **document\_id\_or\_alias** `string` *required*
>
> Document numeric ID or alias returned by List Documents.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Set Indicator Values
>
> **Slug:** `BSC_DESIGNER_SET_INDICATOR_VALUES`
>
> Set one or more indicators' value, baseline, target, minimum, or maximum in one batch request. BSC Designer maps the requested date to each indicator's configured update schedule; use the returned date and metric-specific effective dates for read-back or restoration because they may be later than the requested date. Omitted metrics are left unspecified.
>
> #### Input Parameters
>
> **date** `string` *required*
>
> Requested write date in yyyy-MM-dd format. BSC Designer maps this date to each indicator's configured update schedule, so the response's date and metric-specific \*Date fields are authoritative and may be later.
>
> **values** `array` *required*
>
> One or more indicator updates. Every entry requires indicator\_id and at least one metric.
>
> **document\_id\_or\_alias** `string` *required*
>
> Document numeric ID or alias returned by List Documents.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Indicator
>
> **Slug:** `BSC_DESIGNER_UPDATE_INDICATOR`
>
> Update a scorecard indicator's name, description, or leading/lagging business type without changing its measured values. Unspecified metadata is preserved, but concurrent edits to the same indicator may be overwritten.
>
> #### Input Parameters
>
> **name** `string`
>
> New indicator name; omit to leave it unspecified.
>
> **description** `string`
>
> New indicator description; omit to leave it unspecified.
>
> **indicator\_id** `string` *required*
>
> Exact indicator identifier returned by List Scorecard Items. Preserve braces, capitalization, and spelling.
>
> **indicator\_type** `string ("LEADING" | "LAGGING")`
>
> New business type, LEADING or LAGGING; omit to leave it unspecified.
>
> **document\_id\_or\_alias** `string` *required*
>
> Document numeric ID or alias returned by List Documents.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
