Get subfolders
GET
vaults/{vaultId}/folders/{id}/sub-folders
Get the immediate subfolders of a given folder Id
Resource Information
Method and URI | GET /AutodeskDM/Services/api/vault/v2/vaults/{vaultId}/folders/{id}/sub-folders |
Authentication Context | user context required |
Required OAuth Scopes | No scopes required |
Data Format | JSON |
Request
Headers
Authorization* string | Must be Bearer <token> , where <token> is obtained via a three-legged OAuth flow. |
* Required
Request
URI Parameters
vaultId string | The unique identifier of a vault. |
id string | The unique identifier of a folder.. |
Request
Query String Parameters
option[extendedModels] boolean | true : The response will include additional detailed information for each entity. Examples include:
|
option[propDefIds] string | The properties that need to be returned. property ids separated by ‘,’, e.g. ‘1,2,3’ ‘all’ means return all properties. |
limit int | Specifies the number of results to return per page. Maximum limit is controlled by “Page size conifguration” setting which could be updated using ADMS (“Global Setting” -> “Page size conifguration”). |
cursorState string | Indicates the state of the cursor for pagination. Use this parameter to navigate through paged results |
Response
HTTP Status Code Summary
200 OK | The request succeeded. The response contains the list of subfolders. |
401 Unauthorized | The supplied authorization header was not valid or the supplied token scope was not acceptable. Verify authentication and try again. |
403 Forbidden | The request was successfully validated but lacking the required permissions. Verify your credentials and permissions before you send this request again. |
404 Not Found | The requested resource was not found. |
Response
Body Structure (200)
Expand all
pagination object | Cursor-based pagination object. |
limit int | Limit requested for the current search |
totalResults int | Number of total hits. If this value is larger than the objects returned, then multiple searches will have to be performed to get the complete result set. |
indexingStatus enum:string | Indicates the current status of the indexing engine. This status helps users understand whether the indexing operation is complete or still in progress. This is particularly important for customers with large datasets, as indexing can take a considerable amount of time to complete.
The statuses include:
Note: When the status is either ‘IndexingProperties’ or ‘IndexingContent’, the search results are incomplete because the indexes are still being created. Complete search results will be available once fully indexed.
Possible values: |
nextUrl string | Used to continue a search if the results are too large for a single call. Url has bookmark string embedded for subsequent calls on that search |
results array | |
oneOf array:oneOf | |
Folder object | folder object |
id string | Get the unique identifier for this folder |
url string | The relative URL to access this object. |
name string | Get the descriptive name for this Folder. This is always the Folder Name without the full path. |
fullName string | Get the full vault path for this folder (ie. $/Folder1) |
createDate string | Get the date and time that the folder was created. |
createUserName string | Get the name of the user who created this folder. |
category string | Get the category that is assigned to this folder |
categoryColor number | Category color |
state string | The name of the life cycle state for the current folder |
stateColor number | The color of the state. |
subfolderCount number | Get the number of immediate child folders. |
children string | |
isLibrary boolean | Get whether or not this folder is a library folder |
isReadOnly boolean | Get whether this folder can be modified by the logged in user. |
isCloaked boolean | Get if this folder is cloaked. A cloaked object is one that the caller does not have permissions to view. |
properties array: object | |
propertyDefinitionId string | Unique identifier for a server-based property definition |
definition object | Property definition object. |
id string | Get the unique identifier for a server-based property definition |
url string | The relative URL to access this object. |
displayName string | Get or sets the Display name for this Property Definition |
systemName string | Get the System Name for this Property Definition. |
dataType enum:string | The value defined in SQL database.
Possible values: String , Numeric , Bool , DateTime , Image |
active boolean | Get or sets whether this Property Definition is Active. |
isSystem boolean | Get whether or not this is a System Property (as opposed to an userDefined property) |
initialValue string | Default Value that will be applied to entities that do not have an existing value associated with this PropertyDefinition |
value string | The property value associated with the entity and PropertyDefinition |
Folder object | folder object |
id string | Get the unique identifier for this folder |
url string | The relative URL to access this object. |
name string | Get the descriptive name for this Folder. This is always the Folder Name without the full path. |
fullName string | Get the full vault path for this folder (ie. $/Folder1) |
createDate string | Get the date and time that the folder was created. |
createUserName string | Get the name of the user who created this folder. |
category string | Get the category that is assigned to this folder |
categoryColor number | Category color |
state string | The name of the life cycle state for the current folder |
stateColor number | The color of the state. |
subfolderCount number | Get the number of immediate child folders. |
children string | |
isLibrary boolean | Get whether or not this folder is a library folder |
isReadOnly boolean | Get whether this folder can be modified by the logged in user. |
isCloaked boolean | Get if this folder is cloaked. A cloaked object is one that the caller does not have permissions to view. |
properties array: object | |
propertyDefinitionId string | Unique identifier for a server-based property definition |
definition object | Property definition object. |
id string | Get the unique identifier for a server-based property definition |
url string | The relative URL to access this object. |
displayName string | Get or sets the Display name for this Property Definition |
systemName string | Get the System Name for this Property Definition. |
dataType enum:string | The value defined in SQL database.
Possible values: String , Numeric , Bool , DateTime , Image |
active boolean | Get or sets whether this Property Definition is Active. |
isSystem boolean | Get whether or not this is a System Property (as opposed to an userDefined property) |
initialValue string | Default Value that will be applied to entities that do not have an existing value associated with this PropertyDefinition |
value string | The property value associated with the entity and PropertyDefinition |
parentFolderId string | |
parent object | folder object |
id string | Get the unique identifier for this folder |
url string | The relative URL to access this object. |
name string | Get the descriptive name for this Folder. This is always the Folder Name without the full path. |
fullName string | Get the full vault path for this folder (ie. $/Folder1) |
createDate string | Get the date and time that the folder was created. |
createUserName string | Get the name of the user who created this folder. |
category string | Get the category that is assigned to this folder |
categoryColor number | Category color |
state string | The name of the life cycle state for the current folder |
stateColor number | The color of the state. |
subfolderCount number | Get the number of immediate child folders. |
children string | |
isLibrary boolean | Get whether or not this folder is a library folder |
isReadOnly boolean | Get whether this folder can be modified by the logged in user. |
isCloaked boolean | Get if this folder is cloaked. A cloaked object is one that the caller does not have permissions to view. |
properties array: object | |
propertyDefinitionId string | Unique identifier for a server-based property definition |
definition object | Property definition object. |
id string | Get the unique identifier for a server-based property definition |
url string | The relative URL to access this object. |
displayName string | Get or sets the Display name for this Property Definition |
systemName string | Get the System Name for this Property Definition. |
dataType enum:string | The value defined in SQL database.
Possible values: String , Numeric , Bool , DateTime , Image |
active boolean | Get or sets whether this Property Definition is Active. |
isSystem boolean | Get whether or not this is a System Property (as opposed to an userDefined property) |
initialValue string | Default Value that will be applied to entities that do not have an existing value associated with this PropertyDefinition |
value string | The property value associated with the entity and PropertyDefinition |
included object | |
folder object | |
* object | folder object |
id string | Get the unique identifier for this folder |
url string | The relative URL to access this object. |
name string | Get the descriptive name for this Folder. This is always the Folder Name without the full path. |
fullName string | Get the full vault path for this folder (ie. $/Folder1) |
createDate string | Get the date and time that the folder was created. |
createUserName string | Get the name of the user who created this folder. |
category string | Get the category that is assigned to this folder |
categoryColor number | Category color |
state string | The name of the life cycle state for the current folder |
stateColor number | The color of the state. |
subfolderCount number | Get the number of immediate child folders. |
children string | |
isLibrary boolean | Get whether or not this folder is a library folder |
isReadOnly boolean | Get whether this folder can be modified by the logged in user. |
isCloaked boolean | Get if this folder is cloaked. A cloaked object is one that the caller does not have permissions to view. |
properties array: object | |
propertyDefinitionId string | Unique identifier for a server-based property definition |
definition object | Property definition object. |
id string | Get the unique identifier for a server-based property definition |
url string | The relative URL to access this object. |
displayName string | Get or sets the Display name for this Property Definition |
systemName string | Get the System Name for this Property Definition. |
dataType enum:string | The value defined in SQL database.
Possible values: String , Numeric , Bool , DateTime , Image |
active boolean | Get or sets whether this Property Definition is Active. |
isSystem boolean | Get whether or not this is a System Property (as opposed to an userDefined property) |
initialValue string | Default Value that will be applied to entities that do not have an existing value associated with this PropertyDefinition |
value string | The property value associated with the entity and PropertyDefinition |
propertyDefinition object | |
* object | Property definition object. |
id string | Get the unique identifier for a server-based property definition |
url string | The relative URL to access this object. |
displayName string | Get or sets the Display name for this Property Definition |
systemName string | Get the System Name for this Property Definition. |
dataType enum:string | The value defined in SQL database.
Possible values: String , Numeric , Bool , DateTime , Image |
active boolean | Get or sets whether this Property Definition is Active. |
isSystem boolean | Get whether or not this is a System Property (as opposed to an userDefined property) |
initialValue string | Default Value that will be applied to entities that do not have an existing value associated with this PropertyDefinition |
Example
This example illustrates how to get all subfolders of a folder.
Note: {VaultServerAddress}
is used as a placeholder in the example(s) and could represent one of the following:
- Vault Server IP address or hostname. Ex: http://10.41.110.49.
- Vault Gateway URL if gateway is configured. Ex: https://test.vg.autodesk.com.
Request
curl -v '{VaultServerAddress}/AutodeskDM/Services/api/vault/v2/vaults/117/folders/2/sub-folders' \
-X 'GET' \
-H 'Accept: application/json'\
-H 'Authorization: Bearer AuIPTf4KYLTYGVnOHQ0cuolwCW2a...'
Response
{
"pagination": {
"limit": 1000,
"totalResults": 1,
"indexingStatus": "NA"
},
"results": [
{
"name": "subFolder1",
"id": "51",
"fullName": "$/ColinTest/subFolder1",
"category": "Folder",
"categoryColor": -2302756,
"stateColor": 0,
"subfolderCount": 0,
"isLibrary": false,
"isCloaked": false,
"isReadOnly": false,
"createDate": "2024-10-22T07:25:27.207Z",
"createUserName": "TestAccount",
"entityType": "Folder",
"url": "/AutodeskDM/Services/api/vault/v2/vaults/117/folders/51"
}
]
}
Show More