Home
Updating bookmarks
To update a bookmark, send a replacement bookmark entry document in Atom format to the existing bookmark's edit Web address.
If the bookmark's Web address is changed, the edit Web address of the bookmark resource is changed as well.
All existing bookmark information will be replaced with the new data. To avoid deleting all existing data, retrieve any data you want to retain first, and send it back with this request. For example, if you want to add a new tag to a bookmark entry, retrieve the existing tags, and send them all back with the new tag in the update request. See Retrieving bookmarks for more information.
See Authenticating requests for information about how to authenticate the request.
Atom API request details
Method Resource URI Input representation PUT bookmark Value of the href attribute of the <link rel="edit"> element of each entry in the bookmarks feed. bookmark
Input
Provide a bookmark Atom entry document.The content type of the Atom entry document must be application/atom+xml.
Output
None. Returned HTTP Headers
- HTTP/1.1 200 OK
- Indicates that the bookmark was successfully updated. If an error occurs, this header will contain one of the error codes below.
Error codes
- HTTP/1.1 400 Bad Request
- HTTP/1.1 403 Forbidden
- HTTP/1.1 404 Not Found
Related reference