FilePropertiesRoutes

open class FilePropertiesRoutes

Copyright © 2016 Dropbox, Inc. All rights reserved.

Auto-generated by Stone, do not modify.

Routes for the file_properties namespace

  • Add property groups to a Dropbox file. See templatesAddForUser or templatesAddForTeam to create new templates.

    Declaration

    Swift

    @discardableResult
    open func propertiesAdd(path: String, propertyGroups: Array<FileProperties.PropertyGroup>) -> RpcRequest<VoidSerializer, FileProperties.AddPropertiesErrorSerializer>

    Parameters

    path

    A unique identifier for the file or folder.

    propertyGroups

    The property groups which are to be added to a Dropbox file.

    Return Value

    Through the response callback, the caller will receive a Void object on success or a FileProperties.AddPropertiesError object on failure.

  • Overwrite property groups associated with a file. This endpoint should be used instead of propertiesUpdate when property groups are being updated via a snapshot instead of via a delta. In other words, this endpoint will delete all omitted fields from a property group, whereas propertiesUpdate will only delete fields that are explicitly marked for deletion.

    Declaration

    Swift

    @discardableResult
    open func propertiesOverwrite(path: String, propertyGroups: Array<FileProperties.PropertyGroup>) -> RpcRequest<VoidSerializer, FileProperties.InvalidPropertyGroupErrorSerializer>

    Parameters

    path

    A unique identifier for the file or folder.

    propertyGroups

    The property groups snapshot updates to force apply.

    Return Value

    Through the response callback, the caller will receive a Void object on success or a FileProperties.InvalidPropertyGroupError object on failure.

  • Permanently removes the specified property group from the file. To remove specific property field key value pairs, see propertiesUpdate. To update a template, see templatesUpdateForUser or templatesUpdateForTeam. To remove a template, see templatesRemoveForUser or templatesRemoveForTeam.

    Declaration

    Swift

    @discardableResult
    open func propertiesRemove(path: String, propertyTemplateIds: Array<String>) -> RpcRequest<VoidSerializer, FileProperties.RemovePropertiesErrorSerializer>

    Parameters

    path

    A unique identifier for the file or folder.

    propertyTemplateIds

    A list of identifiers for a template created by templatesAddForUser or templatesAddForTeam.

    Return Value

    Through the response callback, the caller will receive a Void object on success or a FileProperties.RemovePropertiesError object on failure.

  • Search across property templates for particular property field values.

    Declaration

    Swift

    @discardableResult
    open func propertiesSearch(queries: Array<FileProperties.PropertiesSearchQuery>, templateFilter: FileProperties.TemplateFilter = .filterNone) -> RpcRequest<FileProperties.PropertiesSearchResultSerializer, FileProperties.PropertiesSearchErrorSerializer>

    Parameters

    queries

    Queries to search.

    templateFilter

    Filter results to contain only properties associated with these template IDs.

    Return Value

    Through the response callback, the caller will receive a FileProperties.PropertiesSearchResult object on success or a FileProperties.PropertiesSearchError object on failure.

  • Once a cursor has been retrieved from propertiesSearch, use this to paginate through all search results.

    Declaration

    Swift

    @discardableResult
    open func propertiesSearchContinue(cursor: String) -> RpcRequest<FileProperties.PropertiesSearchResultSerializer, FileProperties.PropertiesSearchContinueErrorSerializer>

    Parameters

    cursor

    The cursor returned by your last call to propertiesSearch or propertiesSearchContinue.

    Return Value

    Through the response callback, the caller will receive a FileProperties.PropertiesSearchResult object on success or a FileProperties.PropertiesSearchContinueError object on failure.

  • Add, update or remove properties associated with the supplied file and templates. This endpoint should be used instead of propertiesOverwrite when property groups are being updated via a delta instead of via a snapshot . In other words, this endpoint will not delete any omitted fields from a property group, whereas propertiesOverwrite will delete any fields that are omitted from a property group.

    Declaration

    Swift

    @discardableResult
    open func propertiesUpdate(path: String, updatePropertyGroups: Array<FileProperties.PropertyGroupUpdate>) -> RpcRequest<VoidSerializer, FileProperties.UpdatePropertiesErrorSerializer>

    Parameters

    path

    A unique identifier for the file or folder.

    updatePropertyGroups

    The property groups delta updates to apply.

    Return Value

    Through the response callback, the caller will receive a Void object on success or a FileProperties.UpdatePropertiesError object on failure.

  • Add a template associated with a team. See propertiesAdd to add properties to a file or folder. Note: this endpoint will create team-owned templates.

    Declaration

    Swift

    @discardableResult
    open func templatesAddForTeam(name: String, description_: String, fields: Array<FileProperties.PropertyFieldTemplate>) -> RpcRequest<FileProperties.AddTemplateResultSerializer, FileProperties.ModifyTemplateErrorSerializer>

    Return Value

    Through the response callback, the caller will receive a FileProperties.AddTemplateResult object on success or a FileProperties.ModifyTemplateError object on failure.

  • Add a template associated with a user. See propertiesAdd to add properties to a file. This endpoint can’t be called on a team member or admin’s behalf.

    Declaration

    Swift

    @discardableResult
    open func templatesAddForUser(name: String, description_: String, fields: Array<FileProperties.PropertyFieldTemplate>) -> RpcRequest<FileProperties.AddTemplateResultSerializer, FileProperties.ModifyTemplateErrorSerializer>

    Return Value

    Through the response callback, the caller will receive a FileProperties.AddTemplateResult object on success or a FileProperties.ModifyTemplateError object on failure.

  • Get the schema for a specified template.

    Declaration

    Swift

    @discardableResult
    open func templatesGetForTeam(templateId: String) -> RpcRequest<FileProperties.GetTemplateResultSerializer, FileProperties.TemplateErrorSerializer>

    Parameters

    templateId

    An identifier for template added by route See templatesAddForUser or templatesAddForTeam.

    Return Value

    Through the response callback, the caller will receive a FileProperties.GetTemplateResult object on success or a FileProperties.TemplateError object on failure.

  • Get the schema for a specified template. This endpoint can’t be called on a team member or admin’s behalf.

    Declaration

    Swift

    @discardableResult
    open func templatesGetForUser(templateId: String) -> RpcRequest<FileProperties.GetTemplateResultSerializer, FileProperties.TemplateErrorSerializer>

    Parameters

    templateId

    An identifier for template added by route See templatesAddForUser or templatesAddForTeam.

    Return Value

    Through the response callback, the caller will receive a FileProperties.GetTemplateResult object on success or a FileProperties.TemplateError object on failure.

  • Get the template identifiers for a team. To get the schema of each template use templatesGetForTeam.

    Declaration

    Swift

    @discardableResult
    open func templatesListForTeam() -> RpcRequest<FileProperties.ListTemplateResultSerializer, FileProperties.TemplateErrorSerializer>

    Return Value

    Through the response callback, the caller will receive a FileProperties.ListTemplateResult object on success or a FileProperties.TemplateError object on failure.

  • Get the template identifiers for a team. To get the schema of each template use templatesGetForUser. This endpoint can’t be called on a team member or admin’s behalf.

    Declaration

    Swift

    @discardableResult
    open func templatesListForUser() -> RpcRequest<FileProperties.ListTemplateResultSerializer, FileProperties.TemplateErrorSerializer>

    Return Value

    Through the response callback, the caller will receive a FileProperties.ListTemplateResult object on success or a FileProperties.TemplateError object on failure.

  • Permanently removes the specified template created from templatesAddForUser. All properties associated with the template will also be removed. This action cannot be undone.

    Declaration

    Swift

    @discardableResult
    open func templatesRemoveForTeam(templateId: String) -> RpcRequest<VoidSerializer, FileProperties.TemplateErrorSerializer>

    Parameters

    templateId

    An identifier for a template created by templatesAddForUser or templatesAddForTeam.

    Return Value

    Through the response callback, the caller will receive a Void object on success or a FileProperties.TemplateError object on failure.

  • Permanently removes the specified template created from templatesAddForUser. All properties associated with the template will also be removed. This action cannot be undone.

    Declaration

    Swift

    @discardableResult
    open func templatesRemoveForUser(templateId: String) -> RpcRequest<VoidSerializer, FileProperties.TemplateErrorSerializer>

    Parameters

    templateId

    An identifier for a template created by templatesAddForUser or templatesAddForTeam.

    Return Value

    Through the response callback, the caller will receive a Void object on success or a FileProperties.TemplateError object on failure.

  • Update a template associated with a team. This route can update the template name, the template description and add optional properties to templates.

    Declaration

    Swift

    @discardableResult
    open func templatesUpdateForTeam(templateId: String, name: String? = nil, description_: String? = nil, addFields: Array<FileProperties.PropertyFieldTemplate>? = nil) -> RpcRequest<FileProperties.UpdateTemplateResultSerializer, FileProperties.ModifyTemplateErrorSerializer>

    Parameters

    templateId

    An identifier for template added by See templatesAddForUser or templatesAddForTeam.

    name

    A display name for the template. template names can be up to 256 bytes.

    addFields

    Property 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 FileProperties.UpdateTemplateResult object on success or a FileProperties.ModifyTemplateError object on failure.

  • Update a template associated with a user. This route can update the template name, the template description and add optional properties to templates. This endpoint can’t be called on a team member or admin’s behalf.

    Declaration

    Swift

    @discardableResult
    open func templatesUpdateForUser(templateId: String, name: String? = nil, description_: String? = nil, addFields: Array<FileProperties.PropertyFieldTemplate>? = nil) -> RpcRequest<FileProperties.UpdateTemplateResultSerializer, FileProperties.ModifyTemplateErrorSerializer>

    Parameters

    templateId

    An identifier for template added by See templatesAddForUser or templatesAddForTeam.

    name

    A display name for the template. template names can be up to 256 bytes.

    addFields

    Property 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 FileProperties.UpdateTemplateResult object on success or a FileProperties.ModifyTemplateError object on failure.