URL: /api/v2/folders/[id]
Attributes:
| Name | Where? | Description |
|---|---|---|
| id | part of the url | Folder ID |
| name: | Folder Name (string) |
|---|---|
| is_public: | Public flag (boolean) |
| item_ordering: | Order of contained items (json encoded list) |
Request:
GET /api/v2/folders/[folder id]?bearer_token=[token] HTTP/1.1
Host: minus.com
Accept: */*
Accept-Charset: UTF-8,*;q=0.5
Response body:
{
"files": "https://minus.com/api/v2/folders/[folder id]/files",
"view_count": 0,
"date_last_updated": "2011-11-10 17:18:11",
"last_updated": "2011-11-10 17:18:11",
"name": "Screen Shot 2011-10-13 at 9.04.00 AM",
"creator": "https://minus.com/api/v2/users/api_examples",
"url": "https://minus.com/api/v2/folders/[folder id]",
"created": "2011-11-10 17:18:06",
"item_ordering": ["bkErpJKXLMunu", "TQ2pnAjsAf35"],
"last_updated_ago": 325092,
"created_ago": 325097,
"thumbnail_url": "/kbkErpJKXLMunu.jpg",
"file_count": 2,
"is_public": false,
"id": "[folder id]"
}
Request:
PUT /api/v2/folders/N3giEM9n?bearer_token=0f513a4a4ce378a72fc4 HTTP/1.1
Host: minus.com
Content-Type: application/x-www-form-urlencoded; charset=UTF-8
Accept: */*
Accept-Charset: UTF-8,*;q=0.5
name=Test&item_ordering=["TQ2pnAjsAf35", "bkErpJKXLMunu"]
Response body:
{
"files": "https://minus.com/api/v2/folders/[folder id]/files",
"view_count": 0,
"date_last_updated": "2011-11-14 11:44:05",
"last_updated": "2011-11-14 11:44:05",
"name": "Test",
"creator": "https://minus.com/api/v2/users/api_examples",
"url": "https://minus.com/api/v2/folders/[folder id]",
"created": "2011-11-10 17:18:06",
"item_ordering": ["TQ2pnAjsAf35", "bkErpJKXLMunu"],
"last_updated_ago": 0,
"created_ago": 325559,
"thumbnail_url": "/kTQ2pnAjsAf35.jpg",
"file_count": 2,
"is_public": false,
"id": "[folder id]"
}
Request:
DELETE /api/v2/folders/N3giEM9n?bearer_token=0f513a4a4ce378a72fc4 HTTP/1.1
Host: minus.com
Content-Type: application/x-www-form-urlencoded; charset=UTF-8
Accept: */*
Accept-Charset: UTF-8,*;q=0.5