change-security-of-item.md

Change Security of Item

Modify an item with a private URL to have a public URL or vice versa.

Request

• Requires authentication

• HTTP Method: PUT

• URL: Value of item's href attribute. (e.g., http://my.cl.ly/items/1912565)

• Body:

  {
    "item": {
      "private": false
    }
  }

Response

• Status: 200 OK

• Body:

  {
    "href":         "http://my.cl.ly/items/1912565",
    "name":         "CloudApp",
    "private":      false,
    "subscribed":   false,
    "url":          "http://cl.ly/2wt6",
    "content_url":  "http://cl.ly/2wt6",
    "item_type":    "bookmark",
    "view_counter": 0,
    "icon":         "http://my.cl.ly/images/item_types/bookmark.png",
    "remote_url":   null,
    "redirect_url": "http://getcloudapp.com",
    "source":       "Cloud/1.5.1 CFNetwork/520.0.13 Darwin/11.0.0 (x86_64) (MacBookPro5%2C5)",
    "created_at":   "2010-10-23T21:15:21Z",
    "updated_at":   "2010-10-23T21:17:04Z",
    "deleted_at":   null
  }

Example

curl --digest -u arthur@dent.com:towel \
     -H "Accept: application/json" \
     -H "Content-Type: application/json" \
     -d \
       '{
          "item": {
            "private": false
          }
        }' \
     -X PUT \
     "http://my.cl.ly/items/1912565"