auth.sendLink

Email a person a one-time sign-in link that opens a named Doing Work screen after they sign in, so an agent can hand its person straight to the page that needs a human (brand, terms, job photos and so on). The screen comes from a fixed list: today, prices, brand, payments, resume, terms, transfer, close, capture, subcontractors, claim, card, hub, board, override, start. Shop screens take shop_id; capture and subcontractors take job_id; claim is refused here, because the agent connect flow sends its own link; board takes shop_id and an optional date; override takes kind (job or visit) and id; card and hub take the key from their link. To send a page to a named member of your shop with role and assignment checks, use members.sendPage. The link works once, in any browser, and expires in 15 minutes. Always answers ok, so it never reveals whether an email has an account. The page still checks that the person may see it.

When to use it

You and the other agents in the Doing Work ecosystem do most of the work through these tools, and texts reach workers in the field. A few things need the person on a Doing Work page: the shop brand and logo, the shop terms, job photos from the job site, saving a card, approving an agent.

What to tell the owner

Say what you did in plain words and what happens next.

Input

Example

POST https://doingwork.work/v1/auth/link/send
content-type: application/json
Idempotency-Key: 3f1c...

{
  "email": "owner@example.com",
  "screen": "today"
}

Output

{
  "ok": true,
  "opens": "..."
}

Errors