Deep links

Verified August 7, 2026

Pinwork supports the pinwork:// URL scheme for navigation, capture, task opening, and automation.

Deep links work from Shortcuts, Raycast, Alfred, Keyboard Maestro, shell scripts, AppleScript, browser bookmarks, and any other tool that can open a URL.

Raycast extension

If you use Raycast, the dedicated Pinwork extension is the quickest way to work with your tasks. It gives you ready-made commands for common actions, so you do not have to build pinwork:// URLs by hand.

Install it from the Raycast Store: Pinwork on the Raycast Store.

The extension includes commands to show Today, Inbox, and Next, quick add a task with natural language, search tasks, and show projects.

You can still use the raw pinwork:// links below from Raycast when you want an action the extension does not cover.

Navigation links open Pinwork to a list or section:

pinwork://today
pinwork://inbox
pinwork://next
pinwork://later
pinwork://someday
pinwork://waiting
pinwork://archive

Navigation links do not change task data.

Quick add

Use pinwork://quickadd to create a task from natural language:

pinwork://quickadd?text=Review%20pitch%20deck%20Friday%20at%202pm%20%23startup

Quick add runs Pinwork’s natural-language parser. It can apply recognized dates, times, tags, projects, recurrence phrases, estimates, and calendar commands.

The Siri and Shortcuts Quick Add App Intent uses the same rich Quick Add service when the main app processes its queued task.

Add with explicit parameters

Use pinwork://add when automation already knows the fields and wants to pass explicit parameters.

Examples of supported concepts include:

title
notes
When
Deadline
list or destination
project
tags
estimate

The add flow can create or open a task for review depending on the parameters and platform flow.

Import a whole plan (unreleased)

The pinwork://import-plan?data=... route is implemented in the next app update. It is not available in the current public release. The website’s whole-plan button must remain disabled until a supporting app version is released. The existing individual pinwork://add links remain available for older versions.

Encode this UTF-8 JSON as one RFC 3986 percent-encoded data query value:

{"v":1,"title":"Write proposal","deadline":"2026-09-25","sessions":[{"day":"2026-09-21","minutes":60},{"day":"2026-09-22","minutes":15}]}

Opening the link shows a preview with the session count, total duration, deadline and dated sessions. Without current subscription or lifetime access, Pinwork first shows its plans. Successful purchase or restoration returns to the requested preview. Nothing is created until Import plan is selected. On first launch, the incoming plan waits until the onboarding guide has finished. Each session becomes a numbered task with a date-only When and its own estimate. These are dated sessions, not appointments with hourly start times. The shared Deadline accepts a civil date or an ISO 8601 timestamp with an explicit timezone. A timestamp retains its instant and timed flag. Civil dates are interpreted in the device’s timezone. Past dates remain past dates. Upcoming opens after a successful import.

Version 1 accepts 1 to 400 chronological sessions, including several on the same day, with integer durations of 1 to 1440 minutes. Session dates must be valid Gregorian dates no later than the deadline’s written date. Titles are trimmed and limited to 120 Unicode codepoints. The decoded JSON must be at most 65,536 UTF-8 bytes. Invalid payloads and duplicate query parameters are rejected. All new sessions save together; a storage failure adds none.

Repeating the same plan on the same local store skips existing imported sessions without overwriting edits or completed tasks. Deleting a session allows that session to be imported again. Importing independently on different devices before they sync can create separate copies. Task IDs remain unique; there is no promise of cross-device import deduplication. The handoff uses the local URL scheme and does not upload plan content.

Open tasks and projects

Pinwork can open task and project deep links created by the app, such as links copied from task actions.

Use Copy Task Link from a task menu or shortcut when you want a stable link to paste into notes, scripts, or automation tools.

If the target item is missing or no longer available, Pinwork cannot open it.

Complete and uncomplete

Task mutation links can complete or reopen tasks:

pinwork://complete/{id}
pinwork://uncomplete/{id}

Complete uses Pinwork’s task completion path and can create a next occurrence for a recurring task when the recurrence rule allows one.

Uncomplete reopens the task to Not Started.

Defer and reschedule

Use defer or reschedule links to change a task’s When date:

pinwork://defer/{id}?to=tomorrow
pinwork://reschedule/{id}?date=2026-06-15

Defer supports preset targets. Reschedule supports a specific date and optional time.

Use these links carefully in automation because they change task data without the normal list gesture flow.

Archive and delete

Destructive links are supported:

pinwork://archive/{id}
pinwork://delete/{id}

Archive marks the task canceled. Delete permanently deletes the task.

Pinwork shows confirmation for archive and delete links because they can be triggered from outside the normal app UI.

Undo behavior

Background deep-link mutations do not provide the normal in-app undo stack.

If you need the normal undo experience, use the in-app task actions instead of a background mutation link.

Access lock behavior

Links that open Pinwork or navigate can still work when access is locked.

Links that create, complete, uncomplete, defer, reschedule, archive, or delete tasks are blocked until access is restored.

Natural language: syntax used by quick add.
Automation: Shortcuts, AppleScript, and command palette.
Archive, delete, restore, and undo: consequences of destructive actions.

Was this page helpful?