These are the docs for the Metabase master branch. Some features documented here may not yet be available in the latest release. Check out the docs for the latest version, Metabase v0.50.

Bookmark

Handle creating bookmarks for the user. Bookmarks are in three tables and should be thought of as a tuple of (model, model-id) rather than a row in a table with an id. The DELETE takes the model and id because DELETE’s do not necessarily support request bodies. The POST is therefore shaped in this same manner. Since there are three underlying tables the id on the actual bookmark itself is not unique among “bookmarks” and is not a good identifier for using in the API.

DELETE /api/bookmark/:model/:id

Delete a bookmark. Will delete a bookmark assigned to the user making the request by model and id.

PARAMS:

  • model enum of card, dashboard, collection.

  • id value must be an integer greater than zero.

GET /api/bookmark/

Fetch all bookmarks for the user.

POST /api/bookmark/:model/:id

Create a new bookmark for user.

PARAMS:

  • model enum of card, dashboard, collection.

  • id value must be an integer greater than zero.

PUT /api/bookmark/ordering

Sets the order of bookmarks for user.

PARAMS:

  • orderings sequence of map where {:type -> <enum of card, dashboard, collection>, :item_id -> }.

« Back to API index

Read docs for other versions of Metabase.

Want to improve these docs? Propose a change.