Get a folder with a path or a child URI

get/folders/@item

Get a folder with a resource wildcard. Either a path or a child URI is required. The result must be exactly one matching folder. If the childUri parameter is provided, the parent folder of the member with the matching URI is returned, if it exists. If the path is provided, it must be a slash-delimited path to the desired folder.

Request Samples

Response Samples


1{
2  "creationTimeStamp": "2019-08-08T12:53:51.309Z",
3  "modifiedTimeStamp": "2019-08-08T12:53:51.309Z",
4  "createdBy": "testuser",
5  "modifiedBy": "testuser",
6  "id": "6e6aa6e9-7c6a-4491-84fd-84051031a44d",
7  "name": "My Folder",
8  "parentFolderUri": "/folders/folders/f210f767-7f3a-4109-849b-f1b7d1c5d11a",
9  "description": "My Folder for testuser",
10  "type": "myFolder",
11  "memberCount": 0,
12  "properties": {
13    "allowMove": "false"
14  },
15  "links": [
16    {
17      "method": "GET",
18      "rel": "self",
19      "href": "/folders/folders/6e6aa6e9-7c6a-4491-84fd-84051031a44d",
20      "uri": "/folders/folders/6e6aa6e9-7c6a-4491-84fd-84051031a44d",
21      "type": "application/vnd.sas.content.folder"
22    },
23    {
24      "method": "GET",
25      "rel": "up",
26      "href": "/folders/folders/f210f767-7f3a-4109-849b-f1b7d1c5d11a",
27      "uri": "/folders/folders/f210f767-7f3a-4109-849b-f1b7d1c5d11a",
28      "type": "application/vnd.sas.content.folder"
29    },
30    {
31      "method": "PUT",
32      "rel": "validateNewMemberName",
33      "href": "/folders/commons/validations/folders/6e6aa6e9-7c6a-4491-84fd-84051031a44d/members/@new/name?value={newname}&type={newtype}",
34      "uri": "/folders/commons/validations/folders/6e6aa6e9-7c6a-4491-84fd-84051031a44d/members/@new/name?value={newname}&type={newtype}"
35    },
36    {
37      "method": "GET",
38      "rel": "ancestors",
39      "href": "/folders/ancestors?childUri=/folders/folders/6e6aa6e9-7c6a-4491-84fd-84051031a44d",
40      "uri": "/folders/ancestors?childUri=/folders/folders/6e6aa6e9-7c6a-4491-84fd-84051031a44d",
41      "type": "application/vnd.sas.content.folder.ancestor"
42    },
43    {
44      "method": "DELETE",
45      "rel": "delete",
46      "href": "/folders/folders/6e6aa6e9-7c6a-4491-84fd-84051031a44d",
47      "uri": "/folders/folders/6e6aa6e9-7c6a-4491-84fd-84051031a44d"
48    },
49    {
50      "method": "DELETE",
51      "rel": "deleteRecursively",
52      "href": "/folders/folders/6e6aa6e9-7c6a-4491-84fd-84051031a44d?recursive=true",
53      "uri": "/folders/folders/6e6aa6e9-7c6a-4491-84fd-84051031a44d?recursive=true"
54    },
55    {
56      "method": "GET",
57      "rel": "members",
58      "href": "/folders/folders/6e6aa6e9-7c6a-4491-84fd-84051031a44d/members",
59      "uri": "/folders/folders/6e6aa6e9-7c6a-4491-84fd-84051031a44d/members",
60      "type": "application/vnd.sas.collection",
61      "itemType": "application/vnd.sas.content.folder.member"
62    },
63    {
64      "method": "POST",
65      "rel": "addMember",
66      "href": "/folders/folders/6e6aa6e9-7c6a-4491-84fd-84051031a44d/members",
67      "uri": "/folders/folders/6e6aa6e9-7c6a-4491-84fd-84051031a44d/members",
68      "type": "application/vnd.sas.content.folder.member"
69    },
70    {
71      "method": "POST",
72      "rel": "createChild",
73      "href": "/folders/folders?parentFolderUri=/folders/folders/6e6aa6e9-7c6a-4491-84fd-84051031a44d",
74      "uri": "/folders/folders?parentFolderUri=/folders/folders/6e6aa6e9-7c6a-4491-84fd-84051031a44d",
75      "type": "application/vnd.sas.content.folder"
76    },
77    {
78      "method": "GET",
79      "rel": "transferExport",
80      "href": "/folders/folders/6e6aa6e9-7c6a-4491-84fd-84051031a44d",
81      "uri": "/folders/folders/6e6aa6e9-7c6a-4491-84fd-84051031a44d",
82      "responseType": "application/vnd.sas.transfer.object"
83    },
84    {
85      "method": "PUT",
86      "rel": "transferImportUpdate",
87      "href": "/folders/folders/6e6aa6e9-7c6a-4491-84fd-84051031a44d",
88      "uri": "/folders/folders/6e6aa6e9-7c6a-4491-84fd-84051031a44d",
89      "type": "application/vnd.sas.transfer.object",
90      "responseType": "application/vnd.sas.summary"
91    }
92  ],
93  "version": 1
94}

Query Parameters

Name	Type	Required	Description
childUri	string	false	The URI of a resource whose parent folder you want to return. This can be a folder or non-folder resource.
path	string	false	The slash-delimited path to a folder. For example, `/root/child/grandchild/greatgrandchild` would return the folder greatgrandchild.

Responses

Status	Meaning	Description
200	OK	The request succeeded. The folder was found and returned.	Headers	Schema
400	Bad Request	The request was invalid. Either no path or childUri was provided in the request, or the request was not formatted correctly.		Schema
404	Not Found	No folder exists at the requested path. No folder that matches the criteria exists.		Schema