AI agents: fetch the documentation index at llms.txt. Markdown versions are available by appending .md to any page URL, including this page's markdown.
URL Scheme
Create and open Done Bear tasks from Shortcuts and other apps with the donebear URL scheme.
Use the donebear URL scheme from Shortcuts, bookmarklets, and other apps on the same iPhone. This is an automation scheme, like Things' things:///add. It is separate from the https links that already open a workspace, task, or settings screen.
The scheme is handled by the iOS app. Add URLs need an auth token stored on that device. Show URLs do not.
Auth token
- Open Done Bear on iPhone.
- Go to Settings → URL Scheme.
- Copy the auth token.
Add URLs must include auth-token. Without it, or with a token that does not match, the app refuses to create a task. Rotate the token if it leaked. Disable it to reject add URLs without deleting the token; Enable turns it back on.
The token never leaves the device. It is not an API key and the server does not see it.
Add a task
donebear:///add?title=Buy%20milk&when=today&auth-token=YOUR_TOKENdonebear://add?... (host form) is accepted too.
| Parameter | Required | Description |
|---|---|---|
title | one of title or titles | Task title. |
titles | one of title or titles | Newline-separated titles. Creates one task per line. |
auth-token | yes | The token from Settings → URL Scheme. |
notes or description | no | Description body. |
when | no | inbox, today, upcoming, anytime, someday, or a start date . Default is today. A deadline with no lands in Anytime. A project with no lands in Inbox. A deadline wins over a project for that default. |
Published with Blode.md