def get_bookmark(self, bookmark):
"""
Return single Bookmark by id
:calls: `GET /api/v1/users/self/bookmarks/:id \
<https://canvas.instructure.com/doc/api/bookmarks.html#method.bookmarks/bookmarks.show>`_
:param bookmark: The object or ID of the bookmark.
:type bookmark: :class:`canvasapi.bookmark.Bookmark` or int
:rtype: :class:`canvasapi.bookmark.Bookmark`
"""
from canvasapi.bookmark import Bookmark
bookmark_id = obj_or_id(bookmark, "bookmark", (Bookmark, ))
response = self._requester.request(
"GET", "users/self/bookmarks/{}".format(bookmark_id))
return Bookmark(self._requester, response.json())
def create_bookmark(self, name, url, **kwargs):
"""
Create a new Bookmark.
:calls: `POST /api/v1/users/self/bookmarks \
<https://canvas.instructure.com/doc/api/bookmarks.html#method.bookmarks/bookmarks.create>`_
:param name: The name of the bookmark.
:type name: `str`
:param url: The url of the bookmark.
:type url: `str`
:rtype: :class:`canvasapi.bookmark.Bookmark`
"""
from canvasapi.bookmark import Bookmark
response = self._requester.request('POST',
'users/self/bookmarks',
name=name,
url=url,
_kwargs=combine_kwargs(**kwargs))
return Bookmark(self._requester, response.json())