---
id: "en/api-post-nd-api-file-remove-share-participant"
title: "Delete sharing participants"
language: "en"
description: "POST /nd/api/file/remove_share_participant: Delete sharing participant interface description, including path, method, parameters and return information."
canonical_url: "https://www.babel.cc/public/babelwiki/en/api-post-nd-api-file-remove-share-participant.html"
markdown_url: "https://www.babel.cc/public/babelwiki/ai/en/api-post-nd-api-file-remove-share-participant.md"
alternates: {"en": "https://www.babel.cc/public/babelwiki/ai/en/api-post-nd-api-file-remove-share-participant.md", "zh": "https://www.babel.cc/public/babelwiki/ai/zh/api-post-nd-api-file-remove-share-participant.md"}
reading_note: "文档记录不等于当前部署能力；以实际版本、授权模块与配置为准。保留原文的可选、限制及待确认说明，勿补猜接口。 / Documentation is not a guarantee for every deployment. Preserve optional-module requirements, limitations and unresolved API contracts."
---

# Delete sharing participants

`POST /nd/api/file/remove_share_participant`

## POST body parameters

| Parameter | Type | Description |
| --- | --- | --- |
| `file_id` | `string` | Required file ID |
| `babelshare_ids` | `string[]` | Required array of sharing-record IDs to remove, taken from `users[].babelshareId` returned by [Get all sharing participants](https://www.babel.cc/public/babelwiki/en/api-get-nd-api-share-share-participants.html). Do not substitute `participantId`. |

Example JSON request (identifiers are illustrative):

```json
{
  "file_id": "<FILE_ID>",
  "babelshare_ids": ["1001", "1002"]
}
```

## Response

Fields listed in the source: `code`, `success`.

Query participants with the same `file_id`, then collect the target records' `babelshareId` values into the array, preserving their string type.

## Calling the Endpoint

Use `Authorization: Bearer <access_token>` and a JSON POST body. Check HTTP status and then the business result.

[Authentication](https://www.babel.cc/public/babelwiki/en/developer-api-auth.html) · [API overview](https://www.babel.cc/public/babelwiki/en/developer-api-overview.html)