Create a new repository container

post/repository/items/{itemId}/children

Create a new repository context or folder.

Request Samples

Response Samples


1{
2  "value": {
3    "RepositoryContext": {
4      "version": 1,
5      "createdBy": "sastest1",
6      "creationTimeStamp": "2023-08-29T12:23:24Z",
7      "modifiedBy": "sastest1",
8      "modifiedTimeStamp": "2023-09-19T19:01:21Z",
9      "id": "cac68a83-2f9b-4e45-859f-1163581edf1e",
10      "typeId": "businessunit",
11      "createdByDisplayName": "SAS Test User 1 (sastest1)",
12      "modifiedByDisplayName": "SAS Test User 1 (sastest1)",
13      "primaryType": "CONTEXT",
14      "name": "BU",
15      "location": "/",
16      "path": "/BU",
17      "size": 5318049,
18      "propertiesModifiedTimeStamp": "2023-08-29T12:23:24Z",
19      "propertiesModifiedBy": "sastest1",
20      "propertiesModifiedByDisplayName": "SAS Test User 1 (sastest1)",
21      "state": "ACTIVE",
22      "owner": "sastest1",
23      "ownerDisplayName": "SAS Test User 1 (sastest1)",
24      "syncable": "ALLOW",
25      "defaultOwner": "sastest1",
26      "defaultOwnerDisplayName": "SAS Test User 1 (sastest1)",
27      "defaultMajorVersionLimit": 5,
28      "defaultMinorVersionLimit": 10,
29      "tags": []
30    },
31    "RepositoryFolder": {
32      "version": 1,
33      "createdBy": "sastest1",
34      "creationTimeStamp": "2023-09-15T15:41:22Z",
35      "modifiedBy": "sastest1",
36      "modifiedTimeStamp": "2023-09-17T18:08:16Z",
37      "id": "16edf3c1-b383-4649-9e34-8e153b111f1a",
38      "typeId": "folder",
39      "createdByDisplayName": "SAS Test User 1 (sastest1)",
40      "modifiedByDisplayName": "SAS Test User 1 (sastest1)",
41      "primaryType": "FOLDER",
42      "name": "folder1",
43      "location": "/BU",
44      "path": "/BU/folder1",
45      "size": 1420,
46      "propertiesModifiedTimeStamp": "2023-09-15T15:41:22Z",
47      "propertiesModifiedBy": "sastest1",
48      "propertiesModifiedByDisplayName": "SAS Test User 1 (sastest1)",
49      "state": "ACTIVE",
50      "syncable": "ALLOW",
51      "owner": "sastest1",
52      "ownerDisplayName": "SAS Test User 1 (sastest1)",
53      "defaultOwner": "sastest1",
54      "defaultOwnerDisplayName": "SAS Test User 1 (sastest1)",
55      "tags": []
56    }
57  }
58}

Path Parameters

Name	Type	Required	Description
itemId	string	true	The unique identifier for the repository location in which to create the item.

Query Parameters

Name	Type	Required	Description
description	string	false	The description for the newly created item.
owner	string	false	The owner to set for the newly created context. By default, the default permission's owner is used to set the new owner. However, this behavior can be overwritten by explicitly setting the owner with this parameter. This can be set only for contexts, this parameter is ignored when creating folders.
typeId	string	false	The type identifier of the context to be created. This parameter is required when a context is being created. For folder primary types this parameter will be ignored.
name	string	true	The name of the new item to be created.
type	string	true	The primary type of the new item to be created. Allowed values: CONTEXTFOLDER

Responses

Status	Meaning	Description
201	Created	Created - the repository item was created successfully.	Headers	Schema
400	Bad Request	Bad Request
404	Not Found	A repository item with the specified identifier could not be found.
409	Conflict	A repository item with the same name already exists at the specified location.