Newer Version Available

This content describes an older version of this product. View Latest

Folders

Use the Analytics Folders API to perform operations on report and dashboard folders. The Folders API is available in API version 41.0 and later.

Resources for the Analytics Folders API are available at /services/data/<latest API version>/folders. You can query each resource with an HTTP method.

Resource Supported HTTP Method Description

Folder Collections

/services/data/<latest API version>/folders/

POST

GET

Enables creation of report and dashboard folders and subfolders (POST).

Gets the list of folders (GET).

Folder Operations

/services/data/<latest API version>/folders/<folderid>

GET

PATCH

DELETE

Enables renaming (PATCH), deleting (DELETE), and obtaining information (GET) on the report or dashboard folder or subfolder.
Folder Shares

/services/data/<latest API version>/folders/<folderid>/shares

GET

PUT

POST

Extracts a list of current folder shares (GET), adds new shares (POST), or replaces existing shares (PUT).

Folder Share by ID

/services/data/<latest API version>/folders/<folderid>/shares/<shareid>

GET

PATCH

DELETE

For a specified share ID, extracts the share information (GET), updates the access level on the share (PATCH), or deletes the share (DELETE).

Folder Share Recipients

/services/data/<latest API version>/folders/<folderid>/share-recipients?shareType=<shareType>

GET

Returns a list of folder share recipients (GET).

Folder Child Operations

/services/data/<latest API version>/folders/<folderid>/children/

GET

Returns a list of first-level child folders (subfolders) (GET).