Tcl Dropbox: Dropbox Create Folder

Back to Index

Create a folder. Creates the folder /Halloween/emojis

Documentation: https://www.dropbox.com/developers/documentation/http/documentation#files-create_folder

CURL Command

curl -X POST https://api.dropboxapi.com/2/files/create_folder_v2 \
    --header "Authorization: Bearer DROPBOX-ACCESS-TOKEN" \
    --header "Content-Type: application/json" \
    --data "{\"path\": \"/Halloween/emojis\",\"autorename\": false}"

Tcl Example

load ./chilkat.dll

set rest [new_CkRest]

#  URL: https://api.dropboxapi.com/2/files/create_folder_v2
set bTls 1
set port 443
set bAutoReconnect 1
set success [CkRest_Connect $rest "api.dropboxapi.com" $port $bTls $bAutoReconnect]
if {[expr $success != 1]} then {
    puts "ConnectFailReason: [CkRest_get_ConnectFailReason $rest]"
    puts [CkRest_lastErrorText $rest]
    delete_CkRest $rest
    exit
}

#  See the Online Tool for Generating JSON Creation Code
set json [new_CkJsonObject]

CkJsonObject_UpdateString $json "path" "/Halloween/emojis"
CkJsonObject_UpdateBool $json "autorename" 0

CkRest_AddHeader $rest "Authorization" "Bearer DROPBOX-ACCESS-TOKEN"
CkRest_AddHeader $rest "Content-Type" "application/json"

set sbRequestBody [new_CkStringBuilder]

CkJsonObject_EmitSb $json $sbRequestBody
set sbResponseBody [new_CkStringBuilder]

set success [CkRest_FullRequestSb $rest "POST" "/2/files/create_folder_v2" $sbRequestBody $sbResponseBody]
if {[expr $success != 1]} then {
    puts [CkRest_lastErrorText $rest]
    delete_CkRest $rest
    delete_CkJsonObject $json
    delete_CkStringBuilder $sbRequestBody
    delete_CkStringBuilder $sbResponseBody
    exit
}

set respStatusCode [CkRest_get_ResponseStatusCode $rest]
if {[expr $respStatusCode >= 400]} then {
    puts "Response Status Code = $respStatusCode"
    puts "Response Header:"
    puts [CkRest_responseHeader $rest]
    puts "Response Body:"
    puts [CkStringBuilder_getAsString $sbResponseBody]
    delete_CkRest $rest
    delete_CkJsonObject $json
    delete_CkStringBuilder $sbRequestBody
    delete_CkStringBuilder $sbResponseBody
    exit
}

set jsonResponse [new_CkJsonObject]

CkJsonObject_LoadSb $jsonResponse $sbResponseBody

#  See the Online Tool for Generating JSON Parse Code

set metadataName [CkJsonObject_stringOf $jsonResponse "metadata.name"]
set metadataId [CkJsonObject_stringOf $jsonResponse "metadata.id"]
set metadataPath_lower [CkJsonObject_stringOf $jsonResponse "metadata.path_lower"]
set metadataPath_display [CkJsonObject_stringOf $jsonResponse "metadata.path_display"]
set metadataSharing_infoRead_only [CkJsonObject_BoolOf $jsonResponse "metadata.sharing_info.read_only"]
set metadataSharing_infoParent_shared_folder_id [CkJsonObject_stringOf $jsonResponse "metadata.sharing_info.parent_shared_folder_id"]
set metadataSharing_infoTraverse_only [CkJsonObject_BoolOf $jsonResponse "metadata.sharing_info.traverse_only"]
set metadataSharing_infoNo_access [CkJsonObject_BoolOf $jsonResponse "metadata.sharing_info.no_access"]
set i 0
set count_i [CkJsonObject_SizeOfArray $jsonResponse "metadata.property_groups"]
while {[expr $i < $count_i]} {
    CkJsonObject_put_I $jsonResponse $i
    set template_id [CkJsonObject_stringOf $jsonResponse "metadata.property_groups[i].template_id"]
    set j 0
    set count_j [CkJsonObject_SizeOfArray $jsonResponse "metadata.property_groups[i].fields"]
    while {[expr $j < $count_j]} {
        CkJsonObject_put_J $jsonResponse $j
        set name [CkJsonObject_stringOf $jsonResponse "metadata.property_groups[i].fields[j].name"]
        set value [CkJsonObject_stringOf $jsonResponse "metadata.property_groups[i].fields[j].value"]
        set j [expr $j + 1]
    }
    set i [expr $i + 1]
}

delete_CkRest $rest
delete_CkJsonObject $json
delete_CkStringBuilder $sbRequestBody
delete_CkStringBuilder $sbResponseBody
delete_CkJsonObject $jsonResponse

Sample JSON Response Body

{
  "metadata": {
    "name": "emojis",
    "id": "id:a4ayc_80_OEAAAAAAAAAXz",
    "path_lower": "/halloween/emojis",
    "path_display": "/Halloween/emojis",
    "sharing_info": {
      "read_only": false,
      "parent_shared_folder_id": "84528192421",
      "traverse_only": false,
      "no_access": false
    },
    "property_groups": [
      {
        "template_id": "ptid:1a5n2i6d3OYEAAAAAAAAAYa",
        "fields": [
          {
            "name": "Security Policy",
            "value": "Confidential"
          }
        ]
      }
    ]
  }
}