---
title: "Update Viewpoint Mapping"
method: PUT
path: "/api/v2/business-mapping/viewpoints/{viewpont-id}/mappings/{mapping-id}"
---

# Update Viewpoint Mapping

`PUT /api/v2/business-mapping/viewpoints/{viewpont-id}/mappings/{mapping-id}`

## Request

- Base URL: `https://api.umbrellacost.io`
- URL: `https://api.umbrellacost.io/api/v2/business-mapping/viewpoints/{viewpont-id}/mappings/{mapping-id}`
- Auth: none declared. Required headers: `authorization`, `apikey`

## Path parameters

- `viewpont-id` string, required
- `mapping-id` string, required

## Headers

- `authorization` string, required
- `apikey` string, required

## Request body

- object
  - `name` string, required
  - `rules` object[]: Min 1. The match condition.
    - `filters` object[]
      - `field` string
      - `values` string
      - `operator` string
  - `is_group_by` boolean
  - `group_by_field` string
  - `split` boolean: Turns this into a split mapping - its cost is redistributed onto other mappings instead of staying here.
  - `splitOptions` string

## Response `200`

- object
  - `uuid` string
  - `creation_time` string
  - `update_time` string
  - `created_by` string
  - `name` string
  - `account_id` string
  - `account_key` string
  - `division_id` string
  - `split` boolean
  - `splitOptions` string
  - `global` boolean
  - `rules` string

---

[API](https://skmtc.dev/umbrellacost/apis/cost-usage.md) - [All operations](https://skmtc.dev/umbrellacost/apis/cost-usage/llms.txt) - [OpenAPI document](https://skmtc.dev/umbrellacost/apis/cost-usage/revisions/c5ae311d18ae?raw)