arrow-left

All pages
gitbookPowered by GitBook
1 of 1

Loading...

Bookmarks

circle-exclamation

Welcome to Our New API Docs! This is the new home for all things API (previously at Canvas LMS REST API Documentationarrow-up-right).

hashtag
Bookmarks API

A Bookmark object looks like:

{
  "id": 1,
  "name": "Biology 101",
  "url": "/courses/1",
  "position": 1,
  "data": {"active_tab":1}
}

hashtag

GET /api/v1/users/self/bookmarks

Scope: url:GET|/api/v1/users/self/bookmarks

Returns the paginated list of bookmarks.

Example Request:

Returns a list of objects.

hashtag

POST /api/v1/users/self/bookmarks

Scope: url:POST|/api/v1/users/self/bookmarks

Creates a bookmark.

Request Parameters:

Parameter
Type
Description

Example Request:

Returns a object.

hashtag

GET /api/v1/users/self/bookmarks/:id

Scope: url:GET|/api/v1/users/self/bookmarks/:id

Returns the details for a bookmark.

Example Request:

Returns a object.

hashtag

PUT /api/v1/users/self/bookmarks/:id

Scope: url:PUT|/api/v1/users/self/bookmarks/:id

Updates a bookmark

Request Parameters:

Parameter
Type
Description

Example Request:

Returns a object.

hashtag

DELETE /api/v1/users/self/bookmarks/:id

Scope: url:DELETE|/api/v1/users/self/bookmarks/:id

Deletes a bookmark

Example Request:


This documentation is generated directly from the Canvas LMS source code, available .

integer

The position of the bookmark. Defaults to the bottom.

data

string

The data associated with the bookmark

integer

The position of the bookmark. Defaults to the bottom.

data

string

The data associated with the bookmark

name

string

The name of the bookmark

url

string

The url of the bookmark

name

string

The name of the bookmark

url

string

The url of the bookmark

List bookmarks
Bookmarks::BookmarksController#indexarrow-up-right
Bookmark
Create bookmark
Bookmarks::BookmarksController#createarrow-up-right
Bookmark
Get bookmark
Bookmarks::BookmarksController#showarrow-up-right
Bookmark
Update bookmark
Bookmarks::BookmarksController#updatearrow-up-right
Folder
Delete bookmark
Bookmarks::BookmarksController#destroyarrow-up-right
on Githubarrow-up-right

position

position

curl 'https://<canvas>/api/v1/users/self/bookmarks' \
     -H 'Authorization: Bearer <token>'
curl 'https://<canvas>/api/v1/users/self/bookmarks' \
     -F 'name=Biology 101' \
     -F 'url=/courses/1' \
     -H 'Authorization: Bearer <token>'
curl 'https://<canvas>/api/v1/users/self/bookmarks/1' \
     -H 'Authorization: Bearer <token>'
curl -X PUT 'https://<canvas>/api/v1/users/self/bookmarks/1' \
     -F 'name=Biology 101' \
     -F 'url=/courses/1' \
     -H 'Authorization: Bearer <token>'
curl -X DELETE 'https://<canvas>/api/v1/users/self/bookmarks/1' \
     -H 'Authorization: Bearer <token>'