Table of Contents

Interface HomeResources

Namespace
Smartsheet.Api
Assembly
smartsheet-csharp-sdk.dll

This interface provides methods to access resources previously from the deprecated home API.

Thread Safety: Implementation of this interface must be thread safe.

public interface HomeResources

Properties

FolderResources

Returns the HomeFolderResources object that provides access to folder resources under home.

HomeFolderResources FolderResources { get; }

Property Value

HomeFolderResources

the home folder resources

Methods

GetFoldersPersonal(IEnumerable<HomeInclusion>)

Gets a nested list of shared items that were previously found from the /home API, including reports, sheets, templates, and dashboards.

Mirrors to the following Smartsheet REST API method: GET /home

PersonalFolder GetFoldersPersonal(IEnumerable<HomeInclusion> includes)

Parameters

includes IEnumerable<HomeInclusion>

used to specify the optional objects to include, currently TEMPLATES is supported.

Returns

PersonalFolder

the resource (note that if there is no such resource, this method will throw ResourceNotFoundException rather than returning null).

Exceptions

InvalidRequestException

if there is any problem with the REST API request

AuthorizationException

if there is any problem with the REST API authorization (access token)

InvalidRequestException

if the resource cannot be found

ResourceNotFoundException

if the REST API service is not available (possibly due to rate limiting)

ServiceUnavailableException

if any other REST API related error occurred during the operation

SmartsheetException

if any other error occurred during the operation

GetFoldersPersonal(IEnumerable<HomeInclusion>?, IEnumerable<HomeExclusion>?)

Gets a nested list of shared items that were previously found from the /home API, including reports, sheets, templates, and dashboards.

Mirrors to the following Smartsheet REST API method: GET /folders/personal

PersonalFolder GetFoldersPersonal(IEnumerable<HomeInclusion>? includes = null, IEnumerable<HomeExclusion>? excludes = null)

Parameters

includes IEnumerable<HomeInclusion>

used to specify the optional objects to include, currently TEMPLATES is supported.

excludes IEnumerable<HomeExclusion>

used to specify the optional object to exclude

Returns

PersonalFolder

the resource (note that if there is no such resource, this method will throw ResourceNotFoundException rather than returning null).

Exceptions

InvalidRequestException

if there is any problem with the REST API request

AuthorizationException

if there is any problem with the REST API authorization (access token)

InvalidRequestException

if the resource cannot be found

ResourceNotFoundException

if the REST API service is not available (possibly due to rate limiting)

ServiceUnavailableException

if any other REST API related error occurred during the operation

SmartsheetException

if any other error occurred during the operation