Create a link or Notion document

# A link document pointing at an external page
papermark documents create-link https://example.com/pricing --name "Pricing page"
# → Document created: doc_abc123

# A Notion document (the page must be publicly accessible)
papermark documents create-notion \
  https://www.notion.so/acme/Handbook-abc123 --name "Handbook"

Both accept --folder-id <id> to place the document in a team-library folder and --link to also create a default share link.

Read it back — the target shows up in url:

papermark documents get doc_abc123 --json | jq '{type, url}'
# → { "type": "link", "url": "https://example.com/pricing" }

Repoint it at a new URL (records a new primary version, type preserved):

papermark documents versions add-link doc_abc123 https://example.com/pricing-2025
papermark documents versions add-notion doc_def456 https://www.notion.so/acme/Handbook-v2

Creating a link/notion document is a single call — no presign/PUT dance, since nothing is uploaded. Pass type and external_url instead of upload_id / source_url.

TOKEN=pm_live_…

# Link document
curl -X POST https://api.papermark.com/v1/documents \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"Pricing page","type":"link","external_url":"https://example.com/pricing"}'

# Notion document (page must be public)
curl -X POST https://api.papermark.com/v1/documents \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"Handbook","type":"notion","external_url":"https://www.notion.so/acme/Handbook-abc123"}'

external_url must be HTTPS. It's only valid with type: link or type: notion; for file documents keep using upload_id / source_url.

The document response (and GET /v1/documents/{id}, list, search, and the dataroom documents listing) includes the target in url:

{ "id": "doc_abc123", "object": "document", "type": "link",
  "url": "https://example.com/pricing", "content_type": null, "num_pages": 1 }

Repoint it by adding a new version with external_url — the type is inherited from the document, so there's no type field here:

curl -X POST "https://api.papermark.com/v1/documents/doc_abc123/versions" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"external_url":"https://example.com/pricing-2025"}'

The new version becomes primary in the same transaction; roll back with PATCH /v1/documents/{id}/versions/{version_id} and {"is_primary":true}.

Required scope: documents.write (reads: documents.read).

Add a document to Papermark that points at https://example.com/pricing, call it "Pricing page".

The agent calls upload_document with type: "link" and external_url: "https://example.com/pricing". For a Notion page, name the Notion URL and it uses type: "notion" instead (the page must be public).

The pricing page moved to https://example.com/pricing-2025 — update the "Pricing page" document.

The agent finds the document, then calls add_document_version with external_url to repoint it. Existing share links serve the new URL on the next view.