API Method: bookmark items create

POST /:user_id/bookmarks/:folder_id/items/:item_id

Creates a bookmark item in the specified bookmarks folder of the specified user account. Returns a representation of the created bookmark item with a 201 Created HTTP status code. To create multiple bookmarks at once, see bookmark items create (multiple).

URL:

http://subsift.ilrt.bris.ac.uk/user_id/bookmarks/folder_id/items/item_id.format

Formats (about return formats):

csv, json, rdf, terms, xml, yaml

HTTP Methods (about HTTP methods):

POST

Requires Authentication (about authentication):

true

Parameters:

Usage Examples:

cURL (about cURL):

curl -X POST -H "Token:mytoken" -d "item_url=http://www.cs.bris.ac.uk/~flach"
http://subsift.ilrt.bris.ac.uk/kdd09/bookmarks/pc/items/Peter%20Flach.xml


curl -X POST -H "Token:mytoken" -d "item_id=Peter Flach" -d "description=Peter A. Flach's homepage"
-d "item_url=http://www.cs.bris.ac.uk/~flach" -d "format=xml"
http://subsift.ilrt.bris.ac.uk/kdd09/bookmarks/pc/items

Response (about return values):

XML example:

<?xml version="1.0" encoding="UTF-8"?>
<result>
  <bookmark>
    <name>Peter Flach</name>
    <created>1266788131</created>
    <description>Peter A. Flach's homepage</description>
    <modified>1266788131</modified>
    <url>http://www.cs.bris.ac.uk/~flach</url>
  </bookmark>
</result>