Which workspace a document is in, for a link that names no workspace
For an old link (`/sign/documents/<id>`, an email from before workspace URLs), so the app can send the tab to the same route under `/w/<slug>`. It works across the caller's workspaces: the token may be for any of them. It answers only when the caller could open the document in its own workspace: they are a member with a product seat, Sign is on there, and the document is theirs or shared with the workspace. Rows from before workspaces (no workspace) are not located. Every other case gets the same 404, byte for byte: no such document, someone else's private one, another workspace's, the product turned off there, a malformed id, or a request made with an API key or an OAuth grant (those are bound to one workspace by consent). Both answers are `Cache-Control: no-store`. Rate-limited per user and per client IP.
View as MarkdownAuthorization
bearer In: header
Path Parameters
Response Body
application/json
application/json
application/json
curl -X GET "https://example.com/v1/documents/string/locate"{ "workspace_id": "0967198e-ec7b-4c6b-b4d3-f71244cadbe9", "slug": "string"}Live file-conversion events (SSE) — deprecated alias of GET /v1/events
A Server-Sent Events stream telling the caller when a file they uploaded finishes converting to PDF (status "ready" or "failed"), replacing per-document polling. Scoped to the caller: only files on documents they own are reported, taken from the verified token. Frames carry ids and the new status only; re-read the document (GET /v1/documents/{id}) for the data. The stream emits `event: ready` once on connect (re-check any file you are waiting on — you may have missed an event while disconnected), then `event: conversion` with `{"documentId","fileId","status"}` as files settle, plus `: ping` heartbeat comments every 25s. The server ends the stream after 15 minutes; reconnect with a fresh token. Delivery is best-effort — keep a slow fallback poll of the document. Answers 503 when the server has no event listener; fall back to polling.
Document detail
One document with recipients (ordered) and fields.