---
title: "Create or replace a received share."
method: PUT
path: "/receivedShares/{receivedShareId}"
tags: ["ReceivedShare"]
---

# Create or replace a received share.

`PUT /receivedShares/{receivedShareId}`

Update changes to a received share

## Path parameters

- `receivedShareId` string, required

## Query parameters

- `api-version` string, required

## Request body

- ReceivedShare — Base data transfer object implementation for proxy resources.
  - `id` string — The unique id of the resource.
  - `type` string — Type of the resource.

## Response `200`

Success

- ReceivedShare — Base data transfer object implementation for proxy resources.
  - `id` string — The unique id of the resource.
  - `type` string — Type of the resource.

## Other responses

- `201` — Success
- `default` — Default error response.

## Changes

- **2026-07-13** (2021-09-01-preview) `a1ebde565f2f` — 1 breaking, 2 warning, 1 info
  - removed the success response with the status `200`
  - the optional response header `Operation-Location` removed for the status `201`
  - the optional response header `x-ms-error-code` removed for the status `default`
  - api operation id `ReceivedShares_CreateOrReplace` removed and replaced with `ReceivedShares_Create`

[Change history](https://skmtc.dev/azure/apis/purview-share/changes/receivedShares/:receivedShareId/put.md)

---

[API](https://skmtc.dev/azure/apis/purview-share.md) · [All operations](https://skmtc.dev/azure/apis/purview-share/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/azure/purview-share/revisions/79b396164f79/schema)