Open a link in the web app

GET/share

The share target of the installed web app: its manifest names this endpoint, so a device that supports sharing to installed web apps sends shared links here. PullMD redirects to the web app with the link filled in, and the web app converts it. This endpoint converts nothing itself.

PullMD takes the link from link, then url. If both are empty, it takes the first http:// or https:// URL in text. With sign-in enabled, a browser that isn't signed in is redirected to /login first.

Authorizations

Authorizationstringheader

Needed only when the instance has sign-in enabled (PULLMD_AUTH_MODE is single-admin or multi-user). Send Bearer pmd_<key> with an API key created at /settings. In single-admin mode, the legacy PULLMD_AUTH_TOKEN is also accepted as a bearer token. OAuth access tokens work only on /mcp. Browser sessions use the pullmd_session cookie instead.

Query parameters

linkstring

The shared link.

urlstring

The shared link, used when link is empty.

textstring

Shared text. Used when link and url are empty. PullMD takes the first http:// or https:// URL in it.

cURLcURLPythonJavaScript

curl --request GET \
  --url 'http://localhost:3000/share' \
  --header 'Authorization: Bearer <token>'

{}