Bookmarks

Bookmarks are events that have been bookmarked by one or more users.

List All
List All By Log
List One
Create
Delete

List All

Returns all bookmarks for the authenticated user across all the logs the user is associated with.

URL

GET /logs/bookmarks

Request

// This example returns the last 10

GET /logs/bookmarks?order=desc&pagesize=10
For all possible request parameters, see Events.

Response

Status: 200 OK

[
    {
        "id":"4dfdff994e1feb0b4c0020ef",
        "created":"\/Date(1308491673911)\/",
        "text":"A user was created",
        "link":"",
        "hash":"LiWqANduFe+cia1nMTfN+g==",
        "tags":["user","created"],
        "source":"web3",
        "log":"sample"
        "class":"created",
        "data":true,
        "geo":null,
        "value":null
    }
]
top

List All By Log

Returns all bookmarks for the authenticated user contained in the log identified by {logkey}.

URL

GET /logs/{logkey}/bookmarks

Request

// This example returns the last 10

GET /logs/foo/bookmarks?order=desc&pagesize=10
For all possible request parameters, see Events.

Response

Status: 200 OK

[
    {
        "id":"4dfdff994e1feb0b4c0020ef",
        "created":"\/Date(1308491673911)\/",
        "text":"A user was created",
        "link":"",
        "hash":"LiWqANduFe+cia1nMTfN+g==",
        "tags":["user","created"],
        "source":"web3",
        "log":"sample"
        "class":"created",
        "data":true,
        "geo":null,
        "value":null
    }
]
top

List One

Returns a single bookmark. This call will only work for bookmarks that are contained in the log identified by {logkey}.

URL

GET /logs/{logkey}/bookmarks/{id}

Request

No request data is sent

Response

Status: 200 OK

{
    "id":"4dfdff994e1feb0b4c0020ef",
    "created":"\/Date(1308491673911)\/",
    "text":"A user was created",
    "link":"",
    "hash":"LiWqANduFe+cia1nMTfN+g==",
    "tags":["user","created"],
    "source":"web3",
    "log":"sample"
    "class":"created",
    "data":true,
    "geo":null,
    "value":null
}
top

Create

Creates a new bookmark with the currently authenticated user as the author. In the request, {id} is the id of the event to bookmark. This call will only work for bookmarks that are contained in the log identified by {logkey}.

URL

POST /logs/{logkey}/bookmarks

Request

id={id}

Response

Status: 201 Created
top

Delete

Removes the bookmark at the referenced URL. In the URL, {id} is the id of the event to remove the bookmark. This call will only work for bookmarks that are contained in the log identified by {logkey}.

URL

DELETE /logs/{logkey}/bookmarks/{id}

Request

No request data is sent

Response

Status: 204 No Content
top