DBTEAMTeamAuthRoutes
Objective-C
@interface DBTEAMTeamAuthRoutes : NSObject
Swift
class DBTEAMTeamAuthRoutes : NSObject
Routes for the Team namespace
-
An instance of the networking client that each route will use to submit a request.
Declaration
Objective-C
@property (nonatomic, readonly) id<DBTransportClient> _Nonnull client; -
Initializes the
DBTEAMTeamAuthRoutesnamespace container object with a networking client.Declaration
Objective-C
- (nonnull instancetype)init:(nonnull id<DBTransportClient>)client; -
List all device sessions of a team’s member.
Declaration
Objective-C
- (nonnull DBRpcTask<DBTEAMListMemberDevicesResult *, DBTEAMListMemberDevicesError *> *)devicesListMemberDevices: (nonnull NSString *)teamMemberId;Swift
func devicesListMemberDevices(_ teamMemberId: String) -> DBRpcTask<DBTEAMListMemberDevicesResult, DBTEAMListMemberDevicesError>Parameters
teamMemberIdThe team’s member id.
Return Value
Through the response callback, the caller will receive a
DBTEAMListMemberDevicesResultobject on success or aDBTEAMListMemberDevicesErrorobject on failure. -
List all device sessions of a team’s member.
Declaration
Objective-C
- (nonnull DBRpcTask<DBTEAMListMemberDevicesResult *, DBTEAMListMemberDevicesError *> *) devicesListMemberDevices:(nonnull NSString *)teamMemberId includeWebSessions:(nullable NSNumber *)includeWebSessions includeDesktopClients:(nullable NSNumber *)includeDesktopClients includeMobileClients:(nullable NSNumber *)includeMobileClients;Swift
func devicesListMemberDevices(_ teamMemberId: String, includeWebSessions: NSNumber?, includeDesktopClients: NSNumber?, includeMobileClients: NSNumber?) -> DBRpcTask<DBTEAMListMemberDevicesResult, DBTEAMListMemberDevicesError>Parameters
teamMemberIdThe team’s member id.
includeWebSessionsWhether to list web sessions of the team’s member.
includeDesktopClientsWhether to list linked desktop devices of the team’s member.
includeMobileClientsWhether to list linked mobile devices of the team’s member.
Return Value
Through the response callback, the caller will receive a
DBTEAMListMemberDevicesResultobject on success or aDBTEAMListMemberDevicesErrorobject on failure. -
List all device sessions of a team. Permission : Team member file access.
Declaration
Objective-C
- (nonnull DBRpcTask<DBTEAMListMembersDevicesResult *, DBTEAMListMembersDevicesError *> *) devicesListMembersDevices;Swift
func devicesListMembersDevices() -> DBRpcTask<DBTEAMListMembersDevicesResult, DBTEAMListMembersDevicesError>Return Value
Through the response callback, the caller will receive a
DBTEAMListMembersDevicesResultobject on success or aDBTEAMListMembersDevicesErrorobject on failure. -
List all device sessions of a team. Permission : Team member file access.
Declaration
Objective-C
- (nonnull DBRpcTask<DBTEAMListMembersDevicesResult *, DBTEAMListMembersDevicesError *> *) devicesListMembersDevices:(nullable NSString *)cursor includeWebSessions:(nullable NSNumber *)includeWebSessions includeDesktopClients:(nullable NSNumber *)includeDesktopClients includeMobileClients:(nullable NSNumber *)includeMobileClients;Swift
func devicesListMembersDevices(_ cursor: String?, includeWebSessions: NSNumber?, includeDesktopClients: NSNumber?, includeMobileClients: NSNumber?) -> DBRpcTask<DBTEAMListMembersDevicesResult, DBTEAMListMembersDevicesError>Parameters
cursorAt the first call to the
devicesListMembersDevicesthe cursor shouldn’t be passed. Then, if the result of the call includes a cursor, the following requests should include the received cursors in order to receive the next sub list of team devices.includeWebSessionsWhether to list web sessions of the team members.
includeDesktopClientsWhether to list desktop clients of the team members.
includeMobileClientsWhether to list mobile clients of the team members.
Return Value
Through the response callback, the caller will receive a
DBTEAMListMembersDevicesResultobject on success or aDBTEAMListMembersDevicesErrorobject on failure. -
Deprecated
devicesListTeamDevices is deprecated. Use devicesListMembersDevices.
DEPRECATED: List all device sessions of a team. Permission : Team member file access.
Declaration
Objective-C
- (nonnull DBRpcTask<DBTEAMListTeamDevicesResult *, DBTEAMListTeamDevicesError *> *)devicesListTeamDevices;Swift
func devicesListTeamDevices() -> DBRpcTask<DBTEAMListTeamDevicesResult, DBTEAMListTeamDevicesError>Return Value
Through the response callback, the caller will receive a
DBTEAMListTeamDevicesResultobject on success or aDBTEAMListTeamDevicesErrorobject on failure. -
Deprecated
devicesListTeamDevices is deprecated. Use devicesListMembersDevices.
DEPRECATED: List all device sessions of a team. Permission : Team member file access.
Declaration
Objective-C
- (nonnull DBRpcTask<DBTEAMListTeamDevicesResult *, DBTEAMListTeamDevicesError *> *) devicesListTeamDevices:(nullable NSString *)cursor includeWebSessions:(nullable NSNumber *)includeWebSessions includeDesktopClients:(nullable NSNumber *)includeDesktopClients includeMobileClients:(nullable NSNumber *)includeMobileClients;Swift
func devicesListTeamDevices(_ cursor: String?, includeWebSessions: NSNumber?, includeDesktopClients: NSNumber?, includeMobileClients: NSNumber?) -> DBRpcTask<DBTEAMListTeamDevicesResult, DBTEAMListTeamDevicesError>Parameters
cursorAt the first call to the
devicesListTeamDevicesthe cursor shouldn’t be passed. Then, if the result of the call includes a cursor, the following requests should include the received cursors in order to receive the next sub list of team devices.includeWebSessionsWhether to list web sessions of the team members.
includeDesktopClientsWhether to list desktop clients of the team members.
includeMobileClientsWhether to list mobile clients of the team members.
Return Value
Through the response callback, the caller will receive a
DBTEAMListTeamDevicesResultobject on success or aDBTEAMListTeamDevicesErrorobject on failure. -
Revoke a device session of a team’s member.
Declaration
Objective-C
- (nonnull DBRpcTask<DBNilObject *, DBTEAMRevokeDeviceSessionError *> *) devicesRevokeDeviceSession: (nonnull DBTEAMRevokeDeviceSessionArg *)revokeDeviceSessionArg;Swift
func devicesRevokeDeviceSession(_ revokeDeviceSessionArg: DBTEAMRevokeDeviceSessionArg) -> DBRpcTask<DBNilObject, DBTEAMRevokeDeviceSessionError>Parameters
revokeDeviceSessionArgThe RevokeDeviceSessionArg union
Return Value
Through the response callback, the caller will receive a
voidobject on success or aDBTEAMRevokeDeviceSessionErrorobject on failure. -
Revoke a list of device sessions of team members.
Declaration
Objective-C
- (nonnull DBRpcTask<DBTEAMRevokeDeviceSessionBatchResult *, DBTEAMRevokeDeviceSessionBatchError *> *) devicesRevokeDeviceSessionBatch: (nonnull NSArray<DBTEAMRevokeDeviceSessionArg *> *)revokeDevices;Swift
func devicesRevokeDeviceSessionBatch(_ revokeDevices: [DBTEAMRevokeDeviceSessionArg]) -> DBRpcTask<DBTEAMRevokeDeviceSessionBatchResult, DBTEAMRevokeDeviceSessionBatchError>Return Value
Through the response callback, the caller will receive a
DBTEAMRevokeDeviceSessionBatchResultobject on success or aDBTEAMRevokeDeviceSessionBatchErrorobject on failure. -
Get the values for one or more featues. This route allows you to check your account’s capability for what feature you can access or what value you have for certain features. Permission : Team information.
Declaration
Objective-C
- (nonnull DBRpcTask<DBTEAMFeaturesGetValuesBatchResult *, DBTEAMFeaturesGetValuesBatchError *> *)featuresGetValues: (nonnull NSArray<DBTEAMFeature *> *)features;Swift
func featuresGetValues(_ features: [DBTEAMFeature]) -> DBRpcTask<DBTEAMFeaturesGetValuesBatchResult, DBTEAMFeaturesGetValuesBatchError>Parameters
featuresA list of features in Feature. If the list is empty, this route will return FeaturesGetValuesBatchError.
Return Value
Through the response callback, the caller will receive a
DBTEAMFeaturesGetValuesBatchResultobject on success or aDBTEAMFeaturesGetValuesBatchErrorobject on failure. -
Retrieves information about a team.
Declaration
Objective-C
- (nonnull DBRpcTask<DBTEAMTeamGetInfoResult *, DBNilObject *> *)getInfo;Swift
func getInfo() -> DBRpcTask<DBTEAMTeamGetInfoResult, DBNilObject>Return Value
Through the response callback, the caller will receive a
DBTEAMTeamGetInfoResultobject on success or avoidobject on failure. -
Creates a new, empty group, with a requested name. Permission : Team member management.
Declaration
Objective-C
- (nonnull DBRpcTask<DBTEAMGroupFullInfo *, DBTEAMGroupCreateError *> *) groupsCreate:(nonnull NSString *)groupName;Swift
func groupsCreate(_ groupName: String) -> DBRpcTask<DBTEAMGroupFullInfo, DBTEAMGroupCreateError>Parameters
groupNameGroup name.
Return Value
Through the response callback, the caller will receive a
DBTEAMGroupFullInfoobject on success or aDBTEAMGroupCreateErrorobject on failure. -
Creates a new, empty group, with a requested name. Permission : Team member management.
Declaration
Objective-C
- (nonnull DBRpcTask<DBTEAMGroupFullInfo *, DBTEAMGroupCreateError *> *) groupsCreate:(nonnull NSString *)groupName addCreatorAsOwner:(nullable NSNumber *)addCreatorAsOwner groupExternalId:(nullable NSString *)groupExternalId groupManagementType: (nullable DBTEAMCOMMONGroupManagementType *)groupManagementType;Swift
func groupsCreate(_ groupName: String, addCreatorAsOwner: NSNumber?, groupExternalId: String?, groupManagementType: DBTEAMCOMMONGroupManagementType?) -> DBRpcTask<DBTEAMGroupFullInfo, DBTEAMGroupCreateError>Parameters
groupNameGroup name.
addCreatorAsOwnerAutomatically add the creator of the group.
groupExternalIdThe creator of a team can associate an arbitrary external ID to the group.
groupManagementTypeWhether the team can be managed by selected users, or only by team admins.
Return Value
Through the response callback, the caller will receive a
DBTEAMGroupFullInfoobject on success or aDBTEAMGroupCreateErrorobject on failure. -
Deletes a group. The group is deleted immediately. However the revoking of group-owned resources may take additional time. Use the
groupsJobStatusGetto determine whether this process has completed. Permission : Team member management.Declaration
Objective-C
- (nonnull DBRpcTask<DBASYNCLaunchEmptyResult *, DBTEAMGroupDeleteError *> *) groupsDelete:(nonnull DBTEAMGroupSelector *)groupSelector;Swift
func groupsDelete(_ groupSelector: DBTEAMGroupSelector) -> DBRpcTask<DBASYNCLaunchEmptyResult, DBTEAMGroupDeleteError>Parameters
groupSelectorArgument for selecting a single group, either by group_id or by external group ID.
Return Value
Through the response callback, the caller will receive a
DBASYNCLaunchEmptyResultobject on success or aDBTEAMGroupDeleteErrorobject on failure. -
Retrieves information about one or more groups. Note that the optional field
membersinDBTEAMGroupFullInfois not returned for system-managed groups. Permission : Team Information.Declaration
Objective-C
- (nonnull DBRpcTask<NSArray<DBTEAMGroupsGetInfoItem *> *, DBTEAMGroupsGetInfoError *> *)groupsGetInfo: (nonnull DBTEAMGroupsSelector *)groupsSelector;Swift
func groupsGetInfo(_ groupsSelector: DBTEAMGroupsSelector) -> DBRpcTask<NSArray, DBTEAMGroupsGetInfoError>Parameters
groupsSelectorArgument for selecting a list of groups, either by group_ids, or external group IDs.
Return Value
Through the response callback, the caller will receive a
NSArray<DBTEAMGroupsGetInfoItem *>object on success or aDBTEAMGroupsGetInfoErrorobject on failure. -
Once an async_job_id is returned from
groupsDelete,groupsMembersAdd, orgroupsMembersRemoveuse this method to poll the status of granting/revoking group members’ access to group-owned resources. Permission : Team member management.Declaration
Objective-C
- (nonnull DBRpcTask<DBASYNCPollEmptyResult *, DBTEAMGroupsPollError *> *) groupsJobStatusGet:(nonnull NSString *)asyncJobId;Swift
func groupsJobStatusGet(_ asyncJobId: String) -> DBRpcTask<DBASYNCPollEmptyResult, DBTEAMGroupsPollError>Parameters
asyncJobIdId of the asynchronous job. This is the value of a response returned from the method that launched the job.
Return Value
Through the response callback, the caller will receive a
DBASYNCPollEmptyResultobject on success or aDBTEAMGroupsPollErrorobject on failure. -
Lists groups on a team. Permission : Team Information.
Declaration
Objective-C
- (nonnull DBRpcTask<DBTEAMGroupsListResult *, DBNilObject *> *)groupsList;Swift
func groupsList() -> DBRpcTask<DBTEAMGroupsListResult, DBNilObject>Return Value
Through the response callback, the caller will receive a
DBTEAMGroupsListResultobject on success or avoidobject on failure. -
Lists groups on a team. Permission : Team Information.
Declaration
Objective-C
- (nonnull DBRpcTask<DBTEAMGroupsListResult *, DBNilObject *> *)groupsList: (nullable NSNumber *)limit;Swift
func groupsList(_ limit: NSNumber?) -> DBRpcTask<DBTEAMGroupsListResult, DBNilObject>Parameters
limitNumber of results to return per call.
Return Value
Through the response callback, the caller will receive a
DBTEAMGroupsListResultobject on success or avoidobject on failure. -
Once a cursor has been retrieved from
groupsList, use this to paginate through all groups. Permission : Team Information.Declaration
Objective-C
- (nonnull DBRpcTask<DBTEAMGroupsListResult *, DBTEAMGroupsListContinueError *> *)groupsListContinue:(nonnull NSString *)cursor;Swift
func groupsListContinue(_ cursor: String) -> DBRpcTask<DBTEAMGroupsListResult, DBTEAMGroupsListContinueError>Parameters
cursorIndicates from what point to get the next set of groups.
Return Value
Through the response callback, the caller will receive a
DBTEAMGroupsListResultobject on success or aDBTEAMGroupsListContinueErrorobject on failure. -
Adds members to a group. The members are added immediately. However the granting of group-owned resources may take additional time. Use the
groupsJobStatusGetto determine whether this process has completed. Permission : Team member management.Declaration
Objective-C
- (nonnull DBRpcTask<DBTEAMGroupMembersChangeResult *, DBTEAMGroupMembersAddError *> *) groupsMembersAdd:(nonnull DBTEAMGroupSelector *)group members:(nonnull NSArray<DBTEAMMemberAccess *> *)members;Swift
func groupsMembersAdd(_ group: DBTEAMGroupSelector, members: [DBTEAMMemberAccess]) -> DBRpcTask<DBTEAMGroupMembersChangeResult, DBTEAMGroupMembersAddError>Parameters
groupGroup to which users will be added.
membersList of users to be added to the group.
Return Value
Through the response callback, the caller will receive a
DBTEAMGroupMembersChangeResultobject on success or aDBTEAMGroupMembersAddErrorobject on failure. -
Adds members to a group. The members are added immediately. However the granting of group-owned resources may take additional time. Use the
groupsJobStatusGetto determine whether this process has completed. Permission : Team member management.Declaration
Objective-C
- (nonnull DBRpcTask<DBTEAMGroupMembersChangeResult *, DBTEAMGroupMembersAddError *> *) groupsMembersAdd:(nonnull DBTEAMGroupSelector *)group members:(nonnull NSArray<DBTEAMMemberAccess *> *)members returnMembers:(nullable NSNumber *)returnMembers;Swift
func groupsMembersAdd(_ group: DBTEAMGroupSelector, members: [DBTEAMMemberAccess], returnMembers: NSNumber?) -> DBRpcTask<DBTEAMGroupMembersChangeResult, DBTEAMGroupMembersAddError>Parameters
groupGroup to which users will be added.
membersList of users to be added to the group.
Return Value
Through the response callback, the caller will receive a
DBTEAMGroupMembersChangeResultobject on success or aDBTEAMGroupMembersAddErrorobject on failure. -
Lists members of a group. Permission : Team Information.
Declaration
Objective-C
- (nonnull DBRpcTask<DBTEAMGroupsMembersListResult *, DBTEAMGroupSelectorError *> *)groupsMembersList: (nonnull DBTEAMGroupSelector *)group;Swift
func groupsMembersList(_ group: DBTEAMGroupSelector) -> DBRpcTask<DBTEAMGroupsMembersListResult, DBTEAMGroupSelectorError>Parameters
groupThe group whose members are to be listed.
Return Value
Through the response callback, the caller will receive a
DBTEAMGroupsMembersListResultobject on success or aDBTEAMGroupSelectorErrorobject on failure. -
Lists members of a group. Permission : Team Information.
Declaration
Objective-C
- (nonnull DBRpcTask<DBTEAMGroupsMembersListResult *, DBTEAMGroupSelectorError *> *) groupsMembersList:(nonnull DBTEAMGroupSelector *)group limit:(nullable NSNumber *)limit;Swift
func groupsMembersList(_ group: DBTEAMGroupSelector, limit: NSNumber?) -> DBRpcTask<DBTEAMGroupsMembersListResult, DBTEAMGroupSelectorError>Parameters
groupThe group whose members are to be listed.
limitNumber of results to return per call.
Return Value
Through the response callback, the caller will receive a
DBTEAMGroupsMembersListResultobject on success or aDBTEAMGroupSelectorErrorobject on failure. -
Once a cursor has been retrieved from
groupsMembersList, use this to paginate through all members of the group. Permission : Team information.Declaration
Objective-C
- (nonnull DBRpcTask<DBTEAMGroupsMembersListResult *, DBTEAMGroupsMembersListContinueError *> *) groupsMembersListContinue:(nonnull NSString *)cursor;Swift
func groupsMembersListContinue(_ cursor: String) -> DBRpcTask<DBTEAMGroupsMembersListResult, DBTEAMGroupsMembersListContinueError>Parameters
cursorIndicates from what point to get the next set of groups.
Return Value
Through the response callback, the caller will receive a
DBTEAMGroupsMembersListResultobject on success or aDBTEAMGroupsMembersListContinueErrorobject on failure. -
Removes members from a group. The members are removed immediately. However the revoking of group-owned resources may take additional time. Use the
groupsJobStatusGetto determine whether this process has completed. This method permits removing the only owner of a group, even in cases where this is not possible via the web client. Permission : Team member management.Declaration
Objective-C
- (nonnull DBRpcTask<DBTEAMGroupMembersChangeResult *, DBTEAMGroupMembersRemoveError *> *) groupsMembersRemove:(nonnull DBTEAMGroupSelector *)group users:(nonnull NSArray<DBTEAMUserSelectorArg *> *)users;Swift
func groupsMembersRemove(_ group: DBTEAMGroupSelector, users: [DBTEAMUserSelectorArg]) -> DBRpcTask<DBTEAMGroupMembersChangeResult, DBTEAMGroupMembersRemoveError>Parameters
groupGroup from which users will be removed.
usersList of users to be removed from the group.
Return Value
Through the response callback, the caller will receive a
DBTEAMGroupMembersChangeResultobject on success or aDBTEAMGroupMembersRemoveErrorobject on failure. -
Removes members from a group. The members are removed immediately. However the revoking of group-owned resources may take additional time. Use the
groupsJobStatusGetto determine whether this process has completed. This method permits removing the only owner of a group, even in cases where this is not possible via the web client. Permission : Team member management.Declaration
Objective-C
- (nonnull DBRpcTask<DBTEAMGroupMembersChangeResult *, DBTEAMGroupMembersRemoveError *> *) groupsMembersRemove:(nonnull DBTEAMGroupSelector *)group users:(nonnull NSArray<DBTEAMUserSelectorArg *> *)users returnMembers:(nullable NSNumber *)returnMembers;Swift
func groupsMembersRemove(_ group: DBTEAMGroupSelector, users: [DBTEAMUserSelectorArg], returnMembers: NSNumber?) -> DBRpcTask<DBTEAMGroupMembersChangeResult, DBTEAMGroupMembersRemoveError>Parameters
groupGroup from which users will be removed.
usersList of users to be removed from the group.
Return Value
Through the response callback, the caller will receive a
DBTEAMGroupMembersChangeResultobject on success or aDBTEAMGroupMembersRemoveErrorobject on failure. -
Sets a member’s access type in a group. Permission : Team member management.
Declaration
Objective-C
- (nonnull DBRpcTask<NSArray<DBTEAMGroupsGetInfoItem *> *, DBTEAMGroupMemberSetAccessTypeError *> *) groupsMembersSetAccessType:(nonnull DBTEAMGroupSelector *)group user:(nonnull DBTEAMUserSelectorArg *)user accessType:(nonnull DBTEAMGroupAccessType *)accessType;Swift
func groupsMembersSetAccessType(_ group: DBTEAMGroupSelector, user: DBTEAMUserSelectorArg, accessType: DBTEAMGroupAccessType) -> DBRpcTask<NSArray, DBTEAMGroupMemberSetAccessTypeError>Parameters
accessTypeNew group access type the user will have.
Return Value
Through the response callback, the caller will receive a
NSArray<DBTEAMGroupsGetInfoItem *>object on success or aDBTEAMGroupMemberSetAccessTypeErrorobject on failure. -
Sets a member’s access type in a group. Permission : Team member management.
Declaration
Objective-C
- (nonnull DBRpcTask<NSArray<DBTEAMGroupsGetInfoItem *> *, DBTEAMGroupMemberSetAccessTypeError *> *) groupsMembersSetAccessType:(nonnull DBTEAMGroupSelector *)group user:(nonnull DBTEAMUserSelectorArg *)user accessType:(nonnull DBTEAMGroupAccessType *)accessType returnMembers:(nullable NSNumber *)returnMembers;Swift
func groupsMembersSetAccessType(_ group: DBTEAMGroupSelector, user: DBTEAMUserSelectorArg, accessType: DBTEAMGroupAccessType, returnMembers: NSNumber?) -> DBRpcTask<NSArray, DBTEAMGroupMemberSetAccessTypeError>Parameters
accessTypeNew group access type the user will have.
returnMembersWhether to return the list of members in the group. Note that the default value will cause all the group members to be returned in the response. This may take a long time for large groups.
Return Value
Through the response callback, the caller will receive a
NSArray<DBTEAMGroupsGetInfoItem *>object on success or aDBTEAMGroupMemberSetAccessTypeErrorobject on failure. -
Updates a group’s name and/or external ID. Permission : Team member management.
Declaration
Objective-C
- (nonnull DBRpcTask<DBTEAMGroupFullInfo *, DBTEAMGroupUpdateError *> *) groupsUpdate:(nonnull DBTEAMGroupSelector *)group;Swift
func groupsUpdate(_ group: DBTEAMGroupSelector) -> DBRpcTask<DBTEAMGroupFullInfo, DBTEAMGroupUpdateError>Parameters
groupSpecify a group.
Return Value
Through the response callback, the caller will receive a
DBTEAMGroupFullInfoobject on success or aDBTEAMGroupUpdateErrorobject on failure. -
Updates a group’s name and/or external ID. Permission : Team member management.
Declaration
Objective-C
- (nonnull DBRpcTask<DBTEAMGroupFullInfo *, DBTEAMGroupUpdateError *> *) groupsUpdate:(nonnull DBTEAMGroupSelector *)group returnMembers:(nullable NSNumber *)returnMembers dNewGroupName:(nullable NSString *)dNewGroupName dNewGroupExternalId:(nullable NSString *)dNewGroupExternalId dNewGroupManagementType: (nullable DBTEAMCOMMONGroupManagementType *)dNewGroupManagementType;Swift
func groupsUpdate(_ group: DBTEAMGroupSelector, returnMembers: NSNumber?, dNewGroupName: String?, dNewGroupExternalId: String?, dNewGroupManagementType: DBTEAMCOMMONGroupManagementType?) -> DBRpcTask<DBTEAMGroupFullInfo, DBTEAMGroupUpdateError>Parameters
groupSpecify a group.
dNewGroupNameOptional argument. Set group name to this if provided.
dNewGroupExternalIdOptional argument. New group external ID. If the argument is None, the group’s external_id won’t be updated. If the argument is empty string, the group’s external id will be cleared.
dNewGroupManagementTypeSet new group management type, if provided.
Return Value
Through the response callback, the caller will receive a
DBTEAMGroupFullInfoobject on success or aDBTEAMGroupUpdateErrorobject on failure. -
Creates new legal hold policy. Note: Legal Holds is a paid add-on. Not all teams have the feature. Permission : Team member file access.
Declaration
Objective-C
- (nonnull DBRpcTask<DBTEAMLegalHoldPolicy *, DBTEAMLegalHoldsPolicyCreateError *> *) legalHoldsCreatePolicy:(nonnull NSString *)name members:(nonnull NSArray<NSString *> *)members;Swift
func legalHoldsCreatePolicy(_ name: String, members: [String]) -> DBRpcTask<DBTEAMLegalHoldPolicy, DBTEAMLegalHoldsPolicyCreateError>Parameters
namePolicy name.
membersList of team member IDs added to the hold.
Return Value
Through the response callback, the caller will receive a
DBTEAMLegalHoldPolicyobject on success or aDBTEAMLegalHoldsPolicyCreateErrorobject on failure. -
Creates new legal hold policy. Note: Legal Holds is a paid add-on. Not all teams have the feature. Permission : Team member file access.
Declaration
Objective-C
- (nonnull DBRpcTask<DBTEAMLegalHoldPolicy *, DBTEAMLegalHoldsPolicyCreateError *> *) legalHoldsCreatePolicy:(nonnull NSString *)name members:(nonnull NSArray<NSString *> *)members description_:(nullable NSString *)description_ startDate:(nullable NSDate *)startDate endDate:(nullable NSDate *)endDate;Swift
func legalHoldsCreatePolicy(_ name: String, members: [String], description_: String?, start startDate: Date?, end endDate: Date?) -> DBRpcTask<DBTEAMLegalHoldPolicy, DBTEAMLegalHoldsPolicyCreateError>Parameters
namePolicy name.
description_A description of the legal hold policy.
membersList of team member IDs added to the hold.
startDatestart date of the legal hold policy.
endDateend date of the legal hold policy.
Return Value
Through the response callback, the caller will receive a
DBTEAMLegalHoldPolicyobject on success or aDBTEAMLegalHoldsPolicyCreateErrorobject on failure. -
Gets a legal hold by Id. Note: Legal Holds is a paid add-on. Not all teams have the feature. Permission : Team member file access.
Declaration
Objective-C
- (nonnull DBRpcTask<DBTEAMLegalHoldPolicy *, DBTEAMLegalHoldsGetPolicyError *> *)legalHoldsGetPolicy:(nonnull NSString *)id_;Swift
func legalHoldsGetPolicy(_ id_: String) -> DBRpcTask<DBTEAMLegalHoldPolicy, DBTEAMLegalHoldsGetPolicyError>Parameters
id_The legal hold Id.
Return Value
Through the response callback, the caller will receive a
DBTEAMLegalHoldPolicyobject on success or aDBTEAMLegalHoldsGetPolicyErrorobject on failure. -
List the file metadata that’s under the hold. Note: Legal Holds is a paid add-on. Not all teams have the feature. Permission : Team member file access.
Declaration
Objective-C
- (nonnull DBRpcTask<DBTEAMLegalHoldsListHeldRevisionResult *, DBTEAMLegalHoldsListHeldRevisionsError *> *) legalHoldsListHeldRevisions:(nonnull NSString *)id_;Swift
func legalHoldsListHeldRevisions(_ id_: String) -> DBRpcTask<DBTEAMLegalHoldsListHeldRevisionResult, DBTEAMLegalHoldsListHeldRevisionsError>Parameters
id_The legal hold Id.
Return Value
Through the response callback, the caller will receive a
DBTEAMLegalHoldsListHeldRevisionResultobject on success or aDBTEAMLegalHoldsListHeldRevisionsErrorobject on failure. -
Continue listing the file metadata that’s under the hold. Note: Legal Holds is a paid add-on. Not all teams have the feature. Permission : Team member file access.
Declaration
Objective-C
- (nonnull DBRpcTask<DBTEAMLegalHoldsListHeldRevisionResult *, DBTEAMLegalHoldsListHeldRevisionsError *> *) legalHoldsListHeldRevisionsContinue:(nonnull NSString *)id_;Swift
func legalHoldsListHeldRevisionsContinue(_ id_: String) -> DBRpcTask<DBTEAMLegalHoldsListHeldRevisionResult, DBTEAMLegalHoldsListHeldRevisionsError>Parameters
id_The legal hold Id.
Return Value
Through the response callback, the caller will receive a
DBTEAMLegalHoldsListHeldRevisionResultobject on success or aDBTEAMLegalHoldsListHeldRevisionsErrorobject on failure. -
Continue listing the file metadata that’s under the hold. Note: Legal Holds is a paid add-on. Not all teams have the feature. Permission : Team member file access.
Declaration
Objective-C
- (nonnull DBRpcTask<DBTEAMLegalHoldsListHeldRevisionResult *, DBTEAMLegalHoldsListHeldRevisionsError *> *) legalHoldsListHeldRevisionsContinue:(nonnull NSString *)id_ cursor:(nullable NSString *)cursor;Swift
func legalHoldsListHeldRevisionsContinue(_ id_: String, cursor: String?) -> DBRpcTask<DBTEAMLegalHoldsListHeldRevisionResult, DBTEAMLegalHoldsListHeldRevisionsError>Parameters
id_The legal hold Id.
cursorThe cursor idicates where to continue reading file metadata entries for the next API call. When there are no more entries, the cursor will return none.
Return Value
Through the response callback, the caller will receive a
DBTEAMLegalHoldsListHeldRevisionResultobject on success or aDBTEAMLegalHoldsListHeldRevisionsErrorobject on failure. -
Lists legal holds on a team. Note: Legal Holds is a paid add-on. Not all teams have the feature. Permission : Team member file access.
Declaration
Objective-C
- (nonnull DBRpcTask<DBTEAMLegalHoldsListPoliciesResult *, DBTEAMLegalHoldsListPoliciesError *> *) legalHoldsListPolicies;Swift
func legalHoldsListPolicies() -> DBRpcTask<DBTEAMLegalHoldsListPoliciesResult, DBTEAMLegalHoldsListPoliciesError>Return Value
Through the response callback, the caller will receive a
DBTEAMLegalHoldsListPoliciesResultobject on success or aDBTEAMLegalHoldsListPoliciesErrorobject on failure. -
Lists legal holds on a team. Note: Legal Holds is a paid add-on. Not all teams have the feature. Permission : Team member file access.
Declaration
Objective-C
- (nonnull DBRpcTask<DBTEAMLegalHoldsListPoliciesResult *, DBTEAMLegalHoldsListPoliciesError *> *) legalHoldsListPolicies:(nullable NSNumber *)includeReleased;Swift
func legalHoldsListPolicies(_ includeReleased: NSNumber?) -> DBRpcTask<DBTEAMLegalHoldsListPoliciesResult, DBTEAMLegalHoldsListPoliciesError>Parameters
includeReleasedWhether to return holds that were released.
Return Value
Through the response callback, the caller will receive a
DBTEAMLegalHoldsListPoliciesResultobject on success or aDBTEAMLegalHoldsListPoliciesErrorobject on failure. -
Releases a legal hold by Id. Note: Legal Holds is a paid add-on. Not all teams have the feature. Permission : Team member file access.
Declaration
Objective-C
- (nonnull DBRpcTask<DBNilObject *, DBTEAMLegalHoldsPolicyReleaseError *> *) legalHoldsReleasePolicy:(nonnull NSString *)id_;Swift
func legalHoldsReleasePolicy(_ id_: String) -> DBRpcTask<DBNilObject, DBTEAMLegalHoldsPolicyReleaseError>Parameters
id_The legal hold Id.
Return Value
Through the response callback, the caller will receive a
voidobject on success or aDBTEAMLegalHoldsPolicyReleaseErrorobject on failure. -
Updates a legal hold. Note: Legal Holds is a paid add-on. Not all teams have the feature. Permission : Team member file access.
Declaration
Objective-C
- (nonnull DBRpcTask<DBTEAMLegalHoldPolicy *, DBTEAMLegalHoldsPolicyUpdateError *> *) legalHoldsUpdatePolicy:(nonnull NSString *)id_;Swift
func legalHoldsUpdatePolicy(_ id_: String) -> DBRpcTask<DBTEAMLegalHoldPolicy, DBTEAMLegalHoldsPolicyUpdateError>Parameters
id_The legal hold Id.
Return Value
Through the response callback, the caller will receive a
DBTEAMLegalHoldPolicyobject on success or aDBTEAMLegalHoldsPolicyUpdateErrorobject on failure. -
Updates a legal hold. Note: Legal Holds is a paid add-on. Not all teams have the feature. Permission : Team member file access.
Declaration
Objective-C
- (nonnull DBRpcTask<DBTEAMLegalHoldPolicy *, DBTEAMLegalHoldsPolicyUpdateError *> *) legalHoldsUpdatePolicy:(nonnull NSString *)id_ name:(nullable NSString *)name description_:(nullable NSString *)description_ members:(nullable NSArray<NSString *> *)members;Swift
func legalHoldsUpdatePolicy(_ id_: String, name: String?, description_: String?, members: [String]?) -> DBRpcTask<DBTEAMLegalHoldPolicy, DBTEAMLegalHoldsPolicyUpdateError>Parameters
id_The legal hold Id.
namePolicy new name.
description_Policy new description.
membersList of team member IDs to apply the policy on.
Return Value
Through the response callback, the caller will receive a
DBTEAMLegalHoldPolicyobject on success or aDBTEAMLegalHoldsPolicyUpdateErrorobject on failure. -
List all linked applications of the team member. Note, this endpoint does not list any team-linked applications.
Declaration
Objective-C
- (nonnull DBRpcTask<DBTEAMListMemberAppsResult *, DBTEAMListMemberAppsError *> *)linkedAppsListMemberLinkedApps:(nonnull NSString *)teamMemberId;Swift
func linkedAppsListMemberLinkedApps(_ teamMemberId: String) -> DBRpcTask<DBTEAMListMemberAppsResult, DBTEAMListMemberAppsError>Parameters
teamMemberIdThe team member id.
Return Value
Through the response callback, the caller will receive a
DBTEAMListMemberAppsResultobject on success or aDBTEAMListMemberAppsErrorobject on failure. -
List all applications linked to the team members’ accounts. Note, this endpoint does not list any team-linked applications.
Declaration
Objective-C
- (nonnull DBRpcTask<DBTEAMListMembersAppsResult *, DBTEAMListMembersAppsError *> *) linkedAppsListMembersLinkedApps;Swift
func linkedAppsListMembersLinkedApps() -> DBRpcTask<DBTEAMListMembersAppsResult, DBTEAMListMembersAppsError>Return Value
Through the response callback, the caller will receive a
DBTEAMListMembersAppsResultobject on success or aDBTEAMListMembersAppsErrorobject on failure. -
List all applications linked to the team members’ accounts. Note, this endpoint does not list any team-linked applications.
Declaration
Objective-C
- (nonnull DBRpcTask<DBTEAMListMembersAppsResult *, DBTEAMListMembersAppsError *> *) linkedAppsListMembersLinkedApps:(nullable NSString *)cursor;Swift
func linkedAppsListMembersLinkedApps(_ cursor: String?) -> DBRpcTask<DBTEAMListMembersAppsResult, DBTEAMListMembersAppsError>Parameters
cursorAt the first call to the
linkedAppsListMembersLinkedAppsthe cursor shouldn’t be passed. Then, if the result of the call includes a cursor, the following requests should include the received cursors in order to receive the next sub list of the team applications.Return Value
Through the response callback, the caller will receive a
DBTEAMListMembersAppsResultobject on success or aDBTEAMListMembersAppsErrorobject on failure. -
Deprecated
linkedAppsListTeamLinkedApps is deprecated. Use linkedAppsListMembersLinkedApps.
DEPRECATED: List all applications linked to the team members’ accounts. Note, this endpoint doesn’t list any team-linked applications.
Declaration
Objective-C
- (nonnull DBRpcTask<DBTEAMListTeamAppsResult *, DBTEAMListTeamAppsError *> *) linkedAppsListTeamLinkedApps;Swift
func linkedAppsListTeamLinkedApps() -> DBRpcTask<DBTEAMListTeamAppsResult, DBTEAMListTeamAppsError>Return Value
Through the response callback, the caller will receive a
DBTEAMListTeamAppsResultobject on success or aDBTEAMListTeamAppsErrorobject on failure. -
Deprecated
linkedAppsListTeamLinkedApps is deprecated. Use linkedAppsListMembersLinkedApps.
DEPRECATED: List all applications linked to the team members’ accounts. Note, this endpoint doesn’t list any team-linked applications.
Declaration
Objective-C
- (nonnull DBRpcTask<DBTEAMListTeamAppsResult *, DBTEAMListTeamAppsError *> *) linkedAppsListTeamLinkedApps:(nullable NSString *)cursor;Swift
func linkedAppsListTeamLinkedApps(_ cursor: String?) -> DBRpcTask<DBTEAMListTeamAppsResult, DBTEAMListTeamAppsError>Parameters
cursorAt the first call to the
linkedAppsListTeamLinkedAppsthe cursor shouldn’t be passed. Then, if the result of the call includes a cursor, the following requests should include the received cursors in order to receive the next sub list of the team applications.Return Value
Through the response callback, the caller will receive a
DBTEAMListTeamAppsResultobject on success or aDBTEAMListTeamAppsErrorobject on failure. -
Revoke a linked application of the team member.
Declaration
Objective-C
- (nonnull DBRpcTask<DBNilObject *, DBTEAMRevokeLinkedAppError *> *) linkedAppsRevokeLinkedApp:(nonnull NSString *)appId teamMemberId:(nonnull NSString *)teamMemberId;Swift
func linkedAppsRevokeLinkedApp(_ appId: String, teamMemberId: String) -> DBRpcTask<DBNilObject, DBTEAMRevokeLinkedAppError>Parameters
appIdThe application’s unique id.
teamMemberIdThe unique id of the member owning the device.
Return Value
Through the response callback, the caller will receive a
voidobject on success or aDBTEAMRevokeLinkedAppErrorobject on failure. -
Revoke a linked application of the team member.
Declaration
Objective-C
- (nonnull DBRpcTask<DBNilObject *, DBTEAMRevokeLinkedAppError *> *) linkedAppsRevokeLinkedApp:(nonnull NSString *)appId teamMemberId:(nonnull NSString *)teamMemberId keepAppFolder:(nullable NSNumber *)keepAppFolder;Swift
func linkedAppsRevokeLinkedApp(_ appId: String, teamMemberId: String, keepAppFolder: NSNumber?) -> DBRpcTask<DBNilObject, DBTEAMRevokeLinkedAppError>Parameters
appIdThe application’s unique id.
teamMemberIdThe unique id of the member owning the device.
keepAppFolderThis flag is not longer supported, the application dedicated folder (in case the application uses one) will be kept.
Return Value
Through the response callback, the caller will receive a
voidobject on success or aDBTEAMRevokeLinkedAppErrorobject on failure. -
Revoke a list of linked applications of the team members.
Declaration
Objective-C
- (nonnull DBRpcTask<DBTEAMRevokeLinkedAppBatchResult *, DBTEAMRevokeLinkedAppBatchError *> *) linkedAppsRevokeLinkedAppBatch: (nonnull NSArray<DBTEAMRevokeLinkedApiAppArg *> *)revokeLinkedApp;Swift
func linkedAppsRevokeLinkedAppBatch(_ revokeLinkedApp: [DBTEAMRevokeLinkedApiAppArg]) -> DBRpcTask<DBTEAMRevokeLinkedAppBatchResult, DBTEAMRevokeLinkedAppBatchError>Return Value
Through the response callback, the caller will receive a
DBTEAMRevokeLinkedAppBatchResultobject on success or aDBTEAMRevokeLinkedAppBatchErrorobject on failure. -
Add users to member space limits excluded users list.
Declaration
Objective-C
- (nonnull DBRpcTask<DBTEAMExcludedUsersUpdateResult *, DBTEAMExcludedUsersUpdateError *> *) memberSpaceLimitsExcludedUsersAdd;Swift
func memberSpaceLimitsExcludedUsersAdd() -> DBRpcTask<DBTEAMExcludedUsersUpdateResult, DBTEAMExcludedUsersUpdateError>Return Value
Through the response callback, the caller will receive a
DBTEAMExcludedUsersUpdateResultobject on success or aDBTEAMExcludedUsersUpdateErrorobject on failure. -
Add users to member space limits excluded users list.
Declaration
Objective-C
- (nonnull DBRpcTask<DBTEAMExcludedUsersUpdateResult *, DBTEAMExcludedUsersUpdateError *> *) memberSpaceLimitsExcludedUsersAdd: (nullable NSArray<DBTEAMUserSelectorArg *> *)users;Swift
func memberSpaceLimitsExcludedUsersAdd(_ users: [DBTEAMUserSelectorArg]?) -> DBRpcTask<DBTEAMExcludedUsersUpdateResult, DBTEAMExcludedUsersUpdateError>Parameters
usersList of users to be added/removed.
Return Value
Through the response callback, the caller will receive a
DBTEAMExcludedUsersUpdateResultobject on success or aDBTEAMExcludedUsersUpdateErrorobject on failure. -
List member space limits excluded users.
Declaration
Objective-C
- (nonnull DBRpcTask<DBTEAMExcludedUsersListResult *, DBTEAMExcludedUsersListError *> *) memberSpaceLimitsExcludedUsersList;Swift
func memberSpaceLimitsExcludedUsersList() -> DBRpcTask<DBTEAMExcludedUsersListResult, DBTEAMExcludedUsersListError>Return Value
Through the response callback, the caller will receive a
DBTEAMExcludedUsersListResultobject on success or aDBTEAMExcludedUsersListErrorobject on failure. -
List member space limits excluded users.
Declaration
Objective-C
- (nonnull DBRpcTask<DBTEAMExcludedUsersListResult *, DBTEAMExcludedUsersListError *> *) memberSpaceLimitsExcludedUsersList:(nullable NSNumber *)limit;Swift
func memberSpaceLimitsExcludedUsersList(_ limit: NSNumber?) -> DBRpcTask<DBTEAMExcludedUsersListResult, DBTEAMExcludedUsersListError>Parameters
limitNumber of results to return per call.
Return Value
Through the response callback, the caller will receive a
DBTEAMExcludedUsersListResultobject on success or aDBTEAMExcludedUsersListErrorobject on failure. -
Continue listing member space limits excluded users.
Declaration
Objective-C
- (nonnull DBRpcTask<DBTEAMExcludedUsersListResult *, DBTEAMExcludedUsersListContinueError *> *) memberSpaceLimitsExcludedUsersListContinue:(nonnull NSString *)cursor;Swift
func memberSpaceLimitsExcludedUsersListContinue(_ cursor: String) -> DBRpcTask<DBTEAMExcludedUsersListResult, DBTEAMExcludedUsersListContinueError>Parameters
cursorIndicates from what point to get the next set of users.
Return Value
Through the response callback, the caller will receive a
DBTEAMExcludedUsersListResultobject on success or aDBTEAMExcludedUsersListContinueErrorobject on failure. -
Remove users from member space limits excluded users list.
Declaration
Objective-C
- (nonnull DBRpcTask<DBTEAMExcludedUsersUpdateResult *, DBTEAMExcludedUsersUpdateError *> *) memberSpaceLimitsExcludedUsersRemove;Swift
func memberSpaceLimitsExcludedUsersRemove() -> DBRpcTask<DBTEAMExcludedUsersUpdateResult, DBTEAMExcludedUsersUpdateError>Return Value
Through the response callback, the caller will receive a
DBTEAMExcludedUsersUpdateResultobject on success or aDBTEAMExcludedUsersUpdateErrorobject on failure. -
Remove users from member space limits excluded users list.
Declaration
Objective-C
- (nonnull DBRpcTask<DBTEAMExcludedUsersUpdateResult *, DBTEAMExcludedUsersUpdateError *> *) memberSpaceLimitsExcludedUsersRemove: (nullable NSArray<DBTEAMUserSelectorArg *> *)users;Swift
func memberSpaceLimitsExcludedUsersRemove(_ users: [DBTEAMUserSelectorArg]?) -> DBRpcTask<DBTEAMExcludedUsersUpdateResult, DBTEAMExcludedUsersUpdateError>Parameters
usersList of users to be added/removed.
Return Value
Through the response callback, the caller will receive a
DBTEAMExcludedUsersUpdateResultobject on success or aDBTEAMExcludedUsersUpdateErrorobject on failure. -
Get users custom quota. Returns none as the custom quota if none was set. A maximum of 1000 members can be specified in a single call.
Declaration
Objective-C
- (nonnull DBRpcTask<NSArray<DBTEAMCustomQuotaResult *> *, DBTEAMCustomQuotaError *> *) memberSpaceLimitsGetCustomQuota: (nonnull NSArray<DBTEAMUserSelectorArg *> *)users;Swift
func memberSpaceLimitsGetCustomQuota(_ users: [DBTEAMUserSelectorArg]) -> DBRpcTask<NSArray, DBTEAMCustomQuotaError>Parameters
usersList of users.
Return Value
Through the response callback, the caller will receive a
NSArray<DBTEAMCustomQuotaResult *>object on success or aDBTEAMCustomQuotaErrorobject on failure. -
Remove users custom quota. A maximum of 1000 members can be specified in a single call.
Declaration
Objective-C
- (nonnull DBRpcTask<NSArray<DBTEAMRemoveCustomQuotaResult *> *, DBTEAMCustomQuotaError *> *) memberSpaceLimitsRemoveCustomQuota: (nonnull NSArray<DBTEAMUserSelectorArg *> *)users;Swift
func memberSpaceLimitsRemoveCustomQuota(_ users: [DBTEAMUserSelectorArg]) -> DBRpcTask<NSArray, DBTEAMCustomQuotaError>Parameters
usersList of users.
Return Value
Through the response callback, the caller will receive a
NSArray<DBTEAMRemoveCustomQuotaResult *>object on success or aDBTEAMCustomQuotaErrorobject on failure. -
Set users custom quota. Custom quota has to be at least 15GB. A maximum of 1000 members can be specified in a single call.
Declaration
Objective-C
- (nonnull DBRpcTask<NSArray<DBTEAMCustomQuotaResult *> *, DBTEAMSetCustomQuotaError *> *) memberSpaceLimitsSetCustomQuota: (nonnull NSArray<DBTEAMUserCustomQuotaArg *> *)usersAndQuotas;Swift
func memberSpaceLimitsSetCustomQuota(_ usersAndQuotas: [DBTEAMUserCustomQuotaArg]) -> DBRpcTask<NSArray, DBTEAMSetCustomQuotaError>Parameters
usersAndQuotasList of users and their custom quotas.
Return Value
Through the response callback, the caller will receive a
NSArray<DBTEAMCustomQuotaResult *>object on success or aDBTEAMSetCustomQuotaErrorobject on failure. -
Adds members to a team. Permission : Team member management A maximum of 20 members can be specified in a single call. If no Dropbox account exists with the email address specified, a new Dropbox account will be created with the given email address, and that account will be invited to the team. If a personal Dropbox account exists with the email address specified in the call, this call will create a placeholder Dropbox account for the user on the team and send an email inviting the user to migrate their existing personal account onto the team. Team member management apps are required to set an initial given_name and surname for a user to use in the team invitation and for ‘Perform as team member’ actions taken on the user before they become ‘active’.
Declaration
Objective-C
- (nonnull DBRpcTask<DBTEAMMembersAddLaunchV2Result *, DBNilObject *> *) membersAddV2:(nonnull NSArray<DBTEAMMemberAddV2Arg *> *)dNewMembers;Swift
func membersAddV2(_ dNewMembers: [DBTEAMMemberAddV2Arg]) -> DBRpcTask<DBTEAMMembersAddLaunchV2Result, DBNilObject>Parameters
dNewMembersDetails of new members to be added to the team.
Return Value
Through the response callback, the caller will receive a
DBTEAMMembersAddLaunchV2Resultobject on success or avoidobject on failure. -
Adds members to a team. Permission : Team member management A maximum of 20 members can be specified in a single call. If no Dropbox account exists with the email address specified, a new Dropbox account will be created with the given email address, and that account will be invited to the team. If a personal Dropbox account exists with the email address specified in the call, this call will create a placeholder Dropbox account for the user on the team and send an email inviting the user to migrate their existing personal account onto the team. Team member management apps are required to set an initial given_name and surname for a user to use in the team invitation and for ‘Perform as team member’ actions taken on the user before they become ‘active’.
Declaration
Objective-C
- (nonnull DBRpcTask<DBTEAMMembersAddLaunchV2Result *, DBNilObject *> *) membersAddV2:(nonnull NSArray<DBTEAMMemberAddV2Arg *> *)dNewMembers forceAsync:(nullable NSNumber *)forceAsync;Swift
func membersAddV2(_ dNewMembers: [DBTEAMMemberAddV2Arg], forceAsync: NSNumber?) -> DBRpcTask<DBTEAMMembersAddLaunchV2Result, DBNilObject>Parameters
dNewMembersDetails of new members to be added to the team.
Return Value
Through the response callback, the caller will receive a
DBTEAMMembersAddLaunchV2Resultobject on success or avoidobject on failure. -
Adds members to a team. Permission : Team member management A maximum of 20 members can be specified in a single call. If no Dropbox account exists with the email address specified, a new Dropbox account will be created with the given email address, and that account will be invited to the team. If a personal Dropbox account exists with the email address specified in the call, this call will create a placeholder Dropbox account for the user on the team and send an email inviting the user to migrate their existing personal account onto the team. Team member management apps are required to set an initial given_name and surname for a user to use in the team invitation and for ‘Perform as team member’ actions taken on the user before they become ‘active’.
Declaration
Objective-C
- (nonnull DBRpcTask<DBTEAMMembersAddLaunch *, DBNilObject *> *)membersAdd: (nonnull NSArray<DBTEAMMemberAddArg *> *)dNewMembers;Swift
func membersAdd(_ dNewMembers: [DBTEAMMemberAddArg]) -> DBRpcTask<DBTEAMMembersAddLaunch, DBNilObject>Parameters
dNewMembersDetails of new members to be added to the team.
Return Value
Through the response callback, the caller will receive a
DBTEAMMembersAddLaunchobject on success or avoidobject on failure. -
Adds members to a team. Permission : Team member management A maximum of 20 members can be specified in a single call. If no Dropbox account exists with the email address specified, a new Dropbox account will be created with the given email address, and that account will be invited to the team. If a personal Dropbox account exists with the email address specified in the call, this call will create a placeholder Dropbox account for the user on the team and send an email inviting the user to migrate their existing personal account onto the team. Team member management apps are required to set an initial given_name and surname for a user to use in the team invitation and for ‘Perform as team member’ actions taken on the user before they become ‘active’.
Declaration
Objective-C
- (nonnull DBRpcTask<DBTEAMMembersAddLaunch *, DBNilObject *> *) membersAdd:(nonnull NSArray<DBTEAMMemberAddArg *> *)dNewMembers forceAsync:(nullable NSNumber *)forceAsync;Swift
func membersAdd(_ dNewMembers: [DBTEAMMemberAddArg], forceAsync: NSNumber?) -> DBRpcTask<DBTEAMMembersAddLaunch, DBNilObject>Parameters
dNewMembersDetails of new members to be added to the team.
Return Value
Through the response callback, the caller will receive a
DBTEAMMembersAddLaunchobject on success or avoidobject on failure. -
Once an async_job_id is returned from
membersAdd, use this to poll the status of the asynchronous request. Permission : Team member management.Declaration
Objective-C
- (nonnull DBRpcTask<DBTEAMMembersAddJobStatusV2Result *, DBASYNCPollError *> *) membersAddJobStatusGetV2:(nonnull NSString *)asyncJobId;Swift
func membersAddJobStatusGetV2(_ asyncJobId: String) -> DBRpcTask<DBTEAMMembersAddJobStatusV2Result, DBASYNCPollError>Parameters
asyncJobIdId of the asynchronous job. This is the value of a response returned from the method that launched the job.
Return Value
Through the response callback, the caller will receive a
DBTEAMMembersAddJobStatusV2Resultobject on success or aDBASYNCPollErrorobject on failure. -
Once an async_job_id is returned from
membersAdd, use this to poll the status of the asynchronous request. Permission : Team member management.Declaration
Objective-C
- (nonnull DBRpcTask<DBTEAMMembersAddJobStatus *, DBASYNCPollError *> *) membersAddJobStatusGet:(nonnull NSString *)asyncJobId;Swift
func membersAddJobStatusGet(_ asyncJobId: String) -> DBRpcTask<DBTEAMMembersAddJobStatus, DBASYNCPollError>Parameters
asyncJobIdId of the asynchronous job. This is the value of a response returned from the method that launched the job.
Return Value
Through the response callback, the caller will receive a
DBTEAMMembersAddJobStatusobject on success or aDBASYNCPollErrorobject on failure. -
Deletes a team member’s profile photo. Permission : Team member management.
Declaration
Objective-C
- (nonnull DBRpcTask<DBTEAMTeamMemberInfoV2Result *, DBTEAMMembersDeleteProfilePhotoError *> *) membersDeleteProfilePhotoV2:(nonnull DBTEAMUserSelectorArg *)user;Swift
func membersDeleteProfilePhotoV2(_ user: DBTEAMUserSelectorArg) -> DBRpcTask<DBTEAMTeamMemberInfoV2Result, DBTEAMMembersDeleteProfilePhotoError>Parameters
userIdentity of the user whose profile photo will be deleted.
Return Value
Through the response callback, the caller will receive a
DBTEAMTeamMemberInfoV2Resultobject on success or aDBTEAMMembersDeleteProfilePhotoErrorobject on failure. -
Deletes a team member’s profile photo. Permission : Team member management.
Declaration
Objective-C
- (nonnull DBRpcTask<DBTEAMTeamMemberInfo *, DBTEAMMembersDeleteProfilePhotoError *> *) membersDeleteProfilePhoto:(nonnull DBTEAMUserSelectorArg *)user;Swift
func membersDeleteProfilePhoto(_ user: DBTEAMUserSelectorArg) -> DBRpcTask<DBTEAMTeamMemberInfo, DBTEAMMembersDeleteProfilePhotoError>Parameters
userIdentity of the user whose profile photo will be deleted.
Return Value
Through the response callback, the caller will receive a
DBTEAMTeamMemberInfoobject on success or aDBTEAMMembersDeleteProfilePhotoErrorobject on failure. -
Get available TeamMemberRoles for the connected team. To be used with
membersSetAdminPermissions. Permission : Team member management.Declaration
Objective-C
- (nonnull DBRpcTask<DBTEAMMembersGetAvailableTeamMemberRolesResult *, DBNilObject *> *)membersGetAvailableTeamMemberRoles;Swift
func membersGetAvailableTeamMemberRoles() -> DBRpcTask<DBTEAMMembersGetAvailableTeamMemberRolesResult, DBNilObject>Return Value
Through the response callback, the caller will receive a
DBTEAMMembersGetAvailableTeamMemberRolesResultobject on success or avoidobject on failure. -
Returns information about multiple team members. Permission : Team information This endpoint will return
idNotFoundinDBTEAMMembersGetInfoItem, for IDs (or emails) that cannot be matched to a valid team member.Declaration
Objective-C
- (nonnull DBRpcTask<DBTEAMMembersGetInfoV2Result *, DBTEAMMembersGetInfoError *> *)membersGetInfoV2: (nonnull NSArray<DBTEAMUserSelectorArg *> *)members;Swift
func membersGetInfoV2(_ members: [DBTEAMUserSelectorArg]) -> DBRpcTask<DBTEAMMembersGetInfoV2Result, DBTEAMMembersGetInfoError>Parameters
membersList of team members.
Return Value
Through the response callback, the caller will receive a
DBTEAMMembersGetInfoV2Resultobject on success or aDBTEAMMembersGetInfoErrorobject on failure. -
Returns information about multiple team members. Permission : Team information This endpoint will return
idNotFoundinDBTEAMMembersGetInfoItem, for IDs (or emails) that cannot be matched to a valid team member.Declaration
Objective-C
- (nonnull DBRpcTask<NSArray<DBTEAMMembersGetInfoItem *> *, DBTEAMMembersGetInfoError *> *)membersGetInfo: (nonnull NSArray<DBTEAMUserSelectorArg *> *)members;Swift
func membersGetInfo(_ members: [DBTEAMUserSelectorArg]) -> DBRpcTask<NSArray, DBTEAMMembersGetInfoError>Parameters
membersList of team members.
Return Value
Through the response callback, the caller will receive a
NSArray<DBTEAMMembersGetInfoItem *>object on success or aDBTEAMMembersGetInfoErrorobject on failure. -
Lists members of a team. Permission : Team information.
Declaration
Objective-C
- (nonnull DBRpcTask<DBTEAMMembersListV2Result *, DBTEAMMembersListError *> *) membersListV2;Swift
func membersListV2() -> DBRpcTask<DBTEAMMembersListV2Result, DBTEAMMembersListError>Return Value
Through the response callback, the caller will receive a
DBTEAMMembersListV2Resultobject on success or aDBTEAMMembersListErrorobject on failure. -
Lists members of a team. Permission : Team information.
Declaration
Objective-C
- (nonnull DBRpcTask<DBTEAMMembersListV2Result *, DBTEAMMembersListError *> *) membersListV2:(nullable NSNumber *)limit includeRemoved:(nullable NSNumber *)includeRemoved;Swift
func membersListV2(_ limit: NSNumber?, includeRemoved: NSNumber?) -> DBRpcTask<DBTEAMMembersListV2Result, DBTEAMMembersListError>Parameters
limitNumber of results to return per call.
includeRemovedWhether to return removed members.
Return Value
Through the response callback, the caller will receive a
DBTEAMMembersListV2Resultobject on success or aDBTEAMMembersListErrorobject on failure. -
Lists members of a team. Permission : Team information.
Declaration
Objective-C
- (nonnull DBRpcTask<DBTEAMMembersListResult *, DBTEAMMembersListError *> *) membersList;Swift
func membersList() -> DBRpcTask<DBTEAMMembersListResult, DBTEAMMembersListError>Return Value
Through the response callback, the caller will receive a
DBTEAMMembersListResultobject on success or aDBTEAMMembersListErrorobject on failure. -
Lists members of a team. Permission : Team information.
Declaration
Objective-C
- (nonnull DBRpcTask<DBTEAMMembersListResult *, DBTEAMMembersListError *> *) membersList:(nullable NSNumber *)limit includeRemoved:(nullable NSNumber *)includeRemoved;Swift
func membersList(_ limit: NSNumber?, includeRemoved: NSNumber?) -> DBRpcTask<DBTEAMMembersListResult, DBTEAMMembersListError>Parameters
limitNumber of results to return per call.
includeRemovedWhether to return removed members.
Return Value
Through the response callback, the caller will receive a
DBTEAMMembersListResultobject on success or aDBTEAMMembersListErrorobject on failure. -
Once a cursor has been retrieved from
membersList, use this to paginate through all team members. Permission : Team information.Declaration
Objective-C
- (nonnull DBRpcTask<DBTEAMMembersListV2Result *, DBTEAMMembersListContinueError *> *)membersListContinueV2: (nonnull NSString *)cursor;Swift
func membersListContinueV2(_ cursor: String) -> DBRpcTask<DBTEAMMembersListV2Result, DBTEAMMembersListContinueError>Parameters
cursorIndicates from what point to get the next set of members.
Return Value
Through the response callback, the caller will receive a
DBTEAMMembersListV2Resultobject on success or aDBTEAMMembersListContinueErrorobject on failure. -
Once a cursor has been retrieved from
membersList, use this to paginate through all team members. Permission : Team information.Declaration
Objective-C
- (nonnull DBRpcTask<DBTEAMMembersListResult *, DBTEAMMembersListContinueError *> *)membersListContinue: (nonnull NSString *)cursor;Swift
func membersListContinue(_ cursor: String) -> DBRpcTask<DBTEAMMembersListResult, DBTEAMMembersListContinueError>Parameters
cursorIndicates from what point to get the next set of members.
Return Value
Through the response callback, the caller will receive a
DBTEAMMembersListResultobject on success or aDBTEAMMembersListContinueErrorobject on failure. -
Moves removed member’s files to a different member. This endpoint initiates an asynchronous job. To obtain the final result of the job, the client should periodically poll
membersMoveFormerMemberFilesJobStatusCheck. Permission : Team member management.Declaration
Objective-C
- (nonnull DBRpcTask<DBASYNCLaunchEmptyResult *, DBTEAMMembersTransferFormerMembersFilesError *> *) membersMoveFormerMemberFiles:(nonnull DBTEAMUserSelectorArg *)user transferDestId:(nonnull DBTEAMUserSelectorArg *)transferDestId transferAdminId: (nonnull DBTEAMUserSelectorArg *)transferAdminId;Swift
func membersMoveFormerMemberFiles(_ user: DBTEAMUserSelectorArg, transferDestId: DBTEAMUserSelectorArg, transferAdminId: DBTEAMUserSelectorArg) -> DBRpcTask<DBASYNCLaunchEmptyResult, DBTEAMMembersTransferFormerMembersFilesError>Parameters
transferDestIdFiles from the deleted member account will be transferred to this user.
transferAdminIdErrors during the transfer process will be sent via email to this user.
Return Value
Through the response callback, the caller will receive a
DBASYNCLaunchEmptyResultobject on success or aDBTEAMMembersTransferFormerMembersFilesErrorobject on failure. -
Once an async_job_id is returned from
membersMoveFormerMemberFiles, use this to poll the status of the asynchronous request. Permission : Team member management.Declaration
Objective-C
- (nonnull DBRpcTask<DBASYNCPollEmptyResult *, DBASYNCPollError *> *) membersMoveFormerMemberFilesJobStatusCheck:(nonnull NSString *)asyncJobId;Swift
func membersMoveFormerMemberFilesJobStatusCheck(_ asyncJobId: String) -> DBRpcTask<DBASYNCPollEmptyResult, DBASYNCPollError>Parameters
asyncJobIdId of the asynchronous job. This is the value of a response returned from the method that launched the job.
Return Value
Through the response callback, the caller will receive a
DBASYNCPollEmptyResultobject on success or aDBASYNCPollErrorobject on failure. -
Recover a deleted member. Permission : Team member management Exactly one of team_member_id, email, or external_id must be provided to identify the user account.
Declaration
Objective-C
- (nonnull DBRpcTask<DBNilObject *, DBTEAMMembersRecoverError *> *) membersRecover:(nonnull DBTEAMUserSelectorArg *)user;Swift
func membersRecover(_ user: DBTEAMUserSelectorArg) -> DBRpcTask<DBNilObject, DBTEAMMembersRecoverError>Parameters
userIdentity of user to recover.
Return Value
Through the response callback, the caller will receive a
voidobject on success or aDBTEAMMembersRecoverErrorobject on failure. -
Removes a member from a team. Permission : Team member management Exactly one of team_member_id, email, or external_id must be provided to identify the user account. Accounts can be recovered via
membersRecoverfor a 7 day period or until the account has been permanently deleted or transferred to another account (whichever comes first). CallingmembersAddwhile a user is still recoverable on your team will return withuserAlreadyOnTeaminDBTEAMMemberAddResult. Accounts can have their files transferred via the admin console for a limited time, based on the version history length associated with the team (180 days for most teams). This endpoint may initiate an asynchronous job. To obtain the final result of the job, the client should periodically pollmembersRemoveJobStatusGet.Declaration
Objective-C
- (nonnull DBRpcTask<DBASYNCLaunchEmptyResult *, DBTEAMMembersRemoveError *> *) membersRemove:(nonnull DBTEAMUserSelectorArg *)user;Swift
func membersRemove(_ user: DBTEAMUserSelectorArg) -> DBRpcTask<DBASYNCLaunchEmptyResult, DBTEAMMembersRemoveError>Return Value
Through the response callback, the caller will receive a
DBASYNCLaunchEmptyResultobject on success or aDBTEAMMembersRemoveErrorobject on failure. -
Removes a member from a team. Permission : Team member management Exactly one of team_member_id, email, or external_id must be provided to identify the user account. Accounts can be recovered via
membersRecoverfor a 7 day period or until the account has been permanently deleted or transferred to another account (whichever comes first). CallingmembersAddwhile a user is still recoverable on your team will return withuserAlreadyOnTeaminDBTEAMMemberAddResult. Accounts can have their files transferred via the admin console for a limited time, based on the version history length associated with the team (180 days for most teams). This endpoint may initiate an asynchronous job. To obtain the final result of the job, the client should periodically pollmembersRemoveJobStatusGet.Declaration
Objective-C
- (nonnull DBRpcTask<DBASYNCLaunchEmptyResult *, DBTEAMMembersRemoveError *> *) membersRemove:(nonnull DBTEAMUserSelectorArg *)user wipeData:(nullable NSNumber *)wipeData transferDestId:(nullable DBTEAMUserSelectorArg *)transferDestId transferAdminId:(nullable DBTEAMUserSelectorArg *)transferAdminId keepAccount:(nullable NSNumber *)keepAccount retainTeamShares:(nullable NSNumber *)retainTeamShares;Swift
func membersRemove(_ user: DBTEAMUserSelectorArg, wipeData: NSNumber?, transferDestId: DBTEAMUserSelectorArg?, transferAdminId: DBTEAMUserSelectorArg?, keepAccount: NSNumber?, retainTeamShares: NSNumber?) -> DBRpcTask<DBASYNCLaunchEmptyResult, DBTEAMMembersRemoveError>Parameters
transferDestIdIf provided, files from the deleted member account will be transferred to this user.
transferAdminIdIf provided, errors during the transfer process will be sent via email to this user. If the transfer_dest_id argument was provided, then this argument must be provided as well.
keepAccountDowngrade the member to a Basic account. The user will retain the email address associated with their Dropbox account and data in their account that is not restricted to team members. In order to keep the account the argument wipeData should be set to false.
retainTeamSharesIf provided, allows removed users to keep access to Dropbox folders (not Dropbox Paper folders) already explicitly shared with them (not via a group) when they are downgraded to a Basic account. Users will not retain access to folders that do not allow external sharing. In order to keep the sharing relationships, the arguments wipeData should be set to false and keepAccount should be set to true.
Return Value
Through the response callback, the caller will receive a
DBASYNCLaunchEmptyResultobject on success or aDBTEAMMembersRemoveErrorobject on failure. -
Once an async_job_id is returned from
membersRemove, use this to poll the status of the asynchronous request. Permission : Team member management.Declaration
Objective-C
- (nonnull DBRpcTask<DBASYNCPollEmptyResult *, DBASYNCPollError *> *) membersRemoveJobStatusGet:(nonnull NSString *)asyncJobId;Swift
func membersRemoveJobStatusGet(_ asyncJobId: String) -> DBRpcTask<DBASYNCPollEmptyResult, DBASYNCPollError>Parameters
asyncJobIdId of the asynchronous job. This is the value of a response returned from the method that launched the job.
Return Value
Through the response callback, the caller will receive a
DBASYNCPollEmptyResultobject on success or aDBASYNCPollErrorobject on failure. -
Add secondary emails to users. Permission : Team member management. Emails that are on verified domains will be verified automatically. For each email address not on a verified domain a verification email will be sent.
Declaration
Objective-C
- (nonnull DBRpcTask<DBTEAMAddSecondaryEmailsResult *, DBTEAMAddSecondaryEmailsError *> *) membersSecondaryEmailsAdd: (nonnull NSArray<DBTEAMUserSecondaryEmailsArg *> *)dNewSecondaryEmails;Swift
func membersSecondaryEmailsAdd(_ dNewSecondaryEmails: [DBTEAMUserSecondaryEmailsArg]) -> DBRpcTask<DBTEAMAddSecondaryEmailsResult, DBTEAMAddSecondaryEmailsError>Parameters
dNewSecondaryEmailsList of users and secondary emails to add.
Return Value
Through the response callback, the caller will receive a
DBTEAMAddSecondaryEmailsResultobject on success or aDBTEAMAddSecondaryEmailsErrorobject on failure. -
Delete secondary emails from users Permission : Team member management. Users will be notified of deletions of verified secondary emails at both the secondary email and their primary email.
Declaration
Objective-C
- (nonnull DBRpcTask<DBTEAMDeleteSecondaryEmailsResult *, DBNilObject *> *) membersSecondaryEmailsDelete: (nonnull NSArray<DBTEAMUserSecondaryEmailsArg *> *)emailsToDelete;Swift
func membersSecondaryEmailsDelete(_ emailsToDelete: [DBTEAMUserSecondaryEmailsArg]) -> DBRpcTask<DBTEAMDeleteSecondaryEmailsResult, DBNilObject>Parameters
emailsToDeleteList of users and their secondary emails to delete.
Return Value
Through the response callback, the caller will receive a
DBTEAMDeleteSecondaryEmailsResultobject on success or avoidobject on failure. -
Resend secondary email verification emails. Permission : Team member management.
Declaration
Objective-C
- (nonnull DBRpcTask<DBTEAMResendVerificationEmailResult *, DBNilObject *> *) membersSecondaryEmailsResendVerificationEmails: (nonnull NSArray<DBTEAMUserSecondaryEmailsArg *> *)emailsToResend;Swift
func membersSecondaryEmailsResendVerificationEmails(_ emailsToResend: [DBTEAMUserSecondaryEmailsArg]) -> DBRpcTask<DBTEAMResendVerificationEmailResult, DBNilObject>Parameters
emailsToResendList of users and secondary emails to resend verification emails to.
Return Value
Through the response callback, the caller will receive a
DBTEAMResendVerificationEmailResultobject on success or avoidobject on failure. -
Sends welcome email to pending team member. Permission : Team member management Exactly one of team_member_id, email, or external_id must be provided to identify the user account. No-op if team member is not pending.
Declaration
Objective-C
- (nonnull DBRpcTask<DBNilObject *, DBTEAMMembersSendWelcomeError *> *) membersSendWelcomeEmail:(nonnull DBTEAMUserSelectorArg *)userSelectorArg;Swift
func membersSendWelcomeEmail(_ userSelectorArg: DBTEAMUserSelectorArg) -> DBRpcTask<DBNilObject, DBTEAMMembersSendWelcomeError>Parameters
userSelectorArgArgument for selecting a single user, either by team_member_id, external_id or email.
Return Value
Through the response callback, the caller will receive a
voidobject on success or aDBTEAMMembersSendWelcomeErrorobject on failure. -
Updates a team member’s permissions. Permission : Team member management.
Declaration
Objective-C
- (nonnull DBRpcTask<DBTEAMMembersSetPermissions2Result *, DBTEAMMembersSetPermissions2Error *> *) membersSetAdminPermissionsV2:(nonnull DBTEAMUserSelectorArg *)user;Swift
func membersSetAdminPermissionsV2(_ user: DBTEAMUserSelectorArg) -> DBRpcTask<DBTEAMMembersSetPermissions2Result, DBTEAMMembersSetPermissions2Error>Parameters
userIdentity of user whose role will be set.
Return Value
Through the response callback, the caller will receive a
DBTEAMMembersSetPermissions2Resultobject on success or aDBTEAMMembersSetPermissions2Errorobject on failure. -
Updates a team member’s permissions. Permission : Team member management.
Declaration
Objective-C
- (nonnull DBRpcTask<DBTEAMMembersSetPermissions2Result *, DBTEAMMembersSetPermissions2Error *> *) membersSetAdminPermissionsV2:(nonnull DBTEAMUserSelectorArg *)user dNewRoles:(nullable NSArray<NSString *> *)dNewRoles;Swift
func membersSetAdminPermissionsV2(_ user: DBTEAMUserSelectorArg, dNewRoles: [String]?) -> DBRpcTask<DBTEAMMembersSetPermissions2Result, DBTEAMMembersSetPermissions2Error>Parameters
userIdentity of user whose role will be set.
dNewRolesThe new roles for the member. Send empty list to make user member only. For now, only up to one role is allowed.
Return Value
Through the response callback, the caller will receive a
DBTEAMMembersSetPermissions2Resultobject on success or aDBTEAMMembersSetPermissions2Errorobject on failure. -
Updates a team member’s permissions. Permission : Team member management.
Declaration
Objective-C
- (nonnull DBRpcTask<DBTEAMMembersSetPermissionsResult *, DBTEAMMembersSetPermissionsError *> *) membersSetAdminPermissions:(nonnull DBTEAMUserSelectorArg *)user dNewRole:(nonnull DBTEAMAdminTier *)dNewRole;Swift
func membersSetAdminPermissions(_ user: DBTEAMUserSelectorArg, dNewRole: DBTEAMAdminTier) -> DBRpcTask<DBTEAMMembersSetPermissionsResult, DBTEAMMembersSetPermissionsError>Parameters
userIdentity of user whose role will be set.
dNewRoleThe new role of the member.
Return Value
Through the response callback, the caller will receive a
DBTEAMMembersSetPermissionsResultobject on success or aDBTEAMMembersSetPermissionsErrorobject on failure. -
Updates a team member’s profile. Permission : Team member management.
Declaration
Objective-C
- (nonnull DBRpcTask<DBTEAMTeamMemberInfoV2Result *, DBTEAMMembersSetProfileError *> *)membersSetProfileV2: (nonnull DBTEAMUserSelectorArg *)user;Swift
func membersSetProfileV2(_ user: DBTEAMUserSelectorArg) -> DBRpcTask<DBTEAMTeamMemberInfoV2Result, DBTEAMMembersSetProfileError>Parameters
userIdentity of user whose profile will be set.
Return Value
Through the response callback, the caller will receive a
DBTEAMTeamMemberInfoV2Resultobject on success or aDBTEAMMembersSetProfileErrorobject on failure. -
-membersSetProfileV2:dNewEmail: dNewExternalId: dNewGivenName: dNewSurname: dNewPersistentId: dNewIsDirectoryRestricted: Updates a team member’s profile. Permission : Team member management.
Declaration
Objective-C
- (nonnull DBRpcTask<DBTEAMTeamMemberInfoV2Result *, DBTEAMMembersSetProfileError *> *) membersSetProfileV2:(nonnull DBTEAMUserSelectorArg *)user dNewEmail:(nullable NSString *)dNewEmail dNewExternalId:(nullable NSString *)dNewExternalId dNewGivenName:(nullable NSString *)dNewGivenName dNewSurname:(nullable NSString *)dNewSurname dNewPersistentId:(nullable NSString *)dNewPersistentId dNewIsDirectoryRestricted:(nullable NSNumber *)dNewIsDirectoryRestricted;Swift
func membersSetProfileV2(_ user: DBTEAMUserSelectorArg, dNewEmail: String?, dNewExternalId: String?, dNewGivenName: String?, dNewSurname: String?, dNewPersistentId: String?, dNewIsDirectoryRestricted: NSNumber?) -> DBRpcTask<DBTEAMTeamMemberInfoV2Result, DBTEAMMembersSetProfileError>Parameters
userIdentity of user whose profile will be set.
dNewEmailNew email for member.
dNewExternalIdNew external ID for member.
dNewGivenNameNew given name for member.
dNewSurnameNew surname for member.
dNewPersistentIdNew persistent ID. This field only available to teams using persistent ID SAML configuration.
dNewIsDirectoryRestrictedNew value for whether the user is a directory restricted user.
Return Value
Through the response callback, the caller will receive a
DBTEAMTeamMemberInfoV2Resultobject on success or aDBTEAMMembersSetProfileErrorobject on failure. -
Updates a team member’s profile. Permission : Team member management.
Declaration
Objective-C
- (nonnull DBRpcTask<DBTEAMTeamMemberInfo *, DBTEAMMembersSetProfileError *> *) membersSetProfile:(nonnull DBTEAMUserSelectorArg *)user;Swift
func membersSetProfile(_ user: DBTEAMUserSelectorArg) -> DBRpcTask<DBTEAMTeamMemberInfo, DBTEAMMembersSetProfileError>Parameters
userIdentity of user whose profile will be set.
Return Value
Through the response callback, the caller will receive a
DBTEAMTeamMemberInfoobject on success or aDBTEAMMembersSetProfileErrorobject on failure. -
-membersSetProfile:dNewEmail: dNewExternalId: dNewGivenName: dNewSurname: dNewPersistentId: dNewIsDirectoryRestricted: Updates a team member’s profile. Permission : Team member management.
Declaration
Objective-C
- (nonnull DBRpcTask<DBTEAMTeamMemberInfo *, DBTEAMMembersSetProfileError *> *) membersSetProfile:(nonnull DBTEAMUserSelectorArg *)user dNewEmail:(nullable NSString *)dNewEmail dNewExternalId:(nullable NSString *)dNewExternalId dNewGivenName:(nullable NSString *)dNewGivenName dNewSurname:(nullable NSString *)dNewSurname dNewPersistentId:(nullable NSString *)dNewPersistentId dNewIsDirectoryRestricted:(nullable NSNumber *)dNewIsDirectoryRestricted;Swift
func membersSetProfile(_ user: DBTEAMUserSelectorArg, dNewEmail: String?, dNewExternalId: String?, dNewGivenName: String?, dNewSurname: String?, dNewPersistentId: String?, dNewIsDirectoryRestricted: NSNumber?) -> DBRpcTask<DBTEAMTeamMemberInfo, DBTEAMMembersSetProfileError>Parameters
userIdentity of user whose profile will be set.
dNewEmailNew email for member.
dNewExternalIdNew external ID for member.
dNewGivenNameNew given name for member.
dNewSurnameNew surname for member.
dNewPersistentIdNew persistent ID. This field only available to teams using persistent ID SAML configuration.
dNewIsDirectoryRestrictedNew value for whether the user is a directory restricted user.
Return Value
Through the response callback, the caller will receive a
DBTEAMTeamMemberInfoobject on success or aDBTEAMMembersSetProfileErrorobject on failure. -
Updates a team member’s profile photo. Permission : Team member management.
Declaration
Objective-C
- (nonnull DBRpcTask<DBTEAMTeamMemberInfoV2Result *, DBTEAMMembersSetProfilePhotoError *> *) membersSetProfilePhotoV2:(nonnull DBTEAMUserSelectorArg *)user photo:(nonnull DBACCOUNTPhotoSourceArg *)photo;Swift
func membersSetProfilePhotoV2(_ user: DBTEAMUserSelectorArg, photo: DBACCOUNTPhotoSourceArg) -> DBRpcTask<DBTEAMTeamMemberInfoV2Result, DBTEAMMembersSetProfilePhotoError>Parameters
userIdentity of the user whose profile photo will be set.
photoImage to set as the member’s new profile photo.
Return Value
Through the response callback, the caller will receive a
DBTEAMTeamMemberInfoV2Resultobject on success or aDBTEAMMembersSetProfilePhotoErrorobject on failure. -
Updates a team member’s profile photo. Permission : Team member management.
Declaration
Objective-C
- (nonnull DBRpcTask<DBTEAMTeamMemberInfo *, DBTEAMMembersSetProfilePhotoError *> *) membersSetProfilePhoto:(nonnull DBTEAMUserSelectorArg *)user photo:(nonnull DBACCOUNTPhotoSourceArg *)photo;Swift
func membersSetProfilePhoto(_ user: DBTEAMUserSelectorArg, photo: DBACCOUNTPhotoSourceArg) -> DBRpcTask<DBTEAMTeamMemberInfo, DBTEAMMembersSetProfilePhotoError>Parameters
userIdentity of the user whose profile photo will be set.
photoImage to set as the member’s new profile photo.
Return Value
Through the response callback, the caller will receive a
DBTEAMTeamMemberInfoobject on success or aDBTEAMMembersSetProfilePhotoErrorobject on failure. -
Suspend a member from a team. Permission : Team member management Exactly one of team_member_id, email, or external_id must be provided to identify the user account.
Declaration
Objective-C
- (nonnull DBRpcTask<DBNilObject *, DBTEAMMembersSuspendError *> *) membersSuspend:(nonnull DBTEAMUserSelectorArg *)user;Swift
func membersSuspend(_ user: DBTEAMUserSelectorArg) -> DBRpcTask<DBNilObject, DBTEAMMembersSuspendError>Return Value
Through the response callback, the caller will receive a
voidobject on success or aDBTEAMMembersSuspendErrorobject on failure. -
Suspend a member from a team. Permission : Team member management Exactly one of team_member_id, email, or external_id must be provided to identify the user account.
Declaration
Objective-C
- (nonnull DBRpcTask<DBNilObject *, DBTEAMMembersSuspendError *> *) membersSuspend:(nonnull DBTEAMUserSelectorArg *)user wipeData:(nullable NSNumber *)wipeData;Swift
func membersSuspend(_ user: DBTEAMUserSelectorArg, wipeData: NSNumber?) -> DBRpcTask<DBNilObject, DBTEAMMembersSuspendError>Parameters
wipeDataIf provided, controls if the user’s data will be deleted on their linked devices.
Return Value
Through the response callback, the caller will receive a
voidobject on success or aDBTEAMMembersSuspendErrorobject on failure. -
Unsuspend a member from a team. Permission : Team member management Exactly one of team_member_id, email, or external_id must be provided to identify the user account.
Declaration
Objective-C
- (nonnull DBRpcTask<DBNilObject *, DBTEAMMembersUnsuspendError *> *) membersUnsuspend:(nonnull DBTEAMUserSelectorArg *)user;Swift
func membersUnsuspend(_ user: DBTEAMUserSelectorArg) -> DBRpcTask<DBNilObject, DBTEAMMembersUnsuspendError>Parameters
userIdentity of user to unsuspend.
Return Value
Through the response callback, the caller will receive a
voidobject on success or aDBTEAMMembersUnsuspendErrorobject on failure. -
Returns a list of all team-accessible namespaces. This list includes team folders, shared folders containing team members, team members’ home namespaces, and team members’ app folders. Home namespaces and app folders are always owned by this team or members of the team, but shared folders may be owned by other users or other teams. Duplicates may occur in the list.
Declaration
Objective-C
- (nonnull DBRpcTask<DBTEAMTeamNamespacesListResult *, DBTEAMTeamNamespacesListError *> *)namespacesList;Swift
func namespacesList() -> DBRpcTask<DBTEAMTeamNamespacesListResult, DBTEAMTeamNamespacesListError>Return Value
Through the response callback, the caller will receive a
DBTEAMTeamNamespacesListResultobject on success or aDBTEAMTeamNamespacesListErrorobject on failure. -
Returns a list of all team-accessible namespaces. This list includes team folders, shared folders containing team members, team members’ home namespaces, and team members’ app folders. Home namespaces and app folders are always owned by this team or members of the team, but shared folders may be owned by other users or other teams. Duplicates may occur in the list.
Declaration
Objective-C
- (nonnull DBRpcTask<DBTEAMTeamNamespacesListResult *, DBTEAMTeamNamespacesListError *> *)namespacesList: (nullable NSNumber *)limit;Swift
func namespacesList(_ limit: NSNumber?) -> DBRpcTask<DBTEAMTeamNamespacesListResult, DBTEAMTeamNamespacesListError>Parameters
limitSpecifying a value here has no effect.
Return Value
Through the response callback, the caller will receive a
DBTEAMTeamNamespacesListResultobject on success or aDBTEAMTeamNamespacesListErrorobject on failure. -
Once a cursor has been retrieved from
namespacesList, use this to paginate through all team-accessible namespaces. Duplicates may occur in the list.Declaration
Objective-C
- (nonnull DBRpcTask<DBTEAMTeamNamespacesListResult *, DBTEAMTeamNamespacesListContinueError *> *) namespacesListContinue:(nonnull NSString *)cursor;Swift
func namespacesListContinue(_ cursor: String) -> DBRpcTask<DBTEAMTeamNamespacesListResult, DBTEAMTeamNamespacesListContinueError>Parameters
cursorIndicates from what point to get the next set of team-accessible namespaces.
Return Value
Through the response callback, the caller will receive a
DBTEAMTeamNamespacesListResultobject on success or aDBTEAMTeamNamespacesListContinueErrorobject on failure. -
Deprecated
propertiesTemplateAdd is deprecated.
DEPRECATED: Permission : Team member file access.
Declaration
Objective-C
- (nonnull DBRpcTask<DBFILEPROPERTIESAddTemplateResult *, DBFILEPROPERTIESModifyTemplateError *> *) propertiesTemplateAdd:(nonnull NSString *)name description_:(nonnull NSString *)description_ fields: (nonnull NSArray<DBFILEPROPERTIESPropertyFieldTemplate *> *)fields;Swift
func propertiesTemplateAdd(_ name: String, description_: String, fields: [DBFILEPROPERTIESPropertyFieldTemplate]) -> DBRpcTask<DBFILEPROPERTIESAddTemplateResult, DBFILEPROPERTIESModifyTemplateError>Return Value
Through the response callback, the caller will receive a
DBFILEPROPERTIESAddTemplateResultobject on success or aDBFILEPROPERTIESModifyTemplateErrorobject on failure. -
Deprecated
propertiesTemplateGet is deprecated.
DEPRECATED: Permission : Team member file access. The scope for the route is files.team_metadata.write.
Declaration
Objective-C
- (nonnull DBRpcTask<DBFILEPROPERTIESGetTemplateResult *, DBFILEPROPERTIESTemplateError *> *)propertiesTemplateGet: (nonnull NSString *)templateId;Swift
func propertiesTemplateGet(_ templateId: String) -> DBRpcTask<DBFILEPROPERTIESGetTemplateResult, DBFILEPROPERTIESTemplateError>Parameters
templateIdAn identifier for template added by route See
templatesAddForUserortemplatesAddForTeam.Return Value
Through the response callback, the caller will receive a
DBFILEPROPERTIESGetTemplateResultobject on success or aDBFILEPROPERTIESTemplateErrorobject on failure. -
Deprecated
propertiesTemplateList is deprecated.
DEPRECATED: Permission : Team member file access. The scope for the route is files.team_metadata.write.
Declaration
Objective-C
- (nonnull DBRpcTask<DBFILEPROPERTIESListTemplateResult *, DBFILEPROPERTIESTemplateError *> *)propertiesTemplateList;Swift
func propertiesTemplateList() -> DBRpcTask<DBFILEPROPERTIESListTemplateResult, DBFILEPROPERTIESTemplateError>Return Value
Through the response callback, the caller will receive a
DBFILEPROPERTIESListTemplateResultobject on success or aDBFILEPROPERTIESTemplateErrorobject on failure. -
Deprecated
propertiesTemplateUpdate is deprecated.
DEPRECATED: Permission : Team member file access.
Declaration
Objective-C
- (nonnull DBRpcTask<DBFILEPROPERTIESUpdateTemplateResult *, DBFILEPROPERTIESModifyTemplateError *> *) propertiesTemplateUpdate:(nonnull NSString *)templateId;Swift
func propertiesTemplateUpdate(_ templateId: String) -> DBRpcTask<DBFILEPROPERTIESUpdateTemplateResult, DBFILEPROPERTIESModifyTemplateError>Parameters
templateIdAn identifier for template added by See
templatesAddForUserortemplatesAddForTeam.Return Value
Through the response callback, the caller will receive a
DBFILEPROPERTIESUpdateTemplateResultobject on success or aDBFILEPROPERTIESModifyTemplateErrorobject on failure. -
Deprecated
propertiesTemplateUpdate is deprecated.
DEPRECATED: Permission : Team member file access.
Declaration
Objective-C
- (nonnull DBRpcTask<DBFILEPROPERTIESUpdateTemplateResult *, DBFILEPROPERTIESModifyTemplateError *> *) propertiesTemplateUpdate:(nonnull NSString *)templateId name:(nullable NSString *)name description_:(nullable NSString *)description_ addFields: (nullable NSArray<DBFILEPROPERTIESPropertyFieldTemplate *> *) addFields;Swift
func propertiesTemplateUpdate(_ templateId: String, name: String?, description_: String?, addFields: [DBFILEPROPERTIESPropertyFieldTemplate]?) -> DBRpcTask<DBFILEPROPERTIESUpdateTemplateResult, DBFILEPROPERTIESModifyTemplateError>Parameters
templateIdAn identifier for template added by See
templatesAddForUserortemplatesAddForTeam.nameA display name for the template. template names can be up to 256 bytes.
description_Description for the new template. Template descriptions can be up to 1024 bytes.
addFieldsProperty field templates to be added to the group template. There can be up to 32 properties in a single template.
Return Value
Through the response callback, the caller will receive a
DBFILEPROPERTIESUpdateTemplateResultobject on success or aDBFILEPROPERTIESModifyTemplateErrorobject on failure. -
Deprecated
reportsGetActivity is deprecated.
DEPRECATED: Retrieves reporting data about a team’s user activity. Deprecated: Will be removed on July 1st 2021.
Declaration
Objective-C
- (nonnull DBRpcTask<DBTEAMGetActivityReport *, DBTEAMDateRangeError *> *) reportsGetActivity;Swift
func reportsGetActivity() -> DBRpcTask<DBTEAMGetActivityReport, DBTEAMDateRangeError>Return Value
Through the response callback, the caller will receive a
DBTEAMGetActivityReportobject on success or aDBTEAMDateRangeErrorobject on failure. -
Deprecated
reportsGetActivity is deprecated.
DEPRECATED: Retrieves reporting data about a team’s user activity. Deprecated: Will be removed on July 1st 2021.
Declaration
Objective-C
- (nonnull DBRpcTask<DBTEAMGetActivityReport *, DBTEAMDateRangeError *> *) reportsGetActivity:(nullable NSDate *)startDate endDate:(nullable NSDate *)endDate;Swift
func reportsGetActivity(_ startDate: Date?, end endDate: Date?) -> DBRpcTask<DBTEAMGetActivityReport, DBTEAMDateRangeError>Parameters
startDateOptional starting date (inclusive). If start_date is None or too long ago, this field will be set to 6 months ago.
endDateOptional ending date (exclusive).
Return Value
Through the response callback, the caller will receive a
DBTEAMGetActivityReportobject on success or aDBTEAMDateRangeErrorobject on failure. -
Deprecated
reportsGetDevices is deprecated.
DEPRECATED: Retrieves reporting data about a team’s linked devices. Deprecated: Will be removed on July 1st 2021.
Declaration
Objective-C
- (nonnull DBRpcTask<DBTEAMGetDevicesReport *, DBTEAMDateRangeError *> *) reportsGetDevices;Swift
func reportsGetDevices() -> DBRpcTask<DBTEAMGetDevicesReport, DBTEAMDateRangeError>Return Value
Through the response callback, the caller will receive a
DBTEAMGetDevicesReportobject on success or aDBTEAMDateRangeErrorobject on failure. -
Deprecated
reportsGetDevices is deprecated.
DEPRECATED: Retrieves reporting data about a team’s linked devices. Deprecated: Will be removed on July 1st 2021.
Declaration
Objective-C
- (nonnull DBRpcTask<DBTEAMGetDevicesReport *, DBTEAMDateRangeError *> *) reportsGetDevices:(nullable NSDate *)startDate endDate:(nullable NSDate *)endDate;Swift
func reportsGetDevices(_ startDate: Date?, end endDate: Date?) -> DBRpcTask<DBTEAMGetDevicesReport, DBTEAMDateRangeError>Parameters
startDateOptional starting date (inclusive). If start_date is None or too long ago, this field will be set to 6 months ago.
endDateOptional ending date (exclusive).
Return Value
Through the response callback, the caller will receive a
DBTEAMGetDevicesReportobject on success or aDBTEAMDateRangeErrorobject on failure. -
Deprecated
reportsGetMembership is deprecated.
DEPRECATED: Retrieves reporting data about a team’s membership. Deprecated: Will be removed on July 1st 2021.
Declaration
Objective-C
- (nonnull DBRpcTask<DBTEAMGetMembershipReport *, DBTEAMDateRangeError *> *) reportsGetMembership;Swift
func reportsGetMembership() -> DBRpcTask<DBTEAMGetMembershipReport, DBTEAMDateRangeError>Return Value
Through the response callback, the caller will receive a
DBTEAMGetMembershipReportobject on success or aDBTEAMDateRangeErrorobject on failure. -
Deprecated
reportsGetMembership is deprecated.
DEPRECATED: Retrieves reporting data about a team’s membership. Deprecated: Will be removed on July 1st 2021.
Declaration
Objective-C
- (nonnull DBRpcTask<DBTEAMGetMembershipReport *, DBTEAMDateRangeError *> *) reportsGetMembership:(nullable NSDate *)startDate endDate:(nullable NSDate *)endDate;Swift
func reportsGetMembership(_ startDate: Date?, end endDate: Date?) -> DBRpcTask<DBTEAMGetMembershipReport, DBTEAMDateRangeError>Parameters
startDateOptional starting date (inclusive). If start_date is None or too long ago, this field will be set to 6 months ago.
endDateOptional ending date (exclusive).
Return Value
Through the response callback, the caller will receive a
DBTEAMGetMembershipReportobject on success or aDBTEAMDateRangeErrorobject on failure. -
Deprecated
reportsGetStorage is deprecated.
DEPRECATED: Retrieves reporting data about a team’s storage usage. Deprecated: Will be removed on July 1st 2021.
Declaration
Objective-C
- (nonnull DBRpcTask<DBTEAMGetStorageReport *, DBTEAMDateRangeError *> *) reportsGetStorage;Swift
func reportsGetStorage() -> DBRpcTask<DBTEAMGetStorageReport, DBTEAMDateRangeError>Return Value
Through the response callback, the caller will receive a
DBTEAMGetStorageReportobject on success or aDBTEAMDateRangeErrorobject on failure. -
Deprecated
reportsGetStorage is deprecated.
DEPRECATED: Retrieves reporting data about a team’s storage usage. Deprecated: Will be removed on July 1st 2021.
Declaration
Objective-C
- (nonnull DBRpcTask<DBTEAMGetStorageReport *, DBTEAMDateRangeError *> *) reportsGetStorage:(nullable NSDate *)startDate endDate:(nullable NSDate *)endDate;Swift
func reportsGetStorage(_ startDate: Date?, end endDate: Date?) -> DBRpcTask<DBTEAMGetStorageReport, DBTEAMDateRangeError>Parameters
startDateOptional starting date (inclusive). If start_date is None or too long ago, this field will be set to 6 months ago.
endDateOptional ending date (exclusive).
Return Value
Through the response callback, the caller will receive a
DBTEAMGetStorageReportobject on success or aDBTEAMDateRangeErrorobject on failure. -
Endpoint adds Approve List entries. Changes are effective immediately. Changes are committed in transaction. In case of single validation error - all entries are rejected. Valid domains (RFC-1034/5) and emails (RFC-5322/822) are accepted. Added entries cannot overflow limit of 10000 entries per team. Maximum 100 entries per call is allowed.
Declaration
Objective-C
- (nonnull DBRpcTask<DBTEAMSharingAllowlistAddResponse *, DBTEAMSharingAllowlistAddError *> *)sharingAllowlistAdd;Swift
func sharingAllowlistAdd() -> DBRpcTask<DBTEAMSharingAllowlistAddResponse, DBTEAMSharingAllowlistAddError>Return Value
Through the response callback, the caller will receive a
DBTEAMSharingAllowlistAddResponseobject on success or aDBTEAMSharingAllowlistAddErrorobject on failure. -
Endpoint adds Approve List entries. Changes are effective immediately. Changes are committed in transaction. In case of single validation error - all entries are rejected. Valid domains (RFC-1034/5) and emails (RFC-5322/822) are accepted. Added entries cannot overflow limit of 10000 entries per team. Maximum 100 entries per call is allowed.
Declaration
Objective-C
- (nonnull DBRpcTask<DBTEAMSharingAllowlistAddResponse *, DBTEAMSharingAllowlistAddError *> *) sharingAllowlistAdd:(nullable NSArray<NSString *> *)domains emails:(nullable NSArray<NSString *> *)emails;Swift
func sharingAllowlistAdd(_ domains: [String]?, emails: [String]?) -> DBRpcTask<DBTEAMSharingAllowlistAddResponse, DBTEAMSharingAllowlistAddError>Parameters
domainsList of domains represented by valid string representation (RFC-1034/5).
emailsList of emails represented by valid string representation (RFC-5322/822).
Return Value
Through the response callback, the caller will receive a
DBTEAMSharingAllowlistAddResponseobject on success or aDBTEAMSharingAllowlistAddErrorobject on failure. -
Lists Approve List entries for given team, from newest to oldest, returning up to
limitentries at a time. If there are more thanlimitentries associated with the current team, more can be fetched by passing the returnedcursortosharingAllowlistListContinue.Declaration
Objective-C
- (nonnull DBRpcTask<DBTEAMSharingAllowlistListResponse *, DBTEAMSharingAllowlistListError *> *)sharingAllowlistList;Swift
func sharingAllowlistList() -> DBRpcTask<DBTEAMSharingAllowlistListResponse, DBTEAMSharingAllowlistListError>Return Value
Through the response callback, the caller will receive a
DBTEAMSharingAllowlistListResponseobject on success or aDBTEAMSharingAllowlistListErrorobject on failure. -
Lists Approve List entries for given team, from newest to oldest, returning up to
limitentries at a time. If there are more thanlimitentries associated with the current team, more can be fetched by passing the returnedcursortosharingAllowlistListContinue.Declaration
Objective-C
- (nonnull DBRpcTask<DBTEAMSharingAllowlistListResponse *, DBTEAMSharingAllowlistListError *> *)sharingAllowlistList: (nullable NSNumber *)limit;Swift
func sharingAllowlistList(_ limit: NSNumber?) -> DBRpcTask<DBTEAMSharingAllowlistListResponse, DBTEAMSharingAllowlistListError>Parameters
limitThe number of entries to fetch at one time.
Return Value
Through the response callback, the caller will receive a
DBTEAMSharingAllowlistListResponseobject on success or aDBTEAMSharingAllowlistListErrorobject on failure. -
Lists entries associated with given team, starting from a the cursor. See
sharingAllowlistList.Declaration
Objective-C
- (nonnull DBRpcTask<DBTEAMSharingAllowlistListResponse *, DBTEAMSharingAllowlistListContinueError *> *) sharingAllowlistListContinue:(nonnull NSString *)cursor;Swift
func sharingAllowlistListContinue(_ cursor: String) -> DBRpcTask<DBTEAMSharingAllowlistListResponse, DBTEAMSharingAllowlistListContinueError>Parameters
cursorThe cursor returned from a previous call to
sharingAllowlistListorsharingAllowlistListContinue.Return Value
Through the response callback, the caller will receive a
DBTEAMSharingAllowlistListResponseobject on success or aDBTEAMSharingAllowlistListContinueErrorobject on failure. -
Endpoint removes Approve List entries. Changes are effective immediately. Changes are committed in transaction. In case of single validation error - all entries are rejected. Valid domains (RFC-1034/5) and emails (RFC-5322/822) are accepted. Entries being removed have to be present on the list. Maximum 1000 entries per call is allowed.
Declaration
Objective-C
- (nonnull DBRpcTask<DBTEAMSharingAllowlistRemoveResponse *, DBTEAMSharingAllowlistRemoveError *> *) sharingAllowlistRemove;Swift
func sharingAllowlistRemove() -> DBRpcTask<DBTEAMSharingAllowlistRemoveResponse, DBTEAMSharingAllowlistRemoveError>Return Value
Through the response callback, the caller will receive a
DBTEAMSharingAllowlistRemoveResponseobject on success or aDBTEAMSharingAllowlistRemoveErrorobject on failure. -
Endpoint removes Approve List entries. Changes are effective immediately. Changes are committed in transaction. In case of single validation error - all entries are rejected. Valid domains (RFC-1034/5) and emails (RFC-5322/822) are accepted. Entries being removed have to be present on the list. Maximum 1000 entries per call is allowed.
Declaration
Objective-C
- (nonnull DBRpcTask<DBTEAMSharingAllowlistRemoveResponse *, DBTEAMSharingAllowlistRemoveError *> *) sharingAllowlistRemove:(nullable NSArray<NSString *> *)domains emails:(nullable NSArray<NSString *> *)emails;Swift
func sharingAllowlistRemove(_ domains: [String]?, emails: [String]?) -> DBRpcTask<DBTEAMSharingAllowlistRemoveResponse, DBTEAMSharingAllowlistRemoveError>Parameters
domainsList of domains represented by valid string representation (RFC-1034/5).
emailsList of emails represented by valid string representation (RFC-5322/822).
Return Value
Through the response callback, the caller will receive a
DBTEAMSharingAllowlistRemoveResponseobject on success or aDBTEAMSharingAllowlistRemoveErrorobject on failure. -
Sets an archived team folder’s status to active. Permission : Team member file access.
Declaration
Objective-C
- (nonnull DBRpcTask<DBTEAMTeamFolderMetadata *, DBTEAMTeamFolderActivateError *> *)teamFolderActivate: (nonnull NSString *)teamFolderId;Swift
func teamFolderActivate(_ teamFolderId: String) -> DBRpcTask<DBTEAMTeamFolderMetadata, DBTEAMTeamFolderActivateError>Parameters
teamFolderIdThe ID of the team folder.
Return Value
Through the response callback, the caller will receive a
DBTEAMTeamFolderMetadataobject on success or aDBTEAMTeamFolderActivateErrorobject on failure. -
Sets an active team folder’s status to archived and removes all folder and file members. This endpoint cannot be used for teams that have a shared team space. Permission : Team member file access.
Declaration
Objective-C
- (nonnull DBRpcTask<DBTEAMTeamFolderArchiveLaunch *, DBTEAMTeamFolderArchiveError *> *)teamFolderArchive: (nonnull NSString *)teamFolderId;Swift
func teamFolderArchive(_ teamFolderId: String) -> DBRpcTask<DBTEAMTeamFolderArchiveLaunch, DBTEAMTeamFolderArchiveError>Return Value
Through the response callback, the caller will receive a
DBTEAMTeamFolderArchiveLaunchobject on success or aDBTEAMTeamFolderArchiveErrorobject on failure. -
Sets an active team folder’s status to archived and removes all folder and file members. This endpoint cannot be used for teams that have a shared team space. Permission : Team member file access.
Declaration
Objective-C
- (nonnull DBRpcTask<DBTEAMTeamFolderArchiveLaunch *, DBTEAMTeamFolderArchiveError *> *) teamFolderArchive:(nonnull NSString *)teamFolderId forceAsyncOff:(nullable NSNumber *)forceAsyncOff;Swift
func teamFolderArchive(_ teamFolderId: String, forceAsyncOff: NSNumber?) -> DBRpcTask<DBTEAMTeamFolderArchiveLaunch, DBTEAMTeamFolderArchiveError>Parameters
forceAsyncOffWhether to force the archive to happen synchronously.
Return Value
Through the response callback, the caller will receive a
DBTEAMTeamFolderArchiveLaunchobject on success or aDBTEAMTeamFolderArchiveErrorobject on failure. -
Returns the status of an asynchronous job for archiving a team folder. Permission : Team member file access.
Declaration
Objective-C
- (nonnull DBRpcTask<DBTEAMTeamFolderArchiveJobStatus *, DBASYNCPollError *> *) teamFolderArchiveCheck:(nonnull NSString *)asyncJobId;Swift
func teamFolderArchiveCheck(_ asyncJobId: String) -> DBRpcTask<DBTEAMTeamFolderArchiveJobStatus, DBASYNCPollError>Parameters
asyncJobIdId of the asynchronous job. This is the value of a response returned from the method that launched the job.
Return Value
Through the response callback, the caller will receive a
DBTEAMTeamFolderArchiveJobStatusobject on success or aDBASYNCPollErrorobject on failure. -
Creates a new, active, team folder with no members. This endpoint can only be used for teams that do not already have a shared team space. Permission : Team member file access.
Declaration
Objective-C
- (nonnull DBRpcTask<DBTEAMTeamFolderMetadata *, DBTEAMTeamFolderCreateError *> *)teamFolderCreate:(nonnull NSString *)name;Swift
func teamFolderCreate(_ name: String) -> DBRpcTask<DBTEAMTeamFolderMetadata, DBTEAMTeamFolderCreateError>Parameters
nameName for the new team folder.
Return Value
Through the response callback, the caller will receive a
DBTEAMTeamFolderMetadataobject on success or aDBTEAMTeamFolderCreateErrorobject on failure. -
Creates a new, active, team folder with no members. This endpoint can only be used for teams that do not already have a shared team space. Permission : Team member file access.
Declaration
Objective-C
- (nonnull DBRpcTask<DBTEAMTeamFolderMetadata *, DBTEAMTeamFolderCreateError *> *)teamFolderCreate:(nonnull NSString *)name syncSetting:(nullable DBFILESSyncSettingArg *)syncSetting;Swift
func teamFolderCreate(_ name: String, syncSetting: DBFILESSyncSettingArg?) -> DBRpcTask<DBTEAMTeamFolderMetadata, DBTEAMTeamFolderCreateError>Parameters
nameName for the new team folder.
syncSettingThe sync setting to apply to this team folder. Only permitted if the team has team selective sync enabled.
Return Value
Through the response callback, the caller will receive a
DBTEAMTeamFolderMetadataobject on success or aDBTEAMTeamFolderCreateErrorobject on failure. -
Retrieves metadata for team folders. Permission : Team member file access.
Declaration
Objective-C
- (nonnull DBRpcTask<NSArray<DBTEAMTeamFolderGetInfoItem *> *, DBNilObject *> *) teamFolderGetInfo:(nonnull NSArray<NSString *> *)teamFolderIds;Swift
func teamFolderGetInfo(_ teamFolderIds: [String]) -> DBRpcTask<NSArray, DBNilObject>Parameters
teamFolderIdsThe list of team folder IDs.
Return Value
Through the response callback, the caller will receive a
NSArray<DBTEAMTeamFolderGetInfoItem *>object on success or avoidobject on failure. -
Lists all team folders. Permission : Team member file access.
Declaration
Objective-C
- (nonnull DBRpcTask<DBTEAMTeamFolderListResult *, DBTEAMTeamFolderListError *> *)teamFolderList;Swift
func teamFolderList() -> DBRpcTask<DBTEAMTeamFolderListResult, DBTEAMTeamFolderListError>Return Value
Through the response callback, the caller will receive a
DBTEAMTeamFolderListResultobject on success or aDBTEAMTeamFolderListErrorobject on failure. -
Lists all team folders. Permission : Team member file access.
Declaration
Objective-C
- (nonnull DBRpcTask<DBTEAMTeamFolderListResult *, DBTEAMTeamFolderListError *> *)teamFolderList:(nullable NSNumber *)limit;Swift
func teamFolderList(_ limit: NSNumber?) -> DBRpcTask<DBTEAMTeamFolderListResult, DBTEAMTeamFolderListError>Parameters
limitThe maximum number of results to return per request.
Return Value
Through the response callback, the caller will receive a
DBTEAMTeamFolderListResultobject on success or aDBTEAMTeamFolderListErrorobject on failure. -
Once a cursor has been retrieved from
teamFolderList, use this to paginate through all team folders. Permission : Team member file access.Declaration
Objective-C
- (nonnull DBRpcTask<DBTEAMTeamFolderListResult *, DBTEAMTeamFolderListContinueError *> *) teamFolderListContinue:(nonnull NSString *)cursor;Swift
func teamFolderListContinue(_ cursor: String) -> DBRpcTask<DBTEAMTeamFolderListResult, DBTEAMTeamFolderListContinueError>Parameters
cursorIndicates from what point to get the next set of team folders.
Return Value
Through the response callback, the caller will receive a
DBTEAMTeamFolderListResultobject on success or aDBTEAMTeamFolderListContinueErrorobject on failure. -
Permanently deletes an archived team folder. This endpoint cannot be used for teams that have a shared team space. Permission : Team member file access.
Declaration
Objective-C
- (nonnull DBRpcTask<DBNilObject *, DBTEAMTeamFolderPermanentlyDeleteError *> *) teamFolderPermanentlyDelete:(nonnull NSString *)teamFolderId;Swift
func teamFolderPermanentlyDelete(_ teamFolderId: String) -> DBRpcTask<DBNilObject, DBTEAMTeamFolderPermanentlyDeleteError>Parameters
teamFolderIdThe ID of the team folder.
Return Value
Through the response callback, the caller will receive a
voidobject on success or aDBTEAMTeamFolderPermanentlyDeleteErrorobject on failure. -
Changes an active team folder’s name. Permission : Team member file access.
Declaration
Objective-C
- (nonnull DBRpcTask<DBTEAMTeamFolderMetadata *, DBTEAMTeamFolderRenameError *> *)teamFolderRename:(nonnull NSString *)teamFolderId name:(nonnull NSString *)name;Swift
func teamFolderRename(_ teamFolderId: String, name: String) -> DBRpcTask<DBTEAMTeamFolderMetadata, DBTEAMTeamFolderRenameError>Parameters
nameNew team folder name.
Return Value
Through the response callback, the caller will receive a
DBTEAMTeamFolderMetadataobject on success or aDBTEAMTeamFolderRenameErrorobject on failure. -
Updates the sync settings on a team folder or its contents. Use of this endpoint requires that the team has team selective sync enabled.
Declaration
Objective-C
- (nonnull DBRpcTask<DBTEAMTeamFolderMetadata *, DBTEAMTeamFolderUpdateSyncSettingsError *> *) teamFolderUpdateSyncSettings:(nonnull NSString *)teamFolderId;Swift
func teamFolderUpdateSyncSettings(_ teamFolderId: String) -> DBRpcTask<DBTEAMTeamFolderMetadata, DBTEAMTeamFolderUpdateSyncSettingsError>Return Value
Through the response callback, the caller will receive a
DBTEAMTeamFolderMetadataobject on success or aDBTEAMTeamFolderUpdateSyncSettingsErrorobject on failure. -
Updates the sync settings on a team folder or its contents. Use of this endpoint requires that the team has team selective sync enabled.
Declaration
Objective-C
- (nonnull DBRpcTask<DBTEAMTeamFolderMetadata *, DBTEAMTeamFolderUpdateSyncSettingsError *> *) teamFolderUpdateSyncSettings:(nonnull NSString *)teamFolderId syncSetting:(nullable DBFILESSyncSettingArg *)syncSetting contentSyncSettings: (nullable NSArray<DBFILESContentSyncSettingArg *> *) contentSyncSettings;Swift
func teamFolderUpdateSyncSettings(_ teamFolderId: String, syncSetting: DBFILESSyncSettingArg?, contentSyncSettings: [DBFILESContentSyncSettingArg]?) -> DBRpcTask<DBTEAMTeamFolderMetadata, DBTEAMTeamFolderUpdateSyncSettingsError>Parameters
syncSettingSync setting to apply to the team folder itself. Only meaningful if the team folder is not a shared team root.
contentSyncSettingsSync settings to apply to contents of this team folder.
Return Value
Through the response callback, the caller will receive a
DBTEAMTeamFolderMetadataobject on success or aDBTEAMTeamFolderUpdateSyncSettingsErrorobject on failure. -
Returns the member profile of the admin who generated the team access token used to make the call.
Declaration
Objective-C
- (nonnull DBRpcTask<DBTEAMTokenGetAuthenticatedAdminResult *, DBTEAMTokenGetAuthenticatedAdminError *> *) tokenGetAuthenticatedAdmin;Swift
func tokenGetAuthenticatedAdmin() -> DBRpcTask<DBTEAMTokenGetAuthenticatedAdminResult, DBTEAMTokenGetAuthenticatedAdminError>Return Value
Through the response callback, the caller will receive a
DBTEAMTokenGetAuthenticatedAdminResultobject on success or aDBTEAMTokenGetAuthenticatedAdminErrorobject on failure.
View on GitHub
DBTEAMTeamAuthRoutes Class Reference