---
title: "Deletes a received share"
method: DELETE
path: "/receivedShares/{receivedShareId}"
tags: ["ReceivedShare"]
---

# Deletes a received share

`DELETE /receivedShares/{receivedShareId}`

Delete a received share

## Path parameters

- `receivedShareId` string, required

## Query parameters

- `api-version` string, required

## Response `202`

Accepted

- OperationResponse — Response for long running operation.
  - `endTime` string, date-time — End time of the long running operation. Represented in the standard date-time format as defined by [RFC 3339](https://www.rfc-editor.org/rfc/rfc3339)
  - `error` PurviewShareErrorInfo — The purview share error body model.
    - `code` string, required — Code of the error
    - `details` PurviewShareErrorInfo[] — Nested details of the error model
    - `message` string, required — Message of the error
    - `target` string — Target of the error
  - `id` string — Job id of the long running operation
  - `startTime` string, date-time — Start time of the long running operation. Represented in the standard date-time format as defined by [RFC 3339](https://www.rfc-editor.org/rfc/rfc3339)
  - `status` 'Running' | 'TransientFailure' | 'Succeeded' | 'Failed' | 'NotStarted', required — States for long running operations.

## Other responses

- `default` — Default error response.

## Changes

- **2026-07-13** (2021-09-01-preview) `a1ebde565f2f` — 2 warning
  - the optional response header `Operation-Location` removed for the status `202`
  - the optional response header `x-ms-error-code` removed for the status `default`

[Change history](https://skmtc.dev/azure/apis/purview-share/changes/receivedShares/:receivedShareId/delete.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)