Folder Resource

Returns the representation for an Analytics Cloud application.

Resource URL

1/wave/folders/<folder ID>

Formats

JSON

Available Version

34.0

HTTP Methods

GET

GET Response Body (and /wave/folders POST Response Body)

Property Name	Type	Description	Filter Group and Version	Available Version
`applicationStatus`	String	The status of the application while it’s being created. One of the following: Application creation successfully completed Application creation failed Application currently in progress New status	Medium, 34.0	34.0
`assetIcon`	String	The file name of the icon for the application.	Small, 34.0	34.0
`assetIconUrl`	String	The URL for the asset icon.	Small, 34.0	34.0
`assetSharingUrl`	String	The sharing URL for the asset.	Small, 34.0	34.0
`createdBy`	Wave User	The user who created the asset.	Small, 34.0	34.0
`createdDate`	Date	The time the asset was created.	Small, 34.0	34.0
`description`	String	The description of the asset.	Small, 34.0	34.0
`folderId`	String	The folder ID associated with the application.	Small, 34.0	34.0
`icon`	Asset Reference	The icon for the asset.	Small, 34.0	34.0
`id`	String	The 18-character asset ID.	Small, 34.0	34.0
`label`	String	The label of the asset.	Small, 34.0	34.0
`lastAccessedDate`	Date	The last time the asset was accessed.	Small, 34.0	34.0
`lastModifiedBy`	Wave User	The user who last updated the asset.	Small, 34.0	34.0
`lastModifiedDate`	String	The last time the asset was modified.	Small, 34.0	34.0
`name`	String	The name of the asset.	Small, 34.0	34.0
`namespace`	String	The namespace of the asset.	Small, 34.0	34.0
`permisssions`	Permissions	The permissions for the current user.	Small, 34.0	34.0
`shares`	Wave Folder Share[]	The folder shares list.	Small, 34.0	34.0
`type`	String	The asset type. For folders, the value is `folder`.	Small, 34.0	34.0
`url`	String	The URL to get the definition of the asset.	Small, 34.0	34.0

Wave Folder Share

Property Name	Type	Description	Filter Group and Version	Available Version
`accessType`	String	The access type of the user. Values are: `Edit` `Manage` `View`	Small, 34.0	34.0
`imageUrl`	String	The URL of the user image.	Small, 34.0	34.0
`shareType`	String	The share type of the user. Values are: `Group` `Organization` `Role` `RoleAndSubordinates` `User`	Small, 34.0	34.0
`sharedWithId`	String	The ID of the user with the share representation.	Small, 34.0	34.0
`sharedWithLabel`	String	The label for the share user/group/org.	Small, 34.0	34.0

Example Response Body

1{
2  "applicationStatus" : "newstatus",
3  "assetIcon" : "6.png",
4  "assetIconUrl" : "https://na1.salesforce.com/icons/6.png",
5  "assetSharingUrl" : "https://na1.salesforce.com/application?assetId=xxx&orgId=yyy&loginHost=jsmith-ltm.na1.salesforce.com&urlType=sharing",
6  "createdBy" : {
7    "id" : "005xx000001SxwEAAS",
8    "name" : "Admin User",
9    "profilePhotoUrl" : "https://na1.salesforce.com/profilephoto/005/T"
10  },
11  "createdDate" : "2015-06-22T17:38:33.000Z",
12  "folderId" : "00lxx000000fmEpAAI",
13  "icon" : {
14    "alias" : "6.png",
15    "id" : "02Ixx00000003qvEAA",
16    "url" : "https://na1.salesforce.com/app/icons/6.png"
17  },
18  "id" : "02Ixx00000003qvEAA",
19  "label" : "A new App",
20  "lastModifiedBy" : {
21    "id" : "005xx000001SxwEAAS",
22    "name" : "Admin User",
23    "profilePhotoUrl" : "/profilephoto/005/T"
24  },
25  "lastModifiedDate" : "2015-06-22T17:38:33.000Z",
26  "name" : "A_new_App1",
27  "permissions" : {
28    "manage" : true,
29    "modify" : true,
30    "view" : true
31  },
32  "shares" : [ {
33    "accessType" : "manage",
34    "imageUrl" : "/profilephoto/00G/T",
35    "shareType" : "organization",
36    "sharedWithId" : "00Gxx000000nCDzEAM",
37    "sharedWithLabel" : "All Internal Users"
38  }, {
39    "accessType" : "manage",
40    "imageUrl" : "/profilephoto/005/T",
41    "shareType" : "user",
42    "sharedWithId" : "005xx000001SxzaAAC",
43    "sharedWithLabel" : "Integration User"
44  } ],
45  "type" : "folder",
46  "url" : "/services/data/v34.0/wave/folders/00lxx000000fmEpAAI"
47}

Wave REST API Developer's Guide (Pilot)

Folder Resource