Session URL scheme

Philip Young

15 November 2022

URL Scheme is one way to navigate Session directly from URL. Use cases:

• a document with list of clickable links,
• integrate your to-do app with Session,
• run Session from Alfred,
• run Session inside AppleScript,
• and much more.

URL Scheme is Pro feature and only availble from version 2.1 and above.

Start Session

Programatically start Session.

Parameters:

• intent (optional): Your Session intention.
• duration (optional): Duration in minutes. If not provided, it defaults to your default app duration
• categoryId (optional): Match the first category id. Fall back to default project if not found.
• categoryName (optional): Match the first category with identical name. Case insensitive. Fall back to default project if not found.
• notes (optional) (v2.7.12): Initial notes for the Session

session:///start?intent=Example%20Session&duration=30&notes=Example%20Notes

Try URL above by clicking this link

Start Previous Session

Start previous session with your last intent.

session:///start-previous

Try URL above by clicking this link

Toggle Pause

Toggle pause. Only works while Session is running.

session:///pause

Try URL above by clicking this link

Take a break

Start a break / take a break while in Session

session:///break

Try URL above by clicking this link

Finish Session

Finish Session. Only works while Session is running.

session:///finish

Try URL above by clicking this link

Abandon Session / Rest

Abandon session / stop rest / stop working.

session:///abandon

Try URL above by clicking this link