---
title: "POST /atlas/v2/entity/guid/{guid}/businessmetadata/{bmName}"
method: POST
path: "/atlas/v2/entity/guid/{guid}/businessmetadata/{bmName}"
tags: ["Entity"]
---

# POST /atlas/v2/entity/guid/{guid}/businessmetadata/{bmName}

`POST /atlas/v2/entity/guid/{guid}/businessmetadata/{bmName}`

## Request

- Base URL: `/catalog/api` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/catalog/api/atlas/v2/entity/guid/{guid}/businessmetadata/{bmName}`
- Auth: OAuth 2
  - Implicit: `https://login.microsoftonline.com/common/oauth2/authorize`
  - Scopes: `user_impersonation`

Add or update business metadata attributes

## Path parameters

- `bmName` string, required
- `guid` string, required

## Request body

- object: BusinessMetadataAttributes

## Response `204`

Success

## Other responses

- `default`: Error response describing why the operation failed.

## Changes

- **2026-07-13** (2021-05-01-preview) `659406e7a3f5`: 1 breaking
  - api path removed without deprecation
- **2026-07-13** (2021-05-01-preview) `2a89dc9cd121`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/azure/apis/purview-catalog/changes/atlas/v2/entity/guid/:guid/businessmetadata/:bmName/post.md)

---

[API](https://skmtc.dev/azure/apis/purview-catalog.md) - [All operations](https://skmtc.dev/azure/apis/purview-catalog/llms.txt) - [OpenAPI document](https://skmtc.dev/azure/apis/purview-catalog/revisions/63dd676f9a6b?raw)
