飞书 API

转移拥有者

POST

/open-apis/drive/permission/member/transfer

自建应用商店应用

该接口用于根据文档信息和用户信息转移文档的所有者。

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://open.feishu.cn/open-apis/drive/permission/member/transfer' \
--header 'Authorization;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "type": "doc", 
    "token": "doccntWNxstE5FDpAOFMOfZnMNf",
    "owner": {  
         "member_type": "openid",
         "member_id": "ou_194fcfc5e4b78db556a040ff5e42c00d"
    },
   "remove_old_owner": false,
   "cancel_notify": false
}'

响应示例

{
  "code": 0,
  "msg": "Success",
  "data": {
    "is_success": true,
    "token": "string",
    "type": "doc",
    "owner": {
      "member_type": "openid",
      "member_id": "string"
    }
  }
}

请求参数

Header 参数

Authorization

string

必需

tenant_access_token 或 user_access_token 值格式："Bearer access_token" 示例值："Bearer u-7f1bcd13fc57d46bac21793a18e560"

默认值:

Bearer {{access_token}}

Content-Type

string

必需

固定值："application/json; charset=utf-8"

默认值:

application/json; charset=utf-8

Body 参数application/json

type

string

必需

文档类型 "doc" or "sheet" or "bitable" or "file"

token

string

必需

文件的 token，获取方式见概述

owner

object

必需

要转移到的新的文档所有者

member_type

string

必需

用户类型，可选 email、openid、userid、unionid

member_id

string

必需

用户类型下的值，获取方式见如何获得 User ID、Open ID 和 Union ID？

remove_old_owner

boolean

必需

true 为转移后删除旧 owner 的权限，默认为false

cancel_notify

boolean

必需

true为不通知新owner，默认为false

示例

返回响应

🟢200200 Success

application/json

Body

code

integer

必需

msg

string

必需

data

object

必需

is_success

boolean

请求是否成功

必需

token

string

文档的 token

必需

type

string

必需

文档类型 "doc" or "sheet" or "file"

owner

object

文档当前所有者

必需

修改于 2023-01-13 06:46:57

更新文档公共设置

概述