Creates a new folder. To create a folder in the root folder, use a parent folder id = "0".
curl https://api.box.com/2.0/folders \
-H "Authorization: Bearer BOX_ACCESS_TOKEN" \
-d '{"name":"Important Docs", "parent": {"id": "BOX_FOLDER_ID"}}' \
-X POST#include <CkRestW.h>
#include <CkJsonObjectW.h>
#include <CkStringBuilderW.h>
void ChilkatSample(void)
{
CkRestW rest;
bool success;
// URL: https://api.box.com/2.0/folders
bool bTls = true;
int port = 443;
bool bAutoReconnect = true;
success = rest.Connect(L"api.box.com",port,bTls,bAutoReconnect);
if (success != true) {
wprintf(L"ConnectFailReason: %d\n",rest.get_ConnectFailReason());
wprintf(L"%s\n",rest.lastErrorText());
return;
}
CkJsonObjectW json;
json.UpdateString(L"name",L"Important Docs");
json.UpdateString(L"parent.id",L"BOX_FOLDER_ID");
rest.AddHeader(L"Authorization",L"Bearer BOX_ACCESS_TOKEN");
CkStringBuilderW sbRequestBody;
json.EmitSb(sbRequestBody);
CkStringBuilderW sbResponseBody;
success = rest.FullRequestSb(L"POST",L"/2.0/folders",sbRequestBody,sbResponseBody);
if (success != true) {
wprintf(L"%s\n",rest.lastErrorText());
return;
}
CkJsonObjectW jsonResponse;
jsonResponse.LoadSb(sbResponseBody);
const wchar_t *type = 0;
const wchar_t *id = 0;
const wchar_t *sequence_id = 0;
const wchar_t *etag = 0;
const wchar_t *name = 0;
const wchar_t *created_at = 0;
const wchar_t *modified_at = 0;
const wchar_t *description = 0;
int size;
int path_collectionTotal_count;
const wchar_t *created_byType = 0;
const wchar_t *created_byId = 0;
const wchar_t *created_byName = 0;
const wchar_t *created_byLogin = 0;
const wchar_t *modified_byType = 0;
const wchar_t *modified_byId = 0;
const wchar_t *modified_byName = 0;
const wchar_t *modified_byLogin = 0;
bool trashed_at;
bool purged_at;
const wchar_t *content_created_at = 0;
const wchar_t *content_modified_at = 0;
const wchar_t *owned_byType = 0;
const wchar_t *owned_byId = 0;
const wchar_t *owned_byName = 0;
const wchar_t *owned_byLogin = 0;
bool shared_link;
bool folder_upload_email;
const wchar_t *parentType = 0;
const wchar_t *parentId = 0;
bool parentSequence_id;
bool parentEtag;
const wchar_t *parentName = 0;
const wchar_t *item_status = 0;
int item_collectionTotal_count;
int item_collectionOffset;
int item_collectionLimit;
int i;
int count_i;
bool sequence_id_bool;
bool etag_bool;
const wchar_t *by = 0;
const wchar_t *direction = 0;
type = jsonResponse.stringOf(L"type");
id = jsonResponse.stringOf(L"id");
sequence_id = jsonResponse.stringOf(L"sequence_id");
etag = jsonResponse.stringOf(L"etag");
name = jsonResponse.stringOf(L"name");
created_at = jsonResponse.stringOf(L"created_at");
modified_at = jsonResponse.stringOf(L"modified_at");
description = jsonResponse.stringOf(L"description");
size = jsonResponse.IntOf(L"size");
path_collectionTotal_count = jsonResponse.IntOf(L"path_collection.total_count");
created_byType = jsonResponse.stringOf(L"created_by.type");
created_byId = jsonResponse.stringOf(L"created_by.id");
created_byName = jsonResponse.stringOf(L"created_by.name");
created_byLogin = jsonResponse.stringOf(L"created_by.login");
modified_byType = jsonResponse.stringOf(L"modified_by.type");
modified_byId = jsonResponse.stringOf(L"modified_by.id");
modified_byName = jsonResponse.stringOf(L"modified_by.name");
modified_byLogin = jsonResponse.stringOf(L"modified_by.login");
trashed_at = jsonResponse.IsNullOf(L"trashed_at");
purged_at = jsonResponse.IsNullOf(L"purged_at");
content_created_at = jsonResponse.stringOf(L"content_created_at");
content_modified_at = jsonResponse.stringOf(L"content_modified_at");
owned_byType = jsonResponse.stringOf(L"owned_by.type");
owned_byId = jsonResponse.stringOf(L"owned_by.id");
owned_byName = jsonResponse.stringOf(L"owned_by.name");
owned_byLogin = jsonResponse.stringOf(L"owned_by.login");
shared_link = jsonResponse.IsNullOf(L"shared_link");
folder_upload_email = jsonResponse.IsNullOf(L"folder_upload_email");
parentType = jsonResponse.stringOf(L"parent.type");
parentId = jsonResponse.stringOf(L"parent.id");
parentSequence_id = jsonResponse.IsNullOf(L"parent.sequence_id");
parentEtag = jsonResponse.IsNullOf(L"parent.etag");
parentName = jsonResponse.stringOf(L"parent.name");
item_status = jsonResponse.stringOf(L"item_status");
item_collectionTotal_count = jsonResponse.IntOf(L"item_collection.total_count");
item_collectionOffset = jsonResponse.IntOf(L"item_collection.offset");
item_collectionLimit = jsonResponse.IntOf(L"item_collection.limit");
i = 0;
count_i = jsonResponse.SizeOfArray(L"path_collection.entries");
while (i < count_i) {
jsonResponse.put_I(i);
type = jsonResponse.stringOf(L"path_collection.entries[i].type");
id = jsonResponse.stringOf(L"path_collection.entries[i].id");
sequence_id_bool = jsonResponse.IsNullOf(L"path_collection.entries[i].sequence_id");
etag_bool = jsonResponse.IsNullOf(L"path_collection.entries[i].etag");
name = jsonResponse.stringOf(L"path_collection.entries[i].name");
i = i + 1;
}
i = 0;
count_i = jsonResponse.SizeOfArray(L"item_collection.entries");
while (i < count_i) {
jsonResponse.put_I(i);
i = i + 1;
}
i = 0;
count_i = jsonResponse.SizeOfArray(L"item_collection.order");
while (i < count_i) {
jsonResponse.put_I(i);
by = jsonResponse.stringOf(L"item_collection.order[i].by");
direction = jsonResponse.stringOf(L"item_collection.order[i].direction");
i = i + 1;
}
}
{
"type": "folder",
"id": "47885473705",
"sequence_id": "0",
"etag": "0",
"name": "Important Docs",
"created_at": "2018-03-16T06:54:57-07:00",
"modified_at": "2018-03-16T06:54:57-07:00",
"description": "",
"size": 0,
"path_collection": {
"total_count": 1,
"entries": [
{
"type": "folder",
"id": "0",
"sequence_id": null,
"etag": null,
"name": "All Files"
}
]
},
"created_by": {
"type": "user",
"id": "2787704945",
"name": "chilkat",
"login": "AutomationUser_434741_3nmGYSS7o5@@boxdevedition.com"
},
"modified_by": {
"type": "user",
"id": "2787704945",
"name": "chilkat",
"login": "AutomationUser_434741_3nmGYSS7o5@@boxdevedition.com"
},
"trashed_at": null,
"purged_at": null,
"content_created_at": "2018-03-16T06:54:57-07:00",
"content_modified_at": "2018-03-16T06:54:57-07:00",
"owned_by": {
"type": "user",
"id": "2787704945",
"name": "chilkat",
"login": "AutomationUser_434741_3nmGYSS7o5@@boxdevedition.com"
},
"shared_link": null,
"folder_upload_email": null,
"parent": {
"type": "folder",
"id": "0",
"sequence_id": null,
"etag": null,
"name": "All Files"
},
"item_status": "active",
"item_collection": {
"total_count": 0,
"entries": [
],
"offset": 0,
"limit": 100,
"order": [
{
"by": "type",
"direction": "ASC"
},
{
"by": "name",
"direction": "ASC"
}
]
}
}