Skip to main content
POST
/
v2
/
team.asset.update_scope
UpdateAssetShareScope
curl --request POST \
  --url https://api.manus.im/v2/team.asset.update_scope \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "share_uid": "<string>"
}
'
{
  "ok": true,
  "request_id": "<string>"
}
Questions or issues? Contact us at api-support@manus.ai.
Admin override. This endpoint changes the share scope of a resource that does not belong to the caller. Use it from controlled DSPM workflows only and always supply a meaningful note — it is written to the audit log and is the only record of why the override happened.
Auth: Requires an KEY_TYPE_TEAM_ASSET_MGMT enterprise API key. Audit-class keys are rejected.Lookup share_uid first. Call team.asset.list to discover the uid of the share row you want to override. The share_uid must belong to the same team as the API key.Note is mandatory in spirit. Although note is technically optional, it is written verbatim to team_asset_audit_logs.remark and is the only place the override’s intent is recorded — supply something meaningful. The audit row also records the calling key’s name in api_key_name, which is what operators reviewing the team asset audit log use to tell API-driven overrides apart from manual admin actions — see the overview for the full semantics.Protocols: Also callable via Connect RPC. See Protocols.

Authorizations

​
X-API-Key
string
header
required

Body

application/json
​
share_uid
string
required

UID of the team_asset_shares row to override. Must belong to the calling team. Look up via team.asset.list.

​
permission
enum<string>
required

New permission for the share.

Available options:
SHARE_SCOPE_OWNER,
SHARE_SCOPE_TEAM_ONLY,
SHARE_SCOPE_PUBLIC
​
note
string

Free-form audit note. Written to the team_asset_audit_logs.remark column and surfaced to anyone reviewing why the scope was changed.

Response

Share scope updated successfully.

​
ok
boolean

Whether the request was successful.

Example:

true

​
request_id
string

Unique identifier for this API request.