# Power BI Goals (Preview) API

**Canonical:** https://apis.io/apis/power-bi/power-bi-goals-preview-api/  
**Provider:** Power BI — https://apis.io/providers/power-bi/  
**Base URL:** https://api.powerbi.com  
**Documentation:** https://learn.microsoft.com/en-us/rest/api/power-bi/

Power BI Goals (Preview) API is one of 37 APIs that [Power BI](https://apis.io/providers/power-bi/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Goals_(Preview). The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

The Goals_(Preview) API from Power BI — 7 operation(s) for goals_(preview).

## Operations (10)

| Method | Path | Summary |
|---|---|---|
| GET | `/v1.0/myorg/groups/{groupId}/scorecards({scorecardId})/goals` | Returns a list of goals from a scorecard |
| POST | `/v1.0/myorg/groups/{groupId}/scorecards({scorecardId})/goals` | Adds a new goal to a scorecard |
| GET | `/v1.0/myorg/groups/{groupId}/scorecards({scorecardId})/goals({goalId})` | Returns a goal by ID from a scorecard |
| PATCH | `/v1.0/myorg/groups/{groupId}/scorecards({scorecardId})/goals({goalId})` | Updates a goal by ID |
| DELETE | `/v1.0/myorg/groups/{groupId}/scorecards({scorecardId})/goals({goalId})` | Deletes a goal from a scorecard by goal ID |
| GET | `/v1.0/myorg/groups/{groupId}/scorecards({scorecardId})/goals({goalId})/GetRefreshHistory()` | Reads refresh history of a connected goal |
| POST | `/v1.0/myorg/groups/{groupId}/scorecards({scorecardId})/goals({goalId})/DeleteGoalCurrentValueConnection()` | Disconnects the current value of a goal |
| POST | `/v1.0/myorg/groups/{groupId}/scorecards({scorecardId})/goals({goalId})/DeleteGoalTargetValueConnection()` | Disconnects the target value of a goal |
| POST | `/v1.0/myorg/groups/{groupId}/scorecards({scorecardId})/goals({goalId})/RefreshGoalCurrentValue()` | Schedules a refresh of the connected value of a goal |
| POST | `/v1.0/myorg/groups/{groupId}/scorecards({scorecardId})/goals({goalId})/RefreshGoalTargetValue()` | Schedules a refresh of the target value of a goal |

## Machine-readable artifacts (2)

- **OpenAPI** — https://artifacts.apis.io/power-bi/openapi/power-bi-goals-preview-api-openapi.yml
- **Documentation** — https://learn.microsoft.com/en-us/rest/api/power-bi/

## Other Power BI APIs (12)

- [Power BI Authoring MCP Server](https://apis.io/apis/power-bi/power-bi-authoring-mcp-server/)
- [Power BI Consumption MCP Server](https://apis.io/apis/power-bi/power-bi-consumption-mcp-server/)
- [Power BI Embedded](https://apis.io/apis/power-bi/power-bi-embedded/)
- [Power BI Management API](https://apis.io/apis/power-bi/power-bi-management-api/)
- [Power BI Push Datasets API](https://apis.io/apis/power-bi/power-bi-push-datasets-api/)
- [Power BI Report Server REST API](https://apis.io/apis/power-bi/power-bi-report-server-rest-api/)
- [Power BI Visuals API](https://apis.io/apis/power-bi/power-bi-visuals-api/)
- [Power BI Dashboards API](https://apis.io/apis/power-bi/power-bi-dashboards-api/)
- [Power BI Datasets API](https://apis.io/apis/power-bi/power-bi-datasets-api/)
- [Power BI Gateways API](https://apis.io/apis/power-bi/power-bi-gateways-api/)
- [Power BI Groups API](https://apis.io/apis/power-bi/power-bi-groups-api/)
- [Power BI Imports API](https://apis.io/apis/power-bi/power-bi-imports-api/)

## Tags

Goals_(Preview)

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/power-bi/power-bi-goals-preview-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/power-bi/.