Back to DropboxSharing - Set Access Inheritance
Change the inheritance policy of an existing Shared Folder. Only permitted for shared folders in a shared team root.
If a :field:ShareFolderLaunch.async_job_id
is returned, you'll need to call :route:check_share_job_status
until the action completes to get the metadata for the folder.
Input
type: object
properties:
data:
type: object
description: |
shared_folder_id: The ID for the shared folder.
access_inheritance: The access inheritance settings for the folder.
properties:
access_inheritance:
type: object
description: >
Information about the inheritance policy of a shared folder.
inherit: The shared folder inherits its members from the parent
folder.
no_inherit: The shared folder does not inherit its members from the
parent folder.
other: None
properties:
.tag:
title: Choice of AccessInheritance
type: string
enum:
- inherit
- no_inherit
- other
shared_folder_id:
type: string
description: The ID for the shared folder.
title: Data
Output
type: object
description: >
async_job_id: This response indicates that the processing is asynchronous. The
string is an id that can be used to obtain the status of the asynchronous job.
complete: None
properties:
.tag:
title: Choice of ShareFolderLaunch
type: string
enum:
- async_job_id
- complete
async_job_id:
type: string
description: >-
This response indicates that the processing is asynchronous. The string is
an id that can be used to obtain the status of the asynchronous job.
complete:
type: object
description: >
The metadata which includes basic information about the shared folder.
access_type: The current user's access level for this shared folder.
is_inside_team_folder: Whether this folder is inside of a team folder.
is_team_folder: Whether this folder is a :link:`team folder
https://www.dropbox.com/en/help/986`.
name: The name of the this shared folder.
policy: Policies governing this shared folder.
preview_url: URL for displaying a web preview of the shared folder.
shared_folder_id: The ID of the shared folder.
time_invited: Timestamp indicating when the current user was invited to
this shared folder.
owner_display_names: The display names of the users that own the folder.
If the folder is part of a team folder, the display names of the team
admins are also included. Absent if the owner display names cannot be
fetched.
owner_team: The team that owns the folder. This field is not present if
the folder is not owned by a team.
parent_shared_folder_id: The ID of the parent shared folder. This field is
present only if the folder is contained within another shared folder.
path_lower: The lower-cased full path of this shared folder. Absent for
unmounted folders.
link_metadata: The metadata of the shared content link to this shared
folder. Absent if there is no link on the folder. This is for an
unreleased feature so it may not be returned yet.
permissions: Actions the current user may perform on the folder and its
contents. The set of permissions corresponds to the FolderActions in the
request.
access_inheritance: Whether the folder inherits its members from its
parent.
properties:
owner_team:
type: object
description: |
Information about a team.
id: The team's unique ID.
name: The name of the team.
properties:
id:
type: string
description: The team's unique ID.
name:
type: string
description: The name of the team.
parent_shared_folder_id:
type: string
description: >-
The ID of the parent shared folder. This field is present only if the
folder is contained within another shared folder.
link_metadata:
type: object
description: >
Metadata of a shared link for a file or folder.
audience_options: The audience options that are available for the
content. Some audience options may be unavailable. For example,
team_only may be unavailable if the content is not owned by a user on
a team. The 'default' audience option is always available if the user
can modify link settings.
current_audience: The current audience of the link.
link_permissions: A list of permissions for actions you can perform on
the link.
password_protected: Whether the link is protected by a password.
url: The URL of the link.
access_level: The access level on the link for this file.
audience_restricting_shared_folder: The shared folder that prevents
the link audience for this link from being more restrictive.
expiry: Whether the link has an expiry set on it. A link with an
expiry will have its audience changed to members when the expiry is
reached.
audience_exceptions: The content inside this folder with link audience
different than this folder's. This is only returned when an endpoint
that returns metadata for a single shared folder is called, e.g.
/get_folder_metadata.
properties:
current_audience:
type: object
description: |
public: Link is accessible by anyone.
team: Link is accessible only by team members.
members: Link is accessible only by members of the content.
other: None
properties:
.tag:
title: Choice of LinkAudience
type: string
enum:
- public
- team
- members
- other
url:
type: string
description: The URL of the link.
password_protected:
type: boolean
description: Whether the link is protected by a password.
audience_exceptions:
type: object
description: >
The total count and truncated list of information of content
inside this folder that has a different audience than the link on
this folder. This is only returned for folders.
count: None
exceptions: A truncated list of some of the content that is an
exception. The length of this list could be smaller than the count
since it is only a sample but will not be empty as long as count
is not 0.
properties:
count:
type: number
exceptions:
type: array
description: >-
A truncated list of some of the content that is an exception.
The length of this list could be smaller than the count since
it is only a sample but will not be empty as long as count is
not 0.
items:
type: object
description: >
Information about the content that has a link audience
different than that of this folder.
name: The name of the content, which is either a file or a
folder.
properties:
name:
type: string
description: >-
The name of the content, which is either a file or a
folder.
expiry:
type: string
description: >-
Whether the link has an expiry set on it. A link with an expiry
will have its audience changed to members when the expiry is
reached.
access_level:
type: object
description: >
Defines the access levels for collaborators.
owner: The collaborator is the owner of the shared folder. Owners
can view and edit the shared folder as well as set the folder's
policies using :route:`update_folder_policy`.
editor: The collaborator can both view and edit the shared folder.
viewer: The collaborator can only view the shared folder.
viewer_no_comment: The collaborator can only view the shared
folder and does not have any access to comments.
other: None
properties:
.tag:
title: Choice of AccessLevel
type: string
enum:
- owner
- editor
- viewer
- viewer_no_comment
- other
audience_restricting_shared_folder:
type: object
description: >
Information about the shared folder that prevents the link
audience for this link from being more restrictive.
shared_folder_id: The ID of the shared folder.
name: The name of the shared folder.
audience: The link audience of the shared folder.
properties:
shared_folder_id:
type: string
description: The ID of the shared folder.
audience:
type: object
description: |
public: Link is accessible by anyone.
team: Link is accessible only by team members.
members: Link is accessible only by members of the content.
other: None
properties:
.tag:
title: Choice of LinkAudience
type: string
enum:
- public
- team
- members
- other
name:
type: string
description: The name of the shared folder.
link_permissions:
type: array
description: A list of permissions for actions you can perform on the link.
items:
type: object
description: |
Permissions for actions that can be performed on a link.
action: None
allow: None
reason: None
properties:
action:
type: object
description: |
Actions that can be performed on a link.
change_access_level: Change the access level of the link.
change_audience: Change the audience of the link.
remove_expiry: Remove the expiry date of the link.
remove_password: Remove the password of the link.
set_expiry: Create or modify the expiry date of the link.
set_password: Create or modify the password of the link.
other: None
properties:
.tag:
title: Choice of LinkAction
type: string
enum:
- change_access_level
- change_audience
- remove_expiry
- remove_password
- set_expiry
- set_password
- other
reason:
type: object
description: >
Possible reasons the user is denied a permission.
user_not_same_team_as_owner: User is not on the same team as
the folder owner.
user_not_allowed_by_owner: User is prohibited by the owner
from taking the action.
target_is_indirect_member: Target is indirectly a member of
the folder, for example by being part of a group.
target_is_owner: Target is the owner of the folder.
target_is_self: Target is the user itself.
target_not_active: Target is not an active member of the
team.
folder_is_limited_team_folder: Folder is team folder for a
limited team.
owner_not_on_team: The content owner needs to be on a
Dropbox team to perform this action.
permission_denied: The user does not have permission to
perform this action on the link.
restricted_by_team: The user's team policy prevents
performing this action on the link.
user_account_type: The user's account type does not support
this action.
user_not_on_team: The user needs to be on a Dropbox team to
perform this action.
folder_is_inside_shared_folder: Folder is inside of another
shared folder.
restricted_by_parent_folder: Policy cannot be changed due to
restrictions from parent folder.
insufficient_plan: None
other: None
properties:
insufficient_plan:
type: object
description: >
message: A message to tell the user to upgrade in order
to support expected action.
upsell_url: A URL to send the user to in order to obtain
the account type they need, e.g. upgrading. Absent if
there is no action the user can take to upgrade.
properties:
message:
type: string
description: >-
A message to tell the user to upgrade in order to
support expected action.
upsell_url:
type: string
description: >-
A URL to send the user to in order to obtain the
account type they need, e.g. upgrading. Absent if
there is no action the user can take to upgrade.
.tag:
title: Choice of PermissionDeniedReason
type: string
enum:
- user_not_same_team_as_owner
- user_not_allowed_by_owner
- target_is_indirect_member
- target_is_owner
- target_is_self
- target_not_active
- folder_is_limited_team_folder
- owner_not_on_team
- permission_denied
- restricted_by_team
- user_account_type
- user_not_on_team
- folder_is_inside_shared_folder
- restricted_by_parent_folder
- insufficient_plan
- other
allow:
type: boolean
audience_options:
type: array
description: >-
The audience options that are available for the content. Some
audience options may be unavailable. For example, team_only may be
unavailable if the content is not owned by a user on a team. The
'default' audience option is always available if the user can
modify link settings.
items:
type: object
description: |
public: Link is accessible by anyone.
team: Link is accessible only by team members.
members: Link is accessible only by members of the content.
other: None
properties:
.tag:
title: Choice of LinkAudience
type: string
enum:
- public
- team
- members
- other
time_invited:
type: string
description: >-
Timestamp indicating when the current user was invited to this shared
folder.
preview_url:
type: string
description: URL for displaying a web preview of the shared folder.
access_type:
type: object
description: >
Defines the access levels for collaborators.
owner: The collaborator is the owner of the shared folder. Owners can
view and edit the shared folder as well as set the folder's policies
using :route:`update_folder_policy`.
editor: The collaborator can both view and edit the shared folder.
viewer: The collaborator can only view the shared folder.
viewer_no_comment: The collaborator can only view the shared folder
and does not have any access to comments.
other: None
properties:
.tag:
title: Choice of AccessLevel
type: string
enum:
- owner
- editor
- viewer
- viewer_no_comment
- other
name:
type: string
description: The name of the this shared folder.
owner_display_names:
type: array
description: >-
The display names of the users that own the folder. If the folder is
part of a team folder, the display names of the team admins are also
included. Absent if the owner display names cannot be fetched.
items:
type: string
access_inheritance:
type: object
description: >
Information about the inheritance policy of a shared folder.
inherit: The shared folder inherits its members from the parent
folder.
no_inherit: The shared folder does not inherit its members from the
parent folder.
other: None
properties:
.tag:
title: Choice of AccessInheritance
type: string
enum:
- inherit
- no_inherit
- other
shared_folder_id:
type: string
description: The ID of the shared folder.
path_lower:
type: string
description: >-
The lower-cased full path of this shared folder. Absent for unmounted
folders.
policy:
type: object
description: >
A set of policies governing membership and privileges for a shared
folder.
acl_update_policy: Who can add and remove members from this shared
folder.
shared_link_policy: Who links can be shared with.
member_policy: Who can be a member of this shared folder, as set on
the folder itself. The effective policy may differ from this value if
the team-wide policy is more restrictive. Present only if the folder
is owned by a team.
resolved_member_policy: Who can be a member of this shared folder,
taking into account both the folder and the team-wide policy. This
value may differ from that of member_policy if the team-wide policy is
more restrictive than the folder policy. Present only if the folder is
owned by a team.
viewer_info_policy: Who can enable/disable viewer info for this shared
folder.
properties:
viewer_info_policy:
type: object
description: |
enabled: Viewer information is available on this file.
disabled: Viewer information is disabled on this file.
other: None
properties:
.tag:
title: Choice of ViewerInfoPolicy
type: string
enum:
- enabled
- disabled
- other
resolved_member_policy:
type: object
description: >
Policy governing who can be a member of a shared folder. Only
applicable to folders owned by a user on a team.
team: Only a teammate can become a member.
anyone: Anyone can become a member.
other: None
properties:
.tag:
title: Choice of MemberPolicy
type: string
enum:
- team
- anyone
- other
acl_update_policy:
type: object
description: >
Who can change a shared folder's access control list (ACL). In
other words, who can add, remove, or change the privileges of
members.
owner: Only the owner can update the ACL.
editors: Any editor can update the ACL. This may be further
restricted to editors on the same team.
other: None
properties:
.tag:
title: Choice of AclUpdatePolicy
type: string
enum:
- owner
- editors
- other
shared_link_policy:
type: object
description: >
Who can view shared links in this folder.
anyone: Links can be shared with anyone.
team: Links can be shared with anyone on the same team as the
owner.
members: Links can only be shared among members of the shared
folder.
other: None
properties:
.tag:
title: Choice of SharedLinkPolicy
type: string
enum:
- anyone
- team
- members
- other
member_policy:
type: object
description: >
Policy governing who can be a member of a shared folder. Only
applicable to folders owned by a user on a team.
team: Only a teammate can become a member.
anyone: Anyone can become a member.
other: None
properties:
.tag:
title: Choice of MemberPolicy
type: string
enum:
- team
- anyone
- other
is_inside_team_folder:
type: boolean
description: Whether this folder is inside of a team folder.
is_team_folder:
type: boolean
description: >-
Whether this folder is a :link:`team folder
https://www.dropbox.com/en/help/986`.
permissions:
type: array
description: >-
Actions the current user may perform on the folder and its contents.
The set of permissions corresponds to the FolderActions in the
request.
items:
type: object
description: >
Whether the user is allowed to take the action on the shared folder.
action: The action that the user may wish to take on the folder.
allow: True if the user is allowed to take the action.
reason: The reason why the user is denied the permission. Not
present if the action is allowed, or if no reason is available.
properties:
action:
type: object
description: >
Actions that may be taken on shared folders.
change_options: Change folder options, such as who can be
invited to join the folder.
disable_viewer_info: Disable viewer information for this folder.
edit_contents: Change or edit contents of the folder.
enable_viewer_info: Enable viewer information on the folder.
invite_editor: Invite a user or group to join the folder with
read and write permission.
invite_viewer: Invite a user or group to join the folder with
read permission.
invite_viewer_no_comment: Invite a user or group to join the
folder with read permission but no comment permissions.
relinquish_membership: Relinquish one's own membership in the
folder.
unmount: Unmount the folder.
unshare: Stop sharing this folder.
leave_a_copy: Keep a copy of the contents upon leaving or being
kicked from the folder.
share_link: Use create_link instead.
create_link: Create a shared link for folder.
set_access_inheritance: Set whether the folder inherits
permissions from its parent.
other: None
properties:
.tag:
title: Choice of FolderAction
type: string
enum:
- change_options
- disable_viewer_info
- edit_contents
- enable_viewer_info
- invite_editor
- invite_viewer
- invite_viewer_no_comment
- relinquish_membership
- unmount
- unshare
- leave_a_copy
- share_link
- create_link
- set_access_inheritance
- other
reason:
type: object
description: >
Possible reasons the user is denied a permission.
user_not_same_team_as_owner: User is not on the same team as the
folder owner.
user_not_allowed_by_owner: User is prohibited by the owner from
taking the action.
target_is_indirect_member: Target is indirectly a member of the
folder, for example by being part of a group.
target_is_owner: Target is the owner of the folder.
target_is_self: Target is the user itself.
target_not_active: Target is not an active member of the team.
folder_is_limited_team_folder: Folder is team folder for a
limited team.
owner_not_on_team: The content owner needs to be on a Dropbox
team to perform this action.
permission_denied: The user does not have permission to perform
this action on the link.
restricted_by_team: The user's team policy prevents performing
this action on the link.
user_account_type: The user's account type does not support this
action.
user_not_on_team: The user needs to be on a Dropbox team to
perform this action.
folder_is_inside_shared_folder: Folder is inside of another
shared folder.
restricted_by_parent_folder: Policy cannot be changed due to
restrictions from parent folder.
insufficient_plan: None
other: None
properties:
insufficient_plan:
type: object
description: >
message: A message to tell the user to upgrade in order to
support expected action.
upsell_url: A URL to send the user to in order to obtain the
account type they need, e.g. upgrading. Absent if there is
no action the user can take to upgrade.
properties:
message:
type: string
description: >-
A message to tell the user to upgrade in order to
support expected action.
upsell_url:
type: string
description: >-
A URL to send the user to in order to obtain the account
type they need, e.g. upgrading. Absent if there is no
action the user can take to upgrade.
.tag:
title: Choice of PermissionDeniedReason
type: string
enum:
- user_not_same_team_as_owner
- user_not_allowed_by_owner
- target_is_indirect_member
- target_is_owner
- target_is_self
- target_not_active
- folder_is_limited_team_folder
- owner_not_on_team
- permission_denied
- restricted_by_team
- user_account_type
- user_not_on_team
- folder_is_inside_shared_folder
- restricted_by_parent_folder
- insufficient_plan
- other
allow:
type: boolean
description: True if the user is allowed to take the action.