Hey there, how can we help?

Popular searches: Sync, Bear Pro, Migrate

X callback url Scheme documentation

Bear implements the x-callback-url protocol, which allow iOS and Mac developers to expose and document the methods they make available to other apps and return useful data.

Bear URL Scheme actions look like this:

bear://x-callback-url/[action]?[action parameters]&[x-callback parameters]

with x-success and x-error as available x-callback parameters.

Actions

/open-note

Open a note identified by its title or id and return its content.

parameters

x-success

example

bear://x-callback-url/open-note?id=7E4B681B

/create

Create a new note and return its unique identifier. Empty notes are not allowed.

parameters

x-success

example

bear://x-callback-url/create?title=My%20Note%20Title&text=First%20line&tags=home,home%2Fgroceries

notes

The base64 file parameter have to be encoded when passed as an url parameter.

/add-text

append or prepent text to a note identified by its title or id.

parameters

x-success

example

bear://x-callback-url/add-text?text=new%20line&id=4EDAF0D1&mode=append

/add-file

append or prepend a file to a note identified by its title or id.

parameters

x-success

example

bear://x-callback-url/add-file?filename=test.gif&id=4EDAF0D1-2EFF-4190-BC1D-67D9BAE49BA9-28433-000187BAA3D182EF&mode=append&file=R0lGODlhAQABAIAAAP%2F%2F%2F%2F%2F%2F%2FyH5BAEKAAEALAAAAAABAAEAAAICTAEAOw%3D%3D

notes

The base64 file parameter have to be encoded when passed as an url parameter.

/open-tag

Show all the notes which have a selected tag in bear.

parameters

example

bear://x-callback-url/open-tag?name=work bear://x-callback-url/open-tag?name=todo%2Fwork

/rename-tag

Rename an existing tag.

parameters

example

bear://x-callback-url/rename-tag?name=todo&new_name=done

/delete-tag

Delete an existing tag.

parameters

example

bear://x-callback-url/delete-tag?name=todo

/trash

Move a note to bear trash.

parameters

example

bear://x-callback-url/trash?id=7E4B681B

Show search results in Bear for all notes or for a specific tag.

parameters

example

bear://x-callback-url/search?term=nemo&tag=movies

/grab-url

Create a new note with the content of a web page.

parameters

x-success

available values

yes no

example

bear://x-callback-url/grab-url?url=http://www.bear-writer.com

/change-theme

Change the selected Bear theme. Some themes may require a Bear Pro subscription.

parameters

available values

Red Graphite Charcoal Solarized Light Solarized Dark Panic Mode Dracula Gotham Toothpaste Cobalt

example

bear://x-callback-url/change-theme?theme=Solarized%20Dark

/change-font

Change the selected Bear Font.

parameters

available values

Avenir Next System Helvetica Neue Menlo Georgia Courier Open Dyslexic

example

bear://x-callback-url/change-font?font=Helvetica%20Neue

Support

To discuss URL scheme improvements or reporting bugs please use our Support Forum or Bear's subreddit.

Contact Us