Switch branches/tags
Nothing to show
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
53 lines (42 sloc) 1.93 KB

Upload File With Specific Privacy

An uploaded file's privacy is set to the owner's default privacy setting. If the file to be uploaded should be either public or private, this can be overridden when requesting the parameters to upload a file.

This is simply the first step in the process to upload a file. See the article Upload File for full details.


  • Requires authentication
  • HTTP Method: GET
  • URL:[private]=false


  • Status: 200 OK

  • Body:

      "uploads_remaining": 10,
      "max_upload_size":   26214400,
      "url":               "",
      "params": {
        "AWSAccessKeyId":          "AKIAIDPUZISHSBEOFS6Q",
        "key":                     "items/qL/${filename}",
        "acl":                     "public-read",
        "success_action_redirect": "[private]=false",
        "signature":               "2vRWmaSy46WGs0MDUdLHAqjSL8k=",
        "policy":                  "eyJleHBpcmF0aW9uIjoiMjAxMC0wNC0wMVQwMDowMDowMFoiLCJjb25kaXRpb25zIjpbeyJidWNrZXQiOiJsaW5lYnJlYWstdGVzdCJ9LHsiYWNsIjoicHVibGljLXJlYWQifSx7InN1Y2Nlc3NfYWN0aW9uX3JlZGlyZWN0IjoiaHR0cDovL215LmNsb3VkYXBwLmxvY2FsL3VwbG9hZHMvczMifSxbInN0YXJ0cy13aXRoIiwiJGtleSIsInVwbG9hZHMvcUwvIl1dfQ=="


If the account is using a CloudApp Free plan, there is a maximum daily file upload limit. If that limit has been met, the request will be successful but the params attribute will be missing, uploads_remaining will be 0, and message will be a friendly explanation of the error.


curl --digest -u \
     -H "Accept: application/json" \
     -H "Content-Type: application/json" \